Professional Documents
Culture Documents
Reference Guide
Copyright
Version Number: 2004
Copyright 1981 - 2004 Aspen Technology, Inc. All rights reserved.
Aspen ACOL™, Aspen ACX™, Aspen APLE™, Aspen Adsim™, Aspen
Aerotran™, Aspen CatRef®, Aspen Chromatography®, Aspen Custom
Modeler®, Aspen Decision Analyzer™, Aspen Dynamics®, Aspen Enterprise
Engineering™, Aspen FCC®, Aspen Hetran™, Aspen Hydrocracker®, Aspen
Hydrotreater™, Aspen Icarus Process Evaluator™, Aspen Icarus Project
Manager™, Aspen Kbase™, Aspen Plus®, Aspen Plus® HTRI®, Aspen OLI™,
Aspen OnLine®, Aspen PEP Process Library™, Aspen Plus BatchFrac™, Aspen
Plus Optimizer™, Aspen Plus RateFrac™, Aspen Plus SPYRO®, Aspen Plus
TSWEET®, Aspen Split™, Aspen WebModels™, Aspen Pinch®, Aspen
Properties™, Aspen SEM™, Aspen Teams™, Aspen Utilities™, Aspen Water™,
Aspen Zyqad™, COMThermo®, COMThermo TRC Database™, Aspen
DISTIL™, Aspen DISTIL Complex Columns Module™, Aspen FIHR™, Aspen
FLARENET™, Aspen FRAN™, Aspen HX-Net®, Aspen HX-Net Assisted Design
Module™, Aspen Hyprotech Server™, Aspen HYSYS®, Aspen HYSYS
Optimizer™, ACM Model Export™, Aspen HYSYS Amines™, Aspen HYSYS
Crude Module™, Aspen HYSYS Data Rec™, Aspen HYSYS DMC+ Link™, Aspen
HYSYS Dynamics™, Aspen HYSYS Electrolytes™, Aspen HYSYS Lumper™,
Aspen HYSYS Neural Net™, Aspen HYSYS Olga Transient™, Aspen HYSYS
OLGAS 3-Phase™, Aspen HYSYS OLGAS™, Aspen HYSYS PIPESIM Link™,
Aspen HYSYS Pipesim Net™, Aspen HYSYS PIPESYS™, Aspen HYSYS RTO™,
Aspen HYSYS Sizing™, Aspen HYSYS Synetix Reactor Models™, Aspen HYSYS
Tacite™, Aspen HYSYS Upstream™, Aspen HYSYS for Ammonia Plants™,
Aspen MUSE™, Aspen PIPE™, Aspen Polymers ®, Aspen Process Manuals™,
Aspen BatchSEP™, Aspen Process Tools™, Aspen ProFES 2P Tran™, Aspen
ProFES 2P Wax™, Aspen ProFES 3P Tran™, Aspen ProFES Tranflo™, Aspen
STX™, Aspen TASC-Thermal™, Aspen TASC-Mechanical™, the aspen leaf logo
and Enterprise Optimization are trademarks or registered trademarks of
Aspen Technology, Inc., Cambridge, MA.
All other brand and product names are trademarks or registered trademarks
of their respective companies.
This document is intended as a guide to using AspenTech's software. This
documentation contains AspenTech proprietary and confidential information
and may not be disclosed, used, or copied without the prior consent of
AspenTech or as set forth in the applicable license agreement. Users are
solely responsible for the proper use of the software and the application of the
results obtained.
Although AspenTech has tested the software and reviewed the
documentation, the sole warranty for the software may be found in the
applicable license agreement between AspenTech and the user. ASPENTECH
MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESSED OR
IMPLIED, WITH RESPECT TO THIS DOCUMENTATION, ITS QUALITY,
PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR
PURPOSE.
Introduction
Corporate
Aspen Technology, Inc.
Ten Canal Park
Cambridge, MA 02141-2201
USA
Phone: (1) (617) 949-1000
Toll Free: (1) (888) 996-7001
Fax: (1) (617) 949-1030
URL: http://www.aspentech.com/
Related Documentation
In addition to online help systems available via the product applications, a
number of printable documents are provided to help users learn and use the
HTFS family of products:
Title Content
HTFS Installation Guide.pdf Describes the installation routine
Introduction
Table of Contents
1 Introduction................................................................ 1-1
1.1 Overview..............................................................................1-3
1.2 Pipeline Fittings ...................................................................1-3
1.3 Physical Properties..............................................................1-4
1.4 Property Data Sources ........................................................1-4
1.5 Output Options ....................................................................1-5
1.6 Documentation ....................................................................1-6
iii
3.15 The Input File.....................................................................3-19
3.16 Default Input Data File.......................................................3-20
3.17 Input Errors and Warnings.................................................3-21
4 Output......................................................................... 4-1
4.1 Overview..............................................................................4-3
4.2 Output Views .......................................................................4-3
4.3 Output Files .........................................................................4-7
4.4 Error / Warning Message Log..............................................4-8
Index............................................................................I-1
iv
Introduction 1-1
1 Introduction
1.1 Overview...........................................................................................3
1.6 Documentation.................................................................................6
1-1
1-2 Introduction
1-2
Introduction 1-3
1.1 Overview
PIPE is designed to allow you to model the steady state performance of
an unbranched pipeline system carrying single or two-phase flows. The
list below summarises the main features.
PIPE can:
• Determine the static pressure drop for given mass flowrate and
pipeline geometry.
• Determine the mass flowrate corresponding to a supplied
pressure drop and pipeline geometry.
• Determine the diameter factor to size a pipeline for a given
pressure drop and mass flowrate.
• Determine the critical mass flowrate for a given pressure drop
and pipeline geometry for high velocity flow.
• Perform a 'multiple choke' calculation (for example, for pressure
drop calculation downstream of safety relief valves).
1-3
1-4 Physical Properties
1-4
Introduction 1-5
Graphs are available for several of these output items e.g. absolute
pressure, temperature, velocity, quality, void fraction, and vapour and
liquid densities and viscosities.
1-5
1-6 Documentation
1.6 Documentation
HTFS supplies the following manuals on the HTFS CD:
• HTFS User Guide
• HTFS Installation Guide
(these two are generic to all programs)
• PIPE Getting Started
• PIPE Reference Guide
When appropriate, this manual includes the PIPE input and output
views to help with explanations. Since PIPE is being continuously
developed, there may be minor discrepancies between what you see on
your computer, and the views shown in this manual. The discrepancies
may relate to layout, or to numerical values, but should not be taken as
indicating any problem.
See the PIPE Getting Started for information on the set of QA data that is
included with the program. The QA data are input data sets to help
ensure that PIPE is functioning properly. These sets should be run in
PIPE and then checked that the results are the same (within the limits of
computer accuracy) as the corresponding output files, which are also
provided.
The Help Text is the most extensive documentation available for PIPE. It
is available whenever you are running the program, or can be loaded
separately. There are direct links to appropriate Help topics for every
To load the Help Text when input item, and from many other places in the program.
you are not running PIPE,
double-click on PIPE.HLP in
the main PIPE directory.
1-6
Using PIPE 2-1
2 Using PIPE
2.1 Overview...........................................................................................3
2-1
2-2 Using PIPE
2-2
Using PIPE 2-3
2.1 Overview
The normal PIPE run procedure involves setting up input data
representing a particular case, running the case and examining the
results. If you open a case you have previously run, you can examine the
results without needing to run the program again. Changes can easily be
made to a case and then re-run. You can examine the results of a
changed case before deciding to save those changes. A case can be saved
with incomplete data and then re-opened for completion.
Facilities are provided for you to provide a descriptive title for each run,
to specify a run number, and to add a number of lines of comments
giving further information.
See Chapter 3 - Data Input for a detailed description of the data input
and for output see Chapter 4 - Output. Extensive Help Text is available
when running the program. The Help Text covers not only the details of
input and output, but also the particulars of the User Interface.
2-3
2-4 Starting PIPE
PIPE 5.20 and subsequent releases will work with Windows 2000 and XP.
You will then see the Welcome view, shown in Figure 2.1, which contains
a list of recently used input files, and gives you the option of opening an
Existing file, or starting a New one. Click on the New button, and the
Start up view will open, where you can begin inputting data for a new
example.
Figure 2.1
You can save an example at any point during data input, or after a case
has been run. The next time you start PIPE, the saved case will be listed
with the recently used files, and you can double-click the listing to open
it. If you want to find a previous input file that does not appear in the
2-4
Using PIPE 2-5
Recently Used Project File list, click on the Existing button. When an
input file is opened, PIPE will also open all the associated output files.
When you have your PIPE file loaded, you can start a (different) new
case, using the New command under the File menu Selecting New will
clear any existing data and set up default data. Return to a different
existing case using the Open command under the File menu.
You can also use the key Regardless of the method you choose to begin a new case, the first view
combination SHIFT F1 to return available is the Start up view shown in Figure 2.2. You can return to that
to the Start up view.
view at any point using Start up under the Input menu (or the key
combination SHIFT F1).
When you start an existing case, you will not be taken to the Start up
view. Instead, the Build Pipeline view will open, which shows a
schematic of the pipeline components, allowing new components to be
added or existing components to be changed. This view can also be
access at any time from the View menu or from the toolbar by clicking
on the View Geometry Diagram icon.
View Geometry Diagram icon
Figure 2.2
2-5
2-6 The Start Up View
The most important item on this view is the Calculation Mode drop-
down list. The default setting is PRESSURE DROP, but you can reset it to
MASS FLOWRATE, or DIAMETER as required. As with all input items,
press F1 to see the Help Text, if you are not sure what the options mean
or what you should do.
Click on OK to gain access to the Build Pipeline view for your new case.
2-6
Using PIPE 2-7
Figure 2.3
2-7
2-8 Running PIPE
The Run Progress view records the file that is being run. See Figure 2.4.
Figure 2.4
If the extension is .PEI, you are running the case you just opened,
without having made any changes to it. If the file extension is .PEA, you
are running the edited copy of your original input file, having made
changes to it.
2-8
Using PIPE 2-9
2-9
2-10 PIPE Icons
2-10
Data Input 3-1
3 Data Input
3.1 Overview...........................................................................................3
3.7 Valves..............................................................................................12
3.7.1 Ball and Butterfly Valves.........................................................12
3.7.2 Globe and Gate Valves...........................................................12
3-1
3-2 Data Input
3-2
Data Input 3-3
3.1 Overview
PIPE has a number of data input views, each comprising several tabs.
You can access these views via the Input menu. The contents of each
page vary slightly according to the Calculation Type (Pressure Drop,
Mass Flowrate, or Diameter) you have specified.
Many PIPE input items have defaults. Some of these defaults are
indicated on their input form, but in other cases they will depend on
context and other input values, and are set up when you Run PIPE.
If you are unsure what a data item means, position the cursor on that
item and press F1. You will be shown the Help Text on that item, which
can show diagrams, define defaults, and let you explore other relevant
information. It can point you to more information on what use is made
of an input item during PIPE calculations.
For a full description of each item, and a listing of all possible items, use
the Help Text. For more information on Physical Properties, both input
and output, see Chapter 5 - Physical Properties.
Some input items have checks on them to prevent you from inputting
inappropriate values. However, the best check on input is to Run PIPE.
You will immediately see a list of any errors and warnings produced.
3-3
3-4 Input Views
3-4
Data Input 3-5
Figure 3.1
3-5
3-6 Build Pipeline
Figure 3.2
3-6
Data Input 3-7
In order to edit the pipeline you have defined click on the relevant
component and four new buttons Delete, Insert, Replace, Cancel will
appear on the pipeline diagram view allowing you to delete or replace
the fittings or insert a new component in front of the one selected. See
Figure 3.3.
Figure 3.3
If you want to delete all the fittings you have added, click the Clear All
button. PIPE will confirm this with you before proceeding with the
deletion.
3-7
3-8 Build Pipeline
To open any view for a fitting you have added, right-click on the icon in
the profile. Figure 3.4 shows the input view for a straight pipe length.
Figure 3.4
Each pipe fitting input view has differing fields, depending on the data
required to define its geometry. However, the buttons at the bottom are
common to all segments. The following table defines this button
functionality:
Button Functionality
Next Opens the Input form for the next fitting type in your pipeline profile.
Apply Accepts the input data entered on the form.
OK Accepts the data supplied, and closes the form.
Cancel Closes the view and deletes any information supplied.
Help Opens the related on-line help file.
You have the choice of how you want to specify your pipeline. You can
add all the units first, without specifying their parameter or you can fully
specify each segment as it is added to the profile.
3-8
Data Input 3-9
Diameter Defaults
You need only supply the Diameter of a fitting
• if it is the first fitting in the pipeline. The value you supply here is
used as the upstream pipe diameter for all subsequent fittings up
to, and including, a contraction or an enlargement
or
• if the fitting is either a contraction or an enlargement. You need
supply only the downstream diameter at every change of pipe
cross-section.
When you are asked to supply the Diameter in the following section on
PIPE fittings you should do so only under the above conditions.
3-9
3-10 Pipe Sections
Heat Transfer
To account for the heat transfer you must also enter either:
• A value for the Heat flux and leave external temperature blank.
or
• Heat transfer coefficient and external temperature.
3.5.2 Bends
You can specify Circular or Mitre bends. If you know the value of the loss
coefficient K you should enter it along with the pipe diameter only (see
Section 3.4 - Geometric Data (General)). This value of K will then be
used by PIPE to calculate the pressure drop for the bend.
3-10
Data Input 3-11
If you know the value of the loss coefficient K you should enter it along
with the Upstream Diameter and Downstream Diameter only (see
Section 3.4 - Geometric Data (General)). This value of K will then be
used by PIPE to calculate the pressure drop for the enlargement/outlet.
3-11
3-12 Valves
3.7 Valves
3.7.1 Ball and Butterfly Valves
Valves icon
If you know the value of the loss coefficient K you should enter it along
with the Upstream Diameter only (see Section 3.4 - Geometric Data
(General)). You need not enter anything else. This value of K will then be
used by PIPE to calculate the pressure drop across the valve.
If you do not know K you should enter the Upstream Diameter, the
Valve Disc to Diameter Ratio (for a butterfly valve) and the Valve
Opening Angle (defaulted to Fully Open).
If you do not know K you should enter the Upstream Diameter, the
Valve Seat Area Ratio and the Valve Opening. The minimum allowable
opening is 0.06 for a globe valve and 0.1 for a gate valve. This is defaulted
to 1.0 (Fully Open).
3-12
Data Input 3-13
3.8 Orifices
Orifices icon
3-13
3-14 Known Pressure Drop
3-14
Data Input 3-15
The Geometry and Process Data can be defined using different unit sets
within a single case. Properties Data can be defined with different unit
sets for every individual stream, if you want.
3-15
3-16 Input Units
When a new file is created, it uses a single unit set for all data, which you
can preset (the default setting is SI units). You can change the units via
the Preferences option under the File menu. Alternatively you can click
on the Units field at the bottom of any input property view, to get to the
Preferences view as shown in Figure 3.5. If you checked on the Change
Units Together checkbox, then a single change sets the units of all
components of the input to a consistent set. There is also an option to
define the Default Units for any New file you subsequently initiate.
Figure 3.5
When you change the units, you can decide whether or not any values
you have already input should have their units converted to the new
system.
Some of the preset defaults in the Geometry input have units, so you
should select the Convert option even if you have not yet supplied any
data.
The units of the program output will be deduced from the input units
although you can explicitly specify one of the three sets on the Output
tab of the Output view.
3-16
Data Input 3-17
PIPE Help can be access at any point using the Help menu, or during
input, you can press F1 to go directly to help on the item where the
Help icon
cursor currently points.
The Help Text provides information on data input, how to use the User
Interface, the Program Output, and on Errors and Warnings. See
Figure 3.6.
Figure 3.6
3-17
3-18 Finding Input Items
You will also find information on PIPE capabilities, new features in the
latest version and contact points for user support.
When you have found the Help Text relevant to the particular input
item, you will see that there is an Input Item Identifier at the bottom of
the Help. This takes the form of a Line Number and Item Number in the
input file. For example Inlet Temperature is 204.1, meaning item 1 line
204 (there can be up to 6 items on a line)
To find a particular item, use the Find Input Item icon, or the Find Item
command under the View menu. See Figure 3.7. When you type in a line
Find Input Item icon
number, you will be shown the list of items on that line. If you click on a
particular item, you will be taken to the input view where it occurs. For
Physical Properties input, you will just be taken to the Main Properties
view, and may need to investigate subsidiary pages yourself.
Figure 3.7
Some Error and Warning messages give Line and Item numbers. You
can use the Find Item facility to identify the item more fully, and go to
the input page where you can amend it.
3-18
Data Input 3-19
Figure 3.8
The data lines are gathered together into 'blocks', with a related set of
line numbers. The following table lists the data type and their respective
number ranges.
The first line in each block identifies the block, and the units of the input
data.
3-19
3-20 Default Input Data File
A full listing of all possible input data items is given in the Help Text. The
Help Text on individual items indicates the line number (and position
on the line).
You can preview the Input data file, before it is run, under the View
Preview Input File icon menu, or by using the Preview Input File icon on the toolbar.
The User Interface normally holds an internal version of the input file,
which is modified in response to changes you make in the input, and
which is used when the PIPE calculations are Run. You have the option
of saving this internal version of the input file, at any stage. You will be
explicitly offered the option of saving it each time you Run calculations,
or, if you have changed any input items, on Exit from the program. If you
do not save it, any initial version of your input file will be left unaltered.
To set up such a default file, create a partial input data file in the usual
way, and save it with an appropriate name. Then select Preferences,
under the File menu, and select the Files tab. Select your default file
under the Default Input File option.
When you use such a Default Input Data File, you should ensure that
you use the Save As command (under the File menu) to save new cases.
Save your file with a name different than that of your default input file,
otherwise this modified file will be saved as the default.
To change the Default Input Data File, go to the Files tab of the
Preferences view, and make your selection. Then select New, under the
File menu, to initiate a new data file based on your new default.
3-20
Data Input 3-21
Figure 3.9
3-21
3-22 Input Errors and Warnings
3-22
Output 4-1
4 Output
4.1 Overview...........................................................................................3
4-1
4-2 Output
4-2
Output 4-3
4.1 Overview
Running the core PIPE program produces a number of different types of
output, which can be viewed using the Output menu. When you stop
working on an example, all the key output files remain in place, so you
can view the output again once you re-open a case you have previously
worked on.
This chapter gives an overview of the various outputs you can inspect, to
help you find particular details that may be of interest to you. A more
detailed description of all the Outputs is available in the Help Text. See
Output in the Help Text contents page.
Figure 4.1
4-3
4-4 Output Views
The Results output menu option brings up the Pipe Output view. A
number of different tabulated results may be obtained under the Tables
tab, by selecting the appropriate radio button in the Tables Options
group. See Figure 4.1.
Figure 4.2
When one of the profile options on the Graphs tab, shown in Figure 4.2,
is selected, the appropriate plot will be displayed. The resulting Detailed
Results - Plot view displays the selected data in graphical form, showing
the length profile. See Figure 4.3 .
Figure 4.3
4-4
Output 4-5
If you click on the Fittings Profile button at the bottom of the view, a
plot of the relevant data versus the fitting number appears. Clicking on
one of the data points on the resultant plot displays an information
panel pertaining to that fitting. If the fitting is a straight pipe with a two-
phase flow regime, a graph of the two-phase flow pattern is also
displayed under the fitting data.
Figure 4.4
4-5
4-6 Output Views
Figure 4.5
4-6
Output 4-7
The Line Printer output is the most comprehensive set of results from
PIPE. It is up to 132 characters wide. When you run the PIPE calculations
from the User Interface, by default all the possible components of the
Line Printer output are produced. See Figure 4.6 for an example of this
output.
Figure 4.6
4-7
4-8 Error / Warning Message Log
For each of output file views, six buttons are available at the top of the
view. These buttons and their functionality are listed in the following
table:
Button Function
Print Prints the contents of the view.
Font Opens a view and allows you to change the file font.
Copy Copies all or only the selected text to the clipboard. You can then
paste the clipboard contents into a text viewer/editor such as
Notepad or a word processor application and then print the selected
text from there.
Find Activates the Find operation that will locate a word or phrase you
specify, within the file view. Use this operation if you want to quickly
locate information on a certain aspect of a pipeline. Simply use a
word relevant to the information desired and then the Find operation
will locate the text, if it exists, within the file.
Find Next After locating the first occurrence of a text string within the file view
using the Find button, use the Find Next button to locate all
subsequent occurrences of this text string.
Help Opens a Viewer Help view.
Errors are normally fatal, in that PIPE has identified some fundamental
inconsistency in your data, or a lack of essential data, which means that
it cannot continue further with its calculations.
4-8
Physical Properties 5-1
5 Physical Properties
5.1 Overview...........................................................................................3
5.1.1 Properties Data Input ...............................................................3
5.1.2 Properties Used .......................................................................4
5-1
5-2 Physical
5-2
Physical Properties 5-3
5.1 Overview
A wide range of options are provided for providing the physical property
data needed by this program. The user interface contains the HTFS
Thermo package, which contains data for over 1000 substances and a
range of methods for determining vapour liquid equilibrium and
mixture properties, and can be used to set up tables of property data for
each stream.
Physical Properties
This lets you define a stream data source (components and methods) for
the Thermo databank, and then calculate a table of stream properties,
which can be used as program input. It also lets you directly input
property data tables, or modify those just calculated. Section 5.2 -
Properties Input gives more details.
5-3
5-4 Overview
Use of the newer style input, with the Thermo package gives you more
control. This lets you set up, check and if necessary revise properties
data before running the program. Except for the special case when you
provide direct input, the old style input only sets up the properties data
tables data when the program is run.
Property Data
Liquid Temperature for liquid properties.
Liquid Density.
Liquid Specific Heat.
Liquid Viscosity.
Liquid Thermal Conductivity.
Surface Tension (for two-phase streams, optional).
Vapour Temperature for vapour properties.
Vapour Density.
Vapour Specific Heat.
Vapour Viscosity.
Vapour Thermal Conductivity.
T-h-x Data Temperature for T-h-x.
Specific Enthalpy [h].
Quality (vapour mass fraction) [x].
Sets of 1-24 liquid data points, 1-24 vapour data points and 2-26 T-h-x
points are used. Although separate sets of temperatures can in principle
be used for each of the three subsets, when Thermo is used the liquid
and vapour temperatures are identical with the relevant ones for T-h-x.
5-4
Physical Properties 5-5
The properties need not relate explicitly to the process conditions in the
equipment through which the system flows in any way. Data can be
extrapolated as well as interpolated if necessary. It is, however, clearly
sensible that the properties cover a broadly similar temperature range to
that in the equipment, as major extrapolations are likely to be less
accurate than interpolations.
5-5
5-6 Properties Input
The data source options, and calculated property tables are shown in
the main Physical properties view.
Figure 5.1
5-6
Physical Properties 5-7
Figure 5.2
If you selected a Stream Type on the main properties input form, then a
default Property Package will be selected. You can, however, change the
package used, from a selection including Peng Robinson, SRK, NRTL,
and variants on these. A brief description of each is given on screen.
5-7
5-8 Properties Input
When both components and Property Package are set, the status bar at
the bottom right turns green and reads Ready. You can then close this
view, and on the main Properties input view, the new Data Source is
available to be selected for any stream.
After properties have been calculated you can delete individual data
points (data columns). You can explore the effect of changing the
Property Package, used using Edit to revise the Data Source.
Once data has been generated, you can change the Data Source to
Direct Input and edit individual property values, though this is not
recommended.
5-8
Physical Properties 5-9
For Single Phase streams data need only be input for one phase. Specific
enthalpy data are optional, as they can be found by integrating specific
heats.
A set of Stream Properties data you specify should all relate to the same
pressure, typically some mean pressure within the exchanger. You can
supply a second set of stream data at a different pressure, permitting the
program to allow for the pressure dependence of properties. Such
dependence is sometimes significant, particularly for thermosyphons,
or if there is a very close temperature approach between streams. For
the PIPE program, pressure dependence is mandatory. See Section 5.10
- Pressure Dependence for more information.
5-9
5-10 Properties Data Input (Old Style)
The Old Style physical properties input gives access to all the facilities
that were present before HTFS programs included the Thermo. Many of
these facilities are associated with the fact that, unlike Thermo options,
with many old-style options you cannot see the properties until you
have run the Calculation Engine.
The master view for old style input is shown in Figure 5.3. Using this,
Physical Property information can be supplied in a number of ways.
You can:
• Input Stream Properties directly. You can either type them, or
import them from a PSF file. See Section 5.6 - Importing
Properties and Process Data.
• Identify data from a User Databank. The calculation engine will
read data from this databank when it runs.
• For a single component stream, get the data directly from the
NEL40 Databank supplied with the program.
• Tell the program the stream components and composition, and
get it to calculate the properties.
5-10
Physical Properties 5-11
The Data Source item on the main Physical Properties input view
allows you to select the various options. You should also set the Phase
before supplying further data. A two-phase stream means that it can be
either single phase or two phase, depending on the temperature.
Figure 5.4
If you have previously imported data from a PSF file, you will be able to
see what you have imported.
5-11
5-12 Properties Data Input (Old Style)
You need to specify the properties indicated above for one or both
phases. For Two-phase streams you also supply T-h-x data. Although
you can supply data at up to 24 temperature points, this is potentially
tedious if you are typing the data in, and you are most likely to use this
method when you have only one or two data points available, for
example at an exchanger inlet and outlet.
If you want you can use different sets of temperatures for the Liquid,
Two-phase (Enthalpy + Quality) and Vapour Properties. You should
normally fill in the data tables from the left, without leaving gaps,
though this is not strictly necessary.
For Single Phase streams, T-h-x data are not usually input, as they can
be found by integrating specific heats. If, however, you do want to input
Enthalpies for a Single Phase stream, click on Show T-h-x, and that T-h-
x part of the input table will become available.
Heat Load data, rather than Specific Enthalpies, can be specified. If you
supply a heat load, you must also specify the flowrate to which it relates.
The rules for direct property input are as defined in Section 5.2.3 - Rules
for Direct Property Input. The additional facilities available under Old
Style input are as follows.
5-12
Physical Properties 5-13
5-13
5-14 Mixture Calculations (Old Style)
With the Old Style input, mixture calculations are performed when the
calculation engines run.
From the main Properties input view, set the Data Source for the stream
concerned to Components, and then click on the Specify Mixture
button. The Specify Mixture view, Figure 5.5, lets you define the
temperature range over which mixture properties should be calculated,
or amend the calculation methods or results.
Figure 5.5
5-14
Physical Properties 5-15
For a Two Phase stream, you can select the method to be used for VLE
calculations, SRK or Ideal. There is also a facility called T-h-x Override,
whereby you can control the results of the VLE calculations. At the basic
level, you can simply specify all the temperatures at which you want the
calculations performed. You can also request that any calculated bubble
and dew points (temperatures and optionally enthalpies), be modified
to conform to pre-set values. More information on all these options is
given in the Help Text, accessible by using the Help button at the bottom
of the page.
All the inputs on the Specify Mixture view are optional, but you must
use it to access the Define Components and Define Compositions
views, via the appropriate buttons.
From the Define Components view, Figure 5.6, you can identify each
component, and where data for it is to be obtained. Click on Add
Component until the correct number are identified. The number should
be the total number of components in all such mixtures. If the same
component occurs in more than one stream, it need only be counted
once. There is no need to include those components which only occur in
pure component streams.
Figure 5.6
5-15
5-16 Mixture Calculations (Old Style)
You can also select from a User Databank of component data (if you
have set one up previously), or you can choose to Input Directly.
Selecting Input Directly as the Data Source enables the Property Table
button. If clicked the view for direct input of component properties is
opened. The properties needed for each component are similar to those
required for a stream, but the Liquid Properties are saturation line
values, and the Vapour Properties are ideal gas values, that is values in
the low pressure limit.
Figure 5.7
5-16
Physical Properties 5-17
The Thermo databank contains data for over 1000 substances, and is
accessible via the User Interface to set up tables of Physical Properties
data as part of the program input. To see the list of substances in
Thermo, go to the Physical Properties input view, and click on Add in
the Data Source box.
The NEL40 databank does not in itself contain any methods for VLE
calculations, though it does do mixture calculations when phase
compositions are known. A VLE facility for use with NEL40 is provided
within the HTFS Physical Properties Package (PPP), but it is not as
extensive as the facilities offered with Thermo.
Properties from Thermo will depend on the equation of state used in the
properties method selected, even for pure components. Differences in
properties of a few percent may be found between Thermo and NEL40
in comparisons for compounds which are in both. This may reflect
uncertainties in known values of properties, or differences in the
equations of state used.
5-17
5-18 Property Databanks
One case where NEL40 may be more reliable than Thermo is for water,
since NEL40 contains an accurate water/steam package. Differences are
only likely to be significant at high pressures. The HTFS interface to
Thermo therefore contains a facility for Water from NEL40, which may
be used instead of setting a Data Source for water from Thermo itself.
There is a similar facility for air, which appears in NEL40, but is not
conveniently available in Thermo.
You can set up a User Databank with the properties of any components,
which you may frequently need to access, but which are not in NEL40.
The structure of the databank is very similar to that of the Component
blocks of an Input file. The Help Text gives full details.
The User Databanks of stream and component data are files. Specify
their location by selecting Preferences, under the File menu on the Files
tab, specify the appropriate tab.
5-18
Physical Properties 5-19
The data from a PSF file go directly into your input file. The import
facility can be access via either the Input or the File menus. The first step
is to identify the particular PSF file from which you want to import data.
You will then be taken to the Import PSF Data view.
Figure 5.8
5-19
5-20 Importing Properties and Process Data
If the PSF file has been prepared specifically for the exchanger you are
interested in, you may simply be able to click on OK. You can, however,
use the Import PSF Data view to direct only part of the information
from a PSF file into the input file.
You can:
• View the stream Names, Number and Inlet/Outlet
Temperatures in the file.
• Import data for some streams but not others.
• Import Process data, or only Property data, or both.
• Import data at any selection of pressure levels (PSF files often
contain properties data at the Inlet, Outlet and Mean Pressures in
the exchanger).
• Change the stream Number when you import data.
The Import facility shows you the stream names and inlet/outlet
temperatures in the PSF file. The temperature units of the display can be
reset by clicking on the Units field in the top right corner.
The PSF file itself is largely in basic SI units, and when imported to the
input file the data can be viewed in whatever units have been set for
process and property data.
The Import To column shows the Stream Number to which data will be
imported. This is initially set to the Stream Number from the PSF file,
but you can reset it to a different number if you want, or if it is necessary
for the program. You can set it to ignore, enabling you to import data for
only one stream (or fewer than all the streams for multi-stream
exchangers). You cannot set two stream numbers to be the same.
The Use Properties column lets you select which pressure levels in a PSF
file to use for Properties data. If there are data for three pressure levels,
you can select two (upper and lower), one (middle level), or you can opt
for a special selection.
If you want to import the properties data but not the process data, click
on Separate Process and Properties, and you will see that the Import To
column is divided in two. The left part relates to Process data, the right
part to Properties. You can set either one to Ignore, so that only the
other is imported.
5-20
Physical Properties 5-21
Normally, when you import Process and/or Properties data for a stream,
PSF file layout and contents
are defined in the Help Text. any data you have already entered for that stream is overwritten. You
can however, cause the Properties data to be added to any data
currently present, provided that it relates to a different pressure. Use the
Merge with Existing Data checkbox.
Select Import from HYSYS under either the Input or File menu and you
will be presented with a view to select an existing HYSYS case.
HYSYS will then be started, load the chosen case and the import
interface will generate a list of all heat exchangers within that case. You
can select an exchanger, and for each stream in that exchanger, the
temperatures and pressures will be shown.
5-21
5-22 Importing from HYSYS
Figure 5.9
You can revise the temperatures and pressures. If you then select OK,
HYSYS will perform the flashes needed to generate the data for a PSF
file. You can then review and select from the data as for a normal PSF
import.
5-22
Physical Properties 5-23
When you select this option, you are asked to provide input on stream
inlet/outlet conditions, stream compositions and components, and
possibly also on the methods to be used, and the temperature/pressure
range of data to be set up. When you have supplied the necessary
information, a PSF file will be generated, and you will be taken to the
PSF import facility, where you can opt to import the data you have
created into the input file of your HTFS program.
5-23
5-24 Properties Output
The first type of output can be either held in a separate file, or directed
to the main Lineprinter file. The separate file is the default. If you want it
in the main Lineprinter output, or turned off, select this on the Output
Options view, using the Options command under the Input menu.
The contents of the file format Physical Properties output can be set via
the Properties Output Options view, accessible from the main Physical
Properties (old style) input view. The output is in four parts:
• Input data for each stream/pressure level.
• Table of properties for each stream/pressure level.
• Stream/phase compositions for each stream/pressure level.
• Table of properties for each component.
For more information The third and fourth items are only relevant where mixture calculations
regarding properties
databank, refer to Section have been performed. Only the second item is produced by default. See
5.5 - Property Databanks. the Help Text for more information on the contents of the various parts
of the output. A further option, accessible via Output, lets you output
stream data to a stream properties databank.
5-24
Physical Properties 5-25
If you are using the program to calculate stream properties for a mixture
of known composition, then it is very simple to define two pressure
levels in the properties input. This normally happens by default when
you are using Thermo. If you are using Physical Properties (old style)
input you will need to use the Add Pressure key. You must then specify
the pressure for each level (if you only have one level, you can use a
default pressure). You should select the pressures to span the range
expected in the exchanger.
You can specify data at more than two pressure levels for a stream if you
want. This is unlikely to be necessary if the stream pressure change is
less than 30% of the (absolute) inlet pressure.
When data are available at only one pressure, the PPP can, if specified,
estimate an allowance for pressure dependence, using the Clausius
Clapeyron equation. This will be less accurate for wide boiling range
mixtures. To allow for pressure dependence in such cases, use the
checkbox on the main Physical Properties (old style) input view.
5-25
5-26 Pressure Dependence
If the properties data you have available are not isobaric data, but
contain some inherent pressure dependence, for example from inlet to
outlet, then in many cases you can use this data with relatively minor
inaccuracies. You should not select Pressure Dependence in such cases.
Data with an inherent pressure dependence are, however, not
acceptable for two-phase streams that are pure substances, or
azeotropes, or for which the change in saturation temperature due to
pressure changes is comparable with, or larger than, the isobaric boiling
range.
5-26
Examples 6-1
6 Examples
6.1 Overview...........................................................................................3
6-1
6-2 Examples
6-2
Examples 6-3
6.1 Overview
The following examples will guide you through a number of cases in
order to illustrate some of the typical problems, which PIPE can help to
solve:
1. Single Component Two-phase Flow, using PIPE in PRESSURE
DROP mode, evaluating the pressure drop in a pipeline, MASS
FLOWRATE mode, calculating the mass flowrate required for a
specified pressure drop and DIAMETER mode, calculating a
pipeline diameter.
2. Two-Phase Flow - Hydrocarbon Mixture, handling of mixtures.
3. Multiple Choking - Air Venting System, examining air flow through
a venting system, finding Maximum Mass Flowrate of air that can
pass through a system due to Choking.
6-3
6-4 Single Component Two-phase Flow
You should obtain the saturated water properties from the NEL40
databank at 10 and 8 bar to cover the expected range of pressures in the
system.
The water mass flowrate is 9000 kg/h with an inlet temperature and
pressure of 180oC and 10 bar absolute. The inlet quality is 0.0.
6-4
Examples 6-5
The following table lists the pipe fittings you will have to add to your
case to build this pipeline example:
The following table lists the information required to define the pipeline
units on the Change of Section view.
6-5
6-6 Single Component Two-phase Flow
Figure 6.1
6-6
Examples 6-7
You will see the standard HTFS program Welcome view. If you want to
load an existing file either
• Click on one of the recently used project files or
• Click on Existing and select the file that you want to run.
Figure 6.2
The data for the first example is already stored in the file
HTFS\PIPE520\QADATA\PIPE_2.PEI.
2. To build a new file, click on New.
6-7
6-8 Single Component Two-phase Flow
3. When creating a new data set you should complete the Start up view
which appears automatically after the Welcome view and is shown
in Figure 6.3.
Figure 6.3
This may be access again and modified by selecting Start up from the
Input menu. After completing this view, the Build Pipeline view will
appear.
4. Add the pipeline components as shown in Figure 6.4.
Figure 6.4
6-8
Examples 6-9
A schematic for each of the fittings will appear on the left side of the
view. You may remove, add or move a fitting by clicking with the left
mouse button and selecting the appropriate button from the editor
button bar which automatically appears at the bottom of the view.
Once you have established the amount and order of the fittings in your
pipeline you should then add information about them.
2. Click on each of the fittings with the right mouse button or select
See the table at the beginning the fitting type from the Input menu.
of the Example for data to
input.
If the schematic of a fitting is outlined in red in the spreadsheet you
MUST enter data marked with an asterisk. The schematic should then
turn black. This means that you have supplied enough data for PIPE to
perform calculations on the fitting. An example of data entry for straight
pipe sections is shown in Figure 6.5.
Figure 6.5
6-9
6-10 Single Component Two-phase Flow
Only the diameter of the first length of pipe was supplied. The other pipe
lengths use the diameters of the previous fitting as a default value. You
must always supply values for pipe length as there is no default. You
need only supply the angle of inclination if the pipe is not horizontal.
6-10
Examples 6-11
After specifying the process conditions you should supply the physical
properties of the fluid in the pipeline. To do this you select Physical
Properties from the Input menu, or use the Physical Properties icon.
Physical Properties icon
The Properties view in Figure 6.7 will appear on the screen.
Figure 6.7
6-11
6-12 Single Component Two-phase Flow
When the property view appears there should be a single tab labelled
Stream 1 at the top left of the form. You should
1. Click on Water from NEL40 as the Data Source.
2. Enter pressures of 10 bar (the inlet pressure) and 8 bar (an estimate
for the outlet pressure).
3. Close the Physical Properties form and click on Yes to save the
properties data.
When you have completely specified the geometry of the pipeline, the
process conditions and the physical properties of the fluid, you will have
enough data to run PIPE.
4. To assign identification to your run or change the settings within the
pressure drop calculations you should select Options from the Input
menu on the menu bar.
Calculate Results
1. From the main menu select Run and Calculate All, or use the Run
icon.
PIPE will now check the input data for consistency, correct any minor
Run icon
errors where possible and start the pressure drop calculation. A Status
report displays the progress of the calculations. On successful
completion a summary of the results will be displayed. Any problems
will be reported on this view and direct you to look at the Error/Message
Alternatively you can use the Log or Line Printer output via the Output menu. The Line Printer
search facility and look for output provides detailed warning messages so if there is a problem go
WARNING or FATAL.
straight to this and then scroll down to find the messages.
6-12
Examples 6-13
Figure 6.8
6-13
6-14 Single Component Two-phase Flow
To examine how conditions vary along the length of the pipeline you
should select Graphical Results from the Output menu. The view in
Figure 6.9 will appear.
Figure 6.9
You may also examine tables of the pressure drops over each of the
fittings, and velocities through each of the straight lengths of pipe.
The Output menu also has a Physical Property option which allows you
to look at the variation of the physical properties of the fluid for both the
liquid and vapour phases (if present) as the process conditions change
along the length of the pipeline.
6-14
Examples 6-15
You can also see graphical profiles of a range of variables along the
length of the pipeline. If you click on the Graph tab in the Pipe Output
view, the view in Figure 6.10 appears.
Figure 6.10
If you select Absolute Pressure from the menu the following profile of
the pressure along the length of the pipeline appears.
Figure 6.11
6-15
6-16 Single Component Two-phase Flow
The profile begins at the inlet conditions and continues to the end of the
pipeline. By clicking on the Fittings Profile button you may also view a
graph of the PIPE output against fitting type as shown in Figure 6.12.
Figure 6.12
The results of the PIPE run are given in full in the Lineprinter file which
you may select from the Output menu. The 80 column output is an
abbreviated version of the full output. The Output menu also gives you
the option of seeing the results of the physical property calculations at
the pressures and temperatures which you supplied.
6-16
Examples 6-17
Figure 6.13
You must provide an estimate of the Mass Flowrate in the Process form.
PIPE uses this as the initial value in its iterative pressure drop
calculations. The mass flowrate calculated by PIPE is that for which the
corresponding pressure drop converges to the supplied value. So to run
PIPE in MASS FLOWRATE mode you must also supply the Downstream
or Outlet Pressure.
6-17
6-18 Single Component Two-phase Flow
2. This downstream pressure is 9.109 bar and the estimate of the mass
flow rate required to give the 2 bar pressure drop is 7000 kg/h. These
are entered in the process view as shown in Figure 6.14.
Figure 6.14
Figure 6.15
6-18
Examples 6-19
Figure 6.16
6-19
6-20 Single Component Two-phase Flow
2. Access the Process view and supply the values of the Mass Flowrate
and the Outlet Pressure as shown. See Figure 6.17. The downstream
pressure is 0.5 bar and the mass flowrate is 10000 kg/h.
Figure 6.17
Figure 6.18
6-20
Examples 6-21
Item Setting
Flowrate 5000 kg/h
Temperature -100
Pressure 19.14 bar (abs)
Quality 0.587
6-21
6-22 Two-phase Flow - Hydrocarbon Mixture
Thermal conductivities are not needed by PIPE, but at least one dummy
value (e.g. 0.5) should be input for each phase to ensure that data checks
are not failed.
6-22
Examples 6-23
After you have filled in the Geometric and Process data as in the
previous example you should select Physical Properties from the Input
menu or click on the Physical Properties icon in the toolbar at the top.
You should then fill in the Properties view with the settings shown in
Physical Properties icon Figure 6.19. This is done by clicking on Direct Input in the Stream Data
Source box filling in the form for each pressure level.
Figure 6.19
6-23
6-24 Two-phase Flow - Hydrocarbon Mixture
Once you have completed the property table for each level you may run
PIPE does not require
thermal conductivity
the data. A summary of the results is shown in Figure 6.20.
data. However, you
should enter a sensible Figure 6.20
value to prevent error
messages being
generated.
6-24
Examples 6-25
6-25
6-26 Multiple Choking - Air Venting System
Figure 6.22
The fittings in the pipeline and their dimensions are listed in the table:
Diameter
Description Length (m) Angle (deg)
Upstream (m) Downstream (m)
Upstream Vessel - - - -
Flush Inlet - 0.01 - -
Straight Pipe 0.01 0.01 0.1 0
Sudden Enlargement 0.01 0.025 - -
Straight Pipe 0.025 0.025 5.0 0
Sudden Enlargement 0.025 0.05 - -
Straight Pipe 0.05 0.05 10.0 0
For the purposes of data input the Upstream vessel should not be
regarded as part of the pipeline.
6-26
Examples 6-27
You can use PIPE to find the Maximum Mass Flowrate of air that can
pass through the system due to Choking.
Item Setting
Inlet Temperature 126.85
Inlet Pressure 50 bar
Outlet Pressure 1.013 bar
Inlet Quality 1.0
Mass Flowrate 691 kg/h
The estimate of Mass Flowrate shown is used by PIPE as the initial value
in its iterative pressure drop calculations.
When supplying properties you should treat the air as a vapour. Select
the <Air(NEL40)> properties data bank from the Stream Data Source
box. You should specify Five pressure levels to accurately evaluate the
properties over the full range of possible pressures in the pipeline. The
recommended levels are 50, 30, 10, 5 and 1 bar.
6-27
6-28 Multiple Choking - Air Venting System
After running PIPE with this data you may view a summary of the results
by choosing Brief Output from the Output menu. This is shown in
Figure 6.23.
Figure 6.23
PIPE has calculated that the maximum mass flowrate of air that can pass
through the system is 1636.74 kg/h with a corresponding pressure drop
of 8.177 bar. Since the inlet pressure is 50 bar this mass flowrate appears
to be too small to achieve the specified atmospheric pressure at the vent
outlet.
You can model this situation using PIPE by invoking the Multiple Choke
option. When PIPE encounters a choke point it represents the
associated pressure drop singularity by inserting a program-generated
dummy fitting immediately after the fitting where the choking first
occurs. The pressure drop over this fitting represents the singularity. If
there are no more choke points in the system with this flowrate the
pressure loss over the dummy fitting is adjusted until the system outlet
6-28
Examples 6-29
pressure is achieved. If there are further choke points in the system, the
program will insert dummy fittings at these points until the outlet
pressure is achieved.
You may only use this option You can activate the Multiple Choke option on the Start up view. A
in MASS FLOWRATE mode. summary of the results of running PIPE with the Multiple Choke option
activated is shown in Figure 6.24.
Figure 6.24
6-29
6-30 Multiple Choking - Air Venting System
The Pressure Profile along the length of the pipeline is shown in Figure
6.25 with the Multiple Choke points indicated.
Figure 6.25
6-30
Index
A Diameter Defaults 3-9
Geometry 3-19
Absolute Pressure 1-5, 6-25
Geometry and Process Data Input 6-9
B Get Properties 5-8
Graphical Results 6-14, 6-25
Build Pipeline 2-5, 3-6
H
C
Help 3-17
Calculation Mode 2-6 Help Text 1-6, 2-3
Calculation Type 3-3 Homogeneous Velocity 1-5
Change of Section HYSYS 5-21
Contractions and Inlets 3-11
Enlargements and Outlets 3-11 I
Component Properties 3-19
Icons 2-9
Components
Change of Section 2-9
Calculation of the Properties of a Mixture 5-13
Exit 2-10
Contractions and Inlets 3-11
Find Input Item 2-9
Borda Inlets 3-11
Help 2-10
Flush Inlets 3-11
Known Pressure Change 2-9
Gradual Contractions 3-11
New 2-9
Sudden Contractions 3-11
Open 2-9
Convert Option 3-16
Options 2-10
Copy 4-8
Orifices 2-9
D Physical Properties 2-10
Pipe Sections 2-9
Data Input 3-1 Preview Input File 2-9
Databank 5-12 Process 2-10
Default Input Data File 3-20 Run 2-10
Default Units 3-16 Save 2-9
Determination of Mass Flowrate 6-17 Valves 2-9
Diameter 2-6, 3-14, 6-4 View Geometry Diagram 2-10
DIPPR 5-18 Importing from a Properties Package 5-23
Documentation 1-6 Importing Properties and Process Data 5-19
Downstream Diameter 3-11 Importing PSF Files 5-19
E Information Message 3-21
Input 3-15
Enlargements and Outlets 3-11 Input Directly 5-11
Error / Warning Message Log 2-7, 4-8 Input Errors and Warnings 3-21
Examining the Results 6-13 Input File 3-19
Examples 6-1 Input Item Identifier 3-18
F Input Items
Finding 3-18
Find 1-5, 4-8 Main Properties 3-18
Find Input Item 3-18 Physical Properties 3-18
Find Next 4-8 Input Units 3-15
Font 4-8 Input Views 3-4
G Change of Section 3-4
Known Pressure Change 3-4
Geometric Data (General) 3-9 Options 3-4
I-1
I-2 Index
I-2
Index I-3
I-3
Index I-4
I-4
Index I-5
I-5
I-6 Index
I-6