Aspen Plus 8.0 Guide
Aspen Plus 8.0 Guide
Aspen Plus 8.0 Guide
Aspen Plus, aspenONE, the aspen leaf logo and Plantelligence and Enterprise Optimization are trademarks or
registered trademarks of Aspen Technology, Inc., Burlington, 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.
1 Getting Started....................................................................................................5
The Summary File and Toolkit............................................................................6
Initializing the Toolkit .......................................................................................6
Accessing the Required Files ....................................................................7
Getting the Summary File Name ........................................................................7
Getting Property and Units File Names ......................................................7
Defining Units of Measurement ................................................................8
Specifying a Value for Missing Results.......................................................8
Determining the Data Dimensions ......................................................................8
Retrieving Data for an Object.............................................................................9
Using the Toolkit With a Hierarchical Aspen Plus Run .......................................... 11
Linking Toolkit Subroutines into Your Module ..................................................... 11
Creating a Toolkit Application for Windows ........................................................ 11
About the Windows Version ................................................................... 12
Linker Directive Commands for Windows ........................................................... 12
Calling Summary File Toolkit Routines .............................................................. 13
Opening and Closing Files Using the Summary File Toolkit......................... 13
Using Fortran to Call Routines................................................................ 14
Changes in the Toolkit .................................................................................... 14
2 General Subroutines..........................................................................................15
Initializing the Summary File Toolkit ................................................................. 16
Closing the Summary File Toolkit ..................................................................... 17
Opening and Closing Files................................................................................ 18
Retrieving Run Information ............................................................................. 19
Standard Run Information ..................................................................... 19
Run Titles............................................................................................ 20
Accounting Information......................................................................... 21
Retrieving Flowsheet Balance Results................................................................ 21
Units Conversion ............................................................................................ 22
Changing Units Sets ............................................................................. 22
Converting Units for Real Numbers ......................................................... 23
Determining Units Labels ...................................................................... 23
Component Information Retrieval..................................................................... 24
Number of Components ........................................................................ 24
Component IDs .................................................................................... 25
Component Alias Names ....................................................................... 25
Contents iii
Component CAS Numbers ..................................................................... 26
Component Properties .......................................................................... 26
Sensitivity Block Results ................................................................................. 26
Identifying Sensitivity Blocks ................................................................. 27
Determining Sensitivity Dimensions........................................................ 27
Retrieving Sensitivity Results................................................................. 28
iv Contents
Additional PetroFrac Profile Properties..................................................... 56
Additional Property Profiles.................................................................... 56
Furnace Data for PETROFRAC ................................................................ 57
Component-Dependent Properties for the PetroFrac Furnace ..................... 58
Pumparound Results for PetroFrac Columns............................................. 58
Connectivity Data for PetroFrac Strippers ................................................ 59
Additional Data for RateFrac Models ....................................................... 60
Dimensions of Additional Scalar Data...................................................... 60
Additional Scalar Results Data ............................................................... 60
Dimensions of Component Split Fractions ................................................ 61
Component Split Fractions..................................................................... 61
Number of Liquid Phases ....................................................................... 62
Tray Reports.................................................................................................. 62
Tray Report Dimensions ........................................................................ 62
Sequential Tray Report Properties .......................................................... 63
Specific Tray Report Properties .............................................................. 64
Tray/Packing Sizing and Rating ........................................................................ 64
Number of Columns.............................................................................. 65
Number of Column Sections .................................................................. 65
Column Section Types and Numbers ....................................................... 65
Size of a Column Section....................................................................... 66
Scalar Results for a Column Section ....................................................... 67
Column Section Profile Properties ........................................................... 67
Column Section Profiles......................................................................... 68
Reactor Results.............................................................................................. 69
Number of Reactor Substreams.............................................................. 69
Reactor Profile Dimensions .................................................................... 69
Reactor Profile Properties ...................................................................... 70
Non-Component-Dependent Reactor Profiles............................................ 70
Component-Dependent Reactor Profiles .................................................. 71
Number of Components with Component Attribute Results ........................ 72
Number of Attributes for a Component.................................................... 72
Details of a Component Attribute ........................................................... 72
Component Attribute Results ................................................................. 73
Number of Continuous Feed Streams ...................................................... 73
Continuous Feed Stream Results ............................................................ 74
RBATCH Vent Accumulator Results ......................................................... 74
RBatch Vent Profile Results.................................................................... 77
Reaction Data ...................................................................................... 79
Reactor Property Reports ................................................................................ 82
Number of Reports for a Reactor Block.................................................... 82
Size of a Reactor Property Report........................................................... 82
Sequential Reactor Report Properties ...................................................... 83
Specific Reactor Report Properties .......................................................... 84
Pipeline Results.............................................................................................. 84
Pipeline Results Dimensions................................................................... 85
Non-Component-Dependent Pipeline Inlet and Outlet Conditions ................ 85
Component-Dependent Pipeline Inlet and Outlet Property Names ............... 86
Component-Dependent Pipeline Inlet and Outlet Conditions....................... 87
Segment Data Property Names .............................................................. 87
Pipeline Segment Data.......................................................................... 88
Pipeline Node Property Names ............................................................... 88
Pipeline Node Results............................................................................ 89
Contents v
Pipeline Profile Property Names.............................................................. 89
Pipeline Profile Results .......................................................................... 90
Pipe Results................................................................................................... 90
Pipe Standard Profile Dimensions ........................................................... 91
Pipe Standard Profile Property Names ..................................................... 91
Pipe Standard Profile Properties ............................................................. 91
Pipe Property Reports ........................................................................... 92
Block VLE Results ........................................................................................... 94
Heating/Cooling Curves................................................................................... 94
Number of Heating/Cooling Curves for a Block ......................................... 95
Heating/Cooling Curves for a Block......................................................... 95
Size of a Heating/Cooling Curve ............................................................. 96
Standard Heating/Cooling Curve Results ................................................. 97
Sequential Heating/Cooling Curve Properties ........................................... 97
Specific Heating/Cooling Curve Properties ............................................... 98
Interconnecting Stream IDs................................................................... 99
vi Contents
6 Costing Results Subroutines............................................................................119
Equipment Item Identification........................................................................ 120
Determining Number of Equipment Items.............................................. 120
Listing Equipment Items ..................................................................... 120
Determining Next Equipment Item ....................................................... 120
Equipment Item Results ................................................................................ 121
Retrieving Equipment Item Costing Results ........................................... 121
Determining Equipment Item Sizing Results .......................................... 121
Retrieving Equipment Item Sizing Results ............................................. 122
8 Examples.........................................................................................................137
Example 1: Stream Heat and Material Balance Table Generation ........................ 137
Declaring Variables and Dimensioning................................................... 137
Initializing the Toolkit ......................................................................... 138
Finding Number of Streams ................................................................. 139
Finding Component Molecular Weight ................................................... 139
Writing Stream Table .................................................................................... 140
Example 2: Interactive Heating/Cooling Curve Table Generation ........................ 143
Declaring Variables............................................................................. 143
Initializing the Toolkit ......................................................................... 143
Finding Number of Blocks .................................................................... 143
Finding Blocks with Heating/Cooling Curves........................................... 144
Prompting for Block Name ................................................................... 145
Finding Heating/Cooling Curves for Selected Block ................................. 145
Finding Dimensions of Heating/Cooling Curve ........................................ 146
Retrieving Standard Heating/Cooling Curve Results ................................ 146
Retrieving Property Sets ..................................................................... 147
Example 3: Column Profile Results Written to Plot File ...................................... 150
Contents vii
Opening Files and Initializing Toolkit ..................................................... 150
Finding List of Blocks .......................................................................... 151
Finding List of Properties ..................................................................... 151
Retrieving Selected Property Profile ...................................................... 152
Closing the Application........................................................................ 152
Example 4: Distillation Column Diagram Generation ......................................... 154
Initializing the Toolkit ......................................................................... 154
Retrieving Basic Block Results.............................................................. 154
Retrieving Inlet and Outlet Stream Flows .............................................. 155
Finding Inlet and Outlet Stream IDs ..................................................... 156
A Units ...............................................................................................................161
Table A.1 - Units Options .............................................................................. 163
viii Contents
Index ..................................................................................................................203
Contents ix
x Contents
Who Should Read this Guide
The intended audience for this toolkit is application developers who need to
get information from Aspen Plus simulations into their applications, and prefer
a file based data transfer to data transfer through OLE Automation.
An Aspen Plus summary file is an ASCII file produced by Aspen Plus for every
simulation run, containing all the results for that run. The Summary File
Toolkit is a set of Fortran subroutines that you can use to build a program to
extract results from an Aspen Plus summary file.
This reference manual describes the Summary File Toolkit and how to build
programs using the toolkit.
The manual assumes that you are familiar with Fortran, Aspen Plus, and the
results of an Aspen Plus simulation.
There is also an XML Results file available from Aspen Plus which can be
processed by standard XML tools. See Chapter 9 for some information about
this file.
Related Documentation
Title Content
Aspen Plus Getting Started Building and Tutorials covering basic use of
Running a Process Model Aspen Plus. A prerequisite for the
other Getting Started guides
Aspen Plus Getting Started Modeling Tutorials covering the Aspen plus
Processes with Solids features designed to handle solids
Aspen Plus Getting Started Modeling Tutorials covering the Aspen plus
Processes with Electrolytes features designed to handle
electrolytes
Aspen Plus Getting Started Using Tutorials covering the use of
Equation-Oriented Modeling equation-oriented models in
Aspen Plus
Aspen Plus Getting Started Customizing Tutorials covering the
Unit Operation Models development of custom unit
operation models in Aspen Plus
Aspen Plus Getting Started Modeling Tutorials covering the Aspen Plus
Petroleum Processes features designed to handle
petroleum
Aspen Plus User Guide Procedures for using Aspen Plus
Technical Support
AspenTech customers with a valid license and software maintenance
agreement can register to access the online AspenTech Support Center at:
http://support.aspentech.com
This Web support site allows you to:
Access current product documentation
Search for tech tips, solutions and frequently asked questions (FAQs)
Search for and download application examples
Search for and download service packs and product updates
Submit and track technical issues
Send suggestions
Report product defects
Review lists of known deficiencies and defects
Registered users can also subscribe to our Technical Support e-Bulletins.
These e-Bulletins are used to alert users to important technical support
information such as:
Technical advisories
Product updates and releases
Customer support is also available by phone, fax, and email. The most up-to-
date contact information is available at the AspenTech Support Center at
http://support.aspentech.com.
This chapter describes how to build an application program using the Aspen
Plus Summary File Toolkit. It contains information on:
The summary file and toolkit.
Initializing the toolkit.
Determining data dimensions.
Retrieving data for an object.
Using the toolkit with a hierarchical Aspen Plus run.
Linking toolkit subroutines into your module.
Creating a toolkit application for Windows.
Transferring the toolkit to another computer.
1 Getting Started 5
The Summary File and Toolkit
The summary file is an ASCII file produced by Aspen Plus for every simulation
run. This file contains the summary of simulation results, such as block
results, stream values, tray profiles, heating/cooling curves, and property
tables. The information in a summary file is also contained within the Aspen
Plus backup file. Summary files are named according to the form runid.SUM.
Backup files are named according to the form runid.BKP.
The summary file toolkit is a set of Fortran subroutines that retrieve results
information from the Aspen Plus summary file and backup file. (Use the
backup file with results, in place of the summary file, in procedures
throughout this manual.)
The subroutines are organized around the logical structure of the data. You
can retrieve selected results. Or you can retrieve all the results of a
simulation or simulation object (such as unit operation blocks or streams).
The Fortran source code for the subroutines is provided so that you can build
applications on any computer.
The Fortran source code is delivered in a self-extracting zip archive named
toolkit.exe in the Engine\Utl directory of the Aspen Physical Property System
installation (typically C:\Program Files\APrSystem
<version>\Engine\Utl\toolkit.exe).
The DLL is stored in the Engine\xeq directory of the Aspen Physical Property
System installation (typically C:\Program Files\APrSystem
<version>\Engine\xeq\zetoolkit.dll).
To use the summary file toolkit, an application program must perform three
steps:
1 Initialize the toolkit for a summary file.
2 Get the dimensions of the data to be retrieved.
3 Retrieve the data.
These three steps are described in the following sections.
6 1 Getting Started
Accessing the Required Files
You need to include file definitions for the following files during the
initialization process. The unit numbers for these files must match those
specified in the call to toolkit initialization routine TKINIT or TKINI2.
File Description
1 Getting Started 7
Example of Environment Variable for Windows
When running in an Aspen simulation engine window, the environment
variable ASPTOP points to the top level supplementary directory for Aspen
Plus. The TOOLKIT directory is a subdirectory of this directory. You can use
the following code to expand the file specification:
CALL GETENV('ASPTOP', ASPTOP)
DO 50 I = 80, 1, -1
IF (ASPTOP(I:I) .NE. ' ') GO TO 55
50 CONTINUE
55 CONTINUE
RCPROP = ASPTOP(1:I) // '\TOOLKIT\RCPROPNU.DAT'
RCUNIT = ASPTOP(1:I) // '\TOOLKIT\RCUNITS.DAT'
8 1 Getting Started
1 Querying the summary file for the existence of simulation objects and
data within an object.
2 Defining the size of the data for a simulation object.
The subroutine TKINFO returns the number of blocks, streams, property
tables, and sensitivity tables in the summary file.
Each type of simulation object has a subroutine to find the next object in
sequence. These subroutines are:
Object Type Subroutine to Find Next Object
Blocks TKNBLK
Streams TKNSTR
Property tables TKNPPT
Sensitivity tables TKNEXT
Equipment item TKNEQP
Pressure relief TKNXPR
1 Getting Started 9
Qualifier Description
10 1 Getting Started
Using the Toolkit With a
Hierarchical Aspen Plus Run
Most Aspen Plus objects, including hierarchies, can exist within hierarchies. In
such cases it is not sufficient to reference an object by type and eight
character ID. The object’s ID must contain the full hierarchical path to the
object, with each hierarchy name separated by a period (.). For example, if a
run contains hierarchy H1, which contains hierarchy H2, which contains block
B1, refer to the block as H1.H2.B1.
All toolkit subroutines that accept or return an object ID declare the argument
as CHARACTER *(*). When passing such an argument, set up the dimension
large enough to hold the hierarchical ID. If referencing a non-hierarchical
problem, declaring the ID arguments as CHARACTER*8 is sufficient.
Note: It is not possible to cycle through all blocks in a single hierarchy level.
1 Getting Started 11
About the Windows Version
The Windows version of the summary file toolkit consists of two files:
File Name Description
zetoolkit.dll The summary file toolkit dynamic-link library. This file is stored in the
Engine\xeq subfolder of the APrSystem installation, typically C:\Program
Files\APrSystem <version>\Engine\xeq\zetoolkit.dll
zetoolkit.lib Import library. This file contains the external references to the summary
file toolkit routines in zetoolkit.dll. This file is stored in the Engine\toolkit
subfolder of the Aspen Plus installation, along with the Fortran source
files.
The DLL and LIB are compiled and linked with Intel Fortran 9.1.
If you are using the summary file toolkit as part of a full installation of Aspen
Plus, you can compile and link toolkit applications with the Fortran compiler
for your Operating System. Make sure you are set up for running Aspen Plus.
Aspen Plus provides procedures to help use the Aspen Plus Fortran utilities.
The following table summarizes these procedures:
To do this Enter these commands
Where:
appname = The file name of the main Fortran application. Do not
include the file extension when specifying the file
name. ASPCOMP will accept Fortran files with the
extension .for.
appname.opt = Text file containing the linker directive commands. For
more information, see the following section, Linker
Directive Commands for Windows.
12 1 Getting Started
libifportmd.lib
-nodefaultlib:libifport.lib
libmmd.lib
-nodefaultlib:libm.lib
-nodefaultlib:libifcoremt.lib
-nodefaultlib:libmmt.lib
c:\Engine\toolkit\zetoolkit.lib
tkexample.obj
-out:tkexample.exe
Substitute c:\Engine with the appropriate drive and directory location where
the Aspen Plus Simulation Engine is installed. Replace tkexample with the
name of your application. Add any additional object files and libraries you
need to this directive file.
After creating the linker directive file for your application, you can use the link
and run commands to generate and run your application's executable
program.
1 Getting Started 13
Close the summary file and the log file with TKCLFL, at the end of each
run.
Do not use TKOPEN and TKCLFL for opening and closing the files your
application reads from or writes to.
14 1 Getting Started
2 General Subroutines
This chapter describes the purpose and use of subroutines in the Aspen Plus
Summary File Toolkit. Use the subroutines described in this chapter for:
Initializing the summary file toolkit.
Retrieving run information.
Retrieving flowsheet balance results.
Setting and changing units of measurement.
Retrieving component information.
Retrieving sensitivity results.
2 General Subroutines 15
Initializing the Summary File
Toolkit
Before you can retrieve any results from a summary file, you must call
subroutine TKINIT or TKINI2 to initialize the summary file toolkit.
TKINIT assigns Fortran unit numbers and unit names for files used by the
toolkit. See Initializing the Toolkit, Chapter 1, for information on identifying
the necessary files.
The scratch file is a direct access file used by the toolkit to store intermediate
data. You must supply a Fortran unit number for the scratch file.
To open the summary file and connect it to a unit number, you can:
Use a Fortran OPEN statement in your program.
Call TKOPEN routine (see Opening and Closing Files, this chapter), if using
the Windows DLL.
The property number file and the unit definition file are delivered with Aspen
Plus. The file names you specify to call TKINIT depend on the computer and
operating system you are using (see Getting Property and Units File Names,
Chapter 1).
TKINIT sets the default units set for all results data to the value of UNISET.
This can be one of four values: SI, ENG, MET, or OUT. The first three values
correspond to the Aspen Plus units sets with these names. OUT can be used
to retrieve the results from the summary file without any UOM conversion.
The data is retrieved in the same units as the Aspen Plus out units for the
run.
16 2 General Subroutines
Variable I/O † Type Dimension Description
If you initialize the toolkit with TKINIT, Aspen Plus writes errors or warnings
from the toolkit run to the screen. TKINI2 works in the same way as TKINIT,
except that it allows you to specify a Fortran unit number for error and
warning messages. This is useful for applications where messages should not
be written directly to the screen. Like the summary file, this file should
already be opened before calling TKINI2. If you specify a negative unit
number for the error and warning messages, they are turned off.
2 General Subroutines 17
Argument List Descriptions for TKCLOS
†
Variable I/O Type Dimension Description
18 2 General Subroutines
Argument List Descriptions for TKCLFL
†
Variable I/O Type Dimension Description
2 General Subroutines 19
Argument List Descriptions for TKINFO
†
Variable I/O Type Dimension Description
ISTATF
The values are:
0= Completed without errors,
1= Completed with errors,
2= None in this simulation,
The elements represent:
ISTATF(1): Block status,
(2): Convergence status,
(3): Sensitivity status,
(4): Case study status,
(5): Stream calculation status,
(6): Fortran and transfer status
Run Titles
Call subroutine TKTITL to retrieve the run title.
20 2 General Subroutines
Accounting Information
Call subroutine TKACCT to obtain accounting information for a run.
Accounting information is only available if requested in the Aspen Plus input.
2 General Subroutines 21
Argument List Descriptions for TKFLWB
†
Variable I/O Type Dimension Description
Units Conversion
Use the subroutines in this section to:
Change the units set for results.
Convert units for individual results.
Find units labels for results.
22 2 General Subroutines
Calling Sequence for TKUNIT
CALL TKUNIT (SETID, NTYPES, TYPES, LABELS, IERR)
2 General Subroutines 23
current units set is OUT units. (There is no such thing as a current unit for a
particular units type with OUT units.)
Component Information
Retrieval
Use the subroutines in this section to retrieve information about the
components in the simulation:
TKCOMP gets the number of components in the simulation.
TKCIDS gets the list of component IDs.
TKALIS gets lists of conventional components and their aliases.
TKCASN gets lists of components and their CAS numbers.
TKCPRP retrieves component properties, such as molecular weight, boiling
point, and standard volume.
Number of Components
Call subroutine TKCOMP to determine the number of components in a
simulation. TKCOMP returns the number of both conventional and
nonconventional components.
24 2 General Subroutines
Argument List Descriptions for TKCOMP
†
Variable I/O Type Dimension Description
Component IDs
Call subroutine TKCIDS to retrieve the component IDs for conventional and
nonconventional components.
2 General Subroutines 25
Component CAS Numbers
Call subroutine TKCASN to retrieve conventional component IDs and their
CAS numbers. CAS numbers will be blank for segments and user-defined
components.
Component Properties
Call subroutine TKCPRP to retrieve component properties for conventional
components. The properties that you can retrieve are molecular weight,
boiling point, and standard volume.
26 2 General Subroutines
3 Call TKSENS to retrieve the values for the table and the headers for the
columns.
2 General Subroutines 27
Retrieving Sensitivity Results
Call subroutine TKSENS to retrieve the results for a sensitivity table. The
columns are identified by the variable HEADER. The actual argument to
RVALS should be declared as a one-dimensional array of length, equal to or
greater than (NPOINT * NCOL). The results in each column are stored
consecutively.
28 2 General Subroutines
3 Block Result Subroutines
This chapter describes the use of block result retrieval subroutines in the
summary file toolkit. Use the subroutines described in this chapter for:
Block identification, connectivity, and results.
Compressor results.
Heat exchanger results.
Column results.
Tray reports and tray/packing sizing and rating.
Reactor results and property reports.
Pipeline results.
Block vapor-liquid equilibrium (VLE) results.
Heating/cooling curves.
Block IDs
Call subroutine TKBIDS to get the list of blocks and model types.
Next Block
Call subroutine TKNBLK to find the name of the next unit operation block.
To find the block ID of the first block, set IBLOCK to 1. To find the name of
the second block, set IBLOCK to 2, and so on.
Detailed Results
Call subroutine TKHXD1 to retrieve the first set of detailed results (such as,
areas and heat transfer coefficients) for the heat exchanger.
Column Results
You can retrieve column profile results from the summary file for the rigorous
distillation models RadFrac, MultiFrac, Extract, PetroFrac, and RateFrac. You
can retrieve most column results using the following four-step process. See
also RadFrac Thermosiphon Reboiler Results, Additional Data for PetroFrac
Models, and Additional Data for RateFrac Models, this chapter.
1 Call subroutine TKNCOL to determine the number of columns for
MultiFrac, PetroFrac, and RateFrac.
2 Call subroutine TKPROF to determine the dimensions of the profile.
3 Call subroutine TKPROP to list the properties.
4 Call subroutine TKPRO1 to retrieve the property values for
non-component-dependent properties, or subroutine TKPRO2 to retrieve
the property values for component-dependent properties.
Most of the column subroutines take the argument ICOL, which represents
the column number. This is always 1 for RadFrac and Extract. For MultiFrac
and RateFrac this is the column number: 1, 2, and so on. With PetroFrac the
main column is numbered 1 and the strippers are numbered starting with 2.
The actual name of a stripper can be retrieved using TKPTRS.
RateFrac models have segments rather than stages. The references to
NSTAGE used in the descriptions of the column routines, apply to the number
of segments in a RateFrac column.
Number of Columns
Call subroutine TKNCOL to determine the number of columns in a block using
a staged separation model. TKNCOL returns a value of 1 for Aspen Plus
models RadFrac and Extract. It returns the number of columns for MultiFrac
and RateFrac. For PetroFrac, NCOL equals the number of strippers plus 1 for
the main column. All other models return 0.
Number of Components
Call subroutine TKTRNR to determine the number of components present, the
number of component-dependent properties with results, and the number of
properties with results that are non-component-dependent. If the unit does
not have a thermosiphon reboiler, NRES, NCPROP, and NCP are all returned
as 0.
Reboiler Results
Call subroutine TKTRRS to retrieve the property names and values for the
thermosiphon reboiler. Two sets of property names and values are returned:
one for the component-dependent results and one for the non-component-
dependent results. Note that the component-dependent data is returned in a
single array, with all the results for a single property returned in consecutive
elements of the CRVALS array.
Tray Reports
Tray report results are calculated when the Tray-Report option is chosen for a
rigorous distillation model. The user defines the properties calculated and the
stages for which they are calculated.
Number of Columns
If you want to retrieve MultiFrac or PetroFrac data, call TKNCOL. (See
Column Results, this chapter.) Omit this step if you want to retrieve
RadFrac data.
Non-Component-Dependent Reactor
Profiles
Call subroutine TKRPR1 to retrieve reactor profiles for non-component-
dependent properties.
Reaction Data
You can retrieve the reaction equilibrium constants for each reaction in the
REquil and RGibbs models. For the RStoic model you can retrieve the reaction
extent and the heat of reaction for each reaction. You can also retrieve the
component selectivity for RStoic. You can retrieve reaction data using a three-
step process:
1 Call subroutine TKRRPF to determine the number of reactions.
2 Call subroutine TKRRPR to retrieve the equilibrium constants or reaction
data.
3 Call subroutine TKRRHR to retrieve the heat of reaction data for RStoic.
Use these additional two steps to retrieve the component selectivity
results:
4 Call subroutine TKRRNS to determine the number of selectivity results.
5 Call subroutine TKRRSL to retrieve the component selectivity results.
Number of Reactions
Call subroutine TKRRPF to determine the number of reactions in the REquil,
RGibbs, and RStoic models.
Reaction Results
Call subroutine TKRRPR to retrieve the reaction results. TKRRPR returns a
single property, equilibrium constant for REquil and RGibbs models, and
reaction extent for RStoic models. Specify NPROP as 1.
Heats of Reaction
Call subroutine TKRRHR to retrieve the heats of reaction results for RStoic
models. The heat of reaction and the ID of the reference component in the
reaction are returned for each reaction.
Pipeline Results
You can retrieve all the pipeline model results with the toolkit. Retrieve block
results using the standard block result routine TKBRES. Retrieve other results
using the routines described in this section.
Retrieving all the additional pipeline results is a ten-step process:
1 Call subroutine TKPLSZ to retrieve the dimensions of the pipeline results.
2 Call subroutine TKPLIO to retrieve the inlet and outlet conditions.
3 Call subroutine TKPLCP to retrieve the inlet and outlet property names for
components in a pipeline.
4 Call subroutine TKPLCO to retrieve the inlet and outlet conditions for
components in a pipeline.
Pipe Results
You can retrieve all the results for the single-segment pipeline model Pipe,
using the standard block results routines TKNRES and TKBRES. Retrieve other
results using the routines described in this section.
You can retrieve Pipe results using a six-step process:
1 Call subroutine TKPISP to retrieve the dimensions of the standard profiles.
2 Call subroutine TKPINP to retrieve the names of the standard profile
properties.
3 Call subroutine TKPIPR to retrieve results for standard profile properties.
4 Call subroutine TKPLSZ to retrieve the number of fluid properties. For a
description of TKPLSZ, see Pipeline Results Dimensions, this chapter.
5 Call subroutine TKPLPP to retrieve the names of the fluid properties. For a
description of TKPLPP, see Pipeline Profile Property Names, this chapter.
6 Call subroutine TKPLPR to retrieve the fluid properties results. For a
description of TKPLPR, see Pipeline Profile Results, this chapter.
Heating/Cooling Curves
Aspen Plus can calculate heating/cooling curves for unit operation models
Heater, Flash2, Flash3, HeatX, MHeatX, MCompR, RadFrac, MultiFrac,
RateFrac, and PetroFrac. A unit operation block can have any number of
heating/cooling curves. Many unit operation models allow for multiple types of
heating/cooling curves.You can retrieve heating/cooling curve results using a
five-step process:
HCURVE Standard
HOT Hot side
COLD Cold side
REBOILER Reboiler
CONDENSER Condenser
ICSTREAM Interconnecting stream heater
PUMPAROUND Pumparound
STRIPPERREBOILER Stripper reboiler
This chapter describes the use of stream result retrieval subroutines in the
Aspen Plus summary file toolkit. Use the subroutines described in this chapter
for:
Stream identification.
Material stream results.
Heat and work stream results.
Component attribute results.
Substream attribute results.
Stream property set results.
Stream Identification
The following subroutines are used to identify streams in the summary file:
TKSIDS returns a list of all the streams in the summary file.
TKNSTR returns the next sequential stream.
Both routines return the stream type (MATERIAL, HEAT, or WORK).
You can retrieve all property table results using a standard set of subroutines.
There is a separate set of subroutines for retrieving pressure-temperature
envelope results.
This chapter describes:
Property table identification.
Property and flashcurve table results.
Pressure-temperature envelope results.
Pressure-Temperature
Envelope Results
You can retrieve pressure-temperature envelope results using a four-step
process:
1 Call TKNENV to determine the number of envelopes and properties in a
property table.
2 Call TKSENV to determine the size of each branch of an envelope.
3 Call TKPTEV to retrieve the temperature and pressure along each branch
of an envelope.
4 Retrieve the property set for each branch of an envelope. You can retrieve
each property sequentially using TKNPEV, or retrieve a specific property
using TKPPEV.
This chapter describes the use of costing equipment item retrieval subroutines
in the summary file toolkit. Use the subroutines described in this chapter for
retrieving this information about equipment items:
Identification.
Costing and sizing results.
This chapter describes the use of pressure relief retrieval subroutines in the
summary file toolkit. Use the subroutines described in this chapter for:
Pressure relief model identification.
Dynamic and steady-state results.
Scalar results.
Profile results.
Vessel results.
Vent results.
Accumulator results.
Retrieving Non-Component-Dependent
Dynamic Profiles
Call subroutine TKPSR1 to retrieve profiles for non-component-dependent
properties. The results are independent of the substream.
Retrieving Non-Component-Dependent
Vent Accumulator Profiles
Call subroutine TKPAR1 to retrieve vent accumulator profiles for non-
component-dependent properties. The corresponding times for each profile
point are retrieved using the property name TIME.
The Fortran source code for these examples is in the Engine\user directory of
the Aspen Plus installation. They are named sftex#.f where # is the number
of the example.A summary file (sftex.sum) and the input file used to generate
it (sft.inp) are also in the same directory.
8 Examples 137
+ ID*8, TYPE*12, IDS*8, QUALS*16, TYPES*12,
+ LABELS*16,OLDNAM*16, PLUS*16, EXCL*16, PNAMES*12,
+ SSID*8,COMPID*8, PHASE*8, WETDRY*4, BASIS*4,
+ OLDPHS*8, KFF*1,OLDLAB*16, SOURCE*8, DEST*8
C
C Dimension arrays for the toolkit routines.
C Arrays are dimensioned for 5 streams, 1000 properties,
C and 100 components.
C
DIMENSION QUALS(4,1000), TYPES(1000), LABELS(1000),
+ PNAMES(1000), SSID(1000), COMPID(1000),
+ PHASE(1000), WETDRY(1000), BASIS(1000)
DIMENSION SVALS(1000, 5), IDS(5)
DIMENSION XMW(100)
138 8 Examples
Finding Number of Streams
To find the streams, TKINFO is called to determine the number of simulation
objects in the summary file. The variable NSTRM is the total number of
streams.
C Get the number of streams by calling TKINFO.
C
CALL TKINFO(VERSN, RUNID, DATE, INFILE, ISTAT, IWORK,
+ NBLK, NSTRM, NTABLE, NSENS )
8 Examples 139
+ WETDRY, BASIS, SVALS(LL, NPPG), TYPES(LL),
+ LABELS(LL), IERR)
140 8 Examples
IF (IEND .EQ. 0) WRITE(7, 31) (PLUS,II=1,NPPG), EXCL
ICOMP = ICOMP + 1
ENDIF
500 CONTINUE
C
C Loop through the PROP-SET properties. The properties are
C sorted by phase. If the current phase is different from
C the previous phase, then print a new phase header.
C
OLDNAM = ' '
OLDPHS = ' '
OLDLAB = ' '
IFIRST = 1
DO 600 J = 1, NPROP
L = J + LEN
IF (PHASE(J) .NE. OLDPHS) THEN
C First item is already preceded by a line
IF (IFIRST .EQ. 0) THEN
WRITE(7, 31) (PLUS,II=1,NPPG), EXCL
ELSE
IFIRST = 0
ENDIF
WRITE(7, 40) PHASE(J), (EXCL,II=1,NPPG), EXCL
ENDIF
C
C Check for a component qualifier on the property.
C
IF (COMPID(J) .EQ. ' ') THEN
WRITE(7, 31) (PLUS,II=1,NPPG), EXCL
WRITE(7, 20) PNAMES(J), LABELS(L),
+ (SVALS(L,JJ),JJ=1,NPPG)
OLDNAM = PNAMES(J)
OLDLAB = LABELS (L)
ELSE
C
C For component-dependent properties, write the name for
C the set of components only once.
C
IF (PNAMES(J).NE.OLDNAM .OR. LABELS(L).NE.OLDLAB) THEN
WRITE(7, 31) (PLUS,II=1,NPPG), EXCL
WRITE(7, 21) PNAMES(J),LABELS(L),
+ (EXCL,II=1,NPPG),EXCL
ENDIF
OLDNAM = PNAMES(J)
OLDLAB = LABELS(L)
WRITE(7, 22) COMPID(J), (SVALS(L,JJ),JJ=1,NPPG)
ENDIF
OLDPHS = PHASE(J)
600 CONTINUE
C Underline the final item
WRITE(7,31) (PLUS, II=1, NPG), EXCL
8 Examples 141
MOLEFLOW KMOL/HR
142 8 Examples
Example 2: Interactive
Heating/Cooling Curve Table
Generation
This example retrieves heating/cooling curve results from unit operation
blocks. The summary file is queried for a list of blocks containing curve
results. This example uses a toolkit utility routine TKUPPR, that takes a
character string as an argument and uppercases it. A sample of the program
dialog is shown in Figure 8.2. A sample of the output is shown in Figure 8.3.
Declaring Variables
Declarations and dimensions are similar to those in Example 1. But in this
example, the paths for the properties and units files are coded into the
program.
C
C Data statements
C
DATA UNISET / 'ENG' /
DATA PLUS / '-----------------+' /
DATA EXCL / '-----------------!'/
DATA RMISS / 1.0D35 /
DATA RCPROP / 'C:\Aspen Plus\Engine\Toolkit\RCPROPNU.DAT' /
DATA RCUNIT / 'C:\Aspen Plus\Engine\Toolkit\RCUNITS.DAT' /
8 Examples 143
Finding Blocks with Heating/Cooling
Curves
One method of listing the blocks is to loop through them by calling TKNBLK.
This allows a check of each block for the existence of heating/cooling curves.
C
C Prompt the user to have Hcurves checked for the block.
C To check for Hcurves, loop through all the blocks by
C calling TKNHCV.
C If the block has an Hcurve, load its ID and model type
C into the ID arrays.
C
100 CONTINUE
NITEM = 0
NSET = 0
DO 200 I = 1, NBLK
I1 = NITEM + 1
CALL TKNBLK(I, ID8(I1), ID12(I1), IERR)
IF (IERR .NE. 0) GO TO 200
CALL TKNHCV(ID8(I1), NCURVE)
IF (NCURVE .EQ. 0) GO TO 200
NITEM = NITEM + 1
C
C If there are more than 100 blocks with Hcurves,
C the work area will be filled. Write the first 100 blocks
C to the list.
C
IF (NITEM .LT. 100 .OR. I .EQ. NBLK) GO TO 200
IF (NSET .EQ. 0) THEN
WRITE(6, *)
+ ' The following blocks contain Hcurve results:'
WRITE(6, *) ' Block ID Model'
WRITE(6, *) ' ======================='
ENDIF
DO 190 J = 1, NITEM
WRITE(6, FMT='(1X,A8,2X,A12)') ID8(J), ID12(J)
190 CONTINUE
IF (I .NE. NBLK) NSET = 1
NITEM = 0
200 CONTINUE
C
C If there are any unwritten entries in the list, write
C the list of blocks with Hcurves.
C
IF (NITEM .NE. 0) THEN
IF (NSET .EQ. 0) THEN
WRITE(6, *)
+ ' The following blocks contain Hcurve results:'
WRITE(6, *) ' Block ID Model'
WRITE(6, *) ' ======================='
ENDIF
DO 210 J = 1, NITEM
WRITE(6, FMT='(1X,A8,2X,A12)') ID8(J), ID12(J)
210 CONTINUE
ENDIF
144 8 Examples
Prompting for Block Name
When the blocks with heating/cooling curves are listed, prompt the user for
the block IDs. Since all IDs in the summary file are in uppercase, user-
specified IDs must be converted to uppercase. TKNHCV is called for each ID,
to check whether or not a valid ID has been entered.
C Prompt the user for the block to be checked;
C remember to convert the block ID to uppercase.
C
WRITE(6, *) ' '
WRITE(6, *) ' Please select a block from the list:'
READ(5, FMT='(A)') ID
C Uppercase the response using a toolkit utility routine
CALL TKUPPR (ID)
CALL TKNHCV(ID, NCURVE)
IF (NCURVE .LE. 0) THEN
WRITE(6, *) ' ',ID,' is not a valid block ID.'
WRITE(6, *) ' Please select again.'
GO TO 100
ENDIF
8 Examples 145
Finding Dimensions of Heating/Cooling
Curve
TKSHCV checks the dimensions of the data for the curve that is selected. If
the dimensions are larger than the arrays are dimensioned, an exit with an
error may occur.
C
C For a specific Hcurve, get its size, and
C print the standard properties.
C
IHCNO = INTS(II)
CALL TKSHCV(ID, ID16(II), IHCNO, NPOINT, NPROP)
C
C The TVAL array is dimensioned for 100 points and 100
C properties.
C That means only 99 stream properties can be stored. If
C there are more than 99, or more than 100 points, print
C error.
C
IF (NPROP .GT. 99 .OR. NPOINT .GT. 100) THEN
WRITE(6, *) ' *** Error - This Hcurve is too large ***'
GO TO 700
ENDIF
146 8 Examples
WRITE(6, 10) (LABELS(JJ),JJ=1,4)
WRITE(6, 31) (PLUS,JJ=1,3),EXCL
DO 500 I = 1, NPOINT
WRITE(6, 20) (TVAL(I,JJ),JJ=1,4)
500 CONTINUE
WRITE(6, 31) (PLUS,JJ=1,3),EXCL
8 Examples 147
Block ID Model
FEED-MIX HEATER
HP-SEP FLASH2
Please select a block from the list:
FEED-MIX
FEED-MIX contains the following Hcurves:
ID Type Hcurve No.
1 HCURVE 1
2 HCURVE 2
Select an Hcurve by specifying its ID.
TEMPERATURE PRESSURE VAPOR DUTY
(F) (PSI) FRACTION (BTU/HR)
TEMP
Select properties from the following list:
ID Property Phase Component
1 KMX VAPOR
2 KMX LIQUID
3 MUMX VAPOR
4 MUMX LIQUID
Enter the ID number of the property.
1
148 8 Examples
Figure 8.3 Sample Output File hcurve.out
Temperature KMX Vapor MUMX Vapor
(F) (BTU-FT/HR-SQFT-R) (CP)
8 Examples 149
Example 3: Column Profile
Results Written to Plot File
This example demonstrates retrieving column profile results and writing the
results to a plot file. The program prompts the user for the property to be
retrieved, along with labels for the axes.
150 8 Examples
XMISS = 1D35
CALL TKINI2(UNISET,2,1,3,RCPROP,4,RCUNIT,XMISS,IERR, 6)
8 Examples 151
ENDIF
150 CONTINUE
IF (INDEX .EQ. 0) THEN
WRITE (6,*)
+ 'PROPERTY NAME NOT FOUND. PLEASE ENTER AGAIN.'
WRITE (6,*)
GO TO 120
ENDIF
151 CONTINUE
152 8 Examples
Please select a block from the list:
COLUMN
Choose from the following properties:
B_TEMP B_PRES DUTY LIQ_FLOW VAP_FLOW
FEED_LFLOW FEED_VFLOW FEED_FLOW PROD_LFLOW PROD_VFLOW
LIQ_ENTH VAP_ENTH HYD_LMF HYD_VMF HYD_LVF
HYD_VVF HYD_RHOL HYD_RHOV HYD_MUL HYD_MUV
HYD_STEN HYD_PARM HYD_QR HYD_MWL HYD_MWV
HYD_FMIDX HYD_FFR X Y B_K
1 45.872
2 36.130
3 34.708
4 34.474
5 34.434
6 34.427
7 34.425
8 34.007
9 32.150
10 32.000
11 31.987
12 31.986
13 31.986
8 Examples 153
14 31.986
15 31.986
154 8 Examples
WRITE(6, *) ' *** Error occurred in block'
GO TO 9999
ENDIF
IF (NQUAL .EQ. 0) NQUAL = 1
CALL TKBRES(ID, NRES, NQUAL, PNAMES, QUALS, ITYPES, INTS,
+ CW8, TVALS, TYPES, LABELS)
C
C Search the results array for the values wanted.
C
DO 150 I = 1, NRES
IF (PNAMES(I) .EQ. 'RR') I1=I
IF (PNAMES(I) .EQ. 'BU_RATIO') I2=I
IF (PNAMES(I) .EQ. 'COND_DUTY') I3=I
IF (PNAMES(I) .EQ. 'REB_DUTY') I4=I
IF (PNAMES(I) .EQ. 'TOP_LFLOW') I5=I
IF (PNAMES(I) .EQ. 'BOT_LFLOW') I6=I
150 CONTINUE
RR = TVALS(I1,1)
BR = TVALS(I2,1)
Q1 = TVALS(I3,1)
QN = TVALS(I4,1)
TVFLOW = TVALS(I5,1)
BLFLOW = TVALS(I6,1)
8 Examples 155
CALL TKPRO1(ID, PNAMES, 1, NSTAGE, TVALS(1,7), TYPES,
+ LABELS, IERR)
156 8 Examples
!------- !
! -------!
!------- ! BOILUP RATIO= 1.55
! -------! REFLUX RATIO= 1.20
!------- !
! -------!
->+------- ! FEED = 103.74 LBMOL/HR
! -------!
!------- !
! -------!
!------- !
!------- +<-----+
+----+----+ ! REB-DUTY= 1415130.30000 BTU/HR
! +---+----+
+-------+ +-------- B-PROD= 99.85 LBMOL/HR
! !
+--------+
8 Examples 157
158 8 Examples
9 XML Summary File
The XML Summary File can be saved by selecting File | Export, and in the
Save as type box, selecting XML Results File (*.xml). This file is an XML file
that can be edited with standard XML tools and viewed with the ability to
open and close individual sections in Internet Explorer.
The XML Summary File begins with a top-level <Plant> tag. Within this tag
are a number of tags for blocks, streams, convergence blocks, flowsheeting
operations, run status, etc. Each of these tags has a dictionary attribute
which refers to an XML schema file delivered with Aspen Plus in the Aspen
Plus <version>\Engine\Dat or APrSystem <version>\Engine\Dat
folder. In the XML file, the variables $ASPTOP and $APRSYS are used to
refer to the Aspen Plus <version>\Engine and APrSystem
<version>\Engine folders, respectively. Each of these tags also has a
name, which is the actual name of the block, stream, etc. wherever such a
name is available.
There are a number of status variables with numerical values that appear in
the Run-status sections. The most important of these are explained here.
UOSSTAT2
UOSSTAT2 provides the status message that appears on the Run-Status |
Summary sheet. It has the following possible values:
Value Message
TOTSTAT
TOTSTAT describes the most severe status of all errors / warnings.
0 No error/warning
1 Error
2 Warning
ITSTAT
ITSTAT gives the input translation status.
Value Meaning
0 No problems
4 Warnings
Table A.1 lists the most frequently used units of measurement conversion
options available in Aspen Plus. A complete, up-to-date list of all units is
contained in the file units.lis in the toolkit source directory. See Chapter 1 for
the directory name on all operation systems. The entries in the table show the
units labels used to identify units of measurement. Most of the units labels in
this table are self-explanatory. Labels that may require explanation are:
Prefixes
Units Description
Suffixes
Units Description
**.5 Suffix meaning square root of the preceding unit. Used in a few types
of units such as dipole moment.
DELTA Prefix on units used for temperature change, used for emphasizing
that a value is temperature change and not temperature. Units without
delta can also be specified for temperature change and are equivalent
to the ones with delta.
G The G at the end of ATMG, BARG, PSIG, PAG, KG/SQCMG,
IN-WATER-G and similar pressure units indicates gauge pressure
(pressure above standard atmospheric pressure).
VAC Used as a suffix on pressure units such as IN-WATER-VAC, indicating
vacuum pressure (pressure below standard atmospheric pressure).
Vacuum units are thus exactly negative of the corresponding gauge
pressure units.
A Units 161
Full Unit Names
Units Description
162 A Units
Table A.1 - Units Options
Type of Units Code SI Set ENG Set MET Set Other Units Options
A Units 163
Type of Units Code SI Set ENG Set MET Set Other Units Options
164 A Units
Type of Units Code SI Set ENG Set MET Set Other Units Options
A Units 165
Type of Units Code SI Set ENG Set MET Set Other Units Options
166 A Units
Type of Units Code SI Set ENG Set MET Set Other Units Options
A Units 167
Type of Units Code SI Set ENG Set MET Set Other Units Options
168 A Units
Type of Units Code SI Set ENG Set MET Set Other Units Options
A Units 169
Type of Units Code SI Set ENG Set MET Set Other Units Options
170 A Units
Type of Units Code SI Set ENG Set MET Set Other Units Options
A Units 171
172 A Units
B Property Names
This chapter lists the property names that are returned in the PNAME or
QUALS arguments of the toolkit routines. It also lists the property names that
you can specify where PNAME and QUALS are input arguments.
SCENARIO Scenario
SCTEMP Subcooled temperature
SECTION Section ID
SELECT Selectivity
SETPOINT Set point
SH-SPEED Compressor shaft speed
SHELL_BFL_SP Clearance between the shell and the baffles
SHELL_BND_SP Clearance between shell and tube bundle
SHELL_DIAM Shell inside diameter
SHELL_MIXED Is the shell stream unmixed/mixed?
SIDE Heat exchanger side
SIDE_AREA Side downcomer area/panel
SIDE_DRAW Side draw flow rate
SNOZ_INDIAM Shell inlet nozzle diameter
SNOZ_OUTDIAM Shell outlet nozzle diameter
SOL_FLOW Solid flow
SONVEL Sonic velocity
SP-DIAM Specific diameter of a compressor wheel
SP-SPEED Specific shaft speed of a compressor
SPACE Floor space required
SPAREA Packing surface area
SPCHNG Phase change
SPC_MASSFLOW Specified mass-based vent flow rate
SPC_MOLEFLOW Specified mole-based vent flow rate
SPC_VOLFLOW Specified volume-based vent flow rate
SPEC Variable specified value
SPEED Speed
STAGE_NO Stage number
START_STG Number of first stage in section
STATUS Choke status of pressure relief system
STDVFLOW Standard volume flow
STDVFRAC Standard volume fraction
STDVOL_CYCLE Standard volume per cycle
STDVOL_TIME Standard volume flow during operation
STEAM-FLOW Steam flow rate
STEN Surface tension
STICH1 1st Stichlmair constant
STICH2 2nd Stichlmair constant
STICH3 3rd Stichlmair constant
STOP-CRIT Stop criterion
STOP-TIME Stop time
STOP_STG Number of last stage in section
STREAMFRAC Stream fraction
STRENGTH Strength
SUBS-ATTR Substream attribute value
SURFTEN Surface tension
S_LINEAR Linear s-plot value
S_LOG Logarithmic s-plot value
TAMBIENT Ambient temperature at the node
TB Boiling point temperature
TEMA_TYPE Standard TEMA shell type
THGHT Total height of the equipment
THICKNESS Thickness
TH_BETA Thermosiphon liquid1/total liquid ratio
TH_DUTY Thermosiphon duty
TH_MOLEFLOW Thermosiphon mole fraction
TH_PRES Thermosiphon pressure
TH_TEMP Thermosiphon temperature
TH_VFRAC Thermosiphon vapor faction
TH_X Thermosiphon liquid mole fraction
TH_X1 Thermosiphon liquid1 mole fraction
TH_X2 Thermosiphon liquid2 mole fraction
TH_Y Thermosiphon vapor mole fraction
TIME Time
TIP-MACH Rotor tip Mach number for a compressor wheel
TMAX Maximum temperature
TMIN Minimum temperature
TNOZ_INDIAM Tube inlet nozzle diameter
TNOZ_OUTDIAM Tube outlet nozzle diameter
TOC Outlet temperature
TOLERANCE Tolerance
TOPTHICK Top shell thickness
TOP_L1FLOW Top stage liquid1 flow
TOP_L2FLOW Top stage liquid2 flow
TOP_LFLOW Top stage liquid flow
TOP_TEMP Top stage temperature
TOP_VFLOW Top stage vapor flow
TOS Isentropic outlet temperature
TOTAL-MASS Total mass
TOTAL_NUMBER Total number of tubes
TOT_AREA Total tray area
TOT_ENTH_ABS Absolute total enthalpy balance
TOT_ENTH_REL Relative total enthalpy balance
TOT_MASS_ABS Absolute total mass balance
TOT_MASS_REL Relative total mass balance
TOT_MOLE_ABS Absolute total mole balance
Other properties
Property Name Description
Component in a Mixture
Property Name Description
Pure Components
Property Name Description
K Thermal conductivity
MU Viscosity
SIGMA Surface tension
Distillation Curves
Property Name Description
Distillation Temperature
Property Name Description
Petroleum Cuts
Property Name Description
500-550C Flow rates for petroleum cuts boiling between 500 and 550C
>550C Flow rates for petroleum cuts boiling above 550C
CUTS-E Flow rates for petroleum cuts in 100F increments
CUTS-M Flow rates for petroleum cuts in 50C increments
LT-ENDS Flow rates for light ends
DENSITY Density
ENTHALPY Enthalpy
HEAT-CAPACITY Heat capacity
PWGHT Weight
LIQ_FLOW Liquid flow
VAP_FLOW Vapor flow
FLOWP Flow parameter
DIAM Diameter
TRYSPS Tray spacing
EFF Tray efficiency
TRAY_NUMBER Number of trays
EXHTS Extra height
TTLEN Tangent-to-tangent length
Index 203
TKPAPF, 131 TKRPR1, 71
TKPAPR, 132 TKRPR2, 71
TKPAR1, 132 TKRPRF, 69
TKPAR2, 133 TKRPRP, 70
TKPERF, 37 TKRRHR, 80
TKPIDS, 124 TKRRNS, 81
TKPINP, 91 TKRRPF, 79
TKPIPR, 91 TKRRPR, 80
TKPISP, 91 TKRRRP, 84
TKPLCO, 87 TKRRSL, 81
TKPLCP, 86 TKRSCA, 73
TKPLIO, 86 TKRSUB, 69
TKPLND, 89 TKRTNL, 62
TKPLNP, 88 TKRTNR, 60
TKPLPP, 89 TKRTRS, 60
TKPLPR, 90 TKRTSP, 61
TKPLSG, 88 TKRTSR, 61
TKPLSP, 87 TKSCAT, 107
TKPLSZ, 85 TKSCPR, 68
TKPORT, 32 TKSCRS, 67
TKPPEV, 117 TKSENS, 28
TKPPRP, 113 TKSENV, 115
TKPRO1, 50 TKSHCR, 96
TKPRO2, 50 TKSIDS, 101
TKPROF, 49 TKSINF, 102
TKPROP, 49 TKSNAC, 105
TKPSEC, 67 TKSNCA, 106
TKPSR1, 129 TKSNSA, 107
TKPSR2, 130 TKSPIR, 92
TKPSRF, 126 TKSPPT, 112
TKPSRP, 127 TKSPRP, 109
TKPSS1, 131 TKSRRP, 83
TKPSSP, 127 TKSSAT, 108
TKPSSR, 128 TKSSCA, 106
TKPSSS, 129 TKSSEC, 66
TKPSUB, 126 TKSSID, 103
TKPTAD, 56 TKSSSA, 108
TKPTCN, 59 TKSTRA, 104
TKPTEV, 115 TKSTRM, 103
TKPTFR, 57 TKSVAL, 104
TKPTPP, 58 TKTITL, 20
TKPTPR, 56 TKTPRP, 64
TKPTRS, 55 TKTREP, 63
TKPVPF, 133 TKTRNR, 51
TKPVR1, 134 TKTRRS, 52
TKPVR2, 135 TKUNIT, 23
TKPVRP, 134 TKVAPF, 75
TKRCAT, 73 TKVAPR, 75
TKRFSP, 74 TKVAR1, 76
TKRNAC, 72 TKVAR2, 76
TKRNCA, 72 TKVLE, 94
TKRNFS, 74 TKVTPF, 77
TKRPIP, 93 TKVTPR, 77
204 Index
TKVTR1, 78
TKVTR2, 78
TKWHLR, 38
web site, technical support, 4
Index 205