1D Pumps: Difference between revisions

Content deleted Content added
 
(20 intermediate revisions by 8 users not shown)
Line 1:
=Introduction=
This post provides a modelling example for a 1D pump using a fixed flow rate and pump curve. For this example we will set up a pump in two common situations (2D-2D & 1D-2D).
 
=Pump Attributes=
A pump needs to first be digitised in a 1d_nwke layer. The direction of the polyline must go from inlet to outlet as a pump is unidirectional (see Section 5.9.2.1 Pumps). The attributes required for a pump in your 1d_nwk layer can be found withinin the 2018<u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW manualManual]</u>.<br>
In the 1d_nwk layer, the following attributes are required:<br>
#ID = ID of the pump channel. <br>
Line 16:
 
=2D-2D Configuration=
BecauseAs pumps are zero length channels, they do not create automatic nodes at the upstream and downstream end. If you ran the model with just a pump polyline and SX connection, you will get <u>[[TUFLOW_Message_1353| <font color="red"><tt>ERROR 1353 - No NA data for Node]]</tt></font><ttu>.</tt>]] To remove this error, the most efficient schematisation is to digitise a 1d_nwk 'NODE' at the upstream and downstream end of the pump (no need for a separate 2d_bc SX layer). TheUnlike 'NODE'NODEs requiresconnected ato nominalpipes storageand amount in the “Len_or_NA” attributechannels, inNODEs addition infill 'SX' into the "Conn_1D_2D" attributeconnected to connectzero thelength 1dpumps pump torequire the 2Dfollowing domain. SX connections are required at connections to 2D domains to transfer water from the 1D node to the 2D. Without the SX connection, water will build up within the node and cause an instability. See the example below.attributes:<br>
#Type = "NODE". <br>
#Len_or_NA = The 'NODE' requires a nominal storage amount. This can be estimated from the pipe length and diameter attached to the pump. <br>
#US_Invert = The upper elevation of the automatically created NA table. Make sure these values are set higher than the expected water levels at the intake and outlet of the pump. <br>
#DS_Invert = The bottom elevation of the pump nodes. As the pump does not create automatic nodes, the bottom elevation of the pump nodes must be specified. Note that this does not change the intake or outlet elevations of the pump, but only sets the bottom elevation of the nodes for storing water. <br>
#Conn_1D_2D = Set to "SX" to connect the 1D pump with the 2D domain. Without the SX connection, water will build up within the node and cause instabilities. <br>
 
See the example below.<br>
[[File:1d_nwk_pump_SX_node.PNG|border|300px]] <br>
 
[[File:1d_nwk_pump_SX_node.PNGpng|border|300px600px]] <br>
 
A simple 2D-2D pump configuration will look like the below schematisation. <br>
 
[[File:Pump_schematic.PNG|border|600px]] <br>
 
=1D-2D Configuration=
Line 29 ⟶ 36:
 
=Estry Control File Setup=
Within the *.ecf the following commands and files are at a minimum required to run a pump with no logicallylogical controlcontrols:<br>
<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>==</tt></font><tt>..\model\mi\1d_nwke_xxxxx.MIF</tt><br>
<font color="blue"><tt>Depth Discharge Database</tt></font> <font color="red"><tt>==</tt></font><tt>..\bc_dbase\xxxxx.csv</tt><br>
If you do not specify a Depth-Discharge database then you will be faced with <font color="red"u><tt>ERROR[[TUFLOW Message 1118 | CouldERROR not find a y-Q curve1118]]</tt></font><ttu>.</tt><br>
 
=TUFLOW Operating Control File (.TOC)=
For guidance on setting up the operating controls for pumps, seerefer sectionto 5the <u>[https://docs.9tuflow. in the com/classic-hpc/manual/latest/ TUFLOW Manual]</u>. <br>
 
.ecf command required: <br>
 
<font color="blue"><tt>Read Operating Controls File</tt></font> <font color="red"><tt>==</tt></font><tt> xxxxx.toc</tt><br>
 
;Useful Forum Posts
[http://www.tuflow.com/forum/index.php?/topic/1602-operational-pump/#comment-4028 Operational pumps with logic less than zero].
 
=Depth Discharge Database=
The depth discharge database is set up in the same way as a pit inlet database, see(refer 5.12.4 into the <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW manualManual]</u>). Each pump ‘Inlet_type’ must reference a name within the depth discharge database, otherwise <u>[[TUFLOW_Message_1118 | <font color="red"><tt>ERROR 1118]]</u> - Could not find pit inlet type ",a," in the pit inlet database</tt></font><tt></tt>]]. The ‘Area (m2)’ column is the area of the pump offtake and ‘Width (m)’ column is the width of the pump offtake. Without information in the Area(m2) or Width(m) columns in the depth discharge database <fontu>[[TUFLOW color="red"><tt>ErrorMessage 1092|ERROR 1092]]</tt></font><tt></ttu> and <font color="red"u><tt>Error[[TUFLOW Message 1093|ERROR 1093]]</tt></font><tt></ttu> will appear. <br>
==Pump Curve==
Line 57 ⟶ 61:
 
==Creating a TUFLOW pump curve==
The use of pump curves within TUFLOW requires a 2015 or later build. The setup of the Depth Discharge database for a pump curve is similar to reading in inflow hydrographs, hyetographs etc, that is; a source .csv, and the two corresponding headings within the 3rd and 4th column. <br>
 
[[File:depth-discharge_pump.PNG |border|500px]] <br>
 
Once you have your manufacturer curve for your given pump it is now necessary to create the curve .csv for TUFLOW to read in. The manufacturer specifications will need to be translated into a total head vs pump rate chart. Although reading in the depth discharge database is the same process as other boundary conditions within TUFLOW, the curve itself is fundamentally different as you no longer need to start the csv file with 0,0. If the curve did start at 0,0 this would not make sense because at a total head difference of 0m the pump should effectively be operating at peak performance so the flow rate would be greater than 0 m3. This is why builds prior to 2015 cannot be used with pump curves as it still requires csv dbase entries to start at 0,0. The image below shows a csv file for the pump performance curve given in the previous section. <br>
<br>
[[File:Pump_curve_csv_example.png|border|600px]] <br>
 
==Using a Pump Curve in a TUFLOW Operating Control (TOC) File==
 
With the pump curve defined in the depth-discharge database it can either be specified within the pump 1d_nwk fields in the inlet_type field, for non-operational pumps, or it can be defined with the TOC file, for operational pumps. When defining with a TOC file, the pump curve is defined at the top of the structure control definition block and then the subsequent rules can turn the pump on/off. See the below TOC structure control definition for an example. In this case, the pump curve is used when the pump switches on once upstream water levels reach 2.75m AD. The pump curve is then used until the upstream water levels are reduced to 2.25m AD at which point the pump is switched off.
 
<font color="blue"><tt>Define Pump Control</tt></font><font color="red"><tt> ==</tt></font> Pump_1
<font color="blue"><tt>Pump Capacity</tt></font><font color="red"><tt> ==</tt></font> pump_1
HU <font color="red"><tt>==</tt></font> H1D Pump1.1
<font color="blue"><tt>If </tt></font>HU <= 2.25
<font color="blue"><tt>Pump Operation</tt></font><font color="red"><tt> ==</tt></font> Off
<font color="blue"><tt>Else if</tt></font> HU > 2.25 <font color="blue"><tt>AND</tt></font> HU < 2.75
<font color="blue"><tt>Pump operation</tt></font><font color="red"><tt> ==</tt></font> <font color="blue"><tt> No Change </tt></font>
<font color="blue"><tt>Else if</tt></font> HU <font color="red"><tt>>=</tt></font> 2.75
<font color="blue"><tt>Pump Operation</tt></font><font color="red"><tt> ==</tt></font> On
<font color="blue"><tt>End if</tt></font>
<font color="blue"><tt>End define</tt></font>
 
=1D Result File=
Line 76 ⟶ 96:
Any further questions please email TUFLOW support: [mailto:support@tuflow.com?Subject=TUFLOW%201D%20pumps%20help support@tuflow.com]
<br><br>
{{Tips Navigation
Back to [[TUFLOW_1D_Hydraulic_Structures | 1D Hydraulic Structures]]
|uplink=[[ TUFLOW 1D Channels and Hydraulic Structures | Back to 1D Channels and Hydraulic Structures]]
}}