Housing Project - XTS (Metric Units)
Housing Project - XTS (English Units)
Summary
This example uses the XTS module to simulate a supply pump used to replenish a water storage tank that is used to supply water to a housing development. There is a requirement that the height of the liquid in the water supply tank is not to drop below
Note: This example can only be run if you have a license for the XTS module.
Topics Covered
-
Using Dual Cyclic Junction Transients
-
Understanding Transient Output
-
Resolving Time Step issues
Required Knowledge
This example assumes the user has already worked through the Walk-Through Examples section, and has a level of knowledge consistent with the topics covered there. If this is not the case, please review the Walk-Through Examples, beginning with the Beginner - Three Reservoir example. You can also watch the AFT Fathom Quick Start Video Tutorial Series on the AFT website, as it covers the majority of the topics discussed in the Three-Reservoir Model example.
In addition, it is assumed that the user has worked through the Beginner - Filling a Tank - XTS example, and is familiar with the basics of XTS transient analysis.
Model Files
This example uses the following files, which are installed in the Examples folder as part of the AFT Fathom installation:
Step 1. Start AFT Fathom
From the Start Menu choose the AFT Fathom 13 folder and select AFT Fathom 13.
To ensure that your results are the same as those presented in this documentation, this example should be run using all default AFT Fathom settings, unless you are specifically instructed to do otherwise.
Step 2. Open the model
Open the Metric - Housing Project.fth example file. Right-click on the 4 inch Pipe scenario and select Save Scenario to File Without Children and save this scenario to a new model file.
The Workspace should look like Figure 1 below:
For this example, we will be changing the West Lake junction (J1) from an infinite reservoir to a finite water supply tank. We will then add a new supply reservoir, as well as a supply pump and a check valve to the system. The new supply pump will replenish the supply tank as the water level in the tank is depleted.
Step 3. Define the Modules Panel
Open Analysis Setup from the toolbar or from the Analysis menu. Navigate to the Modules panel. For this example, check the box next to Activate XTS and select Transient to enable the XTS module for use. A new group will appear in Analysis Setup titled Transient Control. Click OK to save the changes and exit Analysis Setup. Open the Analysis menu to see the new option called Time Simulation. From here you can quickly toggle between Steady Only mode (normal AFT Fathom) and Transient (XTS mode).
Step 4. Modify the existing model
Modify the workspace to include the new supply reservoir, supply pump, check valve, and piping as shown in Figure 2. You may need to move the objects to the right on the Workspace to create room for the new pipes and junctions. Do this by selecting all pipes and junctions by either using CTRL+A or click-and-drag and selection box encompassing all objects. Then click, hold, and drag the objects to the right. Now define the new objects.
Pipe Properties
-
Pipe Model tab
-
Pipe Material = PVC - ASTM
-
Pipe Geometry = Cylindrical Pipe
-
Size = 4 inch
-
Type = schedule 40
-
Friction Model Data Set = Standard
-
Lengths =
-
Pipe | Length (meters) |
---|---|
300 | 7.5 |
301 | 150 |
302 | 1.5 |
Junction Properties
-
J300 Reservoir
-
Name = West Lake
-
Tank Model = Infinite Reservoir
-
Liquid Surface Elevation = 0 meters
-
Liquid Surface Pressure = 0 barG (0 kPa (g))
-
Pipe Depth = 0 meters
-
-
J301 Pump
-
Inlet Elevation = 0 meters
-
Pump Model = Centrifugal (Rotodynamic)
-
Analysis Type = Pump Curve
-
Enter Curve Data =
-
-
Volumetric | Head |
---|---|
m3/hr | meters |
0 | 300 |
45 | 350 |
90 | 240 |
-
Curve Fit Order = 2
-
Optional tab
-
Special Condition = Pump Off With Flow Through
-
-
J302 Check Valve
-
Inlet Elevation = 60 meters
-
Loss Model = Cv
-
Cv = 10
-
Forward Velocity to Close Valve = 0 meters/sec
-
Delta Pressure/Head to Reopen = Pressure
-
Delta Pressure = 0 bar (kPa)
-
-
J1 Reservoir
-
Name = Supply Tank
-
Tank Model = Finite Open Tank
-
Known Parameters Initially = Both Parameters (Liquid Surface Level & Surface Pressure)
-
Cross-Sectional Area = Constant, 6.5 meters2
-
Liquid Level Specification = Height from Bottom
-
Liquid Height = 4.9 meters
-
Liquid Surface Pressure = 0 barG (0 kPa (g))
-
Tank Height = 5 meters
-
Pipe Depth = 5 meters
-
Tank Bottom Elevation = 60 meters
-
Step 5. Define the Transient Control Group
Open Analysis Setup again and navigate to the Simulation Duration panel, part of the Transient Control group.
For this example, with a Start Time of 0 minutes, set the Stop Time to 120 minutes with a time step of 1 minute. The output will be saved to the output file for every time step.
Step 6. Specify the Time Simulation Formatting
Open the Output Control window and select the Format & Action tab. Set the Time Simulation Formatting units to minutes and click OK to save and close the window.
Step 7. Enter the Pump Transient Data
For this example, the pump will be set to turn on when the liquid level in the supply tank drops below
The Dual Event Cyclic event requires that two transients be defined. In this case, the first transient will be the pump turning on when the water level drops below
-
Transient tab
-
Transient Type = Speed vs. Time
-
Transient Special Condition = None
-
Initiation of Transient = Dual Event Cyclic
-
First Event
-
Event Type = Reservoir Liquid Height
-
Condition = Less Than or Equal To
-
Value = 3 meters
-
Junction = 1 (Supply Tank)
-
-
First Transient =
-
Time (seconds) | Speed (Percent) |
---|---|
0 | 0 |
30 | 100 |
-
Second Event
-
Event Type = Reservoir Liquid Height
-
Condition = Greater Than or Equal To
-
Value = 5 meters
-
Junction = 1 (Supply Tank)
-
-
Second Transient =
Time (seconds) | Speed (Percent) |
---|---|
0 | 100 |
30 | 0 |
For this example, at the beginning of the simulation, the storage tank is full, so the pump will not be running initially. To account for this, the pump Special Condition on the Optional Tab must be set to Pump Off With Flow Through. In order to be consistent, the First Transient defined must be defined with an initial speed of 0, indicating a pump startup.
ØTurn on Show Object Status from the View menu to verify if all data is entered. If so, the Pipes and Junctions group in Analysis Setup will have a check mark. If not, the uncompleted pipes or junctions will have their number shown in red. If this happens, go back to the uncompleted pipes or junctions and enter the missing data.
Step 8. Run the Model
Click Run Model on the toolbar or from the Analysis menu. This will open the Solution Progress window. This window allows you to watch as the AFT Fathom solver converges on the answer. Now view the results by clicking the Output button at the bottom of the Solution Progress window.
Step 9. Examine the Output
Figure 5 shows a Quick Graph plot of the liquid height in the J1 Supply Tank. The plot illustrates how the Dual Event Cyclic transient will repeat continuously as the event to trigger each transient is met, in turn. The plot shows the tank draining due to the flow to the housing project. When the liquid level reaches
The plot shows the liquid level dropping below
The user should always carefully consider the time step being used in relation to the length of the transient events defined for their analysis.
Note: You may notice a warning message indicating that the static pressure is lower than vapor pressure at the outlet of pipe 301. Since this example is for demonstration purposes only, this warning may be ignored. However, warnings should otherwise never be ignored.