Transient Pipenet Manual
Transient Pipenet Manual
Transient Pipenet Manual
Transient Module
User and Reference Manual
Version 1.7
Foreword
Transient User and Reference Manual
Sunrise Systems Limited
PIPENET and PIPENET VISION are registered trademarks of Sunrise Systems Limited. All other names and
services mentioned in this manual that are trademarks, registered trademarks, or service marks, are the
property of their respective ow ners.
Contents
Table of Contents
Foreword
1 Welcome
................................................................................................................................... 2
2 Sunrise
...................................................................................................................................
- Product Modules
3
3 Obtaining
...................................................................................................................................
Support
3
4 Sunrise
...................................................................................................................................
- How to Contact Us
4
5 Conventions
...................................................................................................................................
used in this document
4
Part 2 Installation
1 Installation
................................................................................................................................... 6
2 Prerequisites
................................................................................................................................... 6
3 Updating
...................................................................................................................................
a key license
6
4 Security
...................................................................................................................................
Key Problems
7
5 Windows
...................................................................................................................................
8
10
13
1 Overall
...................................................................................................................................
view
13
2 The
...................................................................................................................................
Schematic Window
14
3 Tabular
...................................................................................................................................
View window
15
4 Properties
...................................................................................................................................
Window
15
5 Component
...................................................................................................................................
Properties
15
6 Fittings
...................................................................................................................................
window
18
7 The
...................................................................................................................................
Schematic Overview Window
18
8 Menus
................................................................................................................................... 19
File Menu ......................................................................................................................................................... 19
Edit Menu......................................................................................................................................................... 21
View Menu
......................................................................................................................................................... 22
Libraries Menu
......................................................................................................................................................... 23
Options Menu
......................................................................................................................................................... 24
Colouration
.........................................................................................................................................................
Menu
25
Calculation
.........................................................................................................................................................
Menu
25
Output Menu
......................................................................................................................................................... 25
Tools Menu
......................................................................................................................................................... 26
Window Menu
......................................................................................................................................................... 26
Help Menu......................................................................................................................................................... 27
9 Toolbars
................................................................................................................................... 28
Transient .........................................................................................................................................................
Toolbar
28
Options Toolbar
......................................................................................................................................................... 29
Calculation
.........................................................................................................................................................
Toolbar
30
Tag Toolbar
......................................................................................................................................................... 30
Find toolbar
......................................................................................................................................................... 31
II
Transient Module
33
1 Labelling
...................................................................................................................................
the diagram
33
2 Labels
................................................................................................................................... 33
3 Problem
...................................................................................................................................
description
33
4 Stage
...................................................................................................................................
1 - Problem initialisation
34
5 Stage
...................................................................................................................................
2 - Entering The Network
37
6 Stage
...................................................................................................................................
3 - Checking the network
46
7 Stage
...................................................................................................................................
4 - Saving the network
46
8 Stage
...................................................................................................................................
5 - Performing a calculation
46
9 Stage
...................................................................................................................................
6 - Viewing the results
49
53
1 Problem
...................................................................................................................................
description
53
2 Stage
...................................................................................................................................
1 - Adding a pump to the library
54
3 Stage
...................................................................................................................................
2 - Problem initialisation
55
4 Stage
...................................................................................................................................
3 - Entering the network details
57
5 Stage
...................................................................................................................................
4 - Defining output tables and graphs
60
6 Stage
...................................................................................................................................
5 - Performing a calculation
65
69
1 Problem
...................................................................................................................................
description
69
2 Stage
...................................................................................................................................
1 - Creating the library items
70
3 Stage
...................................................................................................................................
2 - Problem Initialisation
73
4 Stage
...................................................................................................................................
3 - Entering the network details
74
5 Stage
...................................................................................................................................
4 - Specifications
75
6 Stage
...................................................................................................................................
5 - Defining forces
75
7 Stage
...................................................................................................................................
6 - Specifying tables
77
8 Stage
...................................................................................................................................
7 - Specifying graphs
78
9 Stage
...................................................................................................................................
8 - Performing the calculation
79
84
1 Forces
................................................................................................................................... 84
2 Time
...................................................................................................................................
control and time steps
91
3 Variable
...................................................................................................................................
time step
93
4 Vapour
...................................................................................................................................
cavitation
97
5 Channel
...................................................................................................................................
cavitation
98
6 Long
...................................................................................................................................
sections
102
Contents
III
7 Pressure
...................................................................................................................................
envelopes
104
107
1 Schematic
...................................................................................................................................
Window
107
2 Schematic
...................................................................................................................................
Underlay
107
3 Selection
...................................................................................................................................
Tool
108
4 Pan
...................................................................................................................................
and Zoom Tool
109
5 Area
...................................................................................................................................
Tool
109
6 Polygon
...................................................................................................................................
Tool
110
7 Text
...................................................................................................................................
Tool
111
8 Link
...................................................................................................................................
Component Tools
113
9 Pipe
...................................................................................................................................
Component Tools
114
10 Schematic
...................................................................................................................................
Printing
114
11 Exporting
...................................................................................................................................
the Schematic
115
12 Moving
...................................................................................................................................
around the network
116
13 Use
...................................................................................................................................
of the mouse
117
120
1 Tabular
...................................................................................................................................
Grid
120
2 Validation
................................................................................................................................... 122
3 Copying
...................................................................................................................................
Cells
122
126
1 Status
...................................................................................................................................
checking
126
2 Height
...................................................................................................................................
Checking
126
129
1 Colour
...................................................................................................................................
Schemes
129
2 Tagging
................................................................................................................................... 133
3 Background
...................................................................................................................................
Colours
133
135
1 Elevation
...................................................................................................................................
Profile Window
135
139
1 Add
...................................................................................................................................
Multiple Pipes
139
Part 14 Libraries
142
1 Libraries
................................................................................................................................... 142
2 Schedules
................................................................................................................................... 144
3 Fittings
................................................................................................................................... 145
IV
Transient Module
4 Control
...................................................................................................................................
Valves
147
5 Pumps
...................................................................................................................................
- Coefficients Unknown
148
6 Pumps
...................................................................................................................................
- Coefficients Known
150
7 Pumps
...................................................................................................................................
Turbo
151
8 Linings
................................................................................................................................... 152
9 General
...................................................................................................................................
Pressure Losses
153
10 Editing
...................................................................................................................................
System Libraries
154
156
1 Title
................................................................................................................................... 156
2 Transient
...................................................................................................................................
options
156
3 Units
................................................................................................................................... 158
4 Fluid
................................................................................................................................... 161
5 API
...................................................................................................................................
Fluid
163
6 Pipe
...................................................................................................................................
types
164
7 Schematic
...................................................................................................................................
display options
165
169
1 Transient
...................................................................................................................................
calculations
169
2 Selecting
...................................................................................................................................
graphs for components
169
3 Defining
...................................................................................................................................
Tables
170
4 Defining
...................................................................................................................................
Forces
172
5 Displaying
...................................................................................................................................
Results
173
6 Controls
................................................................................................................................... 174
7 Absolute
...................................................................................................................................
tolerances
175
8 Relative
...................................................................................................................................
tolerances
175
9 Initial
...................................................................................................................................
state
176
10 Transient
...................................................................................................................................
Output
177
11 Maximum
...................................................................................................................................
and minimum pressure
179
182
1 Graph
...................................................................................................................................
Viewer introduction
182
2 Different
...................................................................................................................................
graph types
185
3 Using
...................................................................................................................................
the property tabs
187
4 Curve
...................................................................................................................................
property tab
188
5 Y...................................................................................................................................
Axis property tab
189
6 X...................................................................................................................................
Axis property tab
190
7 Limit
...................................................................................................................................
Lines properties tab
191
8 Labels
...................................................................................................................................
and Arrows
193
9 Hot
...................................................................................................................................
spot
194
Contents
10 Zooming
................................................................................................................................... 195
Part 18 Modelling
198
1 Standard
...................................................................................................................................
and Spray options
198
2 HazenWilliams
................................................................................................................................... 198
3 Coulson
...................................................................................................................................
and Richardson
199
4 Pipe
...................................................................................................................................
C-factor
200
5 Linings
................................................................................................................................... 200
6 Fluids
................................................................................................................................... 200
7 Fluid
...................................................................................................................................
Equations
202
8 Wave
...................................................................................................................................
Speed
203
9 Specifications
................................................................................................................................... 204
10 Initial
...................................................................................................................................
Guess File and the initial state
209
11 Elastic
...................................................................................................................................
Pipe
210
12 Elastic
...................................................................................................................................
Pipe - Dry Pipe
213
13 Short
...................................................................................................................................
Pipe
216
14 Pipe
...................................................................................................................................
Bundle
217
15 Compressible
...................................................................................................................................
Pipe
222
16 Fittings
...................................................................................................................................
and equipment items
223
17 Simple
...................................................................................................................................
Pump
226
18 Turbo
...................................................................................................................................
Pump
230
19 Inertial
...................................................................................................................................
Pump
234
20 Valves
................................................................................................................................... 241
21 Operating
...................................................................................................................................
Valve
244
22 Standard
...................................................................................................................................
Valve Types
245
23 Non-return
...................................................................................................................................
valve
250
24 Check
...................................................................................................................................
Valve
250
25 Fluid
...................................................................................................................................
Damped Check Valve
252
26 Liquid
...................................................................................................................................
Surge Relief Valve
254
27 Regulator
...................................................................................................................................
Valve
256
28 Inertial
...................................................................................................................................
Check Valve
258
29 Safety
...................................................................................................................................
Valve
260
30 Bursting
...................................................................................................................................
disc
262
31 Pressure
...................................................................................................................................
surge relief valve
264
32 Accumulator
................................................................................................................................... 268
33 SurgeTank
................................................................................................................................... 272
34 Receiving
...................................................................................................................................
Vessel
276
35 Simple
...................................................................................................................................
Tank
283
36 Vacuum
...................................................................................................................................
Breaker
286
37 One-node
...................................................................................................................................
caisson
289
VI
Transient Module
38 Two-node
...................................................................................................................................
caisson - type 1
292
39 Two-node
...................................................................................................................................
caisson - type 2
295
40 General
...................................................................................................................................
Pressure Loss
299
41 Nozzle
................................................................................................................................... 302
42 Nozzle
...................................................................................................................................
Priming Time
304
43 Control
...................................................................................................................................
Systems
305
44 Sensors
................................................................................................................................... 306
45 Transfer
...................................................................................................................................
Function
309
46 PID
...................................................................................................................................
Controller
311
47 Cascade
...................................................................................................................................
PID Controller
315
48 Switch
................................................................................................................................... 317
49 Signal
...................................................................................................................................
Selector
322
324
1 HP-GL/2
...................................................................................................................................
Output
324
Part 20 Errors
326
1 Errors
................................................................................................................................... 326
2 Basic
...................................................................................................................................
errors
326
3 Input
...................................................................................................................................
errors
327
4 Global
...................................................................................................................................
errors
327
5 Specific
...................................................................................................................................
component errors
329
6 Numerical
...................................................................................................................................
errors
330
332
1 Bibliography
................................................................................................................................... 332
2 Surface
...................................................................................................................................
Roughness
332
3 Hazen-Williams
...................................................................................................................................
Coefficients
334
4 Physical
...................................................................................................................................
Constants
335
5 Built-in
...................................................................................................................................
schedules and fittings
336
6 ANSI
...................................................................................................................................
B36.10 Schedule 10
338
7 ANSI
...................................................................................................................................
B36.10 Schedule 20
339
8 ANSI
...................................................................................................................................
B36.10 Schedule 30
340
9 ANSI
...................................................................................................................................
B36.10 Schedule S
341
10 ANSI
...................................................................................................................................
B36.10 Schedule 40
342
11 ANSI
...................................................................................................................................
B36.10 Schedule 60
343
12 ANSI
...................................................................................................................................
B36.10 Schedule XS
344
13 ANSI
...................................................................................................................................
B36.10 Schedule 80
345
14 ANSI
...................................................................................................................................
B36.10 Schedule 100
346
15 ANSI
...................................................................................................................................
B36.10 Schedule 120
347
Contents
VII
16 ANSI
...................................................................................................................................
B36.10 Schedule 140
348
17 ANSI
...................................................................................................................................
B36.10 Schedule 160
349
18 ANSI
...................................................................................................................................
B36.19 Schedule 5S
350
19 ANSI
...................................................................................................................................
B36.10 Schedule XXS
351
20 ANSI
...................................................................................................................................
B36.19 Schedule 10S
352
21 ANSI
...................................................................................................................................
B36.19 Schedule S
353
22 ANSI
...................................................................................................................................
B36.19 Schedule XS
354
23 ANSI
...................................................................................................................................
B36.19 Schedule XXS
355
24 JIS
...................................................................................................................................
1990 Steel Schedule 10
356
25 JIS
...................................................................................................................................
1990 Steel Schedule 20
357
26 JIS
...................................................................................................................................
1990 Steel Schedule 30
358
27 JIS
...................................................................................................................................
1990 Steel Schedule 40
359
28 JIS
...................................................................................................................................
1990 Steel Schedule 60
360
29 JIS
...................................................................................................................................
1990 Steel Schedule 80
361
30 JIS
...................................................................................................................................
1990 Steel Schedule 100
362
31 JIS
...................................................................................................................................
1990 Steel Schedule 120
363
32 JIS
...................................................................................................................................
1990 Steel Schedule 140
364
33 JIS
...................................................................................................................................
1990 Steel Schedule 160
365
34 JIS
...................................................................................................................................
1990 Steel Schedule 5S
366
35 JIS
...................................................................................................................................
1990 Steel Schedule 10S
367
36 JIS
...................................................................................................................................
1990 Steel Schedule 40S
368
37 DIN
...................................................................................................................................
Standard
369
38 Pipe
...................................................................................................................................
Schedule 1 (SPRAY) BS 1387 Heavy
370
39 Pipe
...................................................................................................................................
Schedule 2 (SPRAY) BS 1387 Medium
371
40 Pipe
...................................................................................................................................
Schedule 3 (SPRAY) ANSI B36.10 Schedule 40
371
41 Pipe
...................................................................................................................................
Schedule 4 (SPRAY) ANSI B36.10 Schedule 80
373
42 Pipe
...................................................................................................................................
Schedule 5 (SPRAY) BS3505 Class D
374
43 Pipe
...................................................................................................................................
Schedule 6 (SPRAY) BS.1221 Class C
375
44 Pipe
...................................................................................................................................
Schedule 7 (SPRAY) BS.2871
376
45 Pipe
...................................................................................................................................
Schedule 8 (SPRAY) BS.2871
377
46 Lining
...................................................................................................................................
Type
378
47 K-factor
...................................................................................................................................
- Type of Fitting or Valve
378
48 Entry
...................................................................................................................................
and Exit K-factors
378
49 Equivalent
...................................................................................................................................
Lenghts (FOC)
380
50 Equivalent
...................................................................................................................................
Lengths (NFPA)
382
51 DXF
...................................................................................................................................
Ouput
384
387
1 Introduction
................................................................................................................................... 387
2 Prerequisites
................................................................................................................................... 387
VIII
Transient Module
3 Installing
...................................................................................................................................
the report generator
387
4 Open
...................................................................................................................................
the Project Template Document
387
5 Prepare
...................................................................................................................................
the document titles, headers and footers
388
6 Create
...................................................................................................................................
a PIPENET report file
389
7 Merge
...................................................................................................................................
the report file and the template
389
8 Updating
...................................................................................................................................
the model and the report
392
9 Microsoft
...................................................................................................................................
Office Technology used
393
Index
394
Sunrise Systems
Part
Transient Module
Sunrise Systems
1.1
Welcome
Sunrise Systems
1.2
1.3
For the analysis of the single phase flow of liquids and gases.
For the analysis of fixed fire-protection systems employing water.
For the analysis of transient flow in all types of network employing a
liquid.
Obtaining Support
Support queries, or details of any problems experienced, should be emailed to:
[email protected].
If you are experiencing problems with a specific PIPENET network, please remember to attach
the data files, together with any associated library files, to the email. For PIPENET VISION,
files include the .SDF data file and the associated .SLF file. For PIPENET Classic, files include
the .DAT file, together with the any associated library files, .PDF, .PMP, .UFL, and .VLB.
Please also include any other information that might help in locating the source of the problem.
For queries relating to installation (in particular, security key problems), please include the key
number. For USB keys, this is a five digit number of the form 1nnnn or 2nnnn. For parallel port
Transient Module
keys, the number is located in the bottom right-hand corner of the key label (not the Sunrise
address label). Before sending any queries relating to the installation of the software, please
make sure that you have read the trouble-shooting section in this document, and provide details
of any error messages encountered during installation.
1.4
1.5
Installation
Part
Transient Module
Installation
2.1
Installation
Installation of a PIPENET module will have been described in the installation guide, which
accompanies the CD-ROM. This chapter deals with problems that may occur once the software
has been installed from CD-ROM.
2.2
Prerequisites
To run any of the PIPENET modules, you need the following:
A valid PIPENET licence provided by an appropriate HASP security key or Flex
License Agreement.
A release CD-ROM.
2.7 GHz Processor, if Single Core (Intel preferred).
1 GB memory.
At least 250 M Bytes of free disk storage.
Microsoft Windows 2000, XP, Vista, Windows 7 or Windows 8.
A display monitor with a minimum resolution of 1024 x 768.
2.3
Installation
3. Selecting OK will display a dialog for navigating to the encrypted licence file.
4. As soon as you have selected the licence file, a second dialog will be displayed,
hopefully indicating the success of the operation:
5. If the operation fails then Sunrise Systems should be contacted for further assistance,
which may necessitate the return of the key. This may occur with security keys that
are several years old.
Note that the encrypted licence file is only valid for a specific key, as identified by the number in
the bottom right-hand corner of the key's label. For parallel port keys, this will be a four digit
number; for USB keys, a 5 digit number greater than 10000. Note, also, that a licence file can
only be used once to update a key; if an attempt is made to update a security key more than
once, the second and subsequent attempts will fail with an error.
2.4
Transient Module
PIPENET will never replace an existing file in this directory if it is more recent than the
one shipped with PIPENET.)
Access to the Windows System registry.
If you did not have these rights when you installed the software then the key drivers will not have
been correctly installed, and thus the software cannot be run. Re-install the software, having
obtained the necessary rights and privileges. Contact your IT support group if you unsure as to
how to proceed.
Fitting the security key
A USB key must be fitted to an available USB port, and a parallel key must be fitted to the port
LPT1. If you are using a parallel port key then the key may be fitted in series with security keys
provided by other software manufacturers.
Licensing provided by a key
Each key is specifically programmed for the needs of each user. Depending on the licensing
agreement, the key will be programmed:
for one or more PIPENET modules,
for a specific number of runs or an unlimited number of runs,
for use before a programmed expiry date or for unlimited use.
If the key is not programmed for the module you are attempting to run, or the number of runs has
expired, or the key has passed its expiry date then any error messages displayed will inform you
of the specific error.
If the key is correctly fitted, and the drivers have been correctly installed, then the status of the
key and the licences available can be checked via the Help | Key Status menu option. If the
security key is correctly fitted then this will display the key details, including the key number and
customer name, in addition to licensing details.
Checking installation of security key drivers
If you have followed all of the instructions above, and you have a key licence for the module
you are trying to run, then you should have no further problems. However, if you are still having
problems then please perform the following checks, and email the results to Sunrise Systems. Be
sure to include the key number. If you cannot run Key Status then the key number is also
printed in the bottom right-hand corner of the key's label.
Trouble shooting
The most common reasons for failure are not having the correct key fitted or the key drivers
were not installed correctly. If the key drivers were not installed then the most likely reason for
the failure is that you did not have the necessary access rights during installation. The following
summarises the checks you should perform to locate the source of the problem:
1. Check that you are using a security key appropriate to the module you are trying to
run.
Installation
2. Check that the key is correctly fitted to a USB or parallel port on the computer
where you are attempting to run the PIPENET software.
3. You must have Windows Administrator privileges to install the key drivers, since
changes are made to the System Registry. If you do not have these rights, you will
have to contact your IT department to set up your account details. It is recommended
that you contact your IT department anyway, to confirm any other rights and
restrictions that there may be.
4. Check that you have read and write access to the drive where the software will be
installed (by default, drive C:) and where the temporary files will reside (also, by
default, drive C:). This is necessary, since some organisations prohibit their users from
accessing the local disk, and selected network drives, other than for read access.
Again, if you do not have these rights then you will have to contact your IT
department.
5. Please check (re-install if necessary) that the software and key drivers are correctly
installed.
6. The installation of the key drivers can be checked by running the program
KEYSETUP.EXE, which can be found in the keydriver sub-directory of the
PIPENET installation directory. Running this program produces the display:
Select the Check key drivers button to confirm the installation. Entering this
command will display the status of the key drivers, which, if correctly installed, will
display the date of installation and other information on the printer port, version
number of driver, etc.
7. If step 5 reports that the key driver is not installed then terminate any running
PIPENET module and select the three buttons in the sequence Remove key
drivers, Install key drivers and Check key drivers.
8. The last of the four buttons in the dialog, Check key, will attempt to read the key,
displaying the internally stored key number and the customer name. The customer
name may not be present on very old keys, but the key number should always be
readable if the key drivers are correctly installed.
10
Transient Module
The key-check utility is stored on your hard drive during installation, in the sub-directory
keydriver, and the key check utility program is named KeySetup.exe.
2.5
Windows 8
Sunrise Systems fully support the use of PIPENET on Windows 8, however there are a couple
of known issues which will be addressed here.
Safenet HASP Drivers and Windows 8
PIPENET uses HASP Keys to license the software. The installation CD
Some users have had issues when upgrading from Windows 8.0 to Windows 8.1 due to
problems with the license key drivers. This simple procedure will enable users to upgrade to
Windows 8.1 from Windows 8.0.
Procedure
When installing Windows 8.1, the old HASP Drivers need to be removed. This has to be done
by downloading
Sentinel HASP/LDK Command Line Run-time Installer
from
http://sentinelcustomer.safenet-inc.com/sentineldownloads
extracting the downloaded zip files. Then, in a command window (cmd.exe), navigating to the
directory where the extracted files are kept by typing
cd [directory]
In most cases, this will be
cd C:\Users\***Username***\Downloads\Sentinel_LDK_Run-time_cmd_line\
Once there, type
haspdinst.exe purge
This completely removes all forms of HASP drivers from the machine. It is important to
note that the GUI Installer does not function correctly as it does not have the capacity to
purge the machine of all traces of the HASP drivers.
Following this, install the update to Windows 8.1 and from the aforementioned web
directory, download
Sentinel HASP/LDK Windows GUI Run-time Installer
Installation
11
Ensuring it is version 6.60 or above that is installed. Extract and double click on
HASPUserSetup.exe, following the on screen instructions.
This should correctly reinstall the HASP Drivers, compatible with Windows 8.1. You will
now be able to use PIPENET.
Part
3.1
Overall view
13
The user interface is common to all PIPENET modules, although the toolbars and menus may
vary slightly to reflect the different features available. When the program is started and a
PIPENET data file is opened, the screen will appear thus:
14
Transient Module
The Properties Window and the Schematic Overview can be moved to the right-hand side of the
screen or "floated", by clicking and dragging the top of each window.
At the top of the screen is the usual assortment of menus and toolbars, and at the bottom is the
status bar.
One other window is available, the Elevation Profile Window, which can be used to plot the
elevation along a selected flow path defined by a sequence of nodes.
Menu styles
The menus are arranged differently to the previous PIPENET programs, although users of other
Windows programs may find them more familiar. To revert to the old style of menu, select the
menu option Window | Use Pipenet menu style. To revert to the new window style, select
Window | Use Windows menu style. See also the Window Menu.
3.2
3.3
15
3.4
Properties Window
This is a tabbed set of windows showing:
1. The Properties of the currently selected component, including, where appropriate, a
graph (for example, a pump curve or a filter profile). Unlike earlier versions of
PIPENET, properties can be entered and edited via this window. When a calculation
has been performed, this window will also contain the results for the component.
Properties are displayed in three columns; the first is the name of the property, the
second the current value of the property and the third the units (where appropriate).
Properties are either entered explicitly as values or text strings, or a value is selected
from a drop-down list of acceptable values. If a property cell is greyed out, it indicates
that the value of the property cannot be edited.
2. A fittings window for assigning fittings to pipes.
The Tabbed properties window is normally displayed but, if it is closed, it can be re-opened via
the View menu.
3.5
Component Properties
This window displays the properties associated with the currently selected component. If no
component is selected, the window is blank.
16
Transient Module
If a calculation has been performed, the Properties window will also display a summary of
minimum and maximum pressures at the inlet and outlets. For pipes,the maximum and minimum
internal pressures are also displayed.
W hen a component has been drawn on the schematic,
17
To edit a field, click in the appropriate row in the second column and enter the new value, or
select from the available options. To accept the value enter Tab to move down to the next field
or Enter on the keyboard. Values with a light-grey background cannot be edited. Changes made
in the window can be undone and redone using the undo and/redo keys:
For example, if a pipe is currently displayed, selecting the left button will move to the previous
pipe (if there is one). Pressing the right button will move to the next component. Components are
ordered in the sequence in which they were created.
Display of accompanying graph
Some components may have an accompanying graph. If so, this is also displayed in the
Properties window. For example, selecting a node with a specification will display the
specification curve.
18
3.6
Transient Module
Fittings window
If the currently selected component is a pipe then this window will display the fittings on the pipe.
The top window displays a list of available fittings; the bottom, a list of the fittings currently
selected on the pipe. The lower window displays for each fitting type; the fitting name, the Kfactor and the number of fittings selected on the pipe; below the window is shown the sum of the
K-factors for all fittings.
Adding a fitting
To add a fitting to a pipe, select the desired fitting from the top window, and then click on the
Add button. Each selection of the Add button adds one fitting of the selected type to the pipe.
Removing a fitting
To remove a fitting, select the desired fitting type in the bottom window, and then click on the
Remove button. Each selection of the Remove button removes one fitting of the selected type.
3.7
19
Display of the Overview window, which is not shown on starting the program, is via the View |
Schematic Overview menu option.
3.8
Menus
3.8.1
File Menu
The available options are as follows. The displayed options will vary, depending on whether or
not a network is open.
New
Creates a new network. If licenses are available for more than one module type, a
prompt will be displayed requesting the PIPENET module be selected; namely,
Standard, Spray/Sprinkler or Transient.
Open
Opens an existing data file - files may be the old format data files, with a .DAT file
extension, or the new style files, with a .SDF file extension.
Close
Closes the network - if changes have been made to the network, you will be prompted
to save the file first before closing.
Save
Saves the current network and continue working.
Save As
Saves the current file under a different file name.
Export...
This will export the current network as an old style .DAT file, together with any
associated old-style library files; that is, .PDF files, .UFL files, etc. When selecting this
20
Transient Module
option, you should be aware that some graphical information will not be saved; for
example, colour schemes. When prompted for a file name, enter the name of the .DAT
file, and any associated library files will be saved with the same name, but with a
different file extension.
Autosave...
AutoSave is a feature that can be used to automatically save your edits and
modifications periodically. Select this option to set the interval, in minutes, at which the
network is to be automatically saved. The default is zero, indicating that the autosave
feature is disabled.
Open Library
Opens an external system library.
Import Library
Imports a library file - opens a system library or old format library file (e.g., .pmp pump
library file) and imports its definitions into the local user library.
Print
Print the schematic or the grid - the one that is printed will depend on which of the two
windows is selected. If in doubt, click in the desired window before selecting Print. If
the grid is selected, the current grid page will be printed. If the schematic is selected
then a dialog box is displayed, through which the user can select the scaling and hence
the number of pages. required to print the schematic.
21
Print Preview
Previews the appearance of printed output.
Print Setup
This option displays a standard Windows dialog, from which the user can select a
particular printer, landscape or portrait mode, etc.
Exit
Exits PIPENET.
Recently used file list
Provides a list of recently opened files.
3.8.2
Edit Menu
This menu provides a number of edit related functions:
Undo
Undoes the last operation - this command will undo the last change made in the
Schematic, Properties or Tabular View window. Following the word Undo is a brief
description of the last operation performed.
Redo
Redoes the last undone operation - as with the Undo command, following the word
Redo is a brief description of the last undo operation.
Cut
Combination of a copy operation followed by a delete.
Copy
If the select tool is in operation, this will copy the attributes of the selected component.
If the Area tool is in use, it will copy all components within the selection rectangle.
22
Transient Module
Paste
If the select tool is in operation, this will paste the last copied attributes to the selected
component, as long as the components are of the same type (i.e., both are pipes, both
are pumps, etc.). If the Area tool is used, it will paste all components copied by the
last copy operation.
Paste in column
This option is only available in the Tabular View. When a single cell in a column is
selected, it will reproduce the contents of the cell in all cells in the same column.
Mirror
Used with the Area Tool to mirror the contents of the selected area left-right.
Invert
Used with the Area Tool to invert the contents of the selected area.
Undo/redo on the toolbar
Note the undo and redo operations are available via two shortcut buttons in the toolbar:
The left-hand button is the Undo button and the right-hand button is the Redo button.
3.8.3
View Menu
The view menu controls some aspects of the overall appearance of the various windows.
Toolbar
Displays or hides the main toolbar containing the file and edit related buttons - this is
best left displayed at all times.
Status Bar
Displays or hides the Windows status bar - this is best left displayed at all times.
Palette
Displays or hides the palette bar, which is used to select the tool for drawing within the
schematic window - this is best left displayed at all times.
Schematic Window
Opens the schematic window if, for some reason, it has been closed - only one
schematic window can be open.
Data Window
Opens a tabular view window - more than one tabular view window can be open at
any one time.
Properties
Displays or hides the Properties Window, which contains the tabbed set of windows,
23
Libraries Menu
Before attempting to use libraries, the user should first read the chapter on libraries.
The Libraries menu contains a number of module-specific entries. Those for the Transient
module include:
Schedules
Define or edit pipe schedules in the local user library.
Fittings
Define or edit pipe fittings in the local user library.
Valves
Define or edit valves in the local user library.
Pumps - coefficients unknown
Define or edit pumps with unknown coefficients in the local user library.
Pumps - coefficients known
Define or edit pumps with known coefficients in the local user library.
24
Transient Module
Turbo pumps
Define or edit turbo pumps in the local user library.
Selecting any of these options displays a tabbed dialog for the appropriate library. It is important
to note that any changes are applied to the definitions in the Local User Library.
To edit the System libraries, select the last option (i.e., Edit system Libraries).
The final option in the Libraries menu opens a very similar window, except that, in this case, edits
are performed on a named System Library. It is important to re-emphasis the distinction
between Local User Libraries, where changes made affect only the current user, and System
Libraries, where changes may affect other users.
3.8.5
Options Menu
The Options menu displays a tabbed dialog for viewing and setting the various options in use:
Title - Title for the network, for which up to four lines of text may be specified.
Transient Options - Various modelling options.
Units - Units to be used.
Fluid - Fluid properties.
Pipe Types - Define or edit pipe types.
Display options - Schematic display options.
3.8.6
25
Colouration Menu
This menu contains three items that can be used to set up the colouring of nodes and/or pipes
and ducts, based on the value of one or more attributes. The options are described in detail in
Colour Schemes.
Simple rules
This option is used to define the colouring of links and/or nodes, based on the value of
a single attribute or result. For example, node elevation, pipe length, velocity of fluid
through pipe, and so on.
Complex nodes
This option is used to define more complex colouring rules for nodes, based on the
values of more than one attribute or result.
Complex links
This option is used to define more complex colouring rules for pipes and ducts, based
on the values of more than one attribute or result.
3.8.7
Calculation Menu
Options...
Displays the set of tabbed dialogs for setting the calculation options.
Go...
Displays the dialog for setting the calculation output options prior to performing a
calculation.
3.8.8
Output Menu
Report...
This will prompt for an output viewer, for which the default is the PIPENET supplied
viewer:
26
Transient Module
This will launch the graph viewer for displaying the graphical output produced by the
calculator.
3.8.9
Tools Menu
The tools menu provides a number of useful tools:
Tag selected items
Used in colour coding to tag (or mark) selected components as being significant in
some way, so that they can be colour coded.
Remove tags
Marks all tagged components as untagged.
Make Path
Used in the construction of an elevation profile to construct a path though two or more
selected nodes.
Export clipboard
Copies the schematic to the clipboard, from where it can be pasted into other
applications.
Export HP-GL/2
Exports the schematic as an HP-GL/2 file containing instructions for off-line plotting.
HP-GL/2 is Hewlett-Packard's standardized Graphics Language supported by many
CAD and graphics programs and peripherals. On selecting this option, you will
prompted to supply an output file name.
Export DXF file
Exports the schematic as an AutoCad DXF file, which can be used as input to many
CAD programs. On selecting this option, you will prompted to supply an output file
name.
Add multiple pipes
This tool provides a means of defining a run of pipes, based on a table of elevations
and distances. From this data, if supplied in a suitable form, the PIPENET module can
automatically generate a sequence of pipes with the correct lengths and rises (elevation
changes). For further information on this facility, see the Add multiple pipes section.
27
Selecting OK closes the window, whilst selecting Save will save the displayed details
to a text file (the save feature is not implemented).
Update Key
This option is only available in the Help menu when no PIPENET file is open.
Activating this option will initiate an update to a local HASP security key using a licence
file supplied by Sunrise Systems.
28
Transient Module
3.9
Toolbars
3.9.1
Transient Toolbar
29
Simple tank
Vacuum breaker
Caisson
Two-node caisson
Two-node caisson - type 2
Then there is a group of seven control item:
Flow sensor
Pressure sensor
Pressure Difference sensor
PID controller
Cascade PID controller
Transfer function
Switch
Signal selector
Finally, two buttons:
General Pressure Loss
Equipment Item
3.9.2
Options Toolbar
The options toolbar provides a number of convenient shortcuts to schematic-related options. For
example, display of node labels, grid style, etc.
The toolbar consists of four button groups, from left to right the button options are:
Group 1 - grid related options:
Display grid.
Select Orthogonal grid.
Select Isometric grid.
Snap to Grid.
Group 2 - label options:
Display node labels.
Display component labels.
Display component direction (the arrow is drawn pointing from the pipe input
towards the pipe output).
Display pipe fittings present symbol.
Group 3 - results related options:
30
Transient Module
Display the node colouring-legend button - if this is selected, a node colourcoding legend is displayed in the schematic window.
A drop-down box from which the parameter to be displayed on nodes can be
selected (for example, elevation and pressure).
Display the pipe/duct colouring-legend button - if this is selected a link colourcoding legend is displayed in the schematic window.
A drop-down box from which can be selected the parameter to be displayed on
pipes (for example, flow rate, velocity).
Following a calculation, arrows indicate the flow direction, which may be in
opposite direction to the component direction.
Group 4 - Underlay control:
A single button is provided. Selecting the button will display a dialog from which
the intensity of the underlay can be specified as a percentage.
When an option is selected, the button is shown as depressed, as illustrated for the Select
Orthogonal grid option (i.e., the second button in the above diagram).
3.9.3
Calculation Toolbar
This toolbar contains a few buttons relating to a calculation and the calculation output.
.
Check
Checks the conditions for a calculation. More specifically, it checks that specifications
are complete and consistent, and, if pipe elevations are in use, that node heights are
consistent. This option opens a status window (if it is not already open) as described in
Status Checking.
Calculate
Runs a calculation.
Browse
Browse the output of the last calculation or the last request for input.
Graphs
Opens the graph viewer for viewing results.
3.9.4
Tag Toolbar
This toolbar displays two drop-down lists of the label tags used in the current network for nodes
and for links. It can also be used to select which tag is to be used as the default for all new nodes
and links. To add a tag to a list, simply enter the tag in the edit field followed by return.
31
Selecting the arrow to the right of the text field will drop down a list of currently used tags, and
selecting a tag from this list sets that tag as the default.
If you have a tag selected in one of the drop-downs then, whenever you create a new
component, its automatically assigned numerical id will be prefixed with the specified tag and a
'/'.
Unused tags cannot be explicitly deleted, but, each time a file is re-opened, the tags in use are
re-evaluated, and only those in use will be displayed.
3.9.5
Find toolbar
This toolbar is useful for finding components in the schematic window, particularly for large
networks.
Part
4.1
33
When preparing a network for a simulation, every component and every node must be given a
label that uniquely identifies it. The production of a fully labeled schematic diagram is an essential
part of any simulation.
4.2
Labels
Each component and each node in the network must be given a label that uniquely identifies it.
Labels may either be tagged or untagged. Untagged labels are simply a number in the range 032767. Tagged labels consist of a 'tag' (i.e., a string of up to 8 characters) followed by a slash (/)
and a number in the range 0-999. Tags can be used to make labels more meaningful, and to
allow sections of large networks to be more easily identified. Up to 100 different tags can be
used in one system. Tags must begin with a letter, and may contain only letters and numbers. For
example, the following are all legal labels:
Untagged:
1
1273
9999
Tagged:
JETTY6/1
JETTY6/876
P/12
Notes:
1. Untagged labels greater than 999 and tagged labels may not be used in the same
network.
2. Tags not followed by a slash and a number are not valid labels. For example, XYZ is a
valid tag, but is not a valid label when used alone.
3. Tags are case insensitive; that is, RING is taken to be the same as Ring and ring.
4.3
Problem description
In the first example, we consider a pipe of diameter 25 cm and length 1000 m, leading from the
bottom of a reservoir of average depth 500 m.
34
Transient Module
The waves on the surface of the reservoir cause a fluctuation in pressure at the entrance to the
pipe, of the form:
P = 50 + 0.01 sin (2t/10)
where P is measured in bar G and t is in seconds. The aim of the calculation is to observe the
resulting pressure fluctuations inside the pipe.
The first stage of any simulation is to represent the network in a schematic form for input to
PIPENET. The sketch below shows such a schematic representation
of the problem:
In this case, the problem is represented by a single pipe, labeled 1, having an input node 1 and
an output node 2. This example is supplied in the EXAMPLES directory as ex1.dat.
Setting up the problem
On running the program, select the Standard option. The Transient Module User Interface is
now available for data entry.
In this section, we take the user through the various stages of the setup procedure.
4.4
35
2. Select the Units tab to define the units for the system. Units can be user-defined or set
to SI, British or Metric. In this example, Metric units will be used:
Information on the other features available in this dialog are discussed in Specifying
options - Units.
3. Select the Transient Options tab to define the simulation start and stop times. In this
example, we select start and stop times of 0 and 10 seconds respectively:
36
Transient Module
4. On the same dialog, define a default wavespeed for the pipe in the system. A default
wavespeed is required in this example, since the pipe and fluid details that allow the
Transient module to automatically calculate a wavespeed are not available:
If the User-defined Wavespeeds box is checked, each pipe in the system may be given
a different wavespeed.
5. Select the Fluid tab to define the fluid properties. In this example, the fluid will be
water at 20C. The fluid temperature, bulk modulus and vapour pressure are not used
in this example.
4.5
37
38
Transient Module
In this example, the Young's modulus and Poisson's ratio for the pipe material are unavailable,
and the default wavespeed is displayed. If some pipe schedules had been defined, they would
appear in, and could be selected from, the Pipe Type list. Multiple fittings can be inserted on the
pipe if required. An additional k-factor for the pipe can also be entered in the Additional kfactor field.
Click in the value field for the pipe diameter and enter the value 250, followed by Tab to move
to the next field, the length. Enter a value of 1000.0 for the length of the pipe, followed by either
Tab or Return to accept the value.
39
entered for the component, its colour changes to black (or white, if the background is black).
The colour of a component may revert to blue in either of the following situations:
1. If a check is performed using the check button on the calculation toolbar and the
component is found to be invalid.
2. If the file is saved and re-opened, and on re-loading the component it is found to be
invalid.
Entering the Specifications
Two specifications are required in this example. The pressure at the downstream end of the pipe
is constant, while the pressure at the upstream end varies sinusoidally.
Select the node that is to have the constant specification, and in the Properties window:
1.
2.
3.
4.
Select the other node and, in a similar manner, in the Properties window:
1. Select the specification type as Pressure.
2. Tab to the next field and select the time function as Sine wave.
3. Tab to the next field and enter an amplitude of 0.01.
40
Transient Module
4.
5.
6.
7.
Another way to look at pipes is via the Tabular View, although it is not a significant advantage
with only one pipe, but makes a lot of sense when there are many pipes whose properties you
wish to view. Select the menu option View | Data window to display the window:
Data can be edited in this window simply by clicking in the appropriate cell, and entering a new
value or selecting from a list of valid options. Moving to the next field is achieved by either
entering a tab or by pressing the Return key.
Both the Schematic Window and the Tabular View can be displayed simultaneously by selecting
the menu option Windows | Tile horizontally or Windows | Tile vertically.
41
Select the Add button in the heading of the window, and then enter the title as "Pressures along
the pipe" in the Title 1 field (the name in the title 1 field appears in the combo box in the window
heading), and the window should appear as:
Now select the symbol ... in the first column, adjacent to the column number 1; this expands the
information stored, starting in column 1. Now select the component type as Pipe, and the
window changes to:
42
Transient Module
We want to select the inlet pressure, outlet pressure and Pressure at ...(m) option; for the last of
these, we must provide a value of 500:
43
44
Transient Module
45
This is probably the simplest way for our network, since we only have one pipe. The alternative
is via the Graphs tab in the Tabular View:
which can also be used for displaying all defined graphs. Firstly, select the ... in the first column
of the first available line under the Variable against time section. Next, select the component
type as Pipe, the component label as 1, and the variable as All variables (with all of these
options being selectable from drop-down lists of available items).
Regardless of the method used, the Result Graphs tabbed window should appear as follows:
The start and stop times for the simulation, together with the output time step for graphical
output, are defined in the Calculation | Output dialog (see Stage 4), where a filename for the
graphical output can also be defined.
46
4.6
Transient Module
If there are any errors or warnings, they will be displayed in the dialog. The user should always
perform a check on the network before proceeding with a calculation.
4.7
4.8
47
Pressing the default button sets the run-in time to a quarter of the total simulation time.
Other options in the dialog allow the user to specify a Static initial state (in which all
flows are zero) or to use an initial guess file as the starting point for the simulation.
2. Specify the output filenames and time steps by selecting the Output tab:
No forces are calculated in this example, so the generate forces file option is
unchecked. Example 3 demonstrates the calculation of forces in the Transient Module.
48
Transient Module
A restricted time window for graphical output can be specified by changing the graph
start and stop times (by default, the simulation start and stop times are 0 and 10
seconds respectively). This feature can be useful in reducing the size of the graph file,
by concentrating on an interesting part of the simulation.
Pressing the Timestep button gives information about the simulation time steps and the
division of pipes:
The maximum time step for numerical stability is dependent on the pipe lengths and
wave speeds. All pipes in the network are listed. The number of divisions in each pipe
(based on the calculated time step) is shown, along with the interpolation error based
on these divisions.
The interpolation error tolerance is changed in the Controls tab. In this case, the
default tolerance of 1 is used, which means that PIPENET chooses the simplest way of
dividing the network.
3. Run the simulation by selecting Calculation | Go.
The Calculation...Output dialog appears, and any final changes to the output details
can be made. Selecting OK runs the calculation. The Transient Module progress bar
illustrates the progress of the simulation through each of its three stages; namely, run-in,
simulation and writing of the graph data file:
49
4.9
Output report
Each Transient Module calculation produces an output report. This report contains details of
the calculation, including a summary of the network and specifications, any output tables that
have been requested, together with the minimum and maximum pressures observed during the
simulation. The report file is viewed by selecting Output | Report.
The report viewer will be the PIPENET Output Browser, Write or Word, depending on the
option specified in the calculation output dialog:
50
Transient Module
If there are errors at any stage in the calculation, they will be listed in the output report.
Output graphs
The graphical results can be drawn using the Graph Viewer, which is accessed by selecting
Output | Graphs... For more details on using the Graph Viewer to display and edit graphs, see
the Graph Viewer chapter. In our example, the results show that there is a sinusoidally varying
pressure and flow rate at various points along the pipe.
51
Note that the flow-rate graphs clearly show the time delay for the pressure variation at the
upstream end of the pipe to affect the flow results 1000 metres away, at the downstream end of
the pipe.
Part
5.1
Problem description
53
This second example illustrates a use of the Spray option. It also describes how to create and
use library files to hold project-specific information relating to pipes, valves or pumps.
The system consists of a pump that supplies two sprinkler outlets. The pump is connected to the
outlets by one vertical length of pipe and two horizontal sections that branch off it. A diagram of
the system, including node and component labels, is shown below:
Under normal conditions, each outlet (node 6 and 7) makes a steady demand of 25 litres/min.
The aim of the simulation is to observe the effect of the sudden closure of one of the outlets; in
particular, the size of the pressure surge on all intermediate pipework.
This example is supplied in the EXAMPLES directory as ex2.dat.
Setting up the problem
On running the program, select the Spray option. In this example, we will show how to use
library files to hold project-specific information. Libraries of pumps, valves, pipe schedules or
user-defined fittings can be defined and saved independently of the network data. The library
files can then be loaded into the Transient Module prior to defining the network details.
In setting up the problem, we will first show how to define, save and retrieve a pump library.
Then, we shall use the pre-defined pump characteristic curve for the pump in the sprinkler
system.
54
5.2
Transient Module
Pressure
(litres/minute)
20
30
40
50
60
70
80
55
(bar G)
15.4
14.7
14.2
13.5
12.6
11.2
9.8
5.3
56
Transient Module
57
Defaults
Select Options | Defaults to set the default values for pipes. It is useful to set default pipe
values before entering large networks, to reduce the amount of data that has to be entered. In
the Spray option, default values for C-factor and pipe elevation can be set. In the Standard
option, the C-factor is replaced by roughness. In addition, default values for the k-factor and
pipe diameter can be specified.
5.4
Thus, there is one pump, a non-return valve and three pipes. For now, ignore the green colour of
some components and the appearance of nodes 1, 6 and 7. These relate to graphical results and
specifications respectively. For a small network like this, it is probably best to create all of the
components, and then enter the attributes for each component in turn, using the Properties
window or the Tabular grid.
For the non-return valve, no attributes are required; for the pump, the one and only pump from
the library will selected; and, for pipes, you need to enter the following data:
Pipe label
A
B
C
Input node
4
5
5
Output node
5
6
7
Diameter
250
100
100
Length
100
10
10
Elevation
100
0
0
58
Transient Module
Note that if a pipe is defined as using a pipe type then, instead of explicitly entering the pipe
diameter, the diameter is selected from a combo box listing the available sizes, together with the
unset value.
If the data were entered via the Properties window then the values for all pipes could be viewed
via the tabular grid, for which you should chose View | Data window and then you should see a
table similar to the following:
Specifications
There are four specifications in the system: three I/O specifications at nodes 1, 6 and 7, and one
information specification (for the pump) at node 3. The details of the three constant specifications
are given in the table below. Note that a negative flow rate indicates that fluid flows out of the
system.
Spec. label
1
2
3
Spec. type
Pressure
Flow rate
Information
Node
1
6
3
Time function
Constant
Constant
Constant
Constant value
0
-25
1
For each of the nodes 1,3 and 6, the information can be entered in the Properties window; for
node 1 the Properties window appears thus:
59
The constant value of one for the information specification 3 indicates that the pump operates at
full speed throughout. We wish to simulate a sudden closure of the outlet at node 7, which we do
by defining a Power Ramp time function, with the flow rate value at the node decreasing from 25 to 0 lit/min between 2 and 2.02 seconds. Again, this can all be done in the Properties
window (with the exponent of 1 indicating a linear closure):
60
5.5
Transient Module
The table is divided into two parts: at the top, there are four title lines; and below this, the
definition of the table. The drop-down box at the top indicates which table is currently displayed;
in this case, "Pump operation".
The table definition is initially displayed as a line for each component, identified by its type and
label, together with a start column. The last row (which contains the symbol ... in the first
column) indicates the next free column available (there are a maximum of eight columns allowed
in a table). In the above example, the pipe with label 1 uses the first four columns of the table. To
view which attributes have been selected for the table, select the + symbol in column one, and
the display expands to include a list of the variables:
61
The + symbol now changes to a - symbol, which, if selected, will once again hide the details of
the attributes selected. De-selecting or selecting one or more of the available attributes will
immediately update the number of columns used.
To add extra columns to the grid, click on the last row (i.e., the one containing the ... symbol in
column 1) and select from the list of available component types and component labels displayed.
Finally select the attributes to be displayed:
62
Transient Module
We need to define five tables: one table for the pump, two tables for pipe A and one table for
each of the pipes B and C. For the pump, we select all variables, as in the image above. For
pipe A, we define one table that contains the flow rates at 6 points along the pipe, and one table
for the pressures at 6 points along the pipe. We need two tables because one table can have a
maximum of 8 columns. The display for the pressure table appears as:
63
The tables for pipes B and C are defined in a similar way, but here we require only one table,
with the flow rates and pressures at 3 points along the pipe. The tables for pipe B appears as:
64
Transient Module
Output Graphs
Components for which results (graphs) have been selected are displayed in green (which is the
default colouring scheme). To request results for a particular component, right-click on the
component and chose the Select Results option. This is the same method that was used in
previous versions of the PIPENET VISION Transient Module. For non-pipe components, this
will display a list of available variables - select the single result required; for example, either
Pressure or All (the latter being to accumulate results for all attributes).
Removing results
To remove results for a component, right-click on the component and select the Remove
Results option.
Selecting and removing results in the Tabular Grid
A summary of which results have been selected can be viewed on the tabular grid - select the
Graphs tab when all selected results are displayed, each result being in one of two categories:
variable against time (which is applicable to all components) or variable against distance (for
pipes only):
65
The first column provides the component type, the second the component label and the third the
selected variable. Note that only the last of these is directly editable. To add a new result in one
of the two categories:
1. Select the line containing ... in the first column of the first blank line.
2. Select the component type from the drop-down list in the second column of the newly
created row.
3. Select the component label in the third column.
4. Select the variable(s) required.
5. Finally, select the symbol in the first column to commit the change.
A result may be deleted by right-clicking in the first column of a row and selecting the Delete
graph option.
5.6
66
Transient Module
Select output filenames and time steps for the calculation. We generate a graph output file with a
time step of 0.5 s. Note that the graph data file has a relatively small size of 1060 items.
Press Timestep to view pipe and time step details.
In this example, the longest allowed calculation time step is short relative to the total simulation
time. This is because the sprinkler pipes B and C (10 m in length) are short relative to the longer
pipe A (100 m in length). The pipe lengths are crucial in determining a time step for the
simulation. For a quick qualitative analysis of the problem, we could replace pipes B and C with
the Short Pipe model, and this would increase the calculation time step to 0.072 s.
Select Calculation | Go..., and press OK to perform the simulation. Owing to a shorter
calculation time step, the current simulation is slower than that in the first example.
Viewing and Interpreting the Results
As in example 1, results can be viewed in tabular form using the Output Browser, or in graphical
form using the Graph Viewer. The graphical results show a decrease in the pump outlet flow
rate, owing to the decreased demand in the sprinkler system.
67
The effect of closing the sprinkler at the outlet of pipe C on the system pressure is illustrated by
overlaying a graph of the pressure at the inlet of the sprinkler arm with one of the flow rate out of
pipe C:
Part
6.1
Problem description
69
Our last example demonstrates the ability of the Transient Module to calculate forces. The
scenario consists of water being drawn from a reservoir through piping. The piping contains a 90
elbow and leads to a turbine via a valve:
If the valve is closed quickly, as in an emergency, then the transient forces on the 90 bend in the
pipe are of interest. The force data can be input to a pipe stress analysis program to determine
the safety of the piping in such a scenario. The system is first reduced to a schematic
representation, complete with node and component labels, for input to the Transient Module:
70
6.2
Transient Module
Internal
52.502
62.713
77.927
90.119
102.260
128.190
154.050
External
60.325
70.025
88.900
101.600
114.300
141.300
168.280
Click Apply to accept the data. The schedule will be added to the list of pipe schedules in the
left-hand side of the window.
71
Cv (l/min, Bar)
0
84.26
PIPENET can calculate the curve gradients, based on the supplied data points, by pressing the
Linear button. Alternatively, the user can supply their own gradient values. If you do this, you
should see the valve definition as:-
72
Transient Module
Fittings
We will use a user-defined fitting, placed on the pipe labeled 'Bend', to represent the frictional
effect of the 90 degree bend. From the Fittings tab, select a 90 bend, and enter its details as
below:
73
On pressing Apply, the fitting will be added to the list of user-defined fittings in the top left-hand
window, and is available for use. If you want to retain a fitting, but make it unavailable for use,
select the fitting in the top left-hand window followed by the - button. In this case, the fitting
now appears in the bottom left-hand window. To make it available again, select the fitting in the
bottom left-hand window, and click on the + button.
Saving the library
Once all the items have been defined, simply select the File | Save menu option to save the data
file and the local user library.
6.3
74
6.4
Transient Module
Input node
1
2
Output
node
2
4
For the third pipe, we include the user-defined fitting by selecting it from the Available list and
inserting one fitting:
Valves
To enter the valves, we use the Operating valve tool and, when drawn, select the type as 'Test
valve'. The Properties window should then appear as:
Here, we show the valve with the valve label changed to shutoff.
6.5
75
Stage 4 - Specifications
There are three specifications in our problem: pressure specifications at the two boundaries and
the information setting of the valve. Specify constant pressures at the boundary nodes 1 and 5 of
25 bar G and 10 bar G respectively.
We wish to simulate the sudden closure of the valve. To do this, we define a Power Ramp as its
information setting. The valve setting will change linearly from fully open (s = 1) to closed (s = 0)
between 0.1 and 0.3 seconds.
Label
Type
Node
Time function
Value
Reserv
Pressure
1
Constant
25 bar Gauge
Outlet
Pressure
5
Constant
10 bar Gauge
6.6
76
Transient Module
This view shows the list of defined forces and a description. Clicking on the ... symbol in the first
column of one of the rows displays a dialog, where full details of the force can be viewed and
edited:
The force dialog has two options - Simple or Complex. The Simple option is used to calculate
forces along a straight line. In our example, we wish to calculate the total force on the bend, so
we use the Complex option. This allows for more complicated force definitions; for example,
involving multiple components. Click the Complex option at the upper right-hand side of the
dialog. The external body force is zero here, as there are no restraints. To define the force, we
simply have to define the control surface for the control volume containing the bend. Select the
component as the pipe labeled 'Bend', and define the position, normal vector and flow direction
of the two control surfaces.
6.7
77
The table is divided into two parts: at the top, are four title lines; and below this, the definition of
the table. The drop-down box at the top indicates which table is currently displayed; in this
case, Pipe 1 - Reservoir to Bend.
The table definition is initially displayed as a line for each component, identified by its type and
label, together with a start column. The last row (with the symbol ... in the first column) indicates
the next free column available (there are a maximum of eight columns allowed in a table). In the
above example, the pipe with label 1 uses the first four columns of the table. To view which
attributes have been selected for the table, select the + symbol in column one, and the display
expands to include a list of the variables:
78
Transient Module
The + symbol now changes to a - symbol, which, if selected, will once again hide the details of
the attributes selected. De-selecting or selecting one or more of the available attributes will
immediately update the number of columns used.
To add extra columns to the grid, click on the last row (the one containing the ... symbol in
column 1) and select from the list of available component types and component labels displayed.
Finally, select the attributes to be displayed.
6.8
79
The first column provides the component type; the second, the component label; and the third,
the selected variable), of which only the last of these is directly editable. To add a new result in
one of the two categories:
1. Select the line containing ... in the first column of the first blank line.
2. Select the component type from the drop-down list in the second column of the newly
created row.
3. Select the component label in the third column.
4. Select the variable(s) required.
5. Finally, select the symbol in the first column to commit the change.
A result may be deleted by right-clicking in the first column of a row and selecting the Delete
graph option.
6.9
80
Transient Module
81
When the valve closes, the force on the bend oscillates between about 28500 and 29500
Newtons:
While the actual dynamic force (the difference from the steady state value) is not excessive here,
the lightly damped oscillations could cause fatigue damage in the valve or pipe.
It is also interesting to observe the movie of the pipe pressure for either of the pipes. This gives a
clear demonstration of the pressure wave moving along the pipe after the valve has closed.
Viewing Forces Extrema
On completion of a calculation, the forces extrema can be viewed in the Tabular grid by selecting
the Tabular Results tab and then the option Forces Extrema from the combo box.
82
Transient Module
Other Topics
Part
84
Transient Module
Other Topics
7.1
Forces
A powerful feature of Transient Module is its ability to calculate the hydraulic forces acting on
specific parts of the network. It is also possible to compute dynamic forces.
Control volumes and surfaces
When performing a force calculation, information about the local geometry of the network is
required. This is given by defining a Control Volume that encloses the part of the network where
the force is to be calculated. A control volume can enclose any number of network elements
(except force transfer break points such as anchors or elastic connections) and can have an
external force, Fe, associated with it. The force transfer break points should be set as control
surfaces. The control surfaces are the surfaces through which fluid flows, and are defined by their
normal vector, n. The direction of the vector n is shown in the figure below.
An example of a control volume about a straight pipe with an elbow at each end is shown below:
The total force, F, acting on the defined control volume can be calculated by:
where:
Fe
Fp
Fm
Ff
is the friction between the fluid and the pipe or other devices,
Fh
Other Topics
85
The above simple force includes pipes of two different sizes; i.e., there is a reducer between
them. In fact,a simple force can also contain valves, tees, etc.
86
Transient Module
In the above network, connections in the force definition window must be set to Elastic at
elastic joints and at the boundaries to the open environment (e.g., nozzles), as in nodes 8, 12 and
13. At other internal points and at boundaries to closed environments (e.g., closed tanks).
Complex force
This three-dimensional force can include an external force, Fb. The defined control volume can
contain any number of components, and the flow direction can change many times.
Besides the position of the control surfaces and fluid direction, the normal vector (pointing
outwards from a control volume) of the control surfaces is also required in a complex force (as is
shown in the dialogue below):
Elastic/Rigid Connection
The Elastic/Rigid option is where the end condition of the control volume is defined. The
difference between the two types is:
Other Topics
87
Rigid - this means that at the surface the Hydralic Force Transfer will be preserved. i.
e. the force in the local control volume can be transferred through the control surface
and so balanced by the force in the connected control volume. Examples of this are a
closed environment (e.g. pressurized tank), an elbow in a pipe or even just another
piece of piping.
Elastic - this means that at the surface the Hydralic Force transfer is broken. i.e. the
force in the local control volume cannot be transferred through the control surface to
be balanced by the force in the connected control volume. Examples of this are an
anchor, an expansion compensator, an open tank or a flexible hose.
Therefore the pressure and flowrate at these surfaces are not affected by choosing either elastic
or rigid, it is only the force calculation that will be affected. If the surface is defined to be rigid
then all the force is transferred through that surface, if however, it is elastic then the force is not
transferred.
This shall be further illustrated via two simple cases (both concerning simple forces);
Case 1 looks at the network below with node 2 being a rigid connection for force
transfer. An example is a piece of piping with no anchor or elastic joint at Node 2.
Case 2 looks at the network below with node 2 being a break point for force
transfer. A likewise example to the above is an anchor or an elastic joint placed at
Node 2.
88
Transient Module
These control volumes are defined in the force dialog box as shown below:
The above dialog box is for Case 1 (rigid connection) and as you can see there is only one
control volume defined and it has the force label '1'. Further to this it can be seen that:
The connection type at the inlet of this control volume is rigid (it begins after the
elbow in a pipe)
There is no mention of what is going on at Node 2, and this is because it is rigid so
the force is transferred through this surface, just as it is through the rest of the piping
The end of the control volume is at Node 3 just before the elbow, thus it is also
defined as rigid.
Other Topics
89
The above dialog boxes are for Case 2 (elastic connection) and as you can see there are two
control volumes defined, they have the force labels '1' and '2'. For the first section of the control
90
Transient Module
volume:
The connection type at the inlet of this control volume is rigid (it begins after the
elbow in a pipe)
At node two there is an elastic connection, so this is where the first piece of control
volume end - and so the connection type for the end of this section is defined as
Elastic.
So for the second piece of control volume, which has the force labeled '2'
This control volume begins at Node 2 where there is an Elastic connection. Thus the
connection type for the inlet is Elastic
The end of the control volume, is as with case 1, it finishes at Node 3, which is an
elastic connection as so has been given the connection type Rigid.
Now by taking node two to be elastic the force applied by the anchor = Force due to
the elbow in pipe 2 + frictional force through pipe 2.
Dynamic forces
It is often useful to see how the force varies from a particular static value. This is of particular use
if results from the force calculation are to be used by a pipe stress-analysis program. The
Transient Module can produce results of Dynamic Force, rather than Total Force, which can be
defined in the Options | Transient Options menu item:
The user specifies a time at which forces are considered to be static. From this time onwards,
the force results show the deviation from this static value.
Maximum and minimum force values
The calculator determines the maximum and minimum values for every force during the
simulation. For each simple force, the following values are recorded:the maximum force,
the minimum force,
the time at which the minimum value occurs,
the time at which the maximum value occurs.
For each complex force, the following values are recorded:the maximum FX, FY, FZ,
the minimum FX, FY, FZ,
the maximum and minimum magnitudes,
Other Topics
91
the times at which the maximum and minimum values are recorded.
7.2
The simplest way to divide the network is to use 100 m long sections. The error in using a 100 m
section on the longer pipe is:
This error e is the interpolation error. The default tolerance for e is one (i.e., the network is
divided in the simplest possible way). This tolerance can be changed by selecting the Controls
tab from the Calculation | Options... menu.
The interpolation error can be eliminated on both pipes by using 50 m sections. We can achieve
this by reducing the interpolation error tolerance to 0.28, as can be seen in the table below.
Interpolation tolerance
Number of sections in Pipe A
Interpolation error in Pipe A
Number of sections in Pipe B
Interpolation error in Pipe B
1 (default)
1
0
1
0.33
0.3
1
0.29
2
0.05
0.28
2
0
3
0
92
Transient Module
0.1
0.071
0.05
The calculation time step chosen by PIPENET is 0.000794 seconds, because this is the time
taken for a pressure wave to travel across the shorter pipe. But this time is insignificant
compared to the time the pressure wave takes to cross the longer pipe (0.0794 seconds). The
transient results are not affected significantly by the shorter pipe. In fact, if the shorter pipe had
no influence on the calculation time step, the simulation would run 100 times faster.
There are three ways for a user to remove the influence of these shorter lengths of pipe from the
calculation of a time step:
1. Merge or extend some of the shorter pipes in the network. It is sometimes useful to do
this initially, when obtaining preliminary results. The final runs can then be made with the
correct pipe lengths for maximum accuracy.
2. Replace the pipes that are short with short-pipe components (by browsing for short
pipes in a Data Window). This uses a different modelling equation for the flow in the
the pipe, and assumes that pressure waves travel instantaneously across the pipe.
3. Set a user-defined time step from the Options | Module options menu. PIPENET
then automatically calculates which pipes are to be treated as 'short pipes' during the
simulation.
The user can see the effect of the chosen timestep on the pipes by selecting Calculation |
Output, and then selecting the Timestep button:
Other Topics
93
The pipes that are to be treated as short pipes are labeled as such in the list. The 'short pipes' are
also indicated in the output report. Note that user-defined time steps and the short pipe model
should be used with care. A pipe should only be modelled as a 'short pipe' if the user wishes to
ignore transient behaviour in the pipe. Sometimes the user will want to define a user-defined
timestep that is smaller than the automatically calculated timestep. This may occur in a problem
having complex boundary specifications. As the specifications are not taken into account when
calculating the timestep, some of the detailed behaviour may not be represented properly in the
calculations. For example, if a pressure specification is varying sinusoidally, the calculation
timestep should be smaller than the period of the oscillation.
7.3
94
Transient Module
The second network (b) below is identical to the first one (a), except for the physical
dimensions. Here, the pipe is only 1 metre in length and the check valve has a heavy disc (in
contrast with the first one in figure (a), which has a light disc). The pressure wave, traveling at the
same speed as above, only needs 0.001 s to reach the check valve, and then the valve needs to
take a further 1 s to close (because of the inertia of the disc). In this case, the fast component
for 0 < t < 0.001s is the pipe.
Other Topics
95
Figure A
96
Transient Module
Figure B
Figure C
To choose VTS, select the menu option Options | Module options, and tick the Variable
Timestep box:
Please note that the user-defined time step cannot be used simultaneously with the VTS.
Enabling one will disable the other.
Choosing the Graphical Timestep
While choosing the calculation timestep is important in determining the accuracy of the results
contained within the calculation itself, it is also important to consider the accuracy of the results
that are returned to the user. For example, if a network experiences transient behaviour of a high
frequency, but the graphical timestep is chosen to be of the order of seconds, the majority of the
interesting behaviour of the system will pass unnoticed, including potentially significant pressure
surges.
There are a number of different factors that affect the choice of the graphical timestep. Of these,
the calculation timestep is the most important.
There is little point in choosing a graphical timestep that is smaller than the calculation timestep,
since more detail will not be discernible. In fact, if you are using the automatic timestep and
choose a graphical timestep that is smaller than the automatic timestep, the automatic timestep is
altered to use the smaller graphical timestep.
Other Topics
7.4
97
Vapour cavitation
Vapour cavitation occurs in a system when the pressure at a point falls below the fluid vapour
pressure. The fluid vapourises, forming a cavity in the system. Cavitation generally occurs in the
higher parts of the network, where the pressure due to static head is less. When the pressure
rises back above the fluid vapour pressure, the vapour condenses and the cavity collapses. The
collapse of a cavity can cause a very large pressure surge to occur, and must be avoided by
careful design of the system. The Transient Module is an invaluable aid in both predicting and
eliminating problems due to cavitation.
Vapour Cavitation
The vapour cavitation option is chosen by selecting the second cavitation option from Options |
Transient options. Please see the figure below (in which channel cavitaion has been selected).
In both cases, the cavitation option can be switched 'on' or 'off'. Selecting the vapour cavitation
option greatly increases the complexity of the calculation. For this reason it, is recommended that
a simulation is always initially run with the vapour cavitation option switched 'off'. If, in the output
report, a minimum pressure lies below the vapour pressure, the simulation should be re-run with
vapour cavitation switched 'on'. If cavitation occurs, the output results for pipes will include
results for the 'cavity volume' at points along the pipe. This result is the size of the cavity about
the point, and increases from zero as a cavity forms in the neighbourhood of a point.
The PIPENET VISION Transient Module includes a Vacuum Breaker model that can be used
to eliminate vapour cavitation from the system.
98
7.5
Transient Module
Channel cavitation
While vapour Cavitation is intended to model the growth and collapse of cavities, and the
consequent pressure surge in the system, it cannot predict vapour bubble formation, and so it
does not take into account the effect this has on fluid flowing through components. In particular,
pipes, where the majority of cavities form, continue to behave as though they are completely full.
As a consequence, the phenomenon known as "slack line flow" or "open channel flow" is not
experienced if the presence of cavities is modelled using the vapour cavity model. The open
channel cavitation model is intended to remedy this. Specifically designed to be applicable to
pipes, it realistically models the flow through pipes when a section of the fluid in the pipe is
actually vapour.
Channe l Cavitaton
Channel cavitation is enabled by selecting the third option from Options | Transient Options:
There is a choice between (a) ignoring cavitation, (b) including vapour cavitation, or (c) including
channel cavitation.
Enabling cavitation greatly increases the complexity of the calculation. For this reason, it is
recommended that a simulation is always run initially with the channel cavitation switched off. If
there is a region in which the minimum pressure lies below the vapour pressure (as listed in the
output report), the simulation should be run again with channel cavitation switched 'on'.
If cavitation occurs in a pipe, the output results for pipes will include results for the following:
Other Topics
99
Slug flow
100
Transient Module
Other Topics
Stratified flow
Where:
Ac is the cross-section area of the vapour slug.
D is the pipe diameter.
Hc is the cross-section height of the vapour slug.
Kc is the volume fraction of the vapour slug.
Kf is the liquid holdup of the vapour slug.
L is the pipe length.
Lc is the length of the vapour slug.
101
102
Transient Module
There are a number of restrictions on the use of the channel cavitation model that users should be
aware of, and these are listed below, including a workaround wherever appropriate.
Channel cavitation can model bubbly flow, slug flow and stratified flow, but cannot
model churn flow, annual flow and mist flow.
The channel cavitation model is not applicable for long section pipes.
The slip velocity between the liquid and vapour cavity is ignored.
Each pipe can contain at most one vapour slug. Vapour slugs in a pipe will merge
automatically.
Vapour slugs cannot merge with the dispersed bubbles formed at the flow nodes.
7.6
Long sections
Pipes may be modelled using either a constant gradient or mile post data. Constant gradient
pipes act as a single pipe with the inlet at an initial height and outlet at a final height, and with the
pipe running directly between them. A pipe with the mile post data attribute acts as a number of
pipes, all sharing the same pipe type, roughness and diameter. In this case, the inlet is at an initial
height and the outlet at a final height, but the pipe itself may have bends, which result in the
gradient of the pipe being piecewise linear, rather than constant.
To model a pipe using mile post data, select the appropriate pipe and then select the Mile Post
Data option in the Section Type field:
Other Topics
103
Selecting the Mile Post Data option and entering return or the Tab key will display a dialog,
through which can be entered a set of mile-post data, where the distance along the network is
paired with the height at various points, in order to define the height profile of the section.
When the OK button is pressed, the profile is checked for consistency, and any errors are
displayed. If the profile is correct then, on selecting the OK button, the profile is displayed in the
Property Window for the pipe. Also, upon returning to the Pipe Dialog, the values for net height
change and length will no longer be editable, and will instead reflect the properties of the entered
mile post data.
104
Transient Module
The model will not give correct results if there is vapour cavitation within a pipe defined using
mile post data. In such a case, the section(s) of the pipe that experience vapour cavitation should
be separated, and modelled as individual pipes. Note that the selection of the Mile post data
option will not permit any channel cavitation within any of the sections.
7.7
Pressure envelopes
For networks in which the actual piping system is linear, it is possible to obtain information on the
pressure extrema experienced by the network. From Calculation | Options..., select the Output
tab, and then select the Output pressure envelope option. The pressure envelope information
will be output to the results file, and may then be viewed in the Graph Viewer.
A number of graphs are available, including the maximum and minimum pressures experienced
Other Topics
105
along the piping section of the network. In addition, the numerical values are output to the output
file for reference.
In order to present the pressure envelope results in a meaningful way, PIPENET will choose a
path through the network from one specification to another that passes through all "pipe-like"
components. In addition, the direction of the network will be taken to be that which has the
fewest reversed components. If it is found that a network appears to be backwards (as a result
of viewing the Network Height Profile, for example), this can be remedied by reversing the
direction of components that are not oriented in the correct direction.
The Schematic
Part
The Schematic
The Schematic
8.1
Schematic Window
107
The Schematic window is the primary means of entering and viewing networks. It closely
resembles the schematic window of earlier products, but has a number of improvements.
When the window is first displayed, it is presented with a light-grey background suitable for
general viewing. The background colour may be changed to white or black. However, for
coloured links and text, it will generally be found that a white background is unsuitable for
viewing.
New elements are added by selecting the appropriate element tool from the tool palette, and
then placing and drawing the component using the mouse.
All labeled elements created via the schematic are automatically assigned a unique label. Labeled
elements include nodes, link elements and attribute elements. Numeric labels are used (no tags)
with each component type having its own set of unique labels.
The background colour and the font sizes used for labeling components can be changed using
the Display Options dialog.
Schematic Underlay
A facility has been included whereby a graphic may be imported and displayed as a background
to the main schematic. Display of this underlay is enabled and disabled via the View menu. The
underlay may be zoomed independently of the main network to achieve relative scaling and
registration. Zooming the network results in the underlay being zoomed by the same selected
zoom factor. In normal use, the procedure to use an underlay commences with a new network:
1. Import and display the underlay.
2. Select a suitable zoom size for the underlay.
3. Commence laying out the PIPENET components using the underlay as a guide.
8.2
Schematic Underlay
It is possible to import a graphic to underlay the main pipe network. The graphic to be imported
must be a Windows enhanced metafile (file extension .EMF), a Windows metafile (file
extension .WMF) or an AutoCAD .DXF file.
Currently, the image is loaded on the first request to display the underlay (see the View menu).
Once loaded, the underlay may be zoomed to establish the relative scale between the underlay
and the network. Generally, the procedure will be as follows:
1. Load the underlay.
2. Establish a suitable scaling for the underlay.
3. Start drawing the network over the underlay.
The display of the underlay can be turned on or off via the View menu. When turned off, the
108
Transient Module
underlay will track any changes to the scale of the network, retaining the correct relation.
The zooming of the underlay is independent of the network, whereas zooming the network also
zooms the underlay to maintain relative scales.
Currently, the underlay cannot be translated left-right or up-down, although the network can be
moved using the Area Tool.
8.3
Selection Tool
The first button is the selection tool, and it is used to select a single component. Simply click the
left mouse button whilst pointing at a component to select it. A selected component is shown
highlighted in red, and its attributes displayed in the Properties Window. Right-clicking the
mouse on a selected component will display a pop-up menu, the contents of which are
dependent on the type of component selected, but generally, the pop-up menu will allow you to:
Delete a component.
Add waypoints.
Delete waypoints.
Insert a node in a pipe.
Reverse the direction of a component (which will negate the elevation change).
Copy and paste the attributes of a component.
The selection tool can also be used for dragging nodes to new positions, and for dragging pipe
components, such as orifice plates, along the length of a pipe. To drag a node or a component,
click the left mouse button and, whilst holding the button down, move the mouse to the desired
position and release the mouse button. Note that, if a node is dragged, all of the components to
which it is connected also move with it.
Full undo/redo is available for all operations with this tool.
Adding a waypoint
If you left-click on a pipe, and with the mouse button held down, move the mouse then a
waypoint will be inserted at the selected point in the component link.
Selecting several components
To select multiple components, select the first component in the normal way, by placing the
cursor on or near the component and left-clicking on the component. Subsequent selections are
made in the same way, but with the keyboard Ctrl key held down whilst making the selections.
Another way to select multiple components is using the Area tool.
Copy/Paste
To copy the attributes from one source component onto another target component of the same
type:
1. Right-click on the source component and select the Copy option (alternatively, use
Ctrl-c).
The Schematic
109
2. Right-click on the target component and select the Paste option (alternatively, use
Ctrl-v). All attributes are copied from the source component to the target
component.
If the source and target components are pipes then, prior to the copy, all fittings are removed
from the target pipe and replaced with the fittings from the source pipe.
If Paste (Incl. layout) is selected instead of Paste, the process is very similar, except that any
waypoints and components (for example, orifice plates) are also copied from the source to the
target.
Explode Node
This facility can be used to break all of the links meeting at a designated node. To explode a
node, simply right-click on the node and select the Explode node option.
8.4
8.5
Area Tool
The Area tool is used to select and manipulate a number of components at the same time. With
the Area tool, it is possible to:
Move a group of components.
Select a group of components.
Copy-paste a group of components.
Delete a group of components.
Mirror (left-right) a group of components; i.e., mirror the components about a vertical
centre line.
Invert (up-down) a group of components; i.e., flip the components about a horizontal
centre line.
To use the tool, click the left mouse button at the point that is to be the top-left corner of a
rectangular area. Whilst holding the mouse button down, move to the point that is to be the
bottom-right-hand corner of the rectangle, and release the mouse button. A dashed outline of the
110
Transient Module
defined rectangle is drawn, and all nodes and components that lie completely within the rectangle
are selected.
Via the Edit menu, or by right-clicking, the selected items can now be moved, deleted, mirrored,
inverted or copied. Full undo/redo is available for all operations with this tool.
Selected items
The items marked as selected are:
Each node contained within the rectangle.
Each link component contained within the rectangle whose input and output nodes are
both within the rectangle.
Moving the selected area
The rectangle and all selected items within the rectangle can be moved by selecting the left
mouse button and, whist it is down, dragging the rectangle to a new position. On releasing the
mouse button, the components will be drawn at the new position.
Copying selected items
Items selected within the rectangle can be copied to the clipboard, from whence they can be
pasted onto the same network, or onto another network in a separate instance of the same
module. Copy/paste are activated via the Edit menu options, the Copy and Paste buttons on
the toolbar, or by right clicking within the defined rectangle to display a pop-up menu of options.
Note that if
you are using
copy/paste to
copy from
instance of a
module to
another
instance of the
same module,
ensure that
both instances
are using the
same unit
systems.
8.6
Polygon Tool
The Polygon tool is used to select and manipulate a number of components at the same time. It is
similar to the Area tool, but it allows components to be selected within a polygonal area. With
the Polygon tool it is possible to:
Move a group of components.
Select a group of components.
The Schematic
111
8.7
Text Tool
The Text Tool is used to place text on the schematic; for example, as titles and additional
labeling information. To place a text item on the schematic, click the left mouse at the
approximate point at which the first character is to appear; the following dialog appears:
112
Transient Module
Enter the text that is to appear in the text field and then select either OK to accept the text or
Cancel to abort. Text options can be specified in the Properties Window, and include typeface,
size, style (normal, bold, italic or bold and italic) and colour.
To change the colour of the text, click on the arrow button in the cell. Selecting the drop-down
arrow in the Colour field will display a small selection of colours:
Selecting one of the small coloured cells will use that colour for the text.
Moving and editing text
Once a text element has been added to the schematic, it can be selected, edited and moved:
1. Click on a text element and edit the properties in the Properties window.
2. Click and drag to move the text.
3. Right-click on a text element and select Delete from the pop-up menu to delete the
text.
The Schematic
8.8
113
114
Transient Module
entered for the component, its colour changes to black (or white if the background is black).
The colour of a component may revert to blue in either of the following situations:
1. If a check is performed using the check button on the calculation toolbar and the
component is found to be invalid.
2. If the file is saved and re-opened, and on re-loading the component it is found to be
invalid.
8.9
8.10
Schematic Printing
A schematic may be printed by selecting the File | Print option. The schematic may be printed
to any supported Windows printer on a single page or across multiple pages. Note, however,
that printing to a large plotter using a Windows printer driver may be very slow, since some
Windows drivers will work by rasterizing the schematic. For optimum drawing, you should
export the schematic for off-line plotting.
To print a schematic, select the File | Print option, which will display a dialog box showing a
range of print scales and the number of pages required to print at each scale, and offering the
option to print all pages or a selected range of pages.
The Schematic
115
However many pages are required to display the schematic, the network will be displayed
centred across all pages. Each printed page will show the network title, the date, and the page
number in the form Page m of n. Page fit can be selected to print the complete schematic on one
page. If the option Visible window only is selected, only that part of the network visible in the
schematic window will be printed on a single page.
Printing will be to the currently selected printer with the currently selected page orientation. To
change either or both of these, select the File | Print Setup menu option to display the standard
Windows print setup dialog.
The appearance of the printed schematic can be previewed using the File | Print Preview
option.
8.11
116
8.12
Transient Module
Selecting the right cursor key will move to the uppermost component on the right, i.e. pipe 4:
The Schematic
117
To move to pipe 5 from pipe 4, simply select the down cursor key:
Selecting the down cursor key again will move to pipe 6, whilst selecting the up cursor key will
move back to pipe 4.
If the component is reversed (i.e., the input node is to the right of the output node) then selecting
the right cursor key will move to the link on the left. Similarly, selecting the left cursor key will
move to the link on the right of the current link. So, selecting the right cursor key is interpreted as
a move in the component direction; and the left cursor key, as a move in the reverse direction.
8.13
118
Transient Module
Part
120
Transient Module
9.1
Tabular Grid
The Tabular View window and the Properties window are used to enter and edit the attributes
of components displayed on the schematic, and to display some summary results following a
calculation. The Tabular View window cannot be used for adding new components or deleting
existing components. These operations must be performed via the schematic.
Results
121
The results page displays maximum and minimum pressure results for
components, and the component type to be displayed is selected as in the Data
page.
Graphs
Displays ad-hoc graphs produced in the user interface, mainly the elevation
profile and pressure envelope.
Result graphs
This page is used for defining the output graphs to be produced by the
calculation.
Tables
This page is used for defining the output tables to be produced by the
calculation.
Forces
This page is used in defining the forces to be calculated.
Tabular results
On completion of a calculation, some of the results appearing in the printed
browser report may be viewed here. Currently, Forces Extrema and Pipe type
extrema are available, and are selectable via the combo at the head of the page.
Sorting
Components are initially displayed in data entry order; however, rows may re-ordered by
clicking in a column heading. For example, to sort pipes in ascending order of diameter, click on
the heading for the pipe diameter column. To sort in descending order of diameter, click on the
column heading a second time. Clicking on a heading toggles between ascending and
descending order.
Cell shading
Cells are normally displayed with a white background; however, the following cell shadings may
also be observed:
Cells coloured light grey are read-only.
Cells coloured yellow (currently, only for pipe sizes) indicates that the displayed size has
been calculated during the design phase (in the Standard Module and the Spray/
Sprinkler Module).
Selecting a row
Left-click on the leftmost cell of the row to select a row.
Editing a cell
The contents of editable cells (non-editable cells will be grayed out) are either of the direct data
entry type or of the drop-down selection type. For example, in the pipe tab, pipe bore and pipe
length are both of the direct data entry type - simply click on the cell to edit or re-enter the value.
122
Transient Module
9.2
Validation
All attributes are validated as they are entered:
Fields are validated to check that they are of the correct type; that is, if a field must
contain only numeric data then only entry of numeric digits and optional sign and
decimal point are permitted.
Simple range checking is carried out to ensure that numeric values are within range; for
example, pipe bores must always be positive, filter coefficients must always be
negative, temperatures must be at or above absolute zero, and so on.
If an invalid entry is made then a simple dialog is displayed indicating the fault; for example:
Clicking OK leaves the error highlighted, and the value must be corrected before moving on to
further editing.
9.3
Copying Cells
A cell or a rectangular group of cells can be copied using techniques similar to those used in
Excel or 123. All paste operations can be undone.
Copying a single cell
To copy a single cell, simply right-click on the cell to display a popup menu, and then select the
Copy option. The copied cell can be pasted into another target cell by right-clicking on the
target cell and selecting the Paste option. However, note that a cell in one column can only be
copied to another cell in the same column, since it makes no sense to allow copying between
columns that represent completely different types of attribute.
Paste does not work in read-only columns or component label columns.
Copying a cell or range of cells
Right click on the cell to be copied, and select the Copy option. Now select the target group of
cells as follows:
1.
2.
3.
4.
123
Paste-in-Column
Since the operation of reproducing a single value in a column is common, a shortcut is provided
via the Paste-in-Column option in the popup menu. Simply point to the value to be repeated in
the column and select Paste-in-Column.
Copying a contiguous group of cells from one row to the corresponding
cells in another row
Select the source cells as follows:
1.
2.
3.
4.
Select the target cells in the same manner, only now select the Paste option in the popup menu.
Note that the source and target selections must start and end in the same column.
Copying a rectangular group of cells from one area of the grid to another
Select the source area as follows:
1. Left-click in a cell at one corner (top-left, for example) of the rectangular group.
2. Whilst holding down the shift key, left-click on the diagonally opposite corner cell to
select the group.
3. Right click on any cell within the group to display the popup menu.
4. Select the Copy option.
Select the target area in the same manner, only now selecting the Paste option in the popup
menu. Note the following:
The source and target areas must have the same shape; i.e., they must be the same
number of columns wide and the same number of rows high. Note, however, the one
exception to this in the next paragraph.
The source and target areas must start and end on the same column.
124
Transient Module
Status Checking
Part
10
126
Transient Module
10
Status Checking
10.1
Status checking
A facility is provided for checking the correctness of the currently defined network prior to
attempting to perform a calculation. This will check for component errors, specification errors
and height-elevation inconsistencies. This facility is activated whenever a calculation is attempted
or, explicitly, by selection of the Calculation | Check option, when the following window is
displayed:
If there are no errors or warnings, the window contains a single status line, as depicted above. If
there are errors and/or warnings, these are shown on separate lines, with the first column
showing a component label (where appropriate) and the second column showing a description of
the error. All components found to be in error (for example, a zero length pipe) will be coloured
blue.
Warnings are shown in black text, and indicate possible problems with the network. Errors are
shown in red text, and indicate problems that may prevent a successful calculation.
If a component number is displayed in a cell then double-clicking anywhere in the row will
highlight the component in the schematic window, scrolling the schematic window to display the
component if it is not already visible.
For reference purposes, a copy of the check results can be printed via the Print button.
10.2
Height Checking
Height checking will be performed, and essentially involves summing the rises and falls in every
loop to check that the sum is zero (within the height check tolerance). For every loop in error,
one line will be displayed in the status window, with the component identifying one node in the
loop. The error description will include the value of the error in user-defined length units.
Status Checking
127
Clicking on the component cell will highlight all of the components in the loop, as well as creating
a path. The creation of a path means that a graphical elevation profile can be displayed.
If two or more height errors are found then selecting the Common Height Errors button will
highlight all of the pipes that appear in two or more loops. This is not guaranteed to pinpoint the
error, but it may help.
Colour Schemes
Part
11
Colour Schemes
11
Colour Schemes
11.1
Colour Schemes
129
A colour scheme is a simple set of rules used for the colouring of components on the schematic.
At any time, two colour schemes may be in use, one for colouring nodes and one for colouring
pipes/nozzles. The two colour schemes can be selected from an application-specific set of colour
schemes. There is a default colour scheme for both nodes and pipes/nozzles, which provides the
default colouring of:
RED - item is selected.
BLUE - item is not completely defined or is invalid.
In all other situations, a component is displayed in the default colour: black (for white and grey
backgrounds) or white (on a black background).
Each colour scheme can assign one of six colours to a component: RED, ORANGE, GREEN,
CYAN, BLUE and MAGENTA. If a component falls outside of the rules for a colour scheme, it
will assign a default colour of black (on a white or grey background) or white (on a black
background).
Two generic types of colour scheme are identified:
1. Simple schemes where components are coloured according to the value of a single
attribute or result.
2. Complex schemes where components are coloured according to some logical
combination of one, two or more attributes and results.
Simple Colour schemes
With simple colour schemes, the user selects a component attribute or result (for example, pipe
length, pressure difference, node elevation), and then creates a scheme by associating the
selected attribute or result with a set of intervals. The intervals are defined by five values v1, v2,
v3, v4, and v5, the intervals being:
< v1
v1 & < v2
v2 & < v3
v3 & < v4
v4 & < v5
v5
RED
GREEN
BLUE
CYAN
MAGENTA
ORANGE
If intervals are not defined, they will be provided automatically, based on a suitable scaling of the
known values for the attributes or results. Note that, for results, the intervals are calculated on
the completion of a calculation.
Colour schemes are displayed and edited via the Classes dialog.
130
Transient Module
This consists of two columns, one for nodes and the other for pipes/ducts. At the head of each
column is a combo box for selecting the colour scheme. Note that these two combo boxes have
a dual purpose in also selecting which attribute is displayed above a component in the schematic.
Below the combo box are five edit boxes used for defining the six intervals. The coloured boxes
alongside the edit boxes define the colours for the six intervals. The edit boxes will be grayed out
if the selected colouring scheme does not use intervals.
Immediately below each column of five edit boxes are two check boxes:
Colours On - used to enable/display colours. If this box is unchecked then the default
colouring scheme will be used. However, the selected attribute will still be displayed
when the Display Attributes buttons are selected.
Auto classify - used to select automatic calculation of ranges following completion of
a calculation. If this box is checked then the five values defining the six intervals will be
re-calculated each time a calculation is performed.
Use modulus - if this is selected then classification will not take the sign of the attribute
into consideration.
The final three buttons are used to select the way in which the intervals are coloured, the default
being the six colours ordered as RED, GREEN, BLUE, CYAN, MAGENTA and ORANGE.
The ordering of the colours may be reversed by selecting the Reverse colours button. As an
alternative to the six colours, a single colour may be selected to be represented in six shades.
Selecting the Graduated button displays a pop-up window via which the colour can be selected.
Finally, it is possible to change the default colours by left-clicking on one of the coloured boxes,
when a colour selection pop-up appears. For example, in the following image the user has leftclicked on the orange box.
Colour Schemes
131
Selecting a colour from the pop-up will result in the selected colour replacing the colour in the
box.
The two combo boxes for selecting the colour scheme (and, hence, the attribute to be displayed
on the schematic) are reproduced on the Options Toolbar. The Options toolbar can also be
used to display legends (one for nodes and one for pipes) on the schematic. For example:
The legends can be moved around by clicking and dragging with the mouse.
Values are displayed with the correct sign for directional components; i.e., negative if the flow is
in the opposite direction to the component direction, or positive if it is in the same direction.
Note that, for pipes, results are shown on the Schematic or in the Properties Window with the
correct sign. For colour coding, the absolute value is used; for example, +10 m/s will be coded
using the same colour as -10 m/s. This means that the interval values specified in the dialog
should be zero or positive.
Complex rules
This feature is provided to retain compatibility with the Standard and Spray modules; however,
132
Transient Module
since the Transient calculator does not return simple single-value results this feature is of limited
use.
Complex rules allow the user to define a colouring rule in a more flexible manner. This is best
described by reference to the dialog used to enter a complex colouring rule:
This shows the dialog for entering a complex rule for a pipe; the corresponding dialog for a node
has the same layout. It comprises:
1. A name for the rule.
2. Up to three conditions (only two are used in this example) consisting of an attribute or
result name (selectable from a drop down list), a relational operator (again selectable
from a drop-down list) and a value.
3. Logical And or Or operators relating the conditions.
4. The colour to be used for display.
The above example states that each pipe with a bore greater than 100 mm, where the calculated
velocity in the pipe exceeds 10 m/sec, is to be coloured red.
The legend window can be selected for display as with simple rules, an example of which is as
follows:
Colour Schemes
11.2
133
Tagging
In addition to
the default colour scheme, one additional tagging colour scheme is provided, and it
is common to all application modules. This scheme can be used to colour components based
purely on user selection. This operates as follows:
1. The user selects components in the normal way.
2. The user then tags these selected items by selecting the menu option Tools | Tag
Selected Items.
3. Steps 1 and 2 can be repeated, each Tag-Selected-Items operation adding to the set
of tagged items.
Now if the tagged colour scheme is selected, tagged items will be displayed in CYAN (this
colour may be changed via the Options | Display Options menu item).
Tagged items can be made untagged by selecting the menu option Tools | Remove Tags.
11.3
Background Colours
By default, the schematic is displayed on a light grey background, which is probably the best
choice if component colouring is used. Other background colours can be selected via the
Options | Display Options menu item.
Regardless of the chosen background colour, the schematic is always printed on a white
background.
Part
12
12
12.1
135
This window can be selected for display via the Graphs tab in the Data Window.
Before a profile can be plotted, a path must be defined using the Tools | Make Path menu
option. To use this tool, simply select two or more nodes and then select the Tools | Make
Path menu option to select all components joining the selected nodes. To select more than one
node at a time, simply hold down the Ctrl key whist selecting the nodes.
The path found is the shortest path, where shortest is in terms of the smallest number of nodes.
Having created a path, the elevation profile will be displayed with the nodes plotted from the
leftmost of the two nodes selected to the second, rightmost node. The vertical axis displays an
elevation scale in the user-selected units, and the horizontal axis corresponds to the distance (as
measured from the starting node).
Right-clicking with the mouse displays a popup menu with the following options:
Show values - selecting this option will display the value at a point in a bubble tool-tip.
Label Point - if the mouse is positioned on or close to a node, this will label the node.
Add Text - add text annotation to the plot.
Add Arrow - add an arrow to the plot.
Add arrowed text - add arrowed text to the plot.
Copy - copies the plot to the clipboard, from where it can be inserted into, for
example, a Word document.
Edit properties - selecting this option will display a tabbed dialog, via which it is
possible to edit the title, labels, styles and the axes. These properties can be saved as a
template.
136
Transient Module
Pressure Envelope
If a Transient calculation has been performed, the maximum and minimum pressures will be
displayed for each node, as show in the following image:
The left-hand axis is the node elevation, as in the previous figure, and the right-hand axis is the
pressure. Note that the Title for the graph now indicates that this a pressure envelope. Since
there is more than one plot, a legend is provided. This legend may be moved by selecting the
legend with the right-hand mouse button and selecting the option Move from the pop-up menu.
It is also possible via the pop-up menu to delete the legend or edit the legend. The following
image is the same as the above, but includes two arrowed text items:
137
Part
13
13
13.1
139
This facility is activated via the Tools menu, and provides a quick and simple method of
generating pipe runs, typically as used in pipeline applications. Here, the user may start with a set
of distance and elevation pairs, possibly in a spreadsheet form.
Selecting the tool via the Tools | Add Multiple Pipes option produces the dialog:
The left-hand window contains the attributes that are to be set for each pipe when the OK
button is selected; the right-hand window contains the set of distance-elevation pairs. Above this
right-hand window is the number of pipes to be created, which can be changed using the updown buttons to the right of the displayed value. The distance is incremented automatically by
the length of the pipe specified in the left-hand window. Values in the right-hand window can be
edited.
The check box at the bottom of the dialog indicates that the pipe run will be displayed in a
profile, with pipes being drawn to scale according to their lengths. If this box is unchecked then
the window appears thus:
140
Transient Module
Here, the pipe run is displayed in plan at a specified angle of inclination, with angles being
measured anti-clockwise from the horizontal. Selecting the option Use proportional lengths
draws the pipes to scale, according to their lengths.
Data can be copied from a spreadsheet and pasted into the right-hand window, the number of
rows being set automatically from the number of data pairs copied. This facility must be used
with caution, since the data from the spreadsheet must be arranged in the same column order as
that used in the right-hand window, and the units must agree with those in the column headings.
Undo/redo is available with this facility.
Libraries
Part
14
142
Transient Module
14
Libraries
14.1
Libraries
Two types of library are used in PIPENET modules:
Local User Library
This library is associated with the data file, and is opened when the data file is open. It can
contain various items, depending on the module in use:
pipe schedules,
fittings,
pumps,
valves,
nozzles,
linings,
general pressure losses.
There is only one local user library. It has the file extension .SLF, and replaces all of the separate
library files from previous modules. Whilst a data file is open, entries can be added, deleted or
edited using the Library Editor dialog.
A local user library can be shared by one or more data files; however, if the library is changed in
one network, it is changed for all users of the library.
Local and system libraries have the same format, the only difference being in their relationship to
the data file.
System Library
Whereas the local user library is considered to be under the control of the user opening the data
file, and is, for all intents and purposes, part of the data file, system libraries are external libraries,
generally considered to be under the control of some central administrator.
System libraries can be referenced by a data file, but are not normally edited whilst a data file is
open; instead, the user must edit system libraries in an External System Library Editor.
The concept of separate System Libraries introduces extra flexibility in that now a user can have
more than one source for schedules, fluids, etc. There is also the possibility of imposing central
control over some (System) libraries, whilst allowing users to have their own private library
definitions.
A network data file referencing a single Local User Library essentially corresponds to the way in
which previous products have worked; i.e., in previous products, a network data file could only
refer to a single PDF file, a single UFL library and so on. However, System libraries provide the
facility for a network to gather library definitions from multiple files.
Libraries
143
Opening Libraries
Libraries opened from the File menu are always considered external system libraries. Only the
new format libraries (that is, those with a .SLF extension) can be opened.
Importing libraries
New and old style libraries (i.e., .PDF, .PMP, etc.) can be imported via the Import Library
option in the file menu. Imported libraries are merged into the single local user library.
Exporting Libraries
Libraries cannot be exported individually, but only as a result of exporting the network as an old
style .DAT file. This is achieved by selecting the File | Export... menu option and then providing
the name to be given to the .DAT file. Any associated library files will be saved with the same file
name, but with the appropriate file extension.
Libraries - example 1 - new data and library file
In this example, we assume that a new data file is being created and no library files exist.
1. Create a new project.
2. Define the library items using the Library Editor dialog.
3. Create the network.
Libraries - example 2 - new data file using old style library files
In this example, we assume that a new data file is being created, but it is required to import
library files created under a previous version of PIPENET.
1.
2.
3.
4.
5.
6.
Libraries - example 3 - old data file using old style library files
Opening an old style .Dat file automatically imports any old style library files referenced by the .
Dat file.
144
14.2
Transient Module
Schedules
This library page is used for creating and editing pipe schedules:
To the left is a list of available schedules, both built-in and user-defined, and selecting any item in
this list displays the properties of the schedule on the right.
At the top right are three fields common to all library editors:
1. The name of the schedule as it appears in pop-up menus, with the length of this name
being limited to 20 characters.
2. An optional longer description.
3. the source of the schedule, which may be one of the following:
Built-in schedule provided with the Standard module. Built-in schedules cannot be
edited.
Local user library - these items may be edited whilst a network is open.
System library - these items can only be edited when a network is not currently
open.
Below these three fields are three fields containing the roughness, Poisson's ratio and Young's
Modulus. Below these is a grid showing the standard nominal sizes and the corresponding
internal diameters. If the nominal diameter is "unset" then the corresponding nominal diameter is
not included in the schedule. Right-click within the sizes grid to display an option to copy the grid
contents to the clipboard.
Below these three fields is a field containing the roughness, and below that is a grid showing the
Libraries
145
standard nominal sizes and the corresponding internal diameters. If a nominal diameter is "unset"
then the corresponding nominal diameter is not included in the schedule.
Roughness and diameters are displayed in the user specified units (see Options - Units).
Adding a new schedule
To add a new schedule, select the New button in the bottom left-hand corner of the dialog.
Enter the desired values (if the Description field is left empty, it will, by default, be the same as
the schedule name). When all of the data has been entered, click the Apply button to accept the
new schedule or the Cancel button to abort.
Editing an existing schedule
Select the schedule to be edited from the left-hand window, enter the desired changes, and then
select the Apply button to accept the changes.
Deleting an existing schedule
Select the schedule to be deleted in the left-hand window, and then click on the Delete button.
14.3
Fittings
Fittings are added to the library via the following dialog:
146
Transient Module
a fitting in the top window unavailable for selection, highlight the fitting in the upper window and
select the - button. To make an unavailable fitting in the bottom window available for selection,
highlight the fitting in the lower window and select the + button.
Adding a fitting
To add a new fitting, proceed as follows:
1.
2.
3.
4.
5.
Deleting a fitting
Highlight the desired fitting in the top left-hand window and select the Delete button; this button
is disabled for built-in fittings.
Libraries
14.4
147
Control Valves
This page is used for displaying and editing library control valves.
To the bottom left is a list of available control valves, both built-in and user-defined, and
selecting any item in this list displays the properties of the control valve. At the top left of the
dialog there are the following attributes:
1. The name of the control valve as it appears in pop-up menus (the length of this name is
limited to 20 characters).
2. An optional longer description.
3. The source of the control valve, which may be one of the following:
Built-in control valve provided with the Standard module. Currently, there are no
built-in control valves.
Local user library - these items may be edited whilst a network is open.
System library - these items can only be edited when a network is not currently
open.
4. Valve type K-factor or Flow coefficient.
5. Area of the valve.
At the top right, there is a grid into which can be entered up to eight defining points (with a
minimum of two) . Below the data grid is a plot of the entered points.
Selecting the Linear button (immediately below the grid) will fill in the values for dK/ds or dCv/
148
Transient Module
14.5
Libraries
149
Note that the definition of the pump curve will only be accepted if:
For a quadratic curve - at least three points are provided, and the slope of
the calculated curve is negative everywhere between the minimum and
maximum values.
For a cubic or smooth curve - at least four points are provided.
For flow rates between the specified minimum and maximum flows - there must be no
flow rate that gives no pressure change; that is, the performance curve must not cross
the horizontal axis.
Right-click within the grid area to display an option to copy the grid contents to the clipboard;
right-click within the graph area to copy the graph to the clipboard.
For more information on curve types and degeneration factors, see the modelling section for
simple pumps.
Editing an existing pump
1. Select the name of the pump from the drop-down list.
2. Make any required changes to the pump parameters.
3. Select Apply to commit the changes.
Deleting a pump
1. Select the name of the pump from the drop-down list.
2. Select the Delete button.
150
14.6
Transient Module
Libraries
151
14.7
Pumps Turbo
The Turbo Pump is defined by its rated quantities (i.e., the values of the pressure, flow rate,
speed and torque at the maximum operational speed), the total moment of inertia of the pump,
and a pair of Suter characteristic curves for pressure head and torque.
Three built-in Suter curves are provided: Radial, Mixed Flow and Axial, having specific speeds
of 25 rpm, 147 m3 /s, and 261 metres respectively. Alternatively, the user can define the Suter
curves by selecting user-defined in the Suter curve data field and entering a number of points.
For details of how to transform turbo-pump data for the pressure head and torque into Suter
characteristic-curve data (i.e., x, WH(x) and WB(x)), see the modelling details. The bottom lefthand window is for entry of the pump head - flow rate curve data, and the bottom right-hand
window for the pump torque - flow rate data.
For the moment of inertia, enter the total rotary moment of inertia of the pump impeller port and
the pump motor port.
152
Transient Module
Right-click within the head-flow rate grid area to display an option to copy the head grid
contents to the clipboard; right-click within the torque-flow rate grid area to display an option to
copy the torque grid contents to the clipboard.
14.8
Linings
To view a library lining, select the required lining from the left-hand window and its properties
are displayed on the right-hand side. To delete a lining, select the lining in the left-hand window
and then select the Delete button. To add a new lining:
1.
2.
3.
4.
Note that linings are only applicable when the Spray option has been selected.
Libraries
14.9
153
154
Transient Module
1. Select the name of the pressure-loss component from the drop-down list.
2. Select the Delete button.
Specifying Options
Part
15
156
Transient Module
15
Specifying Options
15.1
Title
Use this dialog to enter a title for the PIPENET problem. A title may consist of up to four lines of
text, with each line containing no more than 65 characters. The first line of the title will be
displayed on each page of a printed schematic.
15.2
Transient options
The options page provides control over a number of modelling and calculation options for the
Transient module. The dialog is the same for both the Standard and Spray sub-types, except for
the Pressure model and Design rules sections. The dialog for the Standard sub-type is:-:
Specifying Options
157
158
15.3
Transient Module
Units
A wide selection of unit systems are provided, including:
SI,
Metric,
US,
Imperial,
User Defined.
Each of the first four provides a fixed, consistent set of options. For example, the unit of
diameter (of pipes) and length in the SI system is fixed at metres, and the unit of temperature is
fixed at Kelvin. The User Defined option allows the user to specify the unit to be used for each
measure independently. We could, for example, have length measured in metres but diameter
measured in inches.
In general, it is recommended that the very first operation in the process of creating a new
network should be the selection of the appropriate units. Whilst units can be changed later, it can
lead to complications and confusion. In particular, switching between mass and volumetric flow
can create problems when the fluid density is unknown (depending on the fluid model being
used), and a warning may be issued in these situations.
The Units dialog
Selecting the menu option Options | Units displays:
Specifying Options
159
The left-hand side is a scrollable window via which for each quantity (length, diameter, velocity,
etc) a unit (metres, feet, etc.) may be selected. For users of previous versions of PIPENET, this
window is functionally identical to the Units dialog in those versions; the same set of options is
available. The units options window can be scrolled vertically to display more options.
The example above illustrates that SI units are in use, and units cannot be changed individually.
Selecting the User-defined option will result in the following display and all unit options are now
enabled:
When you switch to User-defined units you will be offered the chance to copy your current
settings to your User-defined settings. This can be very useful, to reset your user-defined settings
and then tweak one or two of them to preferred values.
Display Precisions
At the upper right of the dialog is an area where the display precisions can be set individually for
general display (in the Property windows, dialogs and the Data window) and in the Schematic
window. To use this facility, select the name of the quantity (Length, Diameter, etc.) in the lefthand window, and the display changes to:
160
Transient Module
Here, Length has been selected. The values displayed for the precision [0.123] indicate that
three decimal places will be used for the display of length in the selected unit of length (metres, in
this example).
Selecting the arrow to the right of each field produces a drop-down list, showing that the number
of decimal places can be selected to be between zero and eight.:
When a network is saved, the preferred precisions are saved, and they are reloaded when the
file is re-opened. Selecting the Save As Defaults button will save the current settings in the
registry, and these will be the defaults used when new networks are created.
Unit Conversion Tool
At the lower right of the dialog is a unit-conversion tool. Again, this area is only active if a
measure is selected.
Specifying Options
161
To use the tool, simply enter a value in the left-hand field, select the unit that the value represents
from the left-hand column (from unit) and the unit to which to convert to from the right-hand
column (to unit), and the result is displayed in the right-hand field. This example illustrates that 1
metre is converted to 3.2808399 ft. The example below illustrates the use of the tool to convert
a pressure; specifically, 1.0 psi Abs converts to 6894.75 Pa Abs.
15.4
Fluid
Via this dialog, the user can specify the properties of the fluid in use, the properties being the
fluid density, fluid viscosity, temperature, bulk modulus and the vapour pressure. An alternative
method of specifying a fluid is provided via the American Petroleum Institute (API dialog), which
is described in the following section.
162
Transient Module
The five fluid parameters are either entered directly for a User-defined fluid, selected from Fluid
name combo box, or they can be calculated for water and steam by selecting Water-Steam as
the fluid name; and selecting the fluid state (second combo box) as one of:
Unsaturated - a pressure and temperature must be provided.
Saturated liquid - a pressure or a temperature must be provided.
Saturated vapour - a pressure or a temperature must be provided.
Specifying Options
163
Selecting the Calculate button will calculate the five fluid parameters, based on the settings of
the Pressure and/or the temperature values, and display them in the dialog. If the calculation of
the fluid parameters succeeds, the fluid state will be displayed in the Messages area; otherwise,
the Messages area will contain an indication of why the calculation could not be completed.
By default, the fluid is assumed to be defined by the settings of this dialog; however, if it is
desired to use the properties of the fluid defined by the API dialog then select the Use API fluid
button - the text of the button changes to Use direct fluid. Selecting the button again will revert
to using the direct fluid specification provided by this dialog.
15.5
API Fluid
This dialog can also be used to specify the fluid in use, in accordance with the American
Petroleum Institute (API) criteria. Based on the entered parameters (on the left-hand side of the
dialog) and, on selecting the Calculate button, the properties of the fluid are calculated and
displayed on the right-hand side of the dialog. Currently, only the five parameters (namely, fluid
density, fluid viscosity, temperature, bulk modulus and the vapour pressure) are used in the
calculation.
By default, the fluid is assumed to be directly specified using the Fluid dialog, which is described
in the previous section; however, if it is desired to use the properties of the fluid defined by this
dialog then select the Use API fluid button - the text of the button changes to Use direct fluid.
Selecting the button again will revert to using the direct fluid specification provided by the Fluid
dialog. For further information on API fluids, refer to the Modelling chapter.
164
15.6
Transient Module
Pipe types
This dialog is used to provide a pipe type:
In the Transient module, all pipes in a network can be entered directly (that is, not using pipe
types) or all pipes in a network must be of a specified type. It is not possible to have some pipes
in a network with pipe types and some pipes without them. If, after entering some pipes, you
define a first pipe type then a warning will be issued, giving the user the opportunity to ensure
that all pipes have a pipe type.
A pipe type will be associated with a pipe schedule, and this schedule must already exist before
the pipe type can be created.
Creating a new pipe type
To create a new pipe type:
1. Select the New button.
2. Select the associated schedule from the drop-down list provided - the name and
description fields are completed.
3. Provide velocities or pressure drops for all those bores that are to be provided by the
schedule.
4. Select Apply to add the pipe type to the library.
Note that if a pipe is defined as using a pipe type then, instead of explicitly entering the pipe
diameter, the diameter is selected from a combo box listing the available sizes, together with the
unset value.
Specifying Options
165
15.7
166
Transient Module
Label Options
The label options allow nodes to be labeled, links to be labeled, component direction to be
indicated and the presence of any fittings on a pipe to be shown.
For pipes, an additional option is available indicating whether or not all segments of a multisegment pipe (that is, one containing way points) are to be labeled, or only the central segment.
Labeling only the central segment may improve the appearance of printed schematics.
An arrowhead pointing from the input towards the output indicates the component direction. As
with the standard PIPENET definition, the component direction does not necessarily correspond
to the direction of flow.
The presence of one or more fittings on a pipe is indicated by a blue diamond symbol centred,
along the length of the pipe.
Annotation
If your schematic display becomes cluttered, this provides a quick and easy way to reduce the
number of decimal places displayed.
Dry Pipe
Indicates if the initial state of the pipe is dry, if it is dry then the below double line will be shown
on the pipe:
Specifying Options
167
Line Thickness
Specify the thickness of the lines used for drawing as being between one (the default) and eight
pixels.
Grid Options
Via the Grid options, you can select the display of a grid, its style and whether all nodes and
waypoints are confined to lay on grid intersections. The grid can be orthogonal (vertical and
horizontal grid lines) or isometric (one vertical axis, one axis at 30 degrees to the horizontal and a
third at 150 degrees to the horizontal).
Colours and Fonts
This options are used to select the background colour and the font size for node and link labels.
Tool Tips
Selecting this option will cause tool tips to be displayed when the mouse cursor is on or near a
component. The tool tip will display the component type, its label and the current parameter
selected from the Options toolbar. The information is displayed for a few seconds, and then
disappears. For example, moving the mouse to a pipe will display:
Performing a Calculation
Part
16
Performing a Calculation
16
Performing a Calculation
16.1
Transient calculations
169
The Transient module generally operates in the same manner as the Standard and Spray
modules. However, there are a number of additions, primarily relating to the selection of tables
and graphs, and with the display of graphical results. Running a transient calculation does not
produce a simple set of results that can be displayed in a grid. Instead, the user selects the results
they want and, on completion of the calculation, the requested results are stored in a results file.
Results can the be selected for display using a separate Graph Viewer program.
16.2
The first column provides the component type, the second provides the component label and the
third provides the selected variable, only the last of which is directly editable. To add a new
result in one of the two categories:
1. Select line containing ... in the first column the first blank line.
170
Transient Module
2. Select the component type from the drop-down list in the second column of the newly
created row.
3. Select the component label in the third column.
4. Select the variable(s) required.
5. Finally, select the symbol in the first column to commit the change.
A result may be deleted by right-clicking in the first column of a row and selecting the Delete
graph option.
16.3
Defining Tables
Tables are defined using the Tables tab in the Tabular grid. When first selected, the display
might typically be as follows:
The table is divided into two parts: at the top are four title lines, and below is the definition of the
table. The drop-down box at the top indicates which table is currently displayed; in this case,
"Pump operation".
The table definition is initially displayed with one line for each component, identified by its type
and label, together with a start column. The last row (with the symbol ... in the first column)
indicates the next free column available. Note that at most eight columns can be present in a
table. In the above example, the pump with the label uses the first five columns of the table. To
view which attributes have been selected for the table, select the + symbol in column one, and
the display then expands to include a list of the variables:
Performing a Calculation
171
The + symbol now changes to a - symbol, which, if selected, will once again hide the details of
the attributes selected. De-selecting or selecting one or more of the available attributes will
immediately update the number of columns used.
To add extra columns to the grid, click on the last row (i.e., the one containing the ... symbol in
column 1) and select from the list of available component types and component labels displayed.
Finally, select the attributes to be displayed:
172
16.4
Transient Module
Defining Forces
Forces are defined using the Forces tab in the Tabular grid. When it is first selected, the display
might typically be as follows:
This view shows the list of defined forces and a description. Clicking on the ... symbol in the first
column of one of the rows displays a dialog where full details of the force can be viewed and
edited:
Performing a Calculation
16.5
173
Displaying Results
Once a calculation has been performed, graphical results may be selected for display, either
directly by right-clicking on a component and selecting the option View Results or, if the Graph
Viewer is already active, by selecting from the list of available graphs there. For further
information on viewing results, please see the section Viewing the results for Tutorial example 1.
174
16.6
Transient Module
Controls
This dialog defines some general controls for each calculation:
Performing a Calculation
16.7
175
Absolute tolerances
These fields can be used to control the accuracy of the calculation. Advanced users can modify
the values to fine-tune the calculation process. The default settings are adequate for most
situations.
16.8
Relative tolerances
These fields can be used to control the accuracy of the calculation. Advanced users can modify
the values to fine-tune the calculation process. The default settings are adequate for most
situations.
176
16.9
Transient Module
Initial state
The initial state dialog allows you to
The starting point for the simulation is selected from the available options, the default being that
the starting point will be generated by PIPENET. Alternatively, Static or Read from an initial
guess file can be selected.
Performing a Calculation
177
If an initial guess file is to be used then one is created by supplying a file name and selecting
Make initial guess file. An existing initial guess file may be edited by entering the file name and
selecting Edit initial guess file. It should be noted that a new initial guess file must be created if the
network is changed in any way.
The run-in time can be entered, or the default button can be selected (in which case, a run-in
time of one quarter of the total simulation time will be set).
The calculation of initial and final steady states is specified by checking the appropriate check
boxes.
178
Transient Module
allowing entry of the snapshot time and the name of the snapshot file.
Selecting the Modify button will allow a user to edit an existing snapshot, and selecting Delete
will delete an existing snapshot.
Time step
Selecting the Timestep button will allow the user to examine the value to be used in the
calculation, and to identify which pipes may cause the simulation to run for a long time.
Information on various factors that affect the choice of time step is displayed:
Performing a Calculation
179
A list of pipes is provided, each pipe displaying the number of sections into which the pipe has
been divided, the length of each section and the wavespeed. Also displayed is the interpolation
error, which is a guide to how well the network has been divided.
180
Transient Module
Graph Viewer
Part
17
182
Transient Module
17
Graph Viewer
17.1
The menu bar has three items. The three menus are summarized below, and described in more
detail later in this section:
File
Edit
Opens a graph .res files, and prints and exports a graph as an image.
Copies the graph.
Graph Viewer
Annotations
183
File menu
Open
Show Movie
Export
Print
Exit
Edit menu
Copy
Annotation
Labels
Arrows
184
Transient Module
Graph Viewer
17.2
185
186
Transient Module
Expand the tree, and right click on the graph to be played. The window closes automatically
when the movie finishes.
Graph Viewer
17.3
187
188
17.4
Transient Module
Line Thickness
Data Points
Graph Viewer
17.5
189
Axis Title
Axis Position
Hide Axis
Font Size
Range
190
17.6
Transient Module
Axis Title
Axis Position
Hide Axis
Font Size
Graph Viewer
17.7
191
To display the maximum and minimum lines for the selected graph, click the appropriate check
box.
Y Value
Style
A series of numbers that are interpreted as a strokedash pattern for the curve. Each number in the list
specifies the length of a dash or gap relative to the
thickness of the line of the cure. For example, a value of
1 creates a dash or gap that has the same length as the
thickness of the pen (i.e., a square).
The first item in the collection, with index 0, specifies the
length of a dash; the second item, which is located at
index 1, specifies the length of a gap.
Objects with an even index value specify dashes;
objects with an odd index value specify gaps.
For example, a line style of 4 1 will result in the
following line The dash is 4 times the size of the line
thickness and the gap is the same size as the line
192
Transient Module
thickness.
Line Thickness
Graph Viewer
17.8
193
194
17.9
Transient Module
Hot spot
Trace the curve with the mouse and, when a data point is encountered, a tool tip will appear,
displaying the coordinates of that data point.
The data points can be made visible via the Curve properties tab.
Graph Viewer
195
17.10 Zooming
It is possible to zoom the graph to an area of interest.
Hold down the Ctrl key, click and hold down the left mouse button and drag the mouse to
highlight the area to be zoomed.
Release the mouse button and the Ctrl key, and the graph redraws to show the zoomed area.
196
Transient Module
The zoomed graph can be zoomed further by repeating the above steps.
To zoom out a zoomed graph, hold down the Alt key and click inside the chart with the left
mouse button.
Modelling
Part
18
198
Transient Module
18
Modelling
18.1
Pipe Linings
Standard
Thirty two built-in schedules, or
user-defined
Not available
Pipe Fittings
Converted to a k-factor
Pressure Drop
Equation
Bernoulli equation
Pipe Schedules
18.2
Spray
Eight built-in schedules,or userdefined
Three built-in linings, or userdefined
Converted to an equivalent length
of pipe
Bernoulli or Hazen-Williams
equation
HazenWilliams
The Hazen-Williams equation is an empirical formula that provides an explicit expression for the
frictional pressure loss.
SI units
The frictional losses are given by:
where:
Pfric
L
Le
Q
D
C
Imperial units
The frictional losses are given by:
Modelling
199
where:
18.3
Pfric
L
Le
Q
D
C
where:
D is the internal diameter of the pipe.
L is the pipe length.
Le is the equivalent length of any pipe fittings.
f is the Fanning friction factor.
u is the fluid velocity.
is the fluid density.
The Fanning friction factor depends on the Reynolds number (Re = uD r/u where u is the fluid
dynamic viscosity) and the relative roughness of the pipe (i.e., the pipe roughness divided by the
pipe diameter). The standard values for f can be obtained from a graphical representation known
as the Moody diagram. This is represented in PIPENET by the following empirical formulae
(where r is the surface roughness of the pipe):
Laminar flow (Re < 2000):
200
Transient Module
18.4
Pipe C-factor
There are two possible methods for calculating pressure drop in pipes - the Coulson and
Richardson method and the Hazen-Williams method.
The Coulson and Richardson method uses the pipe roughness in its calculations, which is taken
from the pipe schedule used for the Pipe Type. In this case, there is no need to specify a Cfactor for the pipe.
The Hazen-Williams method uses the pipe C-factor in its calculations, and so, in this case, the
C-factor must be given.
It should be noted that, for maximum flexibility, the roughness or C-factor value of the Pipe Type
can be overridden by the user when entering the individual pipe data. However, by default, the
roughness or C-factor of each pipe will be determined by the pipe's pipe type.
18.5
Linings
When operating in the Spray mode, any of the available pipe schedules (built-in or user-defined)
may also be lined in accordance with the user's requirements. This is done by specifying the lining
to be used for the Pipe Type, together with the thickness of the lining. Of course, if no lining is to
be used then no such data is supplied.
Three types of lining are built into the program, and a further 3 types may be defined by the user
in the Private Data File. The 3 built-in linings are:
Concrete
Asbestos
Epoxy
In order to define a lining, it is necessary to simply specify the name and roughness of the lining
material via the Library option.
18.6
Fluids
Fluids are defined in the Transient module by a set of five parameters:
fluid density,
fluid viscosity,
temperature,
bulk modulus
vapour pressure.
Modelling
201
202
Transient Module
viscosity calculation method - the default reference data are applied in the calculation.
Error 4 - the input data are not valid for API liquid viscosity calculation - the liquid
viscosities cannot be calculated.
Error 5 - the input data are not valid for API heat capacity calculation - the heat
capacities cannot be calculated. The input data are not valid for API liquid viscosity
calculation - the liquid viscosities cannot be calculated.
Error 6 - The input data are not valid for API fluid calculation- the API fluid properties
cannot be calculated.
18.7
Fluid Equations
The Transient Module solves the water hammer equations in the pipes.
The momentum and continuity equations are solved numerically for the pressures and flow rates.
Other component-modelling equations are described in subsequent sections of this chapter.
Momentum Equation
Applying Newton's second law to a control volume of fluid, and allowing for friction and gravity,
one obtains:
Continuity Equation
The rate of increase of mass of a control volume of fluid is equal to the net mass flow rate into
the volume; i.e.,
where:
p is the pressure in the pipe.
u is the fluid velocity along the pipe.
x is the distance along the pipe.
Modelling
203
t is the time.
A is the cross-sectional area of the pipe.
d is the diameter of the pipe.
the fluid density.
the angle the pipe makes to the horizontal.
f is a friction factor.
18.8
Wave Speed
The wavespeed in a pipe is the speed at which pressure surges are propagated along the pipe. It
depends on a number of factors, including the material and diameter of the pipe, and the bulk
modulus of the fluid. For the Transient Module to make an automatic calculation of the
wavespeed, the user must provide a pipe schedule and define the fluid bulk modulus. If this
information is unavailable, a default wavespeed can be specified.
Details of wavespeeds for each pipe in the network are listed in the output report file, along with
the rest of the pipe data.
The wavespeed is calculated using:
where:
a is the wavespeed.
K is the fluid bulk modulus.
D is the internal pipe diameter.
E is the Young's Modulus for the pipe material.
t is the pipe wall thickness.
c1 is the pipe distensibility (restraint factor).
the fluid density.
The pipe distensibility is calculated by assuming that the pipe is anchored at both ends against
longitudinal movement:
where
If a pipe is not anchored at both ends, the pipe wavespeed should be specified by the user as a
user-defined wavespeed. The earlier formula for the wavespeed should be used, with pipe
distensibility given by:
204
Transient Module
18.9
Specifications
Specifications are used to describe the behaviour of valves and pumps in the network and
boundary value pressures and flow rates. A Pressure or Flow rate specification is required at all
input and output nodes. Note that:
1. PIPENET uses the convention that flow rate is positive into, and negative out of, the
system.
2. There must be at least one pressure specification somewhere in the network.
3. Only one specification is allowed on each node.
4. No pressure or flow rate specification is allowed on an interior node.
An Information specification is used to control the operation of a pump or valve. The
specification value should lie between 0 and 1 (from 0 for a fully closed valve or shut-down
pump, to 1 for a fully open valve or full-speed pump). The information specification should be
attached to an information node having no other connected components.
User Input Parameters
Specification Type - Pressure or flow rate for I/O nodes, information for information
nodes.
Node - Node to which specification applies.
Time function - Choice of time function and associated parameters.
Modelling Equations
The user has the choice of nine basic types of specification. In each case, the program calculates
the specification value at each time.
Built-in Functions
Nine built-in functions are available. These are described below.
Modelling
Constant
where:
and:
A = power ramp start time.
B = initial specification value.
C = power ramp stop time.
D = final specification value.
E = exponent.
205
206
Transient Module
Sine Wave
Gives an oscillating specification value.
where:
A = amplitude.
B = frequency.
C = constant time lag.
D = additive constant.
Exponential
Gives an exponentially increasing or decreasing specification value.
where:
A = amplitude.
B = growth factor.
C = additive constant.
Damped Sine Wave
Gives a damped oscillating specification value throughout the simulation.
Modelling
207
where:
A = amplitude at time t=0.
B = decay factor.
C = frequency.
D = constant time lag.
E = additive constant.
Asymmetric Pulse
Gives a sudden change in the specification value over a specified time period.
where:
A = specification value before the pulse.
B = pulse start time.
C = specification value during the pulse.
D = pulse end time.
E = specification value after the pulse.
Profiles
Three types of profile are available, and are described below. The repeat option ensures that the
specified profile points are repeated over the remainder of the time period. A maximum of 30
208
Transient Module
Up to 40 data points can be used to define the curve, and linear interpolation is used between
the points.
Step Profile
This is a more general form of the asymmetric pulse function:
Up to 40 data points can be used to define the curve, and the function is assumed constant
between the points.
Cubic Profile
This is a more general form of the power ramp function.
Up to 40 data points can be used to define the curve, and cubic interpolation is used between
the points.
Modelling
209
210
Transient Module
Pipe
In the Spray option, the pipe type list contains the built-in schedules and the available fittings, of
which there are the 9 built-in fittings. If the Hazen-Williams equation is being used then the
roughness is replaced by C-factor.
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
NOTE: For this help section it shall be assumed that the Initial State of the Pipe is WET. Please
see 'Elastic Pipe - Dry Pipe' to see how this effects the pipe equations and behaviour.
Modelling
211
Modelling Equations
Fluid Modelling Equations
The momentum and continuity equations are solved for pressures and flow rates along the pipe:
Momentum equation
Continuity equation
where:
Pf is the pressure drop.
u is the fluid velocity.
f is the Fanning friction factor.
L is the pipe length.
D is the pipe internal diameter.
is the fluid density.
The Fanning friction factor is a function of the Reynolds number and the relative pipe roughness.
PIPENET uses the following empirical formulae for the friction factor:
212
Transient Module
Transitional flow:
f is found by interpolating between the laminar value at Re = 2000 and the
turbulent value at Re = 3000.
Colebrook-White equation
PIPENET can also use an alternative formulation of frictional loss using the Colebrook-White
equation:
1/ f
= -4log(r/3.7D + 1.256/Re f)
The pressure drop caused by the difference in elevation of the two ends of the pipe, Pelev , is
given by:
where:
is the fluid density.
Z is the change in elevation in the pipe.
g is the acceleration due to gravity.
where
Modelling
213
:
where:
L is the pipe length in feet.
Le is the equivalent length of any pipe fittings in feet.
Q is the (volumetric) fluid flow rate in UK gallons per minute.
D is the pipe diameter in inches.
C is the Hazen-Williams constant (or C-factor ) for the pipe.
Dry Pipe
214
Transient Module
available. To turn this option on look in Module Options window, if Treat all pipes as wet is
ticked, PIPENET will regard all pipes as being wet throughout the simulation. In this case,
PIPENET behaves exactly as it did in versions prior to PIPENET 1.6.
Untick Treat all pipes as wet to enable the dry pipe option, which also activate; dry nozzle, dry
specification (i.e. boundary condition) and drained surge tank (or receiving vessel) capabilities of
PIPENET. You have a choice as to whether new pipes are created as initially wet or initially dry.
To define a pipe as Dry:
Once Dry Pipe has been turned on (as described above), you had the choice to select all newly
created pipes to be WET or DRY by default. Each pipe also has the option to have it initial state
to be manually altered:
Modelling
It should also be noted that in the schematic view the the pipes will all look alike UNLESS
'Indicate Dry Pipes' option has been ticked in the Display options window.
Modelling Equations
(A) Dry pipe:
1. Momentum equation:
2. Outlet flowrate:
1. Momentum equation:
2. Continuity equation:
3. liquid level:
215
216
Transient Module
Where:
A
D
f
g
h
P
P0
Pa
Q
Q0
u
z
Implementation notes
1. A dry pipe can only be modelled by an elastic pipe (not short pipes, pipe bundles, etc)
2. We assume that there are no wet pipes or dead ends downstream of the dry pipes which
block air flow. The back pressure of dry pipes is assumed to be 0 barg, i.e. the pressure drop
in a dry pipeline is negligible.
3. Similarly we assume that there are no short pipe; pipe bundle; tanks (accumulator, simple
tank, surge tank and receiving vessel) and caissons (one-node caisson, two-node caisson and
two-node caisson type 2) downstream of the dry pipes to block air flow.
4. Slip velocity between air and liquid is neglected in dry pipe model.
5. Dry state cannot coexist with channel cavitation state in a single pipe. Therefore, the channel
cavitation model for that pipe is disabled during filling up and enabled after the pipe is filled
up.
Modelling
217
where:
Q is the flow rate through pipe.
P1 is the inlet pressure.
P2 is the outlet pressure.
A is the cross-sectional area.
L is the length.
D is the diameter.
is the angle of inclination from the horizontal.
f is the friction factor.
g is the acceleration due to gravity,
is the fluid density.
218
Transient Module
Pipe Bundle
Number of tubes.
Inside diameter of each tube.
Length of each tube.
Net height change - this is the difference in height of the pipe outlet from the pipe inlet
(and must be no greater than the length).
5. Roughness or C-factor: roughness in Standard option or Spray option, C-factor only
in Spray option.
6. Additional K-factor: the resistance of the fittings on the tubes except at the entrance
and exit.
7. Status: normal, leak, break or block:
Normal status: no extra parameters required.
Leak status:
Leak area.
Leak time: the time at which the leak starts.
Developing time: the period between when the leak starts and when it
becomes fully developed.
Back pressure: the outside pressure of the tubes; e.g., shell side pressure.
Break status:
Break number: a broken tube (break number is one) has two break sections.
Break time: the time at which the break starts.
Developing time: the period between the start of the break and when it
becomes fully developed.
Back pressure: the outside pressure of the tubes; e.g., shell side pressure.
Block status:
Block number.
Block time: the time to block.
Developing time: the period between when the block starts and when it
becomes fully developed.
Modelling
Modelling equations
Normal status
Momentum equation:
P1
P2
P0
0.5 P1
L dQ i
A dt
gz
2f L
Qi Qi
DA 2
P2
Flow-rate equation:
Q1
Q2
Q1
NQ i
Qj
Qi
Qk
Qi
Q0
Leak status (the leak position is assumed at the middle of the tube)
Momentum equation:
P1
P2
gz
L dQ i
A dt
2f L
Qi Qi
DA 2
219
220
Transient Module
P1
P0
0.5
gz
L dQ j
A dt
2f L
Qj Qj
DA 2
P0
P2
0.5
gz
L dQ k
A dt
2f L
Qk Qk
DA 2
P0
Pb
k Q0 Q0
2 SMA
Flow-rate equation:
Q1
Q2
Q0
Q1
M Qi
MQ j
Q2
M Qi
MQ k
Break status (the break position is assumed at the middle of the tube)
Momentum equation:
L dQ i
A dt
2f L
Qi Qi
DA 2
P1
P2
gz
P1
Pb
0.5
gz
L dQ j
A dt
2f L
Qj Qj
DA 2
Pb
P2
0.5
gz
L dQ k
A dt
2f L
Qk Qk
DA 2
P0
Pb
Flow-rate equation:
Q1
Q2
Q0
Q1
M Qi
MQ j
Q2
M Qi
MQ k
Modelling
Block Status
Part block
Momentum equation:
P1
P2
gz
L dQ i
A dt
2f L
Qi Qi
DA 2
P1
P2
gz
L dQ j
A j dt
2f L
Qj Qj
D j A 2j
P0
0.5 P1
P2
Q2
Q1
Qk
Qj
Q0
M Qi
MQ j
Full block
Momentum equation:
P1
P2
P0
0.5 P1
L dQ i
A dt
gz
P2
Q2
Q1
Qj
M Qi
2f L
Qi Qi
DA 2
221
222
Transient Module
Qk
Q0
where:A
Aj
D
Dj
f
g
L
M
N
P0
P1
P2
Pb
Q0
Q1
Q2
Qi
Qj
Qk
t
z
is the diameter,
is the diameter during pipe block,
is the friction factor,
is acceleration due to gravity,
is the length,
is the number of broken/leaked tubes,
is the total number of tubes,
is the inner pressure at the broken/leaked point,
is the inlet pressure,
is the outlet pressure,
is the outer/back pressure at the broken/leaked point,
is the fluid flow rate escaped,
is the inlet flow rate,
is the outlet flow rate,
is the flow rate in the normal tubes,
is the inlet flow rate in the broken/leaked tubes,
is the outlet flow rate in the broken/leaked tubes,
is the time,
is the net height change,
is the fluid density.
Modelling
223
224
Transient Module
Spray option
For an equipment item, specify the following:
Description (up to 10 characters).
Equivalent length of the pipe.
Modelling Equations
Standard option
In the Standard option the frictional pressure drop across a fitting is given by:
where:
P is the pressure drop.
k is the k-factor for the fitting.
is the density of the fluid.
u is the fluid velocity through the fitting.
Approximate k-factor values for some common fittings types are given in the Reference
section.
Spray option
In the Spray option, fittings are incorporated as equivalent lengths of a straight pipe.
Adding a fitting to a particular pipe is equivalent to extending the pipe's length by an
amount that depends on the fitting type. However, the inclusion of an equivalent length
does not alter the actual length of the pipe, and the time for a pressure wave to travel
the pipe length remains the same. Equivalent lengths are provided for the nine built-in
Spray fittings, for both the FOC and NFPA rules.
Placement of Tees in the Spray option
For the placement of crosses and tees, the NFPA guidelines [NFPA] pages 13-213 to 13-216
provides the following information
22.4.4.7 (3) Calculate the loss for a tee or a cross where flow direction change occurs
based on the equivalent pipe length of the piping segment in which the fitting is
included.
22.4.4.7 (4) The tee at the top of a riser nipper shall be included in the branch line, the
tee at the base of a riser nipple shall be included in the riser nipple, and the tee or cross
at a cross main-feed main junction shall be included in the cross main.
22.4.4.7 (5) Do not include fitting loss for straight-through flow in a tee or cross.
It is possible, however, that sometimes a user may wish to define the fittings in a different way,
according to their own good engineering practices.
Modelling
225
226
Transient Module
where:
s is the pump setting.
Q is the flow rate through the pump.
A, B, C,D are pump performance coefficients.
The pump performance coefficients A, B, C and D are entered directly, or calculated by
PIPENET for a specified pump curve, in Pump libraries. The user also specifies an operating
range for flow rates through the pump. It is recommended that the zero flow rate point is given
when defining a pump curve.
The pump setting, s, must be between 0.0 and 1.0. A setting of s = 0.0 represents a shut-down
pump, while s = 1.0 represents a pump at full speed.
The quadratic curve will, in general, only apply to the specified working range of the pump;
however, degeneration factors can be used to specify the behaviour of the curve below the
specified working range and/or above the specified working range.
Modelling
227
where:
228
Transient Module
where:
There is a potential problem with the cubic curve in that it may lead to multiple solutions.
Therefore, the above function must satisfy the following condition:
Modelling
229
Within the specified working range QLL to QUL in the region of [Qi, Q i+1 ]
Below the lower limit, with Q < QLL and along the tangent direction at the point [QLL, PLL]
where:
Above the upper limit, with Q > QUL and along the tangent direction at the point [QUL, PUL]
where:
230
Transient Module
where:
H
P
Q
N
T
The subscript R denotes the rated quantity of the variable; i.e,. the values of H, P, Q, N and T at
the point of best efficiency. The head-flow rate and torque-flow rate curves for the turbo pump
are then transformed to Suter characteristic curves of the form.
Modelling
231
where:
The figure shows typical Suter curves for a Radial Pump. The regions referred to in the figure are
termed as Zones and Quadrants. Each quadrant is of length pi/2, and the zones lying therein are
split at zero head-flow rate and torque-flow rate values. There are eight possible zones of pump
232
Transient Module
operation: four occur during normal operation and four are abnormal zones. During a transient
event, a pump may enter most, if not all, regions in the figure, depending on the appropriate
circumstances.
Similar Turbo Pumps are characterized by the specific speed. This is defined as:
Moment of Inertia
If the moment of inertia is not obtainable from the manufacturer, the following equations may be
used to provide an estimate for the moment of inertia [ARDT]:Pump impeller inertia
Modelling
233
where
HP
is the width of the pump impeller chamber, in m.
I
is the total moment of inertia, including the pump, entrained fluid and
motor, in kg.m2 .
IM
is the motor inertia, in kg.m2 .
IP
IW
NR
PR
RP
where:
I is the moment of inertia of the turbo pump.
M is the total mass of the rotating parts and entrained fluid.
R is the radius of gyration of the rotating mass.
N is the speed of the turbo pump.
w is the angular velocity.
234
Transient Module
The modelling equations presented here are based on a linear regression analysis of data
presented in [ARDT].
Modelling
235
On the left-hand side of the dialog, the following information must be provide:Pump name.
Pump description.
Model type - select from Trip, Start-up or Both.
Moment of inertia - the total rotation moment of the pump, motor and entrained
fluid.
Rated speed - the recommended working speed.
Motor synchronous speed - the motor driving torque is zero at synchronous speed,
only required for a start-up type pump.
Reference fluid density - the fluid density that the pump curves are based on.
Min/max flowrate - the recommended working range.
Degeneration factor - used to correct the pump performance curve (flow rate vs.
head) beyond the working range.
Units - select from the available options for the units to be used in defining the curves:
Flow rate, Head, Power and Torque (the torque unit is required only for a start-up
type pump).
Via the Head and power data tab, provide:The flow rate and head values defining the H-Q curve.
236
Transient Module
The pump input shaft power, defining the P-Q curve. If power data are not available,
the power curve can be deduced from the flow rate efficiency curve, except for the
power at zero flow rate, which must be entered manually. To select which is entered,
power (default) or efficiency, use the Known combo box in the bottom right-hand
corner of the dialog.
Via the Torque and relative speed tab, provide (not required for the Trip model pump):The torque and relative-speed data defining the T-S curve. Relative speeds are relative
to the rated speed entered on the left-hand side of the dialog. If only the actual speeds
are known then these can be entered instead, by selecting the Rotation speed option
in the Known combo box on the right-hand corner of the dialog.
Inertial pump properties
When one or more library inertial pumps have been defined, selecting an inertial pump in the
schematic window displays the following pump properties:
Pump control
Normal state
The inertial pump works like simple pump at normal state. The pump speed is controlled
Modelling
237
Pump trip
The inertial pump can also simulate pump trip, like the turbo pump does. The difference
is that the turbo pump sets the trip time in the pump property window, while the inertial
pump sets the trip time using a step-type time function via the information node, and the
final setting must be zero.
Pump start-up
The pump model type must be Start-up or Both in the pump library. As with a pump
trip, the inertial pump sets the start time using a step-type time function via the
information node, and the final setting must be 1.0.
238
Transient Module
Modelling equations
Normal state
where:
H
s
Q
A, B, C, D
Modelling
Pump Trip
The pump spin-down rate can be calculated using the power curve.
where
P
I
If the pump power curve P-Q is unavailable, but the pump efficiency curve H-Q is
available, the P-Q curve can be deduced from the H-Q curve.
where
P
H
Q
ref
is pump efficiency.
Pump Startup
239
240
Transient Module
The pump spin-up rate during start-up can be calculated based on the difference of the
motor-driving torque and the pump-resistance torque.
where
TD
TR
P
I
Moment of Inertia
If the moment of inertia is not obtainable from the manufacturer, the following equations may be
used to provide an estimate for the moment of inertia [ARDT]:Pump impeller inertia
Modelling
241
where
HP
is the width of the pump impeller chamber (m).
I
is the total moment of inertia, including the pump, entrained fluid and
motor (kg.m2 ).
IM
is the moment of inertia of the motor (kg.m2 ).
IP
IW
NR
PR
RR
18.20 Valves
Valves are components that have a variable resistance to flow, causing a pressure drop across
the valve. In PIPENET, a wide range of valves are available to the user:
Operating Valves,
Non-return Valves,
Check Valves,
Fluid Damped Check Valve,
Liquid Surge Relief Valve,
Regulator Valve,
Inertial Check Valve,
Pressure surge relief valve.
The pressure drop across the valve (as fluid flows through it) depends on a number of factors,
242
Transient Module
including the flow rate through the valve, the valve characteristic, the valve setting and the
physical properties of the valve.
In PIPENET, the valve setting is represented by a number 's', which varies between zero (for a
fully closed valve) and one (for a fully open valve); for example:
s = 0 Valve is fully closed.
s = 0.25 Valve is quarter open.
s = 0.667 Valve is two thirds open.
s = 1 Valve is fully open.
Depending on the type of valve, the setting may be specified by the user, set by a control system,
or calculated based on flow conditions and the physical properties of the valve.
Valve Characteristics
Valve characteristics can be defined in terms of the K-Factor or Flow Coefficient.
K-Factor Valve
The pressure drop across an open valve is given by:
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q is the flow rate.
k(s) is the k-factor.
s is the valve setting.
A is the valve port area.
is the fluid density.
The value k(s) is the k-factor of the valve, and represents the resistance to flow. The
valve characteristic is the curve of k against s and can be defined by the user or as one
of the built-in types.
Flow Coefficient Valve
The pressure drop across an open valve is given by:
where:
Cv(s) is the Cv value.
is the density of the fluid.
Modelling
243
The value Cv(s) is the flow coefficient of the valve, and represents its capacity for flow.
The valve characteristic is the curve of Cv against s and can be defined by the user or
as one of the built-in types.
Typical representations of the two curves are shown below:
k-factor
Flow coefficient:
244
Transient Module
Modelling
245
1. Valve Equations
Open k-factor valve in SI units (s
0)
2. Continuity Equation
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
s is the specified valve setting.
A is the fully-open cross-sectional area.
is the density of the fluid.
is the density of water at standard conditions.
0
246
Transient Module
Modelling
247
248
Transient Module
Modelling
249
250
Transient Module
2. Continuity Equation
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
Modelling
251
0)
0)
2. Continuity Equation
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
s is the specified valve setting.
A is the fully-open cross-sectional area.
is the density of the fluid.
0 is the density of water at standard conditions.
Check Valve Modelling Equation
252
Transient Module
The physical characteristics of the check valve are determined by the pressure and flow rate
triggers, its reference setting and the close/open time. The pressure trigger, Pt, is the pressure
difference required to keep the valve at its reference setting. Similarly, the flow rate trigger, Qt, is
the flow rate required to keep the valve at its reference setting. The Close/Open Time is a typical
response time for the valve clapper to move from closed to fully open. Note that a very small
Close/Open time may cause the calculation to fail. This problem can usually be overcome by
reducing the calculation time step accordingly, or by using the variable time step facility, which is
specified via the calculation output dialog.
The actual check valve setting is given by:
where:
Modelling
253
Inlet.
Downstream of valve disk.
Upstream of damping disk.
Downstream of damping disk.
Outlet.
0)
0)
254
Transient Module
2. Continuity Equation
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
s is the specified valve setting.
is the density of the fluid.
is the density of water at standard conditions.
0
Modelling Equation
The forces due to the weight of the plug, the spring and the hydrodynamic forces govern the
motion of the check valve plug. The force due to friction is considered negligible.
Applying Newton's second law, we have:
where the three terms on the right-hand side represent gravity, spring factor and hydrodynamic
term, and:
M is the total mass of the valve plug and disk.
sk is the spring constant.
is the displacement.
FH is the total hydrodynamic force on the valve plug and damping disk.
is the inclination of the valve from the horizontal.
Modelling
255
Valve Type - select from a list of defined library valves, or one of the built-in types
(Linear, Equal Percentage or Quick Opening),
If the valve is a built-in type the following information is required:
K-factor Valve - k-factor value for fully open valve and valve port area
Flow Coefficient Valve - fully open CV value.
Physical properties of the check valve (see modelling equation)
Set Pressure - the valve starts to open.
Wide Open Pressure the pressure that the valve is fully opened.
Fully Closed Pressure the pressure that the valve returns to close state, only
required when the hysteresis option is yes.
Hysteresis yes or no.
Modelling Equations
1. Valve Equation
Open k-factor valve in SI units (s
0)
0)
2. Continuity Equation
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
s is the specified valve setting.
A is the fully-open cross section.
is the density of the fluid.
is the density of water at standard conditions.
0
Modelling Equation
The valve remains closed until the inlet pressure is equal to the Set Pressure, PS. While opening,
256
Transient Module
and for pressures between the Set Pressure PS and the Wide Open Pressure PW, the valve
setting is given by:
For inlet pressures greater than the wide-open pressure, the valve is fully open.
If the Hysteresis Check Box is ticked in the component properties then the valve becomes fully
closed again if the inlet pressure falls below the Fully Closed Pressure PC. The valve retains its
setting if the inlet pressure starts falling before it has reached the Wide Open Pressure, PW, until
it reaches the downward branch of the hysteresis loop. The graph below shows the setting of the
valve as a function of the inlet pressure, and the sign of its change.
Note that, if a .DAT file of PIPENET classic Version 4.10 or earlier is loaded, the Fully Closed
Pressure, PC, is set to the value of the Set Pressure, PS, by default . This is for consistency with
older versions, but is not recommended, as it means that there is no hysteresis. This can lead to
high-frequency state switching.
Modelling
257
K-factor Valve - k-factor for the fully open valve and fully open valve area.
Flow Coefficient Valve - fully open CV value.
Physical properties of the valve (see modelling equations below).
Fully closed pressure - the maximum pressure required to maintain the valve as fully
closed.
Fully open pressure - the minimum pressure required to maintain the valve as fully
open.
Order of time response - determines the dynamics of the regulator valve:
zero order - no time delay.
1st order - first-order time delay.
2nd order - second-order time delay and damping effect.
Time delay is modelled by transfer functions.
Time constant - this entry is only applicable if first- or second-order time response is
selected.
Damping ratio - represents the damping effect of the transfer function on the input
pressure - entry is only applicable if second-order time response is selected.
Modelling Equations
1. Valve Equation
Open k-factor valve in SI units (s
2. Continuity Equation
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
s is the specified valve setting.
A is the fully-open cross section.
is the density of the fluid.
0)
0)
258
Transient Module
0
where:
is the time constant.
t is the real time.
Second order:
where:
is the time constant.
r is the damping ratio.
Notes
1. If the time constant, , is zero, the above two formulae reduce to the first one,
corresponding to instant response.
Modelling
259
Valve Type - Select from a list of defined library valves, or one of the built-in types
(Linear, Equal Percentage or Quick Opening).
If the valve is a built-in type, the following information is required:
K-factor Valve - k-factor value at fully open.
Flow Coefficient Valve - fully open CV value.
Physical properties of the inertial check valve (see modelling equation):
Door Mass - Mass of valve door
Door Radius - Radius of valve door
Spring Constant Constant of torsion spring
Preset Torque - Spring preset torque when valve is closed
Angle of Closed Door - Angle of valve door when closed
Inclination of Valve - Valve installation angle
Damping Damping factor to calm down acceleration or deceleration.
Exponent of Velocity
Modelling Equations
1. Valve Equation
Open k-factor valve in SI units (s
0)
0)
2. Continuity Equation
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
s is the specified valve setting.
A is the fully-open cross-sectional area.
260
Transient Module
d
k
dt
Tw Ts Th T0
where:
is the angle of the valve door.
m is the mass of the valve door.
r is the radius of the valve door.
k is the damping.
n is the exponent of the angular velocity.
Tw is the torque due to the weight of the door.
Ts is the torque due to the torsion spring.
Th is the torque due to the hydrodynamic forces.
To is the preset torque when the valve is at close position.
Modelling
261
Time constant - only required for first and second order valves.
Damping ratio - only required for second order valve.
Modelling Equations
1. Valve Equation
Open k-factor valve in SI units (s > 0)
1
k Q Q s 2 A2 P1 P2
2
Open flow coefficient (Cv) valve (s > 0)
QQ
P1 P2
2
0 Cv
Fully closed valve (s = 0)
Q1 0
2. Continuity Equation
Q1 Q2
where:
P1 is the inlet pressure.
P2 is the outlet pressure.
Q1 is the inlet flow rate.
Q2 is the outlet flow rate.
s is the specified valve setting.
A is the fully-open cross section.
is the density of the fluid.
0 is the density of water at standard conditions.
3. Valve Setting Equation
The valve remains closed until the inlet pressure is equal to the Set Pressure Ps. While
opening, and for pressures between the Set Pressure Ps and the Wide Open Pressure Pw
the valve idea setting is given by:
Zero order:
P1 PS
PW PS
First order:
ds
dt
P1
PW
PS
PS
262
Transient Module
Second order:
2
d 2s
dt 2
2r
ds
dt
P1
PW
PS
PS
where:
is the time constant.
r is the damping ratio.
For inlet pressures greater than the wide-open pressure the valve will be fully opened.
If the Hysteresis Check Box is ticked in the component properties, then the valve becomes
fully closed again if the inlet pressure falls below the Fully Closed Pressure PC. The graph
below shows the setting of the valve as a function of the inlet pressure and the sign of its
change.
Modelling
263
K-factor valve - K-factor value and port area when fully open.
Flow Coefficient Valve - fully open CV value.
Rupture pressure - pressure at which disc ruptures.
Rupture time - time for disc to fully rupture; that is, go from fully closed to fully open
. The rupture time is zero for instantaneous rupture.
Modelling equations
During the simulation, at the very first time when we come across (P1 - P2 ) = Prup or (P1 - P2 ) >
Prup , we record the time t 0 = t, indicating that the rupture process has just started. Before the
simulation time reaches t 0 (i.e., t < t 0 ), the conditions S = 0 and Q = 0 are used, as the disc is still
fully closed, implying that (P1 - P2 ) < Prup . After that time point (i.e., when t > t 0 ), the following
equation is always used, regardless of whether (P1 - P2 ) < Prup or (P1 - P2 ) >= Prup , as the disc
has been either (a) partially ruptured, linearly in the time t during the period of the rupture t rup, as
governed by ( t - t 0 )/t rup or (b) completely ruptured; i.e., S = 1 at the end of the rupture time trup
and onwards, while a zero rupture time corresponds to an instant bursting may be used as well,
which corresponds to an instant bursting;
264
Transient Module
where:
P1 is the inlet pressure.
P2 is the outlet pressure, which is left for the user to specify. If this is the case (normally,
it is set to zero Bar G, which is equivalent to the atmospheric pressure) then the outflow
rate Q2 will be calculated accordingly.
Prup is the rupture pressure (which is a pressure difference).
Q1 is the inlet flow rate.
Q2 is the outlet flow rate. If this is specified by the user then the outlet pressure P2 will
be calculated accordingly.
S is the disc nominal setting.
t is the real time.
t 0 is the time when the rupture begins; i.e., when we come across (P1 - P2 ) = Prup or (P
1 - P2 ) > Prup for the first time.
t rup is the rupture time, ranging between 0.1 ms and 10 ms. A zero rupture time may
be used as well, which corresponds to an instant bursting.
A is the disc open area.
is the density of the fluid.
0 is the density of the water at standard conditions.
Note that the flow-rate specifications must be used cautiously, as thay may lead to infeasible
problems or unrealistic solutions.
Modelling
265
266
Transient Module
1. Valve equation
Open C-factor valve (s
0)
2. Continuity equation
where
P1
P2
Q1
Q2
Valve Cv curve
Modelling
267
268
Transient Module
B:
Closing model
The valve closing speed is controlled by a fixed orifice in the check valve. The closing
speed is a standard at 3 seconds from a fully-open position, based on the gas pressure
being 25 psi (1724 kPa) above the line pressure. The fastest closure is limited to 0.5
seconds at 1000 psi (6897 kPa) differential pressure to protect the piston and seat ring.
The closing pattern is similar to the opening pattern, except that it is slower. Therefore,
the above model equations at the opening state are also suitable for the closing process,
and all valves have the same time constant, c. If the required closure time is longer than
the standard time, the orifice size can be changed to match the customer requirements. It
should be noted that the calculated closing speeds are also a function of the viscosity of
the oil in the reservoir.
2" ~ 16"
172425
18.32 Accumulator
Accumulators are placed in systems in order to prevent pressure surges. They consist of a sealed
cylindrical vessel connected to the network at one point. The trapped gas in the accumulator
provides a cushioning effect, which reduces any pressure surges. The accumulator is usually a
cost-effective way of reducing a pressure surge, as it is cheap, reliable and easy to maintain.
The sizing of the accumulator is crucial, as incorrectly sized accumulators can actually increase
pressure surges in other parts of the network.
Modelling
269
270
Transient Module
Heat capacity
ratio
1.66
specified by user
as 1.0
Note
1. All heat capacity ratios listed are based on atmospheric conditions (zero bar g, 20
C).
2. The heat capacity ratio of a triatomic gas is set as 1.33. The actual value is in the
range 1.29 to 1.33, because of its asymmetrical molecular structure. For example,
Steam = 1.33, CO2 = 1.30, N2 O = 1.31 and SO2 = 1.29.
Modelling Equations
Gas volume in accumulators:
Modelling
Pressure head:
Dimension equations:
271
272
Transient Module
User Defined
Average Hydraulic
Diameter:
where:
Ah is the average area of the liquid column,
As is the cross-sectional area at the fluid surface,
Ai, Ai+1 is the input cross area in the tank library,
D is the input diameter,
Dh is the average hydraulic diameter of the liquid column,
Ds is the hydraulic diameter at the fluid surface,
f is the friction factor,
g is the acceleration due to gravity,
L is the tank length,
P is the accumulator inlet pressure,
P0 is the gas pressure,
Q is the inlet flow rate,
R is the tank radius,
V is the total volume of the accumulator,
V0 is the gas volume of the accumulator,
Vl is the liquid volume of the accumulator,
z is the height of the fluid surface from the bottom of the accumulator,
zi, zi+1 is the input liquid level in the tank library,
is the gas heat capacity ratio,
is the fluid density.
If, during a simulation, the accumulator drains completely then the simulation is automatically
halted.
18.33 SurgeTank
The Surge Tank can be used to reduce severe pressure surges. It consists of an open-ended
tank in which the fluid level can rise or fall as pressure surges occur near the inlet of the tank.
Modelling
273
274
Transient Module
Surge Tank - Ve rtical Cylinde r
Further, IF Dry Pipe option has been activated, and the Surge Tank drains then the air can flow
from the Surge Tank into the network (from the Surge Tank into a pipe).
User Input Parameters
1. Type - Vertical cylinder, horizontal cylinder, conical frustum, uniform cross-section.
2. Dimension diameter and height for vertical cylinder; diameter and length for
horizontal cylinder; top diameter, bottom diameter and height for conical frustum;
hydraulic diameter, cross-sectional area and height for uniform section, defined in tank
library for user-defined type.
3. Roughness or C-factor: Roughness is used in standard mode and C-factor is used in
spray mode.
4. Initial fluid depth - start value for the initial fluid depth. This is only applicable if the
simulation has a static start (not required for calculating initial steady-state) - in all other
cases the initial fluid depth is calculated automatically based on the inlet pressure of the
tank.
Modelling Equations
Momentum equation:
Modelling
Dimension equations
User-defined type
275
276
Transient Module
Average Hydraulic
Diameter
where:
A is the input cross-sectional area,
Ah is the average area of the liquid column,
Ai, Ai+1 is the input cross area in the tank library
As is the cross-sectional area at the fluid surface,
D is the input diameter,
Dh is the average hydraulic diameter of the liquid column,
Ds is the hydraulic diameter at the fluid surface,
f is the friction factor,
g is the acceleration due to gravity,
H is the tank height,
L is the tank length,
P is the inlet pressure,
Pa is the atmospheric pressure,
Q is the inlet flow rate,
R is the tank radius or bottom radius (conical frustum type),
r is the top radius (conical frustum type),
t is the time,
Vl is the liquid volume in the surge tank,
z is the height of the fluid surface from the bottom of the surge tank,
zi, zi+1 is the input liquid level in the tank library
is the fluid density.
The simulation will stop if the surge tank drains or overflows during the simulation.
Modelling
277
278
Transient Module
Re ce iving Ve sse l - Ve rtical Cylinde r
Modelling
279
Further, as with Surge Tanks IF Dry Pipe option has been activated, and the receiving vessel
drains then the air can flow from the receiving vessel into the network (from the receiving vessel
into a pipe).
User Input Parameters
1. Tank type - vertical cylinder, horizontal cylinder, conical frustum and uniform section
(default), user-defined type.
2. Dimension diameter and height for vertical cylinder; diameter and length for
horizontal cylinder; top diameter, bottom diameter and height for conical frustum;
hydraulic diameter, cross-sectional area and height for uniform section, defined in library
for user-defined type.
3. Roughness or C-factor - roughness is used in the standard mode and C-factor is used
in the spray mode.
4. Initial fluid depth - start value for the initial fluid depth. This is only applicable if the
280
Transient Module
5.
6.
7.
8.
simulation has a static start (not required for calculating an initial steady-state) - in all
other cases, the initial fluid depth is calculated automatically, based on the inlet pressure
of the tank.
Weir crest ignored (default) or considered (only available for uniform section type
tank),
Weir type rectangular; V-notch and user-defined,
Weir dimension width for rectangular and user-defined weir and angle degree for vnotch,
Weir discharge coefficient only for user-defined type weir.
Modelling Equations
Pressure head:
P1
Pa
z dQ1
Ah dt
gz
2f
z Y
Q1 Q1
Dh Ah2
Fluid height:
Case 1:
Case 2:
As
dz
dt
Q1
z max
As
dz
dt
(z < zmax )
(weir crest is ignored and z = zmax )
Q1
Q2
(z < zmax )
Case 2:
z max
Overflow rate:
Case 1:
Q2
(z < zmax )
Case 2:
(z = zmax )
weir crest is ignored
Q2 Q1
weir crest is considered
Modelling
4
2 g bY 1.5
27
Q2
4
Y
1 0.2
27
b
Q2
281
(broad-crested, end
contracted)
Q2
Q2
2
Y
0.61 0.08
3
z max
2 g bY 1.5
2
Y
0.61 0.08
3
z max
1 0.2
2 g bY 1.5
(sharp-crested, end
contracted)
8
2 g tan Y 2.5
15
2
Q2
0.58
Q2
C d 2 g bY 1.5
(V-notch)
(user defined)
Dimension equations
Vl
Vertical cylinder:
D2
z
4
Ds
Vl
R 2 a cos
4 L zD
2 zD
Horizontal cylinder:
Ds
z2
R r
z
H
R r
z
R
H
2 Rz
z2 L
z2
L
Conical frustum
Vl
As
D2
4
R2
As
2 L zD
z2
282
Transient Module
As
R r
Uniform section
z
H
R r
z
H
Ds
2 R
Vl
Az
Ds
As
Vl
z
Dh
4 Ah
where:
A
is the input cross-sectional area.
Ah is the average area of the liquid column.
Ai, Ai+1 is the input cross area in the tank library
AS
b
D
Dh
DS
f
g
H
L
P1
Pa
Q1
Q2
R
r
Modelling
t
Vl
283
is the time.
is the liquid volume in the receiving vessel.
Y
is the weir crest height.
z
is the height of the fluid surface to the bottom of the receiving vessel.
zmax is the height of the receiving vessel.
is the fluid density.
is the V-notch angle.
The simulation will stop if the receiving vessel drains during the simulation.
284
Transient Module
Simple Tank - Horiz ontal Cylinde r
Modelling
Dimension equations
User-defined
where:
AS is the cross-sectional area at the fluid surface,
Ai, Ai+1 is the input cross area in the tank library
D is the input tank hydraulic diameter at the fluid surface,
DS is the hydraulic diameter at the fluid surface,
f is the friction factor,
g is acceleration due to gravity,
H is the tank height,
L is the tank length,
P0 is the tank air pressure,
P1 is the inlet pressure,
P2 is the outlet pressure,
285
286
Transient Module
Modelling
287
Note that the inputs should be checked by the program after the user changes values.
1. The set pressure of the air inlet should be less than or equal to the ambient pressure,
and the set pressure of the air outlet should be greater than or equal to the ambient
pressure.
2. The set pressure of the air inlet should be greater than the vapour pressure.
3. The default values of both set pressures are set as the ambient pressure, and are
displayed at the beginning.
4. The start and end times must both be specified for the option with timer control, and
the end active time must be greater than the start active time. These parameters are not
used for the Standard type.
Modelling Equations
There are two ways that a vacuum breaker can used in a network:-
State 1: P0 > Pin without any air inside the vacuum breaker
No air is sucked into the network, or expelled to the atmosphere.
Pressure:
Flow rate:
288
Transient Module
Mass of air:
Volume of air:
State 2: P0
Pin, or P0
Pout with air inside, or Pin < P0 < Pout with air inside
Air is being sucked into the network, or being expelled to the atmosphere, or both
valves are closed.
Pressure:
Air mass:
Modelling
289
Where:
AC
M0
is the rate of change of the air mass inside the vacuum breaker,
is the mass of the air inside the vacuum breaker,
P1
P2
P0
Pin
Pout
Pa
Q1
Q2
R
T
t1
t2
V0
Y(P0 ,Pa )
290
Transient Module
O ne Node Caisson
Caisson length.
Caisson diameter.
Caisson elevation.
Roughness or C-factor - caisson roughness in the Standard option or Spray option,
Caisson C-factor only in the Spray option.
Initial depth of fluid in the Caisson, measured along the length of the Caisson (see
below).
Critical depth of fluid in the Caisson, measured along the length of the Caisson (see
below).
Diameter of the Caisson air inlet/outlet valve.
Coefficient of discharge of the Caisson air inlet/outlet valve.
At the beginning of a simulation, the fluid in the Caisson has an initial fluid depth, measured along
the Caisson from the inlet.
If, during a simulation, the fluid depth rises to the critical fluid depth then the simulation is
Modelling
291
automatically halted. The simulation can then be continued with the Caisson replaced by a pipe.
Modelling Equations
Fluid in Caisson
Air in Caisson
Volume of air
where:
P1 is the inlet pressure.
P2 is the air pressure.
Q is the flow rate into the Caisson.
Vc is the air volume.
Mc is the mass of air.
T is the air temperature.
R is the gas constant.
z is the height of the fluid surface.
h is the height of the Caisson.
A is the cross-sectional area of the Caisson.
D is the diameter of the Caisson.
f is the friction factor.
a is the angle of inclination of the Caisson from the horizontal.
g is the acceleration due to gravity.
is the fluid density.
The setting of the air inlet/outlet valve must be specified via a specification on the information
node. The air inlet/outlet valve uses the same model as the Vacuum Breaker for calculating air
inflow or outflow.
292
Transient Module
Two-Node Caisson
Modelling
Modelling equations
(A) Half-filled condition:
1. Momentum equation:
dQ1
dt
A
P1
z
P0
2f
Q1 Q1
AD
Ag sin
M0
RT
V0
Q0
SY P0 , Pa
6. Outlet flowrate:
Q2
A P
x
2f
QQ
AD
Ag sin
2. Continuity equation:
293
294
Transient Module
u
A
A
x
1
A
A
t
u
x
P2
Where:
A
D
f
g
h
M0
P
P1
P2
P0
Pa
Q
Q0
Q1
Q2
R
S
T
u
V0
Modelling
295
Y(P0 ,Pa ) is a well-defined function for the air flow through the valve (refer to Vacuum
z
Breaker).
is the height of the fluid surface.
is the angle of the inclination of the Caisson pipe from horizontal.
is the fluid density.
Implementation notes
1. If during the simulation both the height z of the fluid and the inlet flowrate Q1 drop to or below
the respective negative tolerance values, the simulation will stop.
2. The air inlet/outlet valve uses the same model as the Vacuum Beaker for calculating the air
inflow or outflow (discharge).
3. When the user-defined time step renders the caisson pipe to be a short pipe, then the short
pipe model is used. the ambient atmosphere.
Caisson length/height.
Caisson diameter.
Caisson elevation.
Caisson roughness in the Standard or Spray option, Caisson Cfactor in the Spray option.
Initial depth of fluid in the Caisson, measured along the length of
the caisson.
Valve diameter
Diameter of the Caisson air inlet/outlet valve.
Valve coefficient of Coefficient of discharge of the Caisson air inlet/outlet valve.
discharge
Beta factor
A factor for the air inlet/outlet valve, representing the sensitivity
of the valve position to the pressure of air inside the Caisson. Its
default value is 1.
Wave speed
Local wave speed. The default value is the default wave speed
for the network.
296
Transient Module
Two-Node Caisson
Modelling equations
(A) Half-filled condition:
1. Momentum equation:
2.
Air in caisson:
4. Volume of air:
Modelling
7. Outlet flowrate:
Momentum equation:
2. Continuity equation:
Where:
P
P1
297
298
Transient Module
P2
P0
Pa
Q
u
Q1
Q2
Y(P0 ,Pa )
S
M0
V0
R
T
z
h
A
D
f
g
Implementation notes
1. If, during the simulation, both the height z of the fluid and the inlet flowrate Q1 drop to
or below the their respective negative tolerance values, the simulation will stop.
2. If, during the simulation, the height z of the fluid reaches the height h of the Caisson, and
the inner air pressure P0 is greater than or equal to the ambient pressure Pa, the
Caisson will be modelled as a regular (rigorous) pipe.
3. The air inlet/outlet valve uses the same model as the Vacuum Beaker for calculating the
air inflow or outflow (discharge).
4. When the user-defined time step renders the caisson pipe to be a short pipe, the short
pipe model is used.
Modelling
299
where:
P1
P2
Q
K
m
where:
Pref is the reference pressure drop,
Qref
is the reference flow rate.
User-defined type
The resistance factor at the known flow rate and pressure drop can be calculated using
the following equation. The resistance factor at any flow rate can be interpolated using
the above factors.
300
Transient Module
Q < Qmin
The Q-K curve will be extrapolated to the lower flow rate along the constant K
line, with the same K factor at the lower limit point:
Q > Qmax
The Q-K curve will be extrapolated to the higher flow rate along the constant K
line, with the same K factor at the higher limit point:
Modelling
301
Q < Qmin
The Q-K curve will be extrapolated to the lower flow rate along the constant K
line, with the same K factor at the lower limit point:
Q > Qmax
The Q-K curve will be extrapolated to the higher flow rate along the constant K
line, with the same K factor at the higher limit point:
302
Transient Module
Q < Qmin
The Q-K curve will be extrapolated to the lower flow rate along the constant K
line, with the same K factor at the lower limit point:
Q > Qmax
The Q-K curve will be extrapolated to the higher flow rate along the constant K
line, with the same K factor at the higher limit point:
18.41 Nozzle
This is a simple model of a nozzle, which can work at three states: constant open, constant close
and close to open. However, the way Nozzles are defined in Transient Spray and Transient
Standard are slightly different. The reason for this is that Transient Standard is more general,
whereas the Transient Spray option is used for the analysis of fire protection systems in
accordance with either NFPA or FOC rules.
Transient Spray only requires the K-coefficient of the Nozzle (which is the rate at which the
Modelling
303
Modeling Equations:
Nozzle discharge Equation (Transient Spray)
(open state)
Q=0
(close state)
G=0
P
G
Cy
Cd
A
n
(open state)
(close state)
304
Transient Module
In Standard:
Modelling
305
306
Transient Module
The sensor components in Transient Module provide instantaneous readings for pressure or flow
rate. However, in reality, physical sensors have their own dynamics, and their output signal can
take time to react to changes in the input signal.
The transfer function component allows these dynamic effects to be modelled in the Transient
Module. The transfer function can also be used to model the dynamics of the controlled device
(e.g., a valve or pump).
The PID Controller takes an input signal from a sensor and converts it into a control signal for
the device that is to be controlled.
A Switch is available, and can be used to examine the flow rate or pressure at a designated point
in the network.
A Signal selector is also available, and can be used to select the minimum or the maximum of
two input signals. It can also be used to switch between two input signals after a specified time.
18.44 Sensors
Two generic types of sensor are provided: analogue and digital. The modelling for both types is
very similar, and they use the same user interface, the main difference being the presence of an
attribute that indicates whether the sensor is analogue or digital.
Modelling
307
A. Analogue sensors
Sensors are used to take a Pressure, Pressure Difference or Flow-rate reading for the control
system. Pressure is measured at a particular node, Pressure difference is the difference in
pressure between two specified nodes, and Flow rate is measured between two nodes. Sensors
are connected to PID Controllers, either directly or via Transfer Functions.
User Input Parameters
1. If a pressure sensor or a pressure-difference sensor - Input and Output Node.
2. If a flow rate sensor or a pressure-difference sensor - Output info node.
3. Information node for connection to a transfer function or PID Controller.
Modelling Equations
Pressure sensor:
P1 = P2
and
Q1 = Q2 = 0
Pressure difference sensor:
P = P1 - P2
and
Q1 = Q2 = 0
Flow sensor:
P1 = P2
and
Q1 = Q2
where:
P1
P2
Q1
308
Transient Module
Q2
P
B. Digital sensors
Digital sensors are used to simulate the behaviour of discrete data systems. The designed
components include the digital pressure sensor, digital flow sensor and digital differentialpressure sensor.
The digital sensors share the same symbols and interfaces with the conventional (analogue)
sensors. In addition, the digital sensors have a new parameter; namely, the Scan frequency, for
which the unit is 1/time, and the reciprocal of which must be greater than or equal to the time
step.
Input and output
Modelling equations
Pressure sensor:
Modelling
309
Flow sensor:
where:
P
P1
P2
Q1
Q2
t
ti
310
Transient Module
Damping Ratio - represents the damping effect of the transfer function on the
input signal.
Output range (min) - default value 0 for the information output type transfer
function, and unlimited for other types.
Output range (max) - default value 1 for the information output type transfer
function, and is unlimited for other types.
Ramp-up limit - must be positive or unset. Only available for the Limiting
power ramp order option. An unset value indicates that there is no limitation on
the ramp-up rate.
Ramp-down limit - must be negative or unset. Only available for the Limiting
power ramp order option. An unset value indicates that there is no limitation on
the ramp-down rate.
Modelling Equations
Zero Order
where:
x(t) is the input signal.
y(t) is the output signal.
G is the Gain. The gain represents the amplification of the signal.
B is the bias, which represents the offset of the signal.
ymin is the minimum output, which represents the lower limitation of the
signal.
ymax is the maximum output, which represents the upper limitation of the
signal.
First Order
where:
is the time constant. The time constant represents the time delay for the
device to react to changes in its input.
Second Order
Modelling
311
where:
r is the damping ratio. The damping ratio represents the damping effect
of the transfer function on the input signal.
Limiting power ramp
where
u+ is the ramp-up rate.
u- is the ramp-down rate.
312
Transient Module
judged on how quickly they settle down, and on the size of the offset.
P-Controllers are usually the cheapest, but tend to give a non-zero offset.
I-Controllers tend to eliminate the offset, but can introduce oscillations before the signal settles
down. Anti-Windup I-Controllers stop integrating when the controller output hits its limits.
This reduces the oscillations, particularly in situations such as start-up or when large changes
occur.
D-Controllers damp the oscillations, causing the signal to settle down more quickly. Too large a
D-term should be avoided, as this makes the controller very sensitive to measurement noise,
which may result in excessive high frequency controller action.
User Input Parameters
The input node collects signals from a sensor or a transfer function. The Output node sends a
signal to a transfer function or controlled device.
Type - Pressure, Pressure Difference or Flow rate Controller.
Set Point - (ys, us) as defined above.
Controller Type - any combination of P (proportional), I (Integral with or without
Anti-Windup option) and D (differential).
Parameters for PID modelling equations (see below)
Gain,
Reset Time,
Anti-Windup,
Rate Time,
Tracking Time Constant.
Modelling
313
Modelling Equations
Notation:
K is the Gain.
TI is the Reset Time.
TD is the Rate Time.
TT is the Tracking Time Constant.
u, us is the Output and output set point.
y, ys is the Input and input set point (also called reference signal).
The error is defined as:
Anti-Windup
Anti-Windup is modelled by introducing a negative-feedback signal when saturation occurs, the
logic diagram and equation being as follows:
314
Transient Module
where:
v = umin
if u
v= u
if umin
v = umax
if u
umin;
u
umax;
umax.
Her,e u is the calculated output and v is the desired (real) output. TT is the tracking time
constant.
Ideally the tracking time constant, TT , should be larger than the rate time, TD, but smaller than
the reset time, TI. A rule of thumb is to choose TT such that:
Modelling
315
is explicitly provided for TT , any further changes to either TI or TD will not affect the value of TT .
Notes
1. Usually, a negative gain must be chosen to obtain negative (= stable) feedback.
2. Setting TD > TI /4 results in oscillatory behaviour of the controller by itself.
3. The output signal, u, is limited to the range [0,1], except in the case of controllers with
integral (I) term but without the Anti-Windup option.
4. The differential term is bandwidth limited, = 100/TD.
316
Transient Module
Components
Sensor:
Cascade PID Controller:
Transfer function:
Equipment:
Typical applications
Time type controller
Modelling
317
18.48 Switch
A switch is used to examine the pressure, differential pressure or flow rate at a designated point
in the network, or to act as a timer switch. It compares the monitored value at the designated
point with the preset value to decide on the operation (start-up or trip) of the equipment (valve,
pump, etc.).
.
Typical connection
Pressure, differential-pressure and flow type switches
318
Transient Module
Timer switch
Modelling
319
V2).
V2).
320
Transient Module
Notes
1. When considering the flow direction, the setting value can be positive or negative. For
instance, the switch settings are: switch on above -8000 lit/min and switch off below 10000 lit/min, so the switch should be on when the flow rate is -7000 lit/min and off
when the flow rate is -12000 lit/min.
2. When ignoring the flow direction, the setting values must be positive.
Timer type switches
Case 1: switch on above V1 and off below V2 (V1 < V2).
Modelling
321
322
Transient Module
Maximum type
Time switch
where
x1, x2 are the two input signals,
y is the output signal,
t is the time,
t s is the time at which the output is switched from the first input to the second one.
Part
19
324
Transient Module
19
19.1
HP-GL/2 Output
Via the Tools | Export HP-GL/2 menu option, the schematic can be output as a HewlettPackard HP-GL/2 file, with a .hpgl file extension. This type of file can be read by a number of
graphics programs and is commonly used as an offline plotting format. The specifications for the
HP-GL/2 format are provided by [HPGL2].
Errors
Part
20
326
Transient Module
20
Errors
20.1
Errors
Errors can be detected at various points in the opening of an existing network file, or in the
creation of a new network:
Basic errors in the operating environment, the most common error being the absence
of a valid licence to run a PIPENET module, or the absence or incorrect operation of
the security key drivers.
Input errors detected either in reading the main data file or an associated library file.
Specific component errors detected in the GUI when a check operation is
performed; for example, pipe has zero length these errors should be selfexplanatory.
Global errors detected in the graphical user interface (GUI) when a check operation
is performed.
Numerical errors that can only be checked after the calculation starts, and are
therefore reported in the calculator output.
20.2
Basic errors
These are usually related to the absence of a valid licence to run the program or an incorrect
operation of the security key drivers, but other options are also possible:
Attempts to run the software on earlier versions of Windows operating system may fail
the software is only validated for Windows 2000, XP, Vista, and Windows 7.
A working PIPENET system may suddenly stop working if a new operating system is
installed, or if a new Windows service pack is installed. Generally, Sunrise Systems
will discover these errors in advance, and will be able to provide suitable fixes, new
security key drivers, etc.
No valid licence separate licences are available for the three PIPENET modules:
Transient, Spray/Sprinkler and Standard. Attempting to run a module for which you
have no licence will produce an error. To determine which licences you have, refer to
the Help | Key status menu option . If in doubt, contact Sunrise Systems for details
of your current licences.
Licence has expired with the issue of PIPENET VISION 1.10, expiry-date
checking was added to HASP security keys. If an old key is being used, or if the
licence for the module you are attempting to run has expired, then a message will be
displayed informing you of the situation. To see the expiry dates, see the Help | Key
status menu option; if no expiry dates are shown then you have an old key that needs
to be updated. Keys can be updated remotely by Sunrise Systems providing (usually
via email) a small encrypted key-update file see the Updating a key licence section
for further details.
Drivers for security keys not installed correctly see the installation instructions
supplied with the software for information on how to check the status of the drivers
and, if necessary, re-install them. Periodically, the supplier of the security key drivers
Errors
327
will have to issue new versions of the drivers when a new operating system or service
patch is released. When this occurs, Sunrise Systems will make the drivers available
on our website or via email.
20.3
Input errors
Input errors can occur when reading either old .DAT files or library files, or, more rarely, when
reading the newer .SDF data files and SLF library files. These errors should not occur, since
PIPENET wrote the files and they should be correct. However, with the older .DAT files and
library files, some users would edit the file directly using a simple text editor, and this could result
in errors. With the newer file formats (which can still be opened in a simple text editor), it is not
expected that users will directly edit the files.
One error that may occur with both the old and new types of file is that one of the library files
referenced by the main data file may be missing. In earlier versions of PIPENET, this could
occur if the .DAT file and the associated library files were moved to a new location, since the .
DAT file would contains references to the library files in their original location. With PIPENET
VISION, if a library file cannot be found in its original location, a search will be made in the
directory where the main data file (.SDF file) is located.
20.4
Global errors
These are errors detected when a check is performed, and which relate either to the network as
a whole or to some section of the network. For the Transient module, the following errors are
possible, classified as errors, warnings or information:
A library <component> must be defined error
User defined pumps and turbo pumps are not allowed. One of these components exists
in the network, but there is no library item defined.
At least one pipe type must be defined error
If the Spray option has been requested then all pipes must belong to a pipe type;
therefore, at least one pipe type must have been defined.
Calculator does not permit a mixture of scheduled and non-scheduled pipes
error
In Standard mode, all pipes must belong to a pipe type or no pipes must belong to a
pipe type, and the calculator does not permit a mixture of scheduled and non-scheduled
pipes.
Height discrepancy discovered at node error
Pipe elevations are being used, and, in checking a loop, an error has been discovered;
that is, the sum of all elevations in the loop does not sum to zero. Double-clicking on this
item will highlight the loop in error in the schematic. For further information see the
height checking section.
328
Transient Module
I/O node must be on a single pipe when using variable fluid properties and
volumetric flow rate - error
An input or output node must only be connected to one pipe when using variable fluid
properties and volumetric flow rate.
Info node has more than two attached components error
Information nodes must have two and only two attached components, where a
component may be a PID controller, switch, etc., or a specification.
Linear Network: Pressure envelope available - information
The network is linear and, therefore, a pressure envelope can be produced.
Network is empty error
Network contains no components, and there is therefore nothing to calculate.
Network is over specified in analysis phase - error
There are too many specifications in the analysis phase; that is, the number of
specifications and number of input/output nodes do not meet the specification
requirements.
Network is under specified in analysis phase error
There are insufficient specifications in the analysis phase; that is, the number of
specifications and number of input/output nodes do not meet the specification
requirements.
Network must have at least one inlet - warning
The network must have at least one inlet.
Network must have outlets or nozzles error
The network must have one or more outlets.
No analysis phase pressure specification error
At least one pressure specification must be provided for the analysis phase see
specifications requirements.
Node has less than 2 attached components error
Every node must have at least two attached components, where a component may be a
pipe, a pump, a valve, etc., or a specification.
This node may need to declared as an input node - warning
This warning message will appear for each node that has a single pipe that uses the node
as an input, but there is no pipe that uses the node as an output. That is, there appears to
be flow out of the node but there is no flow into the node.
This node may need to declared as an output node - warning
This warning message will appear for each node that has a single pipe that uses the node
Errors
329
as an output, but there is no pipe that uses the node as an input. That is, there appears to
be flow into the node but there is no flow out of the node..
Non-Linear Network: Pressure envelope not available - information
The network is non-linear; that is, there are one or more pipes in branches and,
therefore, a pressure envelope cannot be produced.
No pressure specifications defined error
No pressure specification has been provided.
No rigorous pipe - error
A user-defined time step has been specified and all normal pipes in the network are
classed as short, given this time step (that is, for all normal pipes, length < time step *
wave speed). To correct this, the user should either decrease the time step or increase
the length of a pipe.
Part of the network is disconnected error
The network is disconnected; that is, the network is separated into two or more
unconnected sections.
Pipe type <pipe-type-name> has a lining that is too thick error
The named pipe type has a lining with a thickness that is greater than or equal to half the
smallest used bore.
Pump is not protected against flow reversal - warning
The pump is not protected against flow reversal, and so a non-return valve should be
placed after the pump.
Specification is on a non-boundary flow node - error
A specification has been provided for a node that is not a boundary (input or output)
node.
There must be at least two specifications - error
There must be at least two specifications provided for the analysis phase see
specifications requirements.
20.5
330
Transient Module
breakers).
Flow coefficient must be given (bursting valves).
Equipment description must be given (equipment items).
Note that many of these errors are of the general form <attribute name> must be given, as in
the last two examples above, indicating that a value for the attribute has not been provided.
Double-clicking on the error in the Check status dialog will highlight the component in the
schematic.
20.6
Numerical errors
There is a general category of errors that cannot be detected in the GUI, as they can only be
checked by the calculator, either in setting up the calculation or during the calculation itself. For
example:
If the initial fluid depth of a caisson is zero, and the downstream pressure is less than
the pressure inside the caisson when the calculation starts, then the air inside the
caisson will be expelled into the network.
The simulation will stop if a simple tank drains.
The simulation will stop if a simple tank overflows.
The simulation will stop if the flow rate into the top of a tank goes negative.
Also, note that, when you request a calculation, a check is performed first, and any errors or
warnings are displayed in the check status dialog.
Reference Data
Part
21
332
Transient Module
21
Reference Data
21.1
Bibliography
[CRANE]
Technical paper No. 410M, "Flow of Fluids Through Valves, Fittings and pipe",
Crane Co., 1988.
[ARDT]
"Fluid Transients in Pipeline Systems", A.R.D. Thorley, D & L George, Herts.,
England, 1991.
[WANDS]
1993.
[DANIEL]
[API]
[HPGL2]
1997.
"The HP-GL/2 and HPRTL Reference Guide", Third edition, Addison Wesley,
[ACAD06]
[NFPA13]
NFPA 13, "Standard for the Installation of Sprinkler Systems", NFPA 2007.
[NFPA15]
NFPA 15, "Standard for Water Spray Fixed Systems for Fire Protection",
NFPA 2007.
21.2
Surface Roughness
The following table shows values of surface roughness for typical materials. These values have
been obtained from a number of sources, and are not endorsed by Sunrise Systems Limited.
Material
Roughness
(mm)
(inch)
Asbestos Cement
0.015 0.06
Brass
0.001 to 0.003
Cement smoothed
0.3
1.18 10-2
Concrete - ordinary
0.6 - 1.5
Reference Data
Material
Roughness
(mm)
(inch)
Concrete precast
0.06 0.6
Concrete coarse
0.3 5.0
Copper
0.001 to 0.003
0.03 0.06
Lead
0.001 to 0.003
0.0015 0.007
New - unlined
0.25 to 0.8
Worn
0.8 to 1.5
Rusty
1.5 to 2.5
Asphalted
0.12
4.72 10-3
Stainless
0.015
5.91 10-4
0.0015
5.91 10-5
Commercial pipe
0.045 to 0.09
Stretched
0.015
5.91 10-4
Riveted
1.0 to 9.00
Welded
0.045
1.77 10-3
Galvanized
0.15
5.91 10-2
Rusted
0.1 1.0
Cast iron
Steel
333
334
Transient Module
When a range of values is provided, the lower value is for new pipes and the upper value is for
old pipes. When a single value is quoted, this is for new pipes. Unfortunately, there is no single
source for the above data, and the data has been compiled from a number of sources, including:
1.
2.
3.
4.
21.3
Hazen-Williams Coefficients
The following table provides guidance and suggested values for C-factors. These values have
been obtained from a number of sources and are not endorsed by Sunrise Systems Limited.
Material
C-factor
Possible values
Suggested value
(NFPA13)
Asbestos Cement
140 - 150
140
Brass
120 - 150
100
100
120
120
New unlined
120 - 130
100
10 years old
105 - 75
15 years old
100 60
20 years old
95 55
30 years old
85 45
50 years old
75 - 40
Bitumen-lined
140
Cement-lined
140
140
Concrete
85 - 150
140
Copper
120 - 150
150
Cast iron
Reference Data
Material
335
C-factor
Possible values
Suggested value
(NFPA13)
150 - 160
135
Galvanized steel
120
Lead
130 - 150
Polyethylene
150
150
150
Stainless steel
150
150
140 - 150
100
Vitrified clays
110
120
When a range of values is provided, the smoother value (higher C-factor) is for new pipes and
the lower value for old pipes. When a single value is quoted, this is for new pipes. Unfortunately,
there is no single source for the above data, and the data has been compiled from a number of
sources, including:
1.
2.
3.
4.
21.4
Physical Constants
All values are SI.
Atmospheric Pressure
Acceleration due to gravity
0 C
101325 Pascal
9.80665 ms-2
273.15 Kelvin
336
21.5
Transient Module
Reference Data
Epoxy
Fittings
Fittings K-Factor Values
Values for Entry and Exit to Large Cell or Pipe
Equivalent Lengths of Fittings for NFPA Rules
Equivalent Lengths of Fittings for FOC Rules
337
338
21.6
Transient Module
Outside Diameter
mm
in
342.9
393.7
444.5
495.3
596.9
695.452
746.252
797.052
847.852
358.14
406.4
457.2
508
609.6
711.2
762
812.8
863.6
13.5
15.5
17.5
19.5
23.5
27.38
29.38
31.38
33.38
14.1
16
18
20
24
28
30
32
34
Reference Data
21.7
Outside Diameter
mm
in
206.502
260.35
311.15
339.852
390.652
441.452
488.95
590.55
685.8
736.6
787.4
838.2
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
711.2
762
812.8
863.6
8.13
10.25
12.25
13.38
15.38
17.38
19.25
23.25
27
29
31
33
8.63
10.75
12.75
14
16
18
20
24
28
30
32
34
339
340
21.8
Transient Module
Outside Diameter
mm
in
204.978
257.556
307.086
336.55
387.35
435.102
482.6
581.152
679.45
730.25
781.05
831.85
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
711.2
762
812.8
863.6
8.07
10.14
12.09
13.25
15.25
17.13
19
22.88
26.75
28.75
30.75
32.75
8.63
10.75
12.75
14
16
18
20
24
28
30
32
34
Reference Data
21.9
Outside Diameter
mm
in
13.716
0.54
12.446
15.748
0.49
0.62
17.145
21.336
0.675
0.84
20.828
26.67
35.052
40.894
52.578
62.378
77.978
90.17
102.362
128.27
154.178
202.692
254.508
304.8
336.55
387.35
438.15
488.95
590.55
0.82
1.05
1.38
1.61
2.07
2.47
3.07
3.55
4.03
5.05
6.07
7.98
10.02
12
13.25
15.25
17.25
19.25
23.25
26.67
33.401
42.164
48.26
60.325
73.025
88.9
101.6
114.3
141.3
168.275
219.075
273.05
323.85
355.6
406.4
457.2
508
609.6
1.05
1.315
1.66
1.9
2.375
2.875
3.5
4
4.5
5.563
6.625
8.625
10.75
12.75
14
16
18
20
24
742.95
793.75
844.55
29.25
31.25
33.25
762
812.8
863.6
30
32
34
341
342
Transient Module
Outside Diameter
mm
in
13.716
0.54
12.5222
15.748
0.493
0.62
17.145
21.336
0.675
0.84
20.828
26.67
35.052
40.894
52.578
62.738
77.978
90.17
102.362
128.27
154.178
202.692
254.508
303.276
333.502
381
428.752
477.774
574.802
676.402
723.9
777.748
828.548
0.82
1.05
1.38
1.61
2.07
2.47
3.07
3.55
4.03
5.05
6.07
7.98
10.02
11.94
13.13
15
16.88
18.81
22.63
26.63
28.5
30.62
32.62
26.67
33.528
42.164
48.26
60.452
73.152
88.9
101.6
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
711.2
762
812.8
863.6
1.05
1.32
1.66
1.9
2.38
2.88
3.5
4
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
28
30
32
34
Reference Data
Outside Diameter
mm
in
198.374
247.65
295.402
325.374
373.126
419.1
466.852
560.324
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
7.81
9.75
11.63
12.81
14.69
16.5
18.38
22.06
8.63
10.75
12.75
14
16
18
20
24
343
344
Transient Module
Outside Diameter
mm
in
13.716
0.54
10.668
13.87
0.42
0.55
17.145
21.336
0.675
0.84
18.796
24.384
32.512
38.1
49.276
58.928
73.66
85.344
97.282
122.174
146.304
193.675
247.65
298.45
330.2
381
431.8
482.6
584.2
0.74
0.96
1.28
1.5
1.94
2.32
2.9
3.36
3.83
4.81
5.76
7.625
9.75
11.75
13
15
17
19
23
26.67
33.401
42.164
48.26
60.325
73.025
88.9
101.6
114.3
141.3
168.275
219.075
273.05
323.85
355.6
406.4
457.2
508
609.6
1.05
1.315
1.66
1.9
2.375
2.875
3.5
4
4.5
5.563
6.625
8.625
10.75
12.75
14
16
18
20
24
736.6
787.4
838.2
29
31
33
762
812.8
863.6
30
32
34
Reference Data
Outside Diameter
mm
in
13.716
0.54
10.7442
13.97
0.423
0.55
17.145
21.336
0.675
0.84
18.796
24.384
35.052
38.1
49.276
58.928
73.66
85.344
97.282
122.174
146.304
193.802
242.824
289.052
317.5
363.474
409.702
455.676
547.624
0.74
0.96
1.38
1.5
1.94
2.32
2.9
3.36
3.83
4.81
5.76
7.63
9.56
11.38
12.5
14.31
16.13
17.94
21.56
26.67
33.528
42.164
48.26
60.452
73.152
88.9
101.6
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
1.05
1.32
1.66
1.9
2.38
2.88
3.5
4
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
345
346
Transient Module
Outside Diameter
mm
in
188.976
236.474
280.924
308.102
354.076
398.526
442.976
531.876
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
7.44
9.31
11.06
12.13
13.94
15.69
17.44
20.94
8.63
10.75
12.75
14
16
18
20
24
Reference Data
Outside Diameter
mm
in
92.202
115.824
139.7
182.626
230.124
273.05
299.974
344.424
387.35
431.8
517.652
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
3.63
4.56
5.5
7.19
9.06
10.75
11.81
13.56
15.25
17
20.38
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
347
348
Transient Module
Outside Diameter
mm
in
177.8
222.25
266.7
292.1
333.502
377.952
419.1
504.952
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
7
8.75
10.5
11.5
13.13
14.88
16.5
19.88
8.63
10.75
12.75
14
16
18
20
24
Reference Data
Outside Diameter
mm
in
11.938
0.47
21.336
0.84
15.494
20.828
0.61
0.82
26.67
33.528
1.05
1.32
34.036
42.926
54.102
66.802
1.34
1.69
2.13
2.63
48.26
60.452
73.152
88.9
1.9
2.38
2.88
3.5
87.376
109.474
131.826
172.974
215.9
257.302
284.226
325.374
315.976
407.924
490.474
3.44
4.31
5.19
6.81
8.5
10.13
11.19
12.81
12.44
16.06
19.31
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
349
350
Transient Module
Outside Diameter
mm
in
18.034
0.71
21.336
0.84
23.368
30.226
38.862
44.958
56.896
68.834
84.582
97.282
109.982
135.89
162.814
213.614
266.192
315.976
347.726
398.018
448.818
498.348
598.424
700.024
749.3
800.1
850.9
0.92
1.19
1.53
1.77
2.24
2.71
3.33
3.83
4.33
5.35
6.41
8.41
10.48
12.44
13.69
15.67
17.67
19.62
23.56
27.56
29.5
31.5
33.5
26.67
33.528
42.164
48.26
60.452
73.152
88.9
101.6
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
711.2
762
812.8
863.6
1.05
1.32
1.66
1.9
2.38
2.88
3.5
4
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
28
30
32
34
Reference Data
Outside Diameter
mm
in
6.35
0.25
21.336
0.84
10.922
15.24
22.86
27.94
38.1
44.958
58.42
0.43
0.6
0.9
1.1
1.5
1.77
2.3
26.67
33.401
42.164
48.26
60.325
73.025
88.9
1.05
1.32
1.66
1.9
2.38
2.88
3.5
80.01
103.124
124.46
174.752
222.25
273.05
3.15
4.06
4.9
6.88
8.75
10.75
114.3
141.3
168.275
219.075
273.05
323.85
4.5
5.56
6.63
8.63
10.75
12.75
351
352
Transient Module
Outside Diameter
mm
in
13.716
0.54
13.843
17.018
0.545
0.67
17.145
21.336
0.675
0.84
22.352
27.94
32.6268
42.672
54.864
66.802
82.804
95.504
108.204
134.62
161.544
211.582
264.668
314.706
345.948
396.748
447.548
496.824
596.9
0.88
1.1
1.442
1.68
2.16
2.63
3.26
3.76
4.26
5.3
6.36
8.33
10.42
12.39
13.62
15.62
17.62
19.56
23.5
26.67
33.528
42.164
48.26
60.452
73.152
88.9
101.6
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
1.05
1.32
1.66
1.9
2.38
2.88
3.5
4
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
746.252
29.38
762
30
Reference Data
Outside Diameter
mm
in
13.716
0.54
12.5222
15.748
0.493
0.62
17.145
21.336
0.675
0.84
20.828
26.67
35.052
40.894
52.578
62.738
77.978
90.17
102.362
128.27
154.178
202.692
254.508
304.8
336.55
387.35
438.15
488.95
590.55
692.15
742.95
793.75
844.55
0.82
1.05
1.38
1.61
2.07
2.47
3.07
3.55
4.03
5.05
6.07
7.98
10.02
12
13.25
15.25
17.25
19.25
23.25
27.25
29.25
31.25
33.25
26.67
33.528
42.164
48.26
60.452
73.152
88.9
101.6
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
711.2
762
812.8
863.6
1.05
1.32
1.66
1.9
2.38
2.88
3.5
4
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
28
30
32
34
353
354
Transient Module
Outside Diameter
mm
in
13.716
0.54
10.7442
13.97
0.423
0.55
17.145
21.336
0.675
0.84
18.796
24.384
32.4612
38.1
49.276
58.928
73.66
85.344
97.282
122.174
146.304
193.802
247.65
298.45
330.2
381
431.8
482.6
584.2
685.8
736.6
787.4
838.2
0.74
0.96
1.278
1.5
1.94
2.32
2.9
3.36
3.83
4.81
5.76
7.63
9.75
11.75
13
15
17
19
23
27
29
31
33
26.67
33.528
42.164
48.26
60.452
73.152
88.9
101.6
114.3
141.224
168.402
219.202
273.05
323.85
355.6
406.4
457.2
508
609.6
711.2
762
812.8
863.6
1.05
1.32
1.66
1.9
2.38
2.88
3.5
4
4.5
5.56
6.63
8.63
10.75
12.75
14
16
18
20
24
28
30
32
34
Reference Data
Outside Diameter
mm
in
6.35
0.25
21.336
0.84
10.922
15.24
0.43
0.6
26.67
33.528
1.05
1.32
27.94
38.1
44.958
58.42
69.342
80.01
103.124
124.46
174.752
222.25
273.05
323.85
1.1
1.5
1.77
2.3
2.73
3.15
4.06
4.9
6.88
8.75
10.75
12.75
48.26
60.452
73.152
88.9
101.6
114.3
141.224
168.402
219.202
273.05
323.85
355.6
1.9
2.38
2.88
3.5
4
4.5
5.56
6.63
8.63
10.75
12.75
14
355
356
Transient Module
Outside Diameter
mm
in
342.801
393.601
444.401
495.201
596.801
355.6
406.4
457.2
508
609.6
13.4961
15.4961
17.4961
19.4961
23.4961
14
16
18
20
24
Reference Data
Outside Diameter
mm
in
54.1
67.3001
80.0999
92.6
104.5
129.6
154.2
203.5
254.599
305.699
339.801
390.601
441.401
489.001
590.601
60.5
76.3001
89.0999
101.6
114.3
139.8
165.2
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
2.12992
2.64961
3.15354
3.64567
4.11417
5.10236
6.07087
8.01181
10.0236
12.0354
13.378
15.378
17.378
19.252
23.252
2.38189
3.00394
3.50787
4
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
14
16
18
20
24
357
358
Transient Module
Outside Diameter
mm
in
202.3
251.8
301.701
336.601
387.401
435
482.6
581
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
7.96457
9.91339
11.878
13.252
15.252
17.126
19
22.874
8.51575
10.5276
12.5394
14
16
18
20
24
Reference Data
Outside Diameter
mm
in
16.1
21.4
27.2001
35.5001
41.2001
52.6999
65.9
78.0999
90.2
102.3
126.6
151
199.9
248.8
287.899
333.4
381
428.6
477.799
574.599
21.7
27.2001
33.9999
42.6999
48.6001
60.5
76.3001
89.0999
101.6
114.3
139.8
165.2
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
0.63385
0.84252
1.07087
1.39764
1.62205
2.0748
2.59449
3.0748
3.55118
4.02756
4.98425
5.94488
7.87008
9.79528
11.7283
13.126
15
16.874
18.811
22.622
0.85433
1.07087
1.33858
1.6811
1.91339
2.38189
3.00394
3.50787
4
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
14
16
18
20
24
359
360
Transient Module
Outside Diameter
mm
in
15.3
20.4
26.2001
33.7
39.6001
50.999
64.3001
75.9
87.6
100.1
123.6
146.6
195.7
242
289.9
325.399
372.999
419.199
466.801
560.4
21.7
27.2001
33.9999
42.6999
48.6001
60.5
76.3001
89.0999
101.6
114.3
139.8
165.2
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
0.60236
0.80315
1.0315
1.32677
1.55906
1.99606
2.5315
2.98819
3.44882
3.94094
4.86614
5.77165
7.70472
9.52756
11.4134
12.811
14.685
16.5039
18.378
22.063
0.85433
1.07087
1.33858
1.6811
1.91339
2.38189
3.00394
3.50787
4
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
14
16
18
20
24
Reference Data
Outside Diameter
mm
in
14.3
19.4
25
32.9001
38.4
49.5
62.3001
73.9
85.3999
97.0999
120.8
143.2
190.9
237.2
283.7
317.599
363.601
409.6
455.6
547.601
21.7
27.2001
33.9999
42.6999
48.6001
60.5
76.3001
89.0999
101.6
114.3
139.8
165.2
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
0.56299
0.76378
0.98425
1.29528
1.51181
1.94882
2.45276
2.90945
3.3622
3.82283
4.75591
5.6378
7.51575
9.33858
11.1693
12.5039
14.315
16.126
17.937
21.5591
0.85433
1.07087
1.33858
1.6811
1.91339
2.38189
3.00394
3.50787
4
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
14
16
18
20
24
361
362
Transient Module
Outside Diameter
mm
in
186.1
231
275.699
308
354
398.399
442.999
531.8
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
7.32677
9.09449
10.8543
12.126
13.937
15.685
17.4409
20.937
8.51575
10.5276
12.5394
14
16
18
20
24
Reference Data
Outside Diameter
mm
in
92.0999
114.4
136.6
179.9
224.6
267.701
299.999
344.599
387.401
431.8
517.601
114.3
139.8
165.2
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
3.62598
4.50394
5.37795
7.08268
8.84252
10.5394
11.811
13.5669
15.252
17
20.378
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
14
16
18
20
24
363
364
Transient Module
Outside Diameter
mm
in
175.1
216.6
261.3
292.001
333.4
377.8
419.199
504.8
216.3
267.401
318.501
355.6
406.4
457.2
508
609.6
6.8937
8.52756
10.2874
11.4961
13.126
14.874
16.5039
19.874
8.51575
10.5276
12.5394
14
16
18
20
24
Reference Data
Outside Diameter
mm
in
12.3
16.2
21.2
29.9
34.4
43.1
57.3
66.9
76.2
87.3
108
128.8
170.3
210.2
251.9
284.2
325.4
366.8
408.0
490.6
21.7
27.2
34.0
42.7
48.6
60.5
76.3
89.1
101.6
114.3
139.8
165.2
216.3
267.4
318.5
355.6
406.4
457.2
508.0
609.6
0.4843
0.6378
0.8346
1.1772
1.3543
1.6969
2.2559
2.6339
3.0000
3.4370
4.2520
5.0709
6.7047
8.2756
9.9173
11.189
12.811
14.441
16.063
19.315
0.8543
1.0709
1.3386
1.6811
1.9134
2.3819
3.0039
3.5079
4.0000
4.5000
5.5039
6.5039
8.5158
10.5276
12.5394
14
16
18
20
24
365
366
Transient Module
Outside Diameter
mm
in
30.7
1.20866
33.9999
1.33858
57.2
2.25197
60.5
2.38189
84.9
3.34252
89.0999
3.50787
110.1
134.2
159.6
210.7
260.599
310.5
4.33465
5.28346
6.28346
8.29528
10.2598
12.2244
114.3
139.8
165.2
216.3
267.401
318.501
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
Reference Data
Outside Diameter
mm
in
28.4
1.11811
33.999
1.33858
54.9001
2.16142
60.5
2.38189
83.0999
3.27165
89.0999
3.50787
108.3
133
158.4
208.3
259.4
309.499
4.26378
5.23622
6.23622
8.20079
10.2126
12.185
114.3
139.8
165.2
216.3
267.401
318.501
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
367
368
Transient Module
Outside Diameter
mm
in
27.9999
1.10236
33.9999
1.33858
53.5
2.1063
60.5
2.38189
81.0999
3.19291
89.0999
3.50787
106.3
129.8
155.2
203.3
254.399
305.501
4.18504
5.11024
6.11024
8.00394
10.0157
12.0276
114.3
139.8
165.2
216.3
267.401
318.501
4.5
5.50394
6.50394
8.51575
10.5276
12.5394
Reference Data
Outside Diameter
mm
in
17.3
22.3
28.5001
37.2001
43.1
54.5
70.3001
82.5
0.68110
0.87795
1.12205
1.46457
1.69685
2.14567
2.76772
3.24803
21.3
26.9001
33.7
42.4
48.2999
60.3001
76.0999
88.9
0.83858
1.05906
1.32677
1.66929
1.90157
2.37402
2.99606
3.5
107.1
131.7
159.3
206.5
260.401
309.7
339.601
389.001
4.21654
5.18504
6.27165
8.12992
10.252
12.1929
13.3701
15.315
114.3
139.7
168.3
219.1
272.999
323.901
355.6
406.601
4.5
5.5
6.62598
8.62598
10.748
12.752
14
16.0079
486.001
584.599
696.999
19.1339
23.0157
27.4409
508
609.6
711.2
20
24
28
796.801
31.3701
812.8
32
369
370
Transient Module
Outside Diameter
mm
in
21.4
0.8435
26.9
1.0595
33.8
1.331
42.5
1.672
48.4
1.904
60.3
2.374
76.0
2.9915
88.8
3.4965
103.3
128.85
154.3
200.0
250.0
300.0
114.1
139.65
165.1
200.0
250.0
300.0
4.0675
5.0725
6.075
8.0
10.0
12.0
4.4915
5.4965
6.499
8.0
10.0
12.0
Notes
1. Internal and outside diameters are arithmetic means of values given in BS.1387 (1967).
2. Nominal sizes have been used for internal and outside diameters for pipes in the range
200-300mm (8-12 inch) for users' convenience. This data is not part of BS.1387.
Reference Data
371
Outside Diameter
mm
in
21.4
0.8435
26.9
1.0595
33.8
1.331
42.5
1.672
48.4
1.904
60.3
2.374
76.0
2.9915
88.8
3.4965
105.1
129.95
155.4
200.0
250.0
300.0
114.1
139.65
165.1
200.0
250.0
300.0
4.1395
5.1125
6.115
8.0
10.0
12.0
4.4915
5.4965
6.499
8.0
10.0
12.0
Notes
1. Internal and outside diameters are arithmetic means of values given in BS.1387 (1967).
2. Nominal sizes have been used for internal and outside diameters for pipes in the range
200-300mm (8-12 inch) for users' convenience. This data is not part of BS.1387.
Outside Diameter
mm
in
372
Transient Module
15
20
25
32
40
50
65
80
90
100
125
150
200
250
300
350
400
450
500
600
700
750
800
850
900
0.5
0.75
1.0
1.25
1.5
2.0
2.5
3.0
3.5
4.0
5.0
6.0
8.0
10.0
12.0
14.0
16.0
18.0
20.0
24.0
28.0
30.0
32.0
34.0
36.0
15.76
20.96
26.64
35.08
40.94
52.48
62.68
77.92
90.12
102.26
128.2
154.08
202.74
254.56
303.28
333.34
381.0
428.46
477.82
575.04
0.622
0.824
1.049
1.38
1.61
2.067
2.469
3.068
3.548
4.026
5.047
6.065
7.981
10.02
11.938
13.124
15
16.876
18.812
22.624
21.3
26.7
33.4
42.2
48.3
60.3
73.0
88.9
101.6
114.3
141.3
168.3
219.1
273.1
323.9
355.6
406.4
457.0
508.0
610.0
0.84
1.05
1.315
1.66
1.9
2.375
2.875
3.5
4
4.5
5.563
6.625
8.625
10.75
12.75
14.0
16.0
18.0
20.0
24.0
Notes
1. Internal and outside diameters are arithmetic means of values given in BS.1387 (1967).
2. Nominal sizes have been used for internal and outside diameters for pipes in the range
200-300mm (8-12 inch) for users' convenience. This data is not part of BS.1387.
Reference Data
373
Outside Diameter
mm
in
21.3
0.84
26.7
1.05
33.4
1.315
42.2
1.66
48.3
1.9
60.3
2.375
73.0
2.875
88.9
3.5
101.6
4.0
114.3
4.5
141.3
5.563
168.3
6.625
219.1
8.625
273.1
10.75
323.9
12.75
355.6
14.0
406.4
16.0
457.0
18.0
508.0
20.0
610.0
24.0
Notes
1. Internal and outside diameters are arithmetic means of values given in BS.1387 (1967).
2. Nominal sizes have been used for internal and outside diameters for pipes in the range
200-300mm (8-12 inch) for users' convenience. This data is not part of BS.1387.
374
Transient Module
Outside Diameter
mm
in
37.65
42.95
53.85
67.15
79.2
1.481
1.692
2.12
2.644
3.118
42.25
48.25
60.35
75.35
88.9
1.663
1.9
2.376
2.967
3.5
101.7
124.9
149.75
197.5
246.1
291.95
320.4
366.5
412.2
4.004
4.918
5.895
7.775
9.689
11.495
12.6145
14.4285
16.2275
114.3
140.2
168.25
219.1
273.0
323.85
355.5
406.4
457.2
4.5
5.5201
6.624
8.6260
10.748
12.75
13.996
16.0
18.0
Notes
1. Internal and outside diameters are arithmetic means of values given in BS.3505 (1968).
2. BS.3505 does not include metric nominal sizes; however, these have been retained for
users' convenience.
Reference Data
375
Outside Diameter
mm
in
80.772
3.18
95.504
3.76
106.172
132.588
158.496
210.312
262.128
319.024
370.84
422.656
474.472
526.288
629.412
4.18
5.22
6.24
8.28
10.32
12.56
14.6
16.64
18.68
20.72
24.78
121.92
149.86
177.292
232.156
286.004
345.44
399.288
453.136
506.984
560.324
667.004
4.8
5.9
6.98
9.14
11.26
13.6
15.72
17.84
19.96
22.06
26.26
Notes
1. Imperial sizes taken from BS.1211 (1958).
2. This standard does not include metric nominal sizes; however, these have been retained
for users' convenience.
376
Transient Module
Outside Diameter
mm
in
16.0
0.6299
25.0
0.9843
30.0
1.1811
38.0
1.4961
44.5
1.752
57.0
2.2441
72.1
83.9
103.0
2.8386
3.3031
4.0551
76.1
88.9
108.0
2.9961
3.5
4.252
154.0
212.1
259.0
313.9
357.0
407.0
443.2
493.0
592.0
6.063
8.3504
10.1969
12.3583
14.0551
16.0236
17.4488
19.4094
23.3071
159.0
219.1
267.0
323.9
368.0
419.0
457.2
508.0
610.0
6.2598
8.6260
10.5118
12.752
14.4882
16.4961
18.0
20.0
24.0157
Notes
1. Outside diameters to BS.2871, Part 2, Table 3; BSMA 18, Table 2; BSMA 60. Wall
thicknesses conform to Lloyds offshore requirements.
2. Imperial sizes are direct conversions of metric data.
3. Nominal sizes are included for users' convenience.
Reference Data
377
in
0.5
0.75
1.0
1.25
1.5
2.0
2.5
3.0
3.5
4.0
5.0
6.0
8.0
10.0
12.0
14.0
16.0
18.0
20.0
24.0
28.0
30.0
32.0
34.0
36.0
in
0.5512
0.8661
1.063
1.378
1.6339
2.126
Outside
Diameter
mm
16.0
25.0
30.0
38.0
44.5
57.0
in
0.6299
0.9843
1.1811
1.4961
1.752
2.2441
72.1
83.9
103.0
2.8386
3.3031
4.0551
76.1
88.9
108.0
2.9961
3.5
4.252
152.0
210.1
256.0
309.9
352.0
401.0
438.2
486.0
584.0
5.9843
8.2717
10.0787
12.2008
13.8583
15.7874
17.252
19.1339
22.9921
159.0
219.1
267.0
323.9
368.0
419.0
457.2
508.0
610.0
6.2598
8.6260
10.5118
12.752
14.4882
16.4961
18.0
20.0
24.0157
Notes
1. Outside diameters to BS.2871, Part 2, Table 3; BSMA 18, Table 2; BSMA 60. Wall
thicknesses conform to Lloyds offshore requirements.
2. Imperial sizes are direct conversions of metric data.
3. Nominal sizes are included for users' convenience.
378
Transient Module
Concrete
Asbestos
Epoxy
K-Factor
0.75
90 Bend
180o Bend; Close return
T (STAND Along run) Branch blanked off
T used as Pipe entering run or entering branch
Gate Valve - Open
Diaphragm - Open
Globe Valve - Open
1.50
0.40
1.00
0.17
2.30
6.00
0.0
0.2
0.4
0.6
0.8
1.0
0.50
0.45
0.36
0.21
0.07
0.00
Reference Data
379
380
Transient Module
1
2
3
4
5
6
7
8
9
45 Screwed Elbow
90 Screwed Elbow
(Standard)
90 Welded Elbow
(Long Radius)
Screwed Tee or Cross
(Flow turned 90)
Gate Valve
(Straightway)
Alarm or Non-Return
Valve (Swinging)
Alarm or Non-Return
Valve (Mushroom)
Globe Valve
(Straightway)
Butterfly Valve
1
2
3
4
5
6
7
8
9
45 Screwed Elbow
90 Screwed Elbow
(Standard)
90 Welded Elbow
(Long Radius)
Screwed Tee or Cross
(Flow turned 90)
Gate Valve
(Straightway)
Alarm or Non-Return
Valve (Swinging)
Alarm or Non-Return
Valve (Mushroom)
Globe Valve
(Straightway)
Butterfly Valve
25.0
1.0
0.4
0.77
32.0
1.25
0.55
1.04
40.0
1.5
0.66
1.22
0.3
0.3
0.36
0.49
0.56
1.25
1.25
1.54
2.13
2.44
0.38
0.38
0.38
0.38
0.38
2.42
2.42
2.42
2.42
2.42
12.08
12.08
12.08
12.08
12.08
16.43
16.43
16.43
16.43
16.43
2.19
2.19
2.19
2.19
2.19
80.0
3.0
1.27
2.37
90.0
3.5
1.44
2.71
100.0
4.0
1.61
3.04
0.69
0.88
1.1
1.26
1.43
2.91
3.81
4.75
5.42
6.1
0.38
0.51
0.63
0.72
0.81
2.42
3.18
3.94
4.5
5.07
12.08
18.91
19.71
22.54
25.36
16.43
21.64
26.8
30.64
34.48
2.19
2.86
3.55
4.06
4.56
Reference Data
1
2
3
4
5
6
7
8
9
45 Screwed Elbow
90 Screwed Elbow
(Standard)
90 Welded Elbow
(Long Radius)
Screwed Tee or Cross
(Flow turned 90)
Gate Valve
(Straightway)
Alarm or Non-Return
Valve (Swinging)
Alarm or Non-Return
Valve (Mushroom)
Globe Valve
(Straightway)
Butterfly Valve
381
200
8.0
3.05
5.67
250
10.0
3.89
7.42
300-900
12-36
3.89
7.42
1.72
2.0
2.64
3.35
3.35
7.36
8.61
11.34
14.85
14.85
0.97
1.13
1.5
1.97
1.97
6.12
7.17
9.4
12.3
12.3
30.62
35.88
47.27
61.85
61.85
41.64
48.79
64.29
84.11
84.11
5.47
6.38
8.62
9.9
9.9
Notes
1. The data is taken from 29th Edition FOC Rules, Table 6124.
2. The above values are used only for a Hazen-Williams C-Factor of 120. For other
values of the C-factor, the values are scaled in accordance with Table 6124 of the
FOC Rules.
3. Equivalent lengths of 15mm fittings are assumed the same as the corresponding 20mm
fitting.
4. Equivalent lengths of valves below 50mm are assumed the same as the corresponding
50mm valve.
5. Equivalent lengths of 90mm fittings are the arithmetic means of the corresponding
80mm and 100mm fittings.
6. All fittings above 250mm (10in) are assumed to have the same equivalent length as the
corresponding 250mm fitting.
382
Transient Module
1
2
3
4
5
6
7
8
9
Standard 45 Elbow
Standard 90 Elbow
Long radius Elbow
Tee or Cross (Flow
turned 90)
Gate Valve
Swing Check Valve
Non-return Valve
Ball Valve
Butterfly Valve
1
2
3
4
5
6
7
8
9
Standard 45 Elbow
Standard 90 Elbow
Long radius Elbow
Tee or Cross (Flow
turned 90)
Gate Valve
Swing Check Valve
Non-return Valve
Ball Valve
Butterfly Valve
25.0
1.0
0.3048
0.9144
0.6096
1.8288
32.0
1.25
0.3048
0.9144
0.6096
1.8288
40.0
1.5
0.6096
1.2192
0.6096
2.4384
0.3048
1.524
4.3
1.52
1.8288
0.3048
2.1336
4.3
1.52
1.8288
0.3048
2.1336
4.3
1.52
1.8288
0.3048
2.7432
4.3
1.37
1.8288
200.0
8.0
2.7432
5.4864
3.9624
10.668
250.0
10.0
3.3528
6.7056
4.8768
15.240
300
12.0
3.9624
8.2296
5.4864
18.288
1.2192
13.716
15.300
10.970
3.6576
1.5240
16.764
19.800
12.800
5.7912
1.8288
19.812
23.000
15.240
6.4008
0.3048
1.2192
4.3
1.52
1.8288
0.6096
8.2296
10.0
5.100
2.7432
0,9144
9.7536
12.200
6.7100
3.0480
Reference Data
1
2
3
4
5
6
7
8
9
Standard 45 Elbow
Standard 90 Elbow
Long radius Elbow
Tee or Cross (Flow
turned 90)
Gate Valve
Swing Check Valve
Non-return Valve
Ball Valve
Butterfly Valve
2.4384
44.196
23.000
15.240
7.9248
450.0
18.0
5.7912
10.3632
8.2296
27.1272
500.0
20.0
6.4008
11.5824
9.1440
30.1752
600.0
24.0
7.6200
13.716
10.668
36.576
2.7432
50.292
23.000
15.240
9.1440
3.0480
60.960
23.000
15.240
10.668
3.6576
67.056
23.000
15.240
13.4112
800.0
32.0
10.2951
18.0075
14.4782
48.2720
850.0
34.0
10.9385
19.1330
15.3831
51.2890
900.0
36.0
11.5819
20.2585
16.2879
54.3060
4.8070
92.9365
23.000
15.240
13.4112
5.1074
98.7451
23.000
15.240
13.4112
5.4079
104.553
23.000
15.240
13.4112
1
2
3
4
5
6
7
8
9
383
Notes
1. Equivalent lengths are taken from NFPA 15 (1990), except for fitting types 7 and 8,
which are manufacturers' data.
2. The above values are used only with a Hazen-Williams C-factor of 120. For other
values of the C-factor, the equivalent lengths are scaled in accordance with NFPA 15
Table -7-2 (g).
3. For NFPA 1996 rules the above values only apply to internal diameters identical to
the Schedule 40 steel pipe. For other internal diameters, the equivalent lengths are
scaled in accordance with NFPA 1996 rules Table 5-5.2.1 (Note 2).
4. Equivalent lengths of 15mm fittings are assumed to be the same as the corresponding
20mm fittings.
5. Equivalent lengths of gate and butterfly valves below 50mm are assumed to be the
384
Transient Module
Reference Data
385
Report Generator
Part
22
Report Generator
22
Report Generator
22.1
Introduction
387
The PIPENET report generator is a Microsoft Word template add-in. Using it:
Word can open up a report file generated by PIPENET, and offer up the sub-sections of
the report in the form of a menu to pick from.
Once the user picks a sub-section, the corresponding content is copied into your Word
document at the insertion point. In practical terms, this might generate a section
heading, a title for a picture, or insert a table of data.
If the PIPENET report is regenerated after changes to the model, the Word report can
itself be regenerated to use the new results.
Other Word features such as formatting, or inserting images or other content, remain
available as usual.
22.2
Prerequisites
Microsoft Office 2007 or later
PIPENET 1.6 or later
22.3
22.4
388
22.5
Transient Module
Report Generator
389
Save the document as a Word template document ensuring that the file name has been
changed.
22.6
22.7
390
Transient Module
You should notice that the text in the content controls you added to the title page and to the
headers and footers have been set to values read from the elements in results file. That is,
the text in the Title-1 content control will now have the same value as Title-1 node in the
results file (Figure 5 Updated Title Page).
Report Generator
391
392
Transient Module
You can then format the table and maybe add a total row using standard Microsoft Word
commands, as seen below.
22.8
Report Generator
393
Browse to and select the newly created results file. The document will now update to reflect
the changed title - any other modifications you made to the model will also be reflected in
the document. Also if you added a totals row to the Maximum/Minimum table, the results
will also be updated.
22.9
394
Transient Module
Cell shading
120
C-factor
200, 334
Channel cavitation
98
Check valve
250
Closing a file
19
Colebrook-White
210
Colour schemes
Complex colouring rules
129
Simple colouring rules
129
Index
-AAbsolute tolerances
175
Accumulator
268
American Petroleum Institute
API Fluid
163
Fluids Modelling
200
Analogue sensors
306
Anti-Windup
311
Appearance
PIPENET Menu Style
Windows Menu Style
13
13
Area tool
Copying selected items
Selected items
109
Asymmetric Pulse
Autosave
19
204
-BBibliography
Bursting disc
332
262
-CCalculation
Fast Components
93
Go
25
Graphical Timestep
93
Menu
25
Options
25
Pipe length
91
Short pipes
91
Timestep
93, 216
Timesteps
91
Toolbar
30
Transient
169
Variable Timestep
93
Calculation Controls
174
Cascade PID Controller
Modelling
315
Cavitation
97
Colouration Menu
Complex links
25
Complex nodes
25
Simple rules
25
109
Complex Force
84
Components
Drawing
113
Errors
329
Fast Components
93
Invalid components
37, 113, 126
Properties
15
Tools
113
Undefined components
37, 113
Waypoints
113
Constant gradient
102
Constant specification
204
Contacting Sunrise Systems
Continuity equation
202
Control switch
Modelling
317
Control Systems
305
Analogue
306
Anti-Windup
311
Cascade PID Controller
315
Cascading Control
315
Control Switch
317
Differential Control
311
Digital
306
Flow Switch
317
Gain
311
Integral Control
311
Limiting Power Ramp
309
PID Controller
311
Pressure Switch
317
Proportional Control
311
Sensors
306
Set Point
311
Signal Selector
322
Index
Control Systems
305
Switch
317
Tracking Time Constant
Transfer Function
309
-E311
113
Edit menu
21
Elastic pipes
210
Elastic/Rigid Connection
84
Elevation Profile Window
135
Elevation tolerance
174
Equal Percentage Opening Valve
Equipment items
223
Equivalent Lengths
223
FOC
380
NFPA
382
Errors
326
Basic Errors
326
Global errors
327
Input errors
327
Numerical errors
330
Specific Component Errors
Examples directory
2
Exit the program
19
Expired licence
Expiry date checking
Expiry date licencing
Explode node
108
Exponential
204
Export
AutoCAD
384
Clipboard
26
DXF
26, 384
HPGL
115
HP-GL/2
26, 324
Libraries
142
Library
19
Schematic
115, 324, 384
6
6
241
329
395
396
Transient Module
Fittings
Crosses
223
Equipment Items
223
Equivalent Lengths
223
Fittings Window
18
Library
23, 145
Tee Junction
223
Tees
223
Flow sensor
Modelling
306
Flow switch
317
Fluid damped check valve
252
Fluids
Calculation
161
Continuity Equation
202
Fluid Equations
202
Fluid Options
24
Fluid Parameters
200
Modelling
200, 202
Momentum Equation
202
Saturated liquid
161
Saturated vapour
161
Unsaturated
161
User-defined fluid
161
Water-steam
161
Force
Complex Force
84
Control Volumes
84
Defining Forces
172
Dynamic Forces
84
Elastic Connection
84
Interpreting Force Results
84
Maximum/Minimum Forces
84
Rigid Connection
84
Sign Conventions
84
Simple Force
84
Surfaces
84
Forces
Data Window/Grid
Extrema
79
120
-GGain
311
General Pressure Loss
153
Graphical timestep
93
Graphical Underlay
Import
22
Graphs
Annotations
193
Arrows
193
Curve Properties
188
Data Points
194
Data Window/Grid
120
Graph Types
185
Graph Viewer
49, 182
Hot Spots
194
Labels
193
Limit Lines
191
Output
25, 177
Selecting Results
169
Viewer Properties
187
X-Axis Properties
190
Y-Axis Properties
189
Zoom
195
-HHazen-Williams
Coefficients
Height Checking
126
Help topics
27
Henri Darcy
199
-IImport
Graphical Underlay
Library
19, 142
22
Index
-KKey status
27
K-Factor
Entry and Exit K-factors
378
Fittings in Standard Option
378
Valves
241
-LLabels
33
Laminar flow
199, 210
Libraries
Control Valve
147
Edit System Libraries
154
Export
19, 142
Fittings
23
Import
19, 142
Inertial Pumps
23
Local User Libraries
142
Menu
23
Open
19, 142
Pumps - Coefficients Known
23
Pumps - Coefficients Unknown
23
Schedules
23, 144
System Libraries
154
System Library
142
Turbo Pumps
23, 151
Valves
23
Licensing
7
Remote Update
6
Security Key
6
Updating a Lisence
254
-MMass Flow
158
Mile Post Data
102
Milepost Data
Enter Milepost Data
Mirror
21
Model options
156
Moment of inertia
230
Momentum equation
202
Moody diagram
199
Multiple Pipes
Add Multiple Pipes
139
-NNavigation
116
Non-return valve
250
Nozzle
302
-OObtaining support
3
One-node caisson
289
Open library
19
Opening a file
19
Operating valve
244
Options
156
Defaults Options
24
Display Options
24
Fluids Options
24
Menu
24
Pipe Types Options
24
Title
24
Toolbar
29
Transient Options
24
Units Options
24
Output
.FRC
177
.out
177
.RES
177
Forces file
177
Graph file
177
Graphical Results
169
Graphs
25
Menu
25
Pressure Maxima and Minima
Report
25, 49
Report file
177
Snapshots
177
Output Timestep
Overview window
26
91
18
179
397
398
Transient Module
-PPan
109
Mouse
117
Paste in column
21
Path
Creating a Path
135
Make a path
26
Physical constants
PID controller
Modelling
311
335
Pipe Bundle
217
Pipe Schedules
144
ANSI B36.10 Schedule 10
338
ANSI B36.10 Schedule 100
346
ANSI B36.10 Schedule 120
347
ANSI B36.10 Schedule 140
348
ANSI B36.10 Schedule 160
349
ANSI B36.10 Schedule 20
339
ANSI B36.10 Schedule 30
340
ANSI B36.10 Schedule 40
342
ANSI B36.10 Schedule 60
343
ANSI B36.10 Schedule 80
345
ANSI B36.10 Schedule S
341
ANSI B36.10 Schedule XS
344
ANSI B36.10 Schedule XXS
351
ANSI B36.19 Schedule 10S
352
ANSI B36.19 Schedule 5S
350
ANSI B36.19 Schedule S
353
ANSI B36.19 Schedule XS
354
ANSI B36.19 Schedule XXS
355
DIN Standard
369
JIS 1990 Steel Schedule 10
356
JIS 1990 Steel Schedule 100
362
JIS 1990 Steel Schedule 10S
367
JIS 1990 Steel Schedule 120
363
JIS 1990 Steel Schedule 140
364
JIS 1990 Steel Schedule 160
365
JIS 1990 Steel Schedule 20
357
JIS 1990 Steel Schedule 30
358
JIS 1990 Steel Schedule 40
359
JIS 1990 Steel Schedule 40S
368
JIS 1990 Steel Schedule 5S
366
JIS 1990 Steel Schedule 60
360
JIS 1990 Steel Schedule 80
361
Library
23
376
377
164
24
Pipes
Elastic Pipes
210
Modelling
210
Short pipe
216
Pivot threshold parameter
174
Power ramp
204
Prerequisites
6
Pressure difference sensor
Modelling
306
Pressure Envelope
104, 135
Pressure sensor
Modelling
306
Pressure switch
317
Printing
Data Window/Grid
120
Print Preview
19, 114
Schematic
19, 114
Setup
114
Product modules
3
Properties window
15
Property Window
Scroll buttons
15
Proportional Control
311
Pumps
Inertial Pumps
23
Library
23
Turbo Pumps
23
Pumps - Coefficients Known
150
Pumps - Coefficients Unknown
148
226
241
Index
Single Compressible flow pipe
222
Single-node caisson
289
Smooth pump curve
226
Specific component errors
329
Specifications
204
Spray model option
198
Standard and Spray models
198
Standard model option
198
Status
Status checking
126
Status dialog
126
-RRankine-Hugeniot
222
Receiving vessel
Weir Crest
276
Regulator valve
256
Relative tolerances
175
Results
Data Window
49
Displaying Results
173
Graph Viewer
49
Graphs
120
Output
49
Selecting Graphs for Components
Reynold's number
169
199
-SSafety Valve
Modelling
260
Saturated Fluid
Liquid
161
Vapour
161
-T-
Save
19
SCFP
222
Schematic
Export
115, 324, 384
Print
114
Underlay
107
Window
14, 107
Security key
Problems
Tables
120
Defining Tables
Sensors
Flow Sensors
306
Pressure Difference Sensors
Pressure Sensors
306
170
Tabular Results
120
Tabular view
15, 120
tag toolbar
30
Tagging
133
Remove tags
26
Tag selected items
6
7
Selection tool
Selecting Several Components
Step Profile
204
Streeter
332
Support
3
Surface roughness
332
Surge tank
272
Suter curves
230
Switch
Flow Switch
317
Modelling
317
Pressure Switch
317
108
306
Set point
311
Sign conventions
84
Signal selector
Modelling
322
Simple force
84
Simple pump
226
Simple tank
283
Sine wave
204
26
Tees
223
Temporary path
174
Text tool
Moving and editing text
111
Thorley
332
Timestep
177
Timesteps
Output Timestep
91
Time Control
91
User-defined timesteps
91
Title
156
Title Options
Tolerances
Elevation
24
174
399
400
Transient Module
Tolerances
Interpolation
174
Maximum Number of Iterations
Toolbar
28
Tools menu
26
Tracking time constant
311
Transfer function
Limiting Power Ramp
309
Modelling
309
Transient options
24
Transitional flow
199, 210
Turbo pumps
Library
151
Modelling
230
Moment of Inertia
230
Suter Curves
230
Turbulent flow
199, 210
Tutorial Examples
Example 1
33
Example 2
53
Example 3
69
Force on a 90 degree bend
69
One pipe system
33
Small sprinkler system
53
Two-node caisson - type 1
Two-node caisson - type 2
-UUnderlay
.DXF
107
.EMF
107
.WMF
107
Undo/Redo
21
Units
Changing Units
158
Mass Flow
158
Options
24
Volumetric Flow
158
Update key
292
295
174
241
Vapour cavitation
97
Variable time step
93
Version numbers
27
View Menu
Graphical Underlay
22
Palette
22
Schematic Overview
22
Schematic Window
22
Status Bar
22
Toolbar
22
Vista
2
Volumetric Flow
VTS
93
158
-WWave Speed
User-defined wavespeed
Waypoints
113
Adding Waypoints
203
108
Weir Crest
276
Welcome
2
Wiley
332
Window Menu
PIPENET Menu Style
26
Window Menu Style
26
-ZZoom
109
Mouse
117
27
-VVacuum Breaker
286
Validation
122
Valves
Characteristics
241