Professional Documents
Culture Documents
Contents
Who Should Read this Guide ...................................................................................1
Introducing Summary File Toolkit ...........................................................................3
Related Documentation .....................................................................................3
Technical Support ............................................................................................4
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
iv
Contents
Contents
vi
Contents
Contents
vii
viii
Contents
Index ..................................................................................................................203
Contents
ix
Contents
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
Title
Content
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:
Search for tech tips, solutions and frequently asked questions (FAQs)
Send suggestions
Technical advisories
Customer support is also available by phone, fax, and email. The most up-todate contact information is available at the AspenTech Support Center at
http://support.aspentech.com.
1 Getting Started
This chapter describes how to build an application program using the Aspen
Plus Summary File Toolkit. It contains information on:
1 Getting Started
Accessing the required files and setting up directories for fast data access.
Defining the units of measurement for all values retrieved from the toolkit.
1 Getting Started
Description
Summary file
Properties file
Units file
Scratch file
A temporary direct access file for fast access to summary file results
Prompting the user is the easiest method for most operating systems. Fortran
READ and WRITE statements are used to get the file name.
1 Getting Started
1 Getting Started
Querying the summary file for the existence of simulation objects and
data within an object.
Blocks
TKNBLK
Streams
TKNSTR
Property tables
TKNPPT
Sensitivity tables
TKNEXT
Equipment item
TKNEQP
Pressure relief
TKNXPR
Description
PNAME
SUBSID
Substream ID
1 Getting Started
Qualifier
Description
PHASE
COMPID
Component ID
WETDRY
BASIS
Before calling a subroutine, make sure that all the qualifiers are set to the
desired values or unset. If you do not unset a qualifier from a previous value,
unexpected results may be returned.
All values with physical dimensions are returned in the units you specify
during the initialization process. The units label and the units type are usually
returned with the value. When the physical dimensions of a property are
always known, the units information may not be returned. You can call the
utility routine TKLABL to return the units label for a value not returned. In
addition, you can use the utility routine TKCNVT to convert a value from
default units to user-specified units.
Sometimes the retrieved data values are two-dimensional. For example, the
column profile routine TKPRO2 returns values for every stage and component
combination in a column. The dimension for the results then appears as two
dimensions multiplied together. This figure yields the total number of results
returned. It also shows the sequence of the results data in the array.
The results array is ordered so that the first dimension can scroll before the
second dimension. In the TKPRO2 example, the results are returned in
RVALS, which is dimensioned as NCP*NSTAGE (the number of components *
the number of stages). The values returned in the RVALS array are ordered
so that the results for every component on the first stage are given first,
followed by all the results for every component on the second stage, and so
on.
10
1 Getting Started
1 Getting Started
11
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
ASPCOMP appname
link @appname.opt
appname.exe
Where:
appname
appname.opt
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.
Applications calling the DLL should use this convention. Please see your
compiler documentation about calling Fortran routines and hidden string
length arguments.
Fortran applications can call the routines in the Summary File Toolkit without
any code modifications. If you want to call the Summary File Toolkit from
another language, you will have to modify the code to work with the Fortran
conventions adopted, but this is not recommended. Instead, export an XML
summary file and use standard XML tools to process it.
Open and close the summary file with TKOPEN and TKCLFL.
Open and close the log file optionally used in TKINI2, with TKOPEN and
TKCLFL.
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:
2 General Subroutines
15
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
CHARACTER*4
Dimension Description
IDIRAC
INTEGER
ISUMMF
INTEGER
IPROPN
INTEGER
RCPROP
CHARACTER*80
IUNITS
INTEGER
RCUNIT
CHARACTER*80
RMISS
REAL*8
2 General Subroutines
Dimension Description
IERR
INTEGER
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.
Type
Dimension
Description
CHARACTER*4
IDIRAC
INTEGER
ISUMMF
INTEGER
IPROPN
INTEGER
RCPROP
CHARACTER*80
IUNITS
INTEGER
RCUNIT
CHARACTER*80
RMISS
REAL*8
IERR
INTEGER
ILOG
INTEGER
2 General Subroutines
17
Type
Dimension
Description
ISUMMF
INTEGER
IDIRAC
INTEGER
IPROPN
INTEGER
IUNITS
INTEGER
I/O
Type
Dimension
Description
IUNIT
INTEGER
FILNAM
CHARACTER*(*)
ACCESS
CHARACTER*16
FORM
CHARACTER*16
IRECL
INTEGER
Record length
STATUS
CHARACTER*16
MODE
CHARACTER*16
IERR
INTEGER
Error flag
(0=No error,
1=Invalid argument,
>0= IOSTAT error)
Call subroutine TKCLFL to close the file with the specified Fortran unit
number.
18
2 General Subroutines
Variable
I/O
Type
Dimension
Description
IUNIT
INTEGER
IERR
INTEGER
2 General Subroutines
19
Type
Dimension
Description
VERSN
CHARACTER*20
RUNID
CHARACTER*8
DATE
CHARACTER*80
INFILE
CHARACTER*80
ISSTAT
INTEGER
ISTATF
INTEGER
NBLOCK
INTEGER
Number of blocks
NSTRM
INTEGER
Number of streams
NTABLE
INTEGER
NSENS
INTEGER
ISTATF
The
0=
1=
2=
values are:
Completed without errors,
Completed with errors,
None in this simulation,
Run Titles
Call subroutine TKTITL to retrieve the run title.
I/O
TITLE
Type
Dimension
Description
CHARACTER*64
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.
I/O
ACCNT
Type
Dimension
Description
CHARACTER*8
Account number
PROJID
CHARACTER*8
Project ID
PRNAME
CHARACTER*32
Project name
USER
CHARACTER*20
User name
IERR
INTEGER
Enthalpy balance.
2 General Subroutines
21
I/O
ABSMOL
Type
Dimension
Description
REAL*8
RELMOL
REAL*8
ABSMAS
REAL*8
RELMAS
REAL*8
ABSENT
REAL*8
RELENT
REAL*8
NCC
INTEGER
ABSCON
REAL*8
NCC
RELCON
REAL*8
NCC
NNCC
INTEGER
ABSNC
REAL*8
NNCC
RELNC
REAL*8
NNCC
IERR
INTEGER
Units Conversion
Use the subroutines in this section to:
22
2 General Subroutines
I/O
SETID
Type
Dimension
Description
CHARACTER*4
NTYPES
INTEGER
TYPES
CHARACTER*12 NTYPES
LABELS
CHARACTER*16 NTYPES
IERR
INTEGER
Variable
I/O
Type
Dimension
Description
TYPE
CHARACTER*12
LABEL
CHARACTER*16
NVAL
INTEGER
RVALI
REAL*8
NVAL
RVALO
REAL*8
NVAL
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.)
I/O
NTYPES
Type
Dimension
Description
INTEGER
TYPES
CHARACTER*12 NTYPES
LABELS
CHARACTER*16 NTYPES
Units labels
Component Information
Retrieval
Use the subroutines in this section to retrieve information about the
components in the simulation:
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
I/O
NCC
NNCC
Type
Dimension
Description
INTEGER
INTEGER
Component IDs
Call subroutine TKCIDS to retrieve the component IDs for conventional and
nonconventional components.
I/O
NCC
NNCC
Type
Dimension
Description
INTEGER
INTEGER
Number of nonconventional
components
COMPID
CHARACTER*8NCC
COMPNC
CHARACTER*8NNCC
I/O
NCC
Type
Dimension
Description
INTEGER
COMPID
CHARACTER*8
NCC
ALIAS
CHARACTER*12 NCC
IERR
INTEGER
I = Input to subroutine,
2 General Subroutines
25
I/O
NCC
Type
Dimension
Description
INTEGER
COMPID
CHARACTER*8
NCC
CASN
CHARACTER*12 NCC
IERR
INTEGER
I = Input to subroutine,
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.
I/O
PROP
Type
Dimension
Description
CHARACTER*8
NCC
INTEGER
Number of components
RVALS
REAL*8
NCC
LABEL
CHARACTER*16
Units label
26
Call TKNSEN to retrieve the number of points and the number of columns
in the table.
2 General Subroutines
Call TKSENS to retrieve the values for the table and the headers for the
columns.
Variable
I/O
Type
Dimension
Description
TYPE
CHARACTER*12
IOFF
INTEGER
ID1
CHARACTER*(*)
ID2
CHARACTER*12
IERR
INTEGER
Sequence number
I/O
SENSID
Type
Dimension
Description
CHARACTER*(*)
Sensitivity block ID
NPOINT
INTEGER
NCOL
INTEGER
IERR
INTEGER
2 General Subroutines
27
Variable
I/O
Type
Dimension
SENSID
CHARACTER*(*)
Sensitivity block ID
(Full hierarchical path)
NPOINT
INTEGER
Description
NCOL
INTEGER
HEADER
CHARACTER*8
6, NCOL
RVALS
REAL*8
NPOINT*
NCOL
IERFLG
INTEGER
NPOINT
IERR
INTEGER
28
2 General Subroutines
This chapter describes the use of block result retrieval subroutines in the
summary file toolkit. Use the subroutines described in this chapter for:
Compressor results.
Column results.
Pipeline results.
Heating/cooling curves.
29
Block Identification
The following subroutines are used to identify blocks in the summary file:
Block IDs
Call subroutine TKBIDS to get the list of blocks and model types.
I/O Type
Dimension
Description
NBLOCK
INTEGER
BLKID
CHARACTER*(*) NBLOCK
Block ID
(Full hierarchical path)
BLKTYP
CHARACTER*12 NBLOCK
Model type
IERR
INTEGER
I = Input to subroutine,
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.
I/O
Type
Dimension
Description
IBLOCK
INTEGER
Block number
BLKID
CHARACTER*(*)
Block ID
BLKTYP
CHARACTER*12
Model type
IERR
INTEGER
30
Call subroutine TKCNTN to find the number of inlet and outlet streams.
Call subroutine TKCNCT to retrieve the list of inlet and outlet stream
names.
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NIN
INTEGER
NOUT
INTEGER
IERR
INTEGER
I/O Type
BLKID
Dimension
CHARACTER*(*)
Description
Block ID
NIN
INTEGER
NOUT
INTEGER
BLKIN
CHARACTER*(*) NIN
TYPIN
CHARACTER*8
NIN
31
Variable
I/O Type
Dimension
Description
BLKOUT
CHARACTER*(*) NOUT
TYPOUT
CHARACTER*8
NOUT
IERR
INTEGER
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Description
Block ID
NIN
INTEGER
NOUT
INTEGER
INPORT
CHARACTER*4
NIN
IDIN1
INTEGER
NIN
IDIN2
INTEGER
NIN
IOPORT
CHARACTER*4
NOUT
IDOUT1
INTEGER
NOUT
IDOUT2
INTEGER
NOUT
IERR
INTEGER
Error flag:
0 = No error
1 = Block ID not found
2 = Block has no port
information
32
ID1
Extract
TF
BF
SF
TP
BP
SP
Top feed
Bottom feed
Side feed
Top product
Bottom product
Side product
Stage
number
HeatX
HF
CF
HP
CP
HWD
CWD
Hot feed
Cold feed
Hot product
Cold product
Hot water decant
Cold water decant
Mcompr
S1F
IF
WS
HS
FLS
LK
WD
WS
HS
Stage1 feed
Stage feed
Work feed
Heat feed
Product
Liquid knockout
Water draw
Work out
Heat out
Stage
number
MheatX
HF
CF
HP
CP
HWD
CWD
Hot feed
Cold feed
Hot product
Cold product
Hot water decant
Cold water decant
Stream
number
MultiFrac
F
HS
VD
LD
R
SP
CWD
HS
Feed
Heat feed
Vapor distillate
Liquid distillate
Residue
Side product
Water distillate
Heat product
Column Stage
number number
PetroFrac
MF
SF
MHF
SHF
PHF
VD
LD
B
SP
CWD
SB
PS
CHS
RHS
MHP
SHP
PHP
Column Stage
number number
ID2
33
Model Type
ID1
ID2
RadFrac
F
HS
VD
LD
R
SP
WD
CHS
RHS
Feed
Heat feed
Vapor distillate
Liquid distillate
Residue
Side product
Water distillate
Condenser heat
Reboiler heat
Stage
number
RateFrac
F
HS
VD
LD
R
SP
CWD
HS
Feed
Heat feed
Vapor distillate
Liquid distillate
Residue
Side product
Water distillate
Heat product
Column Section
number number
SCFrac
F
SF
D
B
SP
Feed
Steam feed
Distillate
Bottoms
Side product
The PetroFrac column number for the main column is one. The strippers are
numbered sequentially, starting with two.
34
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NRES
INTEGER
Number of results
NQUAL
INTEGER
IERR
INTEGER
Dimension
CHARACTER*(*)
Description
Block ID
NRES
INTEGER
Number of results
NQUAL
INTEGER
PNAMES
CHARACTER*12 NRES
QUALS
CHARACTER*8
ITYPE
INTEGER
NRES
IVALS
INTEGER
NRES
Integer results
CVALS
CHARACTER*8
NRES
Character results
RVALS
REAL*8
NRES
Real results
TYPES
CHARACTER*12 NRES
Units types
LABELS
CHARACTER*16 NRES
Units labels
35
Compressor Results
If you use the Compr or MCompr model with scalar specifications, you can
retrieve the standard block results. Retrieving these results is described in
Standard Block Results, this chapter.
If you use Compr with performance curves for a stage, or MCompr with
stage-by-stage performance curves, additional results are available. These
results include:
If you use Compr with performance curves for a wheel, or MCompr with
wheel-by-wheel performance curves, the following additional results are
available:
Head coefficient.
Flow coefficient.
You can retrieve compressor performance results from the summary file for
the Compr and MCompr models. You can consider Compr results as belonging
to a single stage. The MCompr performance results can be retrieved for each
stage of the MCompr model. In addition, you can retrieve the performance
results for the wheels within each stage of the MCompr model when wheelby-wheel performance is modeled.
Use this two-step process to retrieve the stage-by-stage performance results:
1
36
When there are no performance results, TKNPER may still return the number
of stages. TKNPER will do this if there are wheel-by-wheel performance
results available. Use NPROP (not NSTAGE) to check if there any performance
results available.
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPROP
INTEGER
Number of stage-by-stage
performance results properties
NSTAGE
INTEGER
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPROP
INTEGER
Number of properties
NSTAGE
INTEGER
PNAMES
CHARACTER*12
NPROP
RVALS
REAL*8
NPROP*
NSTAGE
Real results
TYPES
CHARACTER*12
NPROP
Units types
LABELS
CHARACTER*16
NPROP
Units labels
IERR
INTEGER
37
Dimensions of Wheel-by-Wheel
Performance Results
Call subroutine TKNWHL to determine the number of wheels in a particular
stage of MCompr. The number of properties in the wheel-by-wheel
performance results is also returned. Call TKNPER to find the total number of
stages.
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ISTAGE
INTEGER
NWHEEL
INTEGER
Number of wheels
NPROP
INTEGER
Number of wheel-by-wheel
performance results properties
38
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ISTAGE
INTEGER
Stage number
NPROP
INTEGER
Number of properties
NWHEEL
INTEGER
PNAMES
CHARACTER*12 NPROP
RVALS
REAL*8
Real results
TYPES
CHARACTER*12 NPROP
Units types
LABELS
CHARACTER*16 NPROP
Units labels
IERR
INTEGER
NPROP*
NWHEEL
Call subroutine TKMCPR to retrieve the profile data for the MCompr
stages.
Call subroutine TKMCCP to retrieve the profile data for the MCompr
coolers.
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NSTAGE
INTEGER
NPROP
INTEGER
NCOOL
INTEGER
NCPROP
INTEGER
39
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPROP
INTEGER
NSTAGE
INTEGER
Number of stages
PNAMES
CHARACTER*12
NPROP
RVALS
REAL*8
NPROP*
NSTAGE
Real results
TYPES
CHARACTER*12
NPROP*
NSTAGE
Units types
LABELS
CHARACTER*16
NPROP*
NSTAGE
Units labels
IERR
INTEGER
Dimension
CHARACTER*(*)
Description
Block ID
NCPROP
INTEGER
NCOOL
INTEGER
PNAMES
CHARACTER*12 NCPROP
RVALS
REAL*8
TYPES
LABELS
IERR
INTEGER
40
Call subroutine TKHXD2 to retrieve the velocity and pressure drop results.
You can retrieve the zone, shell, tube, baffle and nozzle data using a six-step
process:
1
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NDET1
INTEGER
NDET2
INTEGER
Detailed Results
Call subroutine TKHXD1 to retrieve the first set of detailed results (such as,
areas and heat transfer coefficients) for the heat exchanger.
41
Dimension
CHARACTER*(*)
Description
Block ID
NDET1
INTEGER
PNAMES
CHARACTER*12 NDET1
RVALS
REAL*8
NDET1
Real results
TYPES
CHARACTER*12 NDET1
Units types
LABELS
CHARACTER*16 NDET1
Units labels
IERR
INTEGER
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NDET2
INTEGER
PNAMES
CHARACTER*12 NDET2
RVALS
REAL*8
NDET2
Real results
TYPES
CHARACTER*12 NDET2
Units types
LABELS
CHARACTER*16 NDET2
Units labels
IERR
INTEGER
Error flag
(0=No error)
42
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NZONE
INTEGER
Number of Zones
NZORES
INTEGER
NSHRES
INTEGER
NTURES
INTEGER
NBARES
INTEGER
NNORES
INTEGER
I/O Type
BLKID
Dimension
CHARACTER*(*)
Description
Block ID
NZONE
INTEGER
Number of Zones
NZORES
INTEGER
PNAMES
CHARACTER*12 NZORES
RVALS
REAL*8
Real results
TYPES
CHARACTER*12 NZORES
Unit types
LABELS
CHARACTER*16 NZORES
Unit labels
IERR
INTEGER
I = Input to subroutine,
NZORES*
NZONE
43
Dimension
CHARACTER*(*)
Description
Block ID
NSHRES
INTEGER
PNAMES
CHARACTER*12 NSHRES
ITYPES
INTEGER
NSHRES
IVALS
INTEGER
NSHRES
Integer results
CVALS
CHARACTER*12 NSHRES
Character results
RVALS
REAL*8
Real results
TYPES
CHARACTER*12 NSHRES
Unit types
LABELS
CHARACTER*16 NSHRES
Unit labels
IERR
INTEGER
Error flag
(0=No error)
NSHRES
I/O Type
BLKID
CHARACTER*(*)
Block ID
NTURES
INTEGER
PNAMES
CHARACTER*12 NTURES
ITYPES
INTEGER
NTURES
IVALS
INTEGER
NTURES
Integer results
CVALS
CHARACTER*12 NTURES
Character results
RVALS
REAL*8
Real results
TYPES
CHARACTER*12 NTURES
Unit types
LABELS
CHARACTER*16 NTURES
Unit labels
IERR
INTEGER
Error flag
(0=No error)
I = Input to subroutine,
44
Dimension
NTURES
Description
Dimension
Description
BLKID
CHARACTER*(*)
NBARES
INTEGER
PNAMES
CHARACTER*12 NBARES
ITYPES
INTEGER
NBARES
IVALS
INTEGER
NBARES
CVALS
CHARACTER*16 NBARES
Character results
RVALS
REAL*8
Real results
TYPES
CHARACTER*12 NBARES
Unit types
LABELS
CHARACTER*16 NBARES
Unit labels
IERR
INTEGER
Error flag
(0=No error)
NBARES
Block ID
Number of Baffle properties
Integer results
I/O Type
BLKID
Dimension
CHARACTER*(*)
Block ID
NNORES
INTEGER
PNAMES
CHARACTER*12 NNORES
RVALS
REAL*8
Real results
TYPES
CHARACTER*12 NNORES
Unit types
LABELS
CHARACTER*16 NNORES
Unit labels
IERR
INTEGER
Error flag
Description
NNORES
45
Variable
I/O Type
Dimension
Description
(0=No error)
Zone profile.
Shell profile.
Tube profile.
Temperature/Duty profile.
You can retrieve the HeatX profile results using a three-step process.
1
The PRFTYP argument for these functions uses the following profile types:
PRFTYP Value
Profile Type
ZONE_PRF
Zone Profile
SHEL_PRF
Shell Profile
TUBE_PRF
Tube Profile
TQ_PRF
Temperature-Duty Profile
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PRFTYP
CHARACTER*8
NPOINT
INTEGER
NPROP
INTEGER
46
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PRFTYP
CHARACTER*8
NPROP
INTEGER
PNAMES
CHARACTER*12 NPROP
LABEL1
CHARACTER*12 NPROP
LABEL2
CHARACTER*12 NPROP
IERR
INTEGER
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PRFTYP
CHARACTER*8
PNAME
CHARACTER*12
NPOINT
INTEGER
IZONE
INTEGER
NPOINT
Number of zone
IPOINT
INTEGER
NPOINT
RVALS
REAL*8
NPOINT
Real results
47
TYPE
CHARACTER*12
Unit types
LABEL
CHARACTER*16
Unit labels
IERR
INTEGER
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
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.
(BLKID, NCOL)
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NCOL
INTEGER
Number of columns
48
Stages.
Components present.
Properties.
I/O
Type
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NSTAGE
INTEGER
Number of stages
NCP
INTEGER
NPROP
INTEGER
Number of properties
I = Input to subroutine,
Dimension
Description
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NPROP
INTEGER
Number of properties
ITYPES
INTEGER
NPROP
Property type
(1=Non-component-dependent,
2=Component-dependent)
PNAMES
CHARACTER*12 NPROP
IERR
INTEGER
Description
49
Non-Component-Dependent Column
Profiles
Call subroutine TKPRO1 to retrieve the profile for a non-componentdependent property. This includes hydraulic properties. TKPRO1 returns a
single units type and label for the entire profile.
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
ICOL
INTEGER
Column number
NSTAGE
INTEGER
Number of stages
RVALS
REAL*8
NSTAGE
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
50
Variable
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
ICOL
INTEGER
Column number
NCP
INTEGER
COMPID
CHARACTER*8
NCP
Component IDs
NSTAGE
INTEGER
Number of stages
Variable
I/O Type
Dimension
Description
RVALS
REAL*8
TYPE
CHARACTER*12
Units types
LABEL
CHARACTER*16
Units labels
IERR
INTEGER
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.
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NRES
INTEGER
NCPROP
INTEGER
Number of component-dependent
properties
NCP
INTEGER
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-componentdependent 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.
51
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NRES
INTEGER
NCPROP
INTEGER
Number of component-dependent
results
NCP
INTEGER
PNAMES
CHARACTER*12 NRES
RVALS
REAL*8
TYPES
CHARACTER*12 NRES
LABELS
CHARACTER*16 NRES
CPNAME
CHARACTER*12 NCPROP
COMPID
CHARACTER*8
NCP
Component names
CRVALS
REAL*8
IERR
INTEGER
NRES
Description
Call TKICST to retrieve the results for all the interconnecting streams or
pumparounds in a model.
52
(BLKID, NICST)
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NICST
INTEGER
Description
I/O Type
BLKID
CHARACTER*(*)
Block ID
NICST
INTEGER
ISCOL
INTEGER
NICST
Source Column
ISSTG
INTEGER
NICST
Source Stage
IDCOL
INTEGER
NICST
Destination Column
IDSTG
INTEGER
NICST
Destination Stage
TEMP
REAL*8
NICST
Temperature
PRES
REAL*8
NICST
Pressure
DUTY
REAL*8
NICST
Duty
VFRAC
REAL*8
NICST
Vapor Fraction
FMOLE
REAL*8
NICST
Mole Flow
FMASS
REAL*8
NICST
Mass Flow
FVOL
REAL*8
NICST
Dimension
Description
53
Variable
I/O Type
Dimension
Description
IERR
INTEGER
54
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NMOLE
INTEGER
NMASS
INTEGER
NSVOL
INTEGER
NRES
INTEGER
NPUMP
INTEGER
Number of pumparounds
NPRRES
INTEGER
NFRCON
INTEGER
NFRRES
INTEGER
NFPROP
INTEGER
NFCOMP
INTEGER
NSTRCN
INTEGER
NCNRES
INTEGER
I/O Type
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NRES
INTEGER
NAME
CHARACTER*8
PNAMES
CHARACTER*12 NRES
Dimension
Description
55
Variable
I/O Type
Dimension
Description
RVALS
REAL*8
NRES
Results
TYPES
CHARACTER*12 NRES
Units type
LABELS
CHARACTER*16 NRES
Units label
IERR
INTEGER
I/O Type
Dimension Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NPROF
INTEGER
BASIS
CHARACTER*4
PNAMES
CHARACTER*12 NPROF
IERR
INTEGER
56
Dimension Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
ICOL
INTEGER
Column number
NSTAGE
INTEGER
Number of stages
BASIS
CHARACTER*4
RVALS
REAL*8
NSTAGE
Real values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
ICON
INTEGER
Connection number
NFRRES
INTEGER
Number of properties
PNAMES
CHARACTER*12 NFRRES
ITYPES
INTEGER
NFRRES
Result type
(1=Integer, 2=Real, 3=Character)
IVALS
INTEGER
NFRRES
CVALS
CHARACTER*12 NFFRES
Character values
RVALS
REAL*8
Real values
TYPES
CHARACTER*12 NFRRES
Units type
LABELS
CHARACTER*16 NFRRES
Units label
IERR
INTEGER
NFRRES
Description
Integer values
57
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NFPROP
INTEGER
Number of properties
NFCOMP
INTEGER
PNAMES
CHARACTER*12 NFPROP
Number of components
COMPID
CHARACTER*8
NFCOMP
Component names
RVALS
REAL*8
TYPES
CHARACTER*12 NFPROP
Units type
LABELS
CHARACTER*16 NFPROP
Units label
IERR
INTEGER
58
Variable
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
IPUMP
INTEGER
Pumparound number
NPRRES
INTEGER
Number of properties
Variable
I/O Type
PNAMES
CHARACTER*12 NPRRES
ITYPES
INTEGER
IVALS
INTEGER
NPRRES
Integer values
RVALS
REAL*8
NPPRES
Real values
TYPES
CHARACTER*12 NPRRES
Units type
LABELS
CHARACTER*16 NPRRES
Units label
IERR
INTEGER
I = Input to subroutine,
Dimension
NPRRES
Description
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
ICON
INTEGER
Connection number
NCNRES
INTEGER
Number of properties
PNAMES
CHARACTER*12 NCNRES
ITYPES
INTEGER
NCNRES
Result type
(1=Integer, 2=Real)
IVALS
INTEGER
NCNRES
Integer values
CVALS
CHARACTER*12 NCNRES
Character values
RVALS
REAL*8
Real values
TYPES
CHARACTER*12 NCNRES
Units type
LABELS
CHARACTER*16 NCNRES
Units label
IERR
INTEGER
NCNRES
Description
59
Call subroutine TKRTRS to retrieve the additional scalar results for each
column.
You can retrieve the split fractions of each component in the outlet streams,
using a two-step process:
1
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NRES
INTEGER
60
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NRES
INTEGER
PNAMES
CHARACTER*12
RVALS
REAL*8
Real values
TYPES
CHARACTER*12 NRES
Unit types
LABELS
CHARACTER*16 NRES
Unit labels
IERR
INTEGER
Error flag
(0=No error)
NRES
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NCP
INTEGER
NSTREAM
INTEGER
61
Dimension
Description
BLKID
CHARACTER*(*
)
Block ID
NCP
INTEGER
NSTREAM I
INTEGER
COMPID
CHARACTER*8 NCP
Component IDs
STRMID
CHARACTER*8 NSTREAM
SFRACS
REAL*8
IERR
INTEGER
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NSTAGE
INTEGER
NLIQ
INTEGER
NSTAGE
IERR
INTEGER
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.
62
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NSTAGE
INTEGER
NPROP
INTEGER
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
INUM
INTEGER
NSTAGE
INTEGER
ISTAGE
INTEGER
NSTAGE
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
Units basis
(MOLE, MASS, or FLOW)
RVALS
REAL*8
NSTAGE
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
63
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
NSTAGE
INTEGER
ISTAGE
INTEGER
NSTAGE
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
RVALS
REAL*8
NSTAGE
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Description
64
Call subroutine TKLSEC to list the column section types and their
numbers.
Call subroutine TKSCRS to retrieve the scalar results for the column
section.
Call subroutine TKSCPR to retrieve the profile data for a named property
in a section.
Several subroutines below have a TYPE or TYPES argument for section types.
The possible values are:
TYPE value
TRAY-SIZE
Tray sizing
TRAY-RATE
Tray rating
PACK-SIZE
Packed sizing
PACK-RATE
Packed rating
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.
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
(MultiFrac and PetroFrac)
NSECT
INTEGER
Number of sections
IERR
INTEGER
65
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number.
(MultiFrac and PetroFrac)
NSECT
INTEGER
Number of sections
TYPES
CHARACTER*12 NSECT
NUMBRS
INTEGER
NSECT
Section numbers
IERR
INTEGER
Stages in a section.
Scalar properties.
Profile properties.
Profile properties have a value for each stage in a section. Scalar properties
have a single value for a section as a whole.
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
(MultiFrac and PetroFrac)
TYPE
CHARACTER*12
NUMBER
INTEGER
Section number
NSTAGE
INTEGER
NPROF
INTEGER
NSCAL
INTEGER
IERR
INTEGER
66
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
(MultiFrac and PetroFrac)
TYPE
CHARACTER*12
NUMBER
INTEGER
Section number
NSCAL
INTEGER
PNAMES
CHARACTER*12
NSCAL
ITYPES
INTEGER
NSCAL
Result types
(1=Integer value
2=Real*8 value
3=Character*12 value)
IVALS
INTEGER
NSCAL
Integer result
CVALS
CHARACTER*12
NSCAL
Character result
RVALS
REAL*8
NSCAL
Real result
UTYPES
CHARACTER*12
NSCAL
Units types
LABELS
CHARACTER*16
NSCAL
Units labels
IERR
INTEGER
67
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
(MultiFrac and PetroFrac)
TYPE
CHARACTER*12
NUMBER
INTEGER
Section number
NPROF
INTEGER
PNAMES
CHARACTER*12 NPROF
PANELS
CHARACTER*1
NPROF
IERR
INTEGER
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
ICOL
INTEGER
Column number
(MultiFrac and PetroFrac)
TYPE
CHARACTER*12
NUMBER
INTEGER
Section number
NSTAGE
INTEGER
ISTAGE
INTEGER
NSTAGE
PNAME
CHARACTER*12
PANEL
CHARACTER*1
RVALS
REAL*8
NSTAGE
Property values
UTYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Description
68
Reactor Results
You can retrieve reactor profile results from the summary file for the reactor
models RPlug and RBatch. You can also retrieve the vent accumulator and
vent profile results for the RBatch model. (See RBatch Vent Accumulator
Results, and RBatch Vent Profile Results, this chapter.) You can retrieve
reaction data for the RStoic, REquil and RGibbs models. (See Reaction Data,
this chapter.) Retrieving reactor profile results is a four-step process:
1
Retrieve the property values. Call subroutine TKRPR1 for non-componentdependent properties. Call subroutine TKRPR2 for component-dependent
properties.
Call subroutines TKRNAC, TKRNCA, TKRSCA, and TKRCAT to retrieve the
property values for the component attributes of a solid substream. Call
subroutines TKRNFS and TKRFSP to retrieve the property values for the
continuous feed stream to the RBatch block.
(BLKID, NSUB)
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NSUB
INTEGER
Number of substreams
Number of properties.
69
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
ISUB
INTEGER
Substream number
SUBSID
CHARACTER*8
Substream ID
NPOINT
INTEGER
NCP
INTEGER
NPROP
INTEGER
Number of properties
Block ID
I/O Type
Dimension Description
BLKID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
NPROP
INTEGER
Number of properties
ITYPES
INTEGER
NPROP
Property type:
1=Non-component-dependent
2=Component-dependent
3=Component attributes
4=Continuous feed stream property
PNAMES
CHARACTER*12 NPROP
IERR
INTEGER
Non-Component-Dependent Reactor
Profiles
Call subroutine TKRPR1 to retrieve reactor profiles for non-componentdependent properties.
70
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
NPOINT
INTEGER
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Description
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
NCP
INTEGER
COMPID
CHARACTER*8
NCP
Component IDs
NPOINT
INTEGER
RVALS
REAL*8
NCP* NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
71
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
NCP
INTEGER
Number of components
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
ICP
INTEGER
COMPID
CHARACTER*8
Component ID
NATT
INTEGER
Number of attributes
72
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
COMPID
CHARACTER*8
Component ID
IDSEQ
INTEGER
IDATT
CHARACTER*8
Attribute ID
NELEM
INTEGER
Number of elements
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
COMPID
CHARACTER*8
Component ID
IDATT
CHARACTER*8
Attribute ID
NELEM
INTEGER
Number of elements
NPOINT
INTEGER
Number of points
ELEMID
CHARACTER*8
NELEM
Element names
RVALS
REAL*8
NELEM* POINT
Property values
IERR
INTEGER
73
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
NFS
INTEGER
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
IFEED
INTEGER
IDFEED
CHARACTER*8
PNAME
CHARACTER*12
NPOINT
INTEGER
Number of points
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Description
74
Call subroutine TKVAR1 to retrieve the property values for noncomponent-dependent properties, or subroutine TKVAR2 to retrieve the
property values for component-dependent properties.
Output points.
Components present.
Properties.
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
NCP
INTEGER
NPROP
INTEGER
Number of properties
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NPROP
INTEGER
Number of properties
ITYPES
INTEGER
NPROP
Property type:
1=Non-component-dependent
2=Component-dependent
PNAMES
CHARACTER*12 NPROP
IERR
INTEGER
Description
75
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NPOINT
INTEGER
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NCP
INTEGER
COMPID
CHARACTER*8
NCP
Component IDs
NPOINT
INTEGER
RVALS
REAL*8
NCP* NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
76
Call subroutine TKVTR1 to retrieve the property values for noncomponent-dependent properties, or subroutine TKVTR2 to retrieve the
property values for component-dependent properties.
Output points.
Components present.
Properties.
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
NCP
INTEGER
NPROP
INTEGER
Number of properties
I/O
Type
BLKID
CHARACTER*(*)
Block ID
NPROP
INTEGER
Number of properties
ITYPES
INTEGER
NPROP
Property type
(1=Non-component-dependent,
2=Component-dependent)
Dimension
Description
77
Variable
I/O
Type
Dimension
Description
PNAMES
CHARACTER*12 NPROP
IERR
INTEGER
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NPOINT
INTEGER
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
78
Variable
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NCP
INTEGER
COMPID
CHARACTER*8
NCP
Component Ids
NPOINT
INTEGER
RVALS
REAL*8
TYPE
CHARACTER*12
Units type
Variable
I/O Type
Dimension
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Description
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 threestep process:
1
Call subroutine TKRRHR to retrieve the heat of reaction data for RStoic.
Use these additional two steps 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.
(BLKID, NREAC)
I/O
BLKID
NREAC
Type
Dimension
Description
CHARACTER*(*)
Block ID
INTEGER
Number of reactions
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.
79
I/O
BLKID
NPROP
Type
Dimension
Description
CHARACTER*(*)
Block ID
INTEGER
NREAC
INTEGER
Number of reactions
PNAMES
CHARACTER*12
NPROP
RVALS
REAL*8
TYPES
CHARACTER*12
NPROP
Units type
LABELS
CHARACTER*16
NPROP
Units label
IERR
INTEGER
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.
I/O
BLKID
Type
Dimension
Description
CHARACTER*(*)
Block ID
NREAC
INTEGER
Number of reactions
COMPID
CHARACTER*12
NREAC
Reference component ID
RVALS
REAL*8
NREAC
Real results
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
80
(BLKID, NSEL)
Variable
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NSEL
INTEGER
Number of selectivity
specifications
Description
Variable
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NSEL
INTEGER
Number of selectivity
specifications
PCOMPS
CHARACTER*8
NSEL
Product component
PSUBS
CHARACTER*8
NSEL
RCOMPS
CHARACTER*8
NSEL
RSUBS
CHARACTER*8
NSEL
RVALS
REAL*8
NSEL
Component selectivity
IERR
INTEGER
81
Call TKLRRP to determine the number and types of reports available for
the reactor.
Call TKNRRP to retrieve the next property set property calculated for a
reactor property report, or call TKRRRP to retrieve a specific property.
For
PROP-REACTOR
RBatch Reactor
PROP-ACCUM
PROP-VENT
RBatch Vent
PROP-REPORT
RPlug Reactor
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NRPRT
INTEGER
TYPES
CHARACTER*12 3
IERR
INTEGER
82
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
TYPE
CHARACTER*12
NPOINT
INTEGER
Number of points
NPROP
INTEGER
Number of properties
IERR
INTEGER
I/O
Type
Dimension Description
BLKID
CHARACTER*(*)
Block ID
TYPE
CHARACTER*12
NPOINT
INTEGER
Number of points
IPROP
INTEGER
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
Wet/dry basis
BASIS
CHARACTER*4
RVALS
REAL*8
NPOINT
Property values
UTYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
83
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
TYPE
CHARACTER*12
NPOINT
INTEGER
Number of points
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
Wet/dry basis
(WET or DRY)
BASIS
CHARACTER*4
Units basis
RVALS
REAL*8
NPOINT
Property values
UTYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Error flag
(0=No error)
Description
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:
84
Call subroutine TKPLCP to retrieve the inlet and outlet property names for
components in a pipeline.
Call subroutine TKPLCO to retrieve the inlet and outlet conditions for
components in a pipeline.
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NIORES
INTEGER
NCC
INTEGER
NCCPRP
INTEGER
NSEG
INTEGER
NSGPRP
INTEGER
NNODE
INTEGER
NNDPRP
INTEGER
NPOINT
INTEGER
NPROF
INTEGER
IERR
INTEGER
85
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NIORES
INTEGER
Number of results
PNAMES
CHARACTER*12 NIORES
ITYPES
INTEGER
CVALSI
CHARACTER*12 NIORES
CVALSO
CHARACTER*12 NIORES
RVALSI
REAL*8
NIORES
RVALSO
REAL*8
NIORES
TYPES
CHARACTER*12 NIORES
Units types
LABELS
CHARACTER*16 NIORES
Units labels
IERR
INTEGER
NIORES
I/O Type
BLKID
Dimension
CHARACTER*(*)
Description
Block ID
NCCPRP
INTEGER
PNAMES
CHARACTER*12 NCCPRP
IERR
INTEGER
86
I/O Type
BLKID
Dimension
CHARACTER*(*
)
Description
Block ID
NCC
INTEGER
PNAME
CHARACTER*12
Number of components
RVALSI
REAL*8
NCC
Inlet results
RVALSO
REAL*8
NCC
Outlet results
TYPE
INTEGER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NSGPRP
INTEGER
Number of segments
PNAMES
CHARACTER*12
NSGPRP
IERR
INTEGER
87
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NSEG
INTEGER
PNAME
CHARACTER*12
ITYPE
INTEGER
RVALS
REAL*8
NSEG
Real results
CVALS
CHARACTER*12 NSEG
Character results
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Description
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NNDPRP
INTEGER
PNAMES
CHARACTER*12 NNDPRP
IERR
INTEGER
88
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NNODE
INTEGER
Number of nodes
PNAME
CHARACTER*12
ITYPE
INTEGER
RVALS
REAL*8
NNODE
Segment results
CVALS
CHARACTER*12
NNODE
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NPROF
INTEGER
PNAMES
CHARACTER*12 NPROF
IERR
INTEGER
Description
89
I/O
Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
PNAME
CHARACTER*12
RVALS
REAL*8
Profile results
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
NPOINT
Description
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:
90
Call subroutine TKPLPP to retrieve the names of the fluid properties. For a
description of TKPLPP, see Pipeline Profile Property Names, this chapter.
Profile points.
Profile properties.
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
NPROP
INTEGER
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NPROP
INTEGER
PNAMES
CHARACTER*12 NPROP
IERR
INTEGER
Description
91
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
PNAME
CHARACTER*12
RVALS
REAL*8
NPOINT
Real results
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Call TKNPIP to retrieve the next property set property calculated in the
profile report. Call TKRPIP to retrieve a specified property.
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
NPROP
INTEGER
92
Property qualifiers.
Property values.
Units type.
Units label.
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
IPROP
INTEGER
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Description
Dimension
CHARACTER*(*)
Description
BLKID
NPOINT
INTEGER
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
Block ID
Number of profile points
93
Dimension
Description
BASIS
CHARACTER*4
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NPH
INTEGER
NCP
INTEGER
COMPID
CHARACTER*8
NCP
Component IDs
REAL*8
NCP
REAL*8
NCP
REAL*8
NCP
RK
REAL*8
NCP
X2
REAL*8
NCP
RK2
REAL*8
NCP
Vapor-Liquid2 K-value
Description
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:
94
Retrieve the property set results by calling either TKNHCP for sequential
heating/cooling curve properties or TKHCPR for specific heating/cooling
curve properties.
The routines listed above replace the routines TKNHCV, TKLHCV, TKSHCV,
TKHCRV, TKNHPR, and TKHPRP. These routines will continue to be supported
and updated but cannot be used to access PetroFrac heating/cooling curves.
PetroFrac models have strippers and pumparounds that may have
heating/cooling curves. The heating/cooling curve for a particular stripper or
pumparound has both a block ID and a second ID for the main
column/pumparound/stripper. The heating/cooling curve routines have an
argument for this second ID called ID2. This argument is ignored for other
models.
You can determine the interconnecting stream ID for MultiFrac
heating/cooling curves by calling TKHCID.
(BLKID, NCURVE)
I/O Type
Dimension
BLKID
CHARACTER*(*)
Block ID
NCURVE
INTEGER
Description
95
I/O Type
BLKID
Dimension
CHARACTER*(*)
Description
Block ID
NCURVE
INTEGER
ID2
CHARACTER*8
NCURVE
TYPES
CHARACTER*16 NCURVE
NUMBER
INTEGER
NCURVE
IERR
INTEGER
HCURVE
Standard
HOT
Hot side
COLD
Cold side
REBOILER
Reboiler
CONDENSER
Condenser
ICSTREAM
PUMPAROUND
Pumparound
STRIPPERREBOILER
Stripper reboiler
I/O
Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ID2
CHARACTER*8
TYPE
CHARACTER*16
NUMBER
INTEGER
NPOINT
INTEGER
NPROP
INTEGER
Number of properties
96
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ID2
CHARACTER*8
TYPE
CHARACTER*16
NUMBER
INTEGER
NPOINT
INTEGER
Number of points
IERFLG
INTEGER
NPOINT
TEMP
REAL*8
NPOINT
PRES
REAL*8
NPOINT
VFRAC
REAL*8
NPOINT
DUTY
REAL*8
NPOINT
IERR
INTEGER
97
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ID2
CHARACTER*8
TYPE
CHARACTER*16
NUMBER
INTEGER
NPOINT
INTEGER
IPROP
INTEGER
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
RVALS
REAL*8
NPOINT
Real values
UTYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
98
Variable
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
ID2
CHARACTER*8
TYPE
CHARACTER*16
Variable
I/O Type
Dimension
Description
NUMBER
INTEGER
NPOINT
INTEGER
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
RVALS
REAL*8
NPOINT
Real values
UTYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
I/O Type
Dimension
Description
BLKID
CHARACTER*(*)
Block ID
TYPE
CHARACTER*16
NUMBER
INTEGER
INTID
INTEGER
CHARID
CHARACTER*8
IERR
INTEGER
99
100
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.
Stream Identification
The following subroutines are used to identify streams in the summary file:
Dimension Description
NSTRM
INTEGER
Stream number
STRMID O
CHARACTER*(*) NSTRM
Stream ID
STRTYP
CHARACTER*12 NSTRM
IERR
INTEGER
Error flag
(0=No error)
101
I/O Type
Dimension
Description
ISTRM
INTEGER
STRMID
CHARACTER*(*)
Stream ID
STRTYP
CHARACTER*12
IERR
INTEGER
Stream number
102
Variable
I/O
Type
Dimension
Description
STRMID
CHARACTER*(*)
Stream ID
SOURCE
CHARACTER*(*)
Source block ID
DEST
CHARACTER*(*)
Destination block ID
NSUBS
INTEGER
Number of substreams
LEN
INTEGER
Variable
I/O
Type
Dimension
Description
IERR
INTEGER
I/O Type
Dimension
Description
STRMID
CHARACTER*(*)
Stream ID
NSUB
INTEGER
Number of substreams
SUBSID
CHARACTER*8
NSUB
Substream IDs
I/O Type
Dimension
STRMID
CHARACTER*(*)
Stream ID
LEN
INTEGER
QUALS
CHARACTER*16 4*LEN
RVALS
REAL*8
Real results
TYPES
CHARACTER*12 LEN
Units type
LABELS
CHARACTER*16 LEN
Units label
IERR
INTEGER
LEN
Description
103
Type
Dimension
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
PNAME
CHARACTER*12
BASIS
CHARACTER*4
RVALS
REAL*8
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Error flag
(0=No error)
Description
104
I/O Type
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
STRTYP
CHARACTER*4
VALUE
REAL*8
Result value
LABEL
CHARACTER*16
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
NAC
INTEGER
105
Dimension
Description
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
ICOMP
INTEGER
COMPID
CHARACTER*8
Component ID
NATT
INTEGER
Number of attributes
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
COMPID
CHARACTER*8
Component ID
IATT
INTEGER
IDATT
CHARACTER*8
Attribute name
NELEM
INTEGER
Number of elements
106
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
COMPID
CHARACTER*8
Component ID
IDATT
CHARACTER*8
Attribute name
NELEM
INTEGER
Number of elements
ELEMID
CHARACTER*8
NELEM
Names of elements
VALUES
REAL*8
NELEM
Real values
IERR
INTEGER
107
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
NSATT
INTEGER
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
ISATT
INTEGER
SATID
CHARACTER*8
Attribute ID
NELEM
INTEGER
Number of elements
I/O Type
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
SUBSID
CHARACTER*8
Substream ID
SATID
CHARACTER*8
Attribute ID
NELEM
INTEGER
Number of elements
VALUES
REAL*8
NELEM
Real values
IERR
INTEGER
108
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
NVAL
INTEGER
Number of values
Dimension Description
STRMID
CHARACTER*(*)
Stream ID
NVAL
INTEGER
Number of values
PNAME
CHARACTER*12 NVAL
SUBSID
CHARACTER*8
NVAL
Substream ID
PHASE
CHARACTER*8
NVAL
Phase
COMPID
CHARACTER*8
NVAL
Component ID
WETDRY
CHARACTER*4
NVAL
BASIS
CHARACTER*4
NVAL
RVALS
REAL*8
NVAL
Real results
109
Dimension Description
TYPES
CHARACTER*12 NVAL
Units types
LABELS
CHARACTER*16 NVAL
Units labels
IERR
INTEGER
110
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:
111
Dimension Description
ITABLE
INTEGER
TABID
CHARACTER*(*)
Property table ID
TYPE
CHARACTER*12
IERR
INTEGER
When you use either of these subroutines, you must call subroutine TKSPPT
to determine the dimensions of the property table.
112
Dimension Description
TABID
CHARACTER*(*)
Property table ID
NPOINT
INTEGER
Number of points
NPROP
INTEGER
Number of properties
IERR
INTEGER
Dimension Description
TABID
CHARACTER*(*)
Property table ID
NPOINT
INTEGER
Number of points
IPROP
INTEGER
Property number
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
RVALS
REAL*8
NPOINT
Real values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Dimension Description
TABID
CHARACTER*(*)
Property table ID
NPOINT
INTEGER
Number of points
113
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
RVALS
REAL*8
NPOINT
Real values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Pressure-Temperature
Envelope Results
You can retrieve pressure-temperature envelope results using a four-step
process:
1
Call TKPTEV to retrieve the temperature and pressure along each branch
of an envelope.
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.
114
Dimension
Description
TABID
CHARACTER*(*)
Property table ID
NENVL
INTEGER
Number of envelopes
NPROP
INTEGER
Number of properties
IERR
INTEGER
Dimension Description
TABID
CHARACTER*(*)
Property table ID
IENVL
INTEGER
Envelope number
NP1
INTEGER
NP2
INTEGER
Dimension Description
TABID
CHARACTER*(*)
Property table ID
IENVL
INTEGER
Envelope number
NP1
INTEGER
NP2
INTEGER
VFRAC1
REAL*8
VFRAC2
REAL*8
TEMP1
REAL*8
NP1
PRES1
REAL*8
NP1
115
Dimension Description
TEMP2
REAL*8
NP2
PRES2
REAL*8
NP2
Dimension Description
TABID
CHARACTER*(*)
Table ID
IENVL
INTEGER
Envelope number
IPROP
INTEGER
NP1
INTEGER
NP2
INTEGER
VFRAC1
REAL*8
VFRAC2
REAL*8
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
VALS1
REAL*8
NP1
VALS2
REAL*8
NP2
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
116
Dimension Description
CHARACTER*(*)
Table ID
IENVL
INTEGER
Envelope number
NP1
INTEGER
NP2
INTEGER
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
PHASE
CHARACTER*8
Phase
COMPID
CHARACTER*8
Component ID
WETDRY
CHARACTER*4
BASIS
CHARACTER*4
VFRAC1
REAL*8
VFRAC2
REAL*8
VALS1
REAL*8
NP1
VALS2
REAL*8
NP2
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
117
118
6 Costing Results
Subroutines
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.
119
Returns
TKNEQ
TKEIDS
TKNEQP
(NEQUIP)
Type
NEQUIP
INTEGER
Dimension Description
Number of equipment items
Dimension Description
NEQUIP
INTEGER
EQPID
CHARACTER*8
NEQUIP
Equipment item ID
EQPTYP
CHARACTER*12 NEQUIP
Equipment type
IERR
INTEGER
120
Dimension Description
IEQUIP
INTEGER
EQPID
CHARACTER*8
Equipment item ID
EQPTYP
CHARACTER*12
Equipment type
IERR
INTEGER
Returns
TKEQCR
TKNEQS
TKEQSR
Dimension Description
EQPID
CHARACTER*8
NCALC
INTEGER
CSCOST
REAL*8
PCOST
REAL*8
Purchased cost
IERR
INTEGER
Equipment Item ID
121
Dimension Description
EQPID
CHARACTER*8
Equipment Item ID
NVAL
INTEGER
Number of results
IERR
INTEGER
CHARACTER*8
NVAL
PNAMES
ITYPES
EQPID
Dimension Description
Equipment item ID
INTEGER
Number of results
CHARACTER*12
NVAL
INTEGER
NVAL
Result type
(1 = Integer value,
2 = Real*8 value,
3 = Character value)
IVALS
INTEGER
NVAL
Integer result
CVALS
CHARACTER*12
NVAL
Character result
RVALS
REAL*8
NVAL
Real result
UTYPES
CHARACTER*12
NVAL
Units type
LABELS
CHARACTER*16
NVAL
Units label
IERR
INTEGER
122
7 Pressure Relief
Subroutines
This chapter describes the use of pressure relief retrieval subroutines in the
summary file toolkit. Use the subroutines described in this chapter for:
Scalar results.
Profile results.
Vessel results.
Vent results.
Accumulator results.
123
TKNPRS returns the number of pressure relief blocks in the summary file.
(NPR)
Dimension Description
INTEGER
Dimension Description
NPR
INTEGER
PRID
CHARACTER*(*) NPR
IERR
INTEGER
124
Dimension Description
IPR
INTEGER
PRID
CHARACTER*(*)
Pressure relief ID
IERR
INTEGER
For dynamic results, call subroutine TKPSR1 to retrieve the noncomponent-dependent profile properties; call subroutine TKPSR2 to
retrieve the component-dependent profile properties.
Or
For steady-state results, call subroutine TKPSS1 to retrieve the property
values.
Retrieving the vent accumulator profiles for the dynamic results requires
three additional steps:
125
Call subroutine TKPVR1 to retrieve the property values for positiondependent properties. Or call subroutine TKPVR2 to retrieve the property
values for component-dependent properties.
Retrieving the vent profiles for the dynamic results requires another three
steps:
(PRID, NSUB)
Dimension
Description
PRID
CHARACTER*(*)
Block ID
NSUB
INTEGER
Number of substreams
126
Dimension Description
PRID
CHARACTER*(*)
Block ID
ISUB
INTEGER
Substream number
SUBSID
CHARACTER*8
Substream ID
ISTATE
INTEGER
Results
(1=Steady state,
2=Dynamic)
NSCAL
INTEGER
NPOINT
INTEGER
NCP
INTEGER
NPROP
INTEGER
Number of properties
Dimension Description
PRID
CHARACTER*(*)
Block ID
SUBSID
CHARACTER*8
Substream ID
NPROP
INTEGER
Number of properties
ITYPES
INTEGER
NPROP
Property type
(1=Not component-dependent
2=Component-dependent)
PNAMES
CHARACTER*12 NPROP
IERR
INTEGER
127
Dimension Description
PRID
CHARACTER*(*)
Block ID
NPROP
INTEGER
Number of properties
NPOINT
INTEGER
PNAMES
CHARACTER*12 NPROP
POSIDS
CHARACTER*32 NPOINT
Position names
IERR
INTEGER
I/O Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
NSCAL
INTEGER
PNAMES
CHARACTER*12
NSCAL
ITYPES
INTEGER
NSCAL
IVALS
INTEGER
NSCAL
CVALS
CHARACTER*12
NSCAL
DVALS
CHARACTER*32
NSCAL
RVALS
REAL*8
NSCAL
TYPES
CHARACTER*12
NSCAL
Units type
LABELS
CHARACTER*16
NSCAL
Units label
IERR
INTEGER
128
DimensionDescription
PRID
CHARACTER*(*)
Block ID
NSCAL
INTEGER
PNAMES
CHARACTER*12
NSCAL
ITYPES
INTEGER
NSCAL
IVALS
INTEGER
NSCAL
CVALS
CHARACTER*8
NSCAL
DVALS
CHARACTER*32
NSCAL
RVALS
REAL*8
NSCAL
TYPES
CHARACTER*12
NSCAL
Units type
LABELS
CHARACTER*16
NSCAL
Units label
IERR
INTEGER
Retrieving Non-Component-Dependent
Dynamic Profiles
Call subroutine TKPSR1 to retrieve profiles for non-component-dependent
properties. The results are independent of the substream.
129
I/O
Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NPOINT
INTEGER
ITYPES
INTEGER
CVALS
CHARACTER*8
NPOINT
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Dimension Description
PRID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
SUBSID
CHARACTER*8
Substream ID
NCP
INTEGER
COMPID O
CHARACTER*8
NCP
Component IDs
NPOINT
INTEGER
RVALS
REAL*8
NCP*
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
130
I/O Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NPOINT
INTEGER
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Output points.
Components present.
Properties.
I/O
Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
NCP
INTEGER
Number of components
present
NPROP
INTEGER
Number of properties
131
I/O
Type
Dimension
PRID
CHARACTER*(*)
Block ID
NPROP
INTEGER
Number of properties
ITYPES
INTEGER
NPROP
Property type
(1=Non-component-dependent
2=Component-dependent)
PNAMES
CHARACTER*12 NPROP
IERR
INTEGER
Description
Retrieving Non-Component-Dependent
Vent Accumulator Profiles
Call subroutine TKPAR1 to retrieve vent accumulator profiles for noncomponent-dependent properties. The corresponding times for each profile
point are retrieved using the property name TIME.
I/O
Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NPOINT
INTEGER
RVALS
REAL*8
NPOINT
Property values
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
132
I/O Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NCP
INTEGER
Number of components
present
COMPID
CHARACTER*8
NCP
Component IDs
NPOINT
INTEGER
RVALS
REAL*8
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
Output points.
Components present.
Positions.
I/O
Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
NPOINT
INTEGER
NCP
INTEGER
Number of components
133
Variable
I/O
Type
Dimension
Description
present
NPROP
INTEGER
Number of properties
NPOS
INTEGER
Number of positions
I/O Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
NPROP
NPOINT
INTEGER
Number of properties
INTEGER
Number of points
ITYPES
INTEGER
NPROP
Property type
(1=Position-dependent
2= Component-dependent)
PNAMES
CHARACTER*12
NPROP
TIMES
REAL*8
NPOINT
Time intervals
TYPE
CHARACTER*12
Time type
LABEL
CHARACTER*16
Time label
IERR
INTEGER
134
I/O Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NPOS
INTEGER
Number of positions
POSIDS
CHARACTER*16
NPOS
Names of positions
NPOINT
INTEGER
RVALS
REAL*8
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
I/O Type
Dimension
Description
PRID
CHARACTER*(*)
Block ID
PNAME
CHARACTER*12
NCP
INTEGER
COMPID
CHARACTER*8
NCP
Component Ids
NPOINT
INTEGER
RVALS
REAL*8
TYPE
CHARACTER*12
Units type
LABEL
CHARACTER*16
Units label
IERR
INTEGER
135
136
8 Examples
Title
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
+
+
+
+
C
C
C
C
C
+
+
Get the name of the Aspen Plus Simulation Engine directory by prompting
the user.
C
C
C
C
C
C
C
C
50
55
C
C
C
C
C
C
C
C
138
8 Examples
8 Examples
139
+
+
140
8 Examples
500
C
C
C
C
C
C
C
C
C
C
C
C
600
C
8 Examples
LIQ
H2RCY
CHRCY
PRODUCT
141
MOLEFLOW
KMOL/HR
H2
0.25941
12.570
0.77824E-01 0.38241E-11
N2
0.23753
6.1762
0.71260E-01 0.14270E-10
C1
2.0170
16.118
0.60509
BZ
CH
64.619
0.72573
19.386
45.229
MOLEFLMX
KMOL/HR
67.222
35.591
20.167
45.291
38.686
0.13065E-07
MASSFLMX
KG/HR
563.14
5485.0
518.09
1645.5
3811.4
VLSTDMX
L/MIN
805.90
131.48
741.43
39.445
123.98
TEMP
322.04
322.04
322.04
322.04
474.15
PRES
ATM
21.094
21.094
21.094
21.094
13.609
VFRAC
1.0000
0.00000E+00 1.0000
LFRAC
0.00000E+00 1.0000
SFRAC
0.00000E+00 0.00000E+00
0.00000E+00 1.0000
1.0000
HMX
CAL/MOL
-8542.1
-35492.
-8542.1
-35492.
-29055.
HMX
CAL/GM
-586.81
-434.98
-586.81
-434.98
-345.26
HMX
CAL/SEC
-91794.
-0.66274E+06 -84450.
-0.19882E+06 -0.36554E+06
SMX
CAL/MOL-K
-14.579
-138.84
-14.579
-138.84
-125.29
SMX
CAL/GM-K
-1.0016
-1.7016
-1.0016
-1.7016
-1.4888
RHOMX
MOL/CC
RHOMX
GM/CC
0.11646E-01 0.69527
0.11646E-01 0.69527
0.51236
14.557
14.557
84.154
MWMX
81.595
81.595
** VAPOR PHASE **
DMX
H2
N2
C1
BZ
CH
MUMX
** LIQUID PHASE **
DMX
SQCM/SEC
H2
N2
C1
BZ
CH
MUMX
142
CP
0.10000E+36 0.25699
0.10000E+36 0.25699
0.10380
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
144
8 Examples
8 Examples
145
146
8 Examples
500
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.
HCURVE
2
HCURVE
2
Select an Hcurve by specifying its ID.
TEMPERATURE
(F)
PRESSURE
(PSI)
VAPOR
FRACTION
DUTY
(BTU/HR)
103.76
330.00
0.73446
0.00000E+00
156.99
330.00
0.75237
0.52969E+06
198.86
330.00
0.78232
0.10594E+07
231.90
330.00
0.82372
0.15891E+07
258.28
330.00
0.87527
0.21188E+07
279.65
330.00
0.93567
0.26485E+07
296.36
330.00
1.0000
0.31507E+07
300.00
330.00
1.0000
0.31782E+07
Property
Phase
KMX
VAPOR
KMX
LIQUID
MUMX
VAPOR
MUMX
LIQUID
Component
148
8 Examples
8 Examples
Temperature
(F)
KMX Vapor
(BTU-FT/HR-SQFT-R)
MUMX Vapor
(CP)
103.76
0.72312E-01
0.10226E-01
156.99
0.71705E-01
0.11065E-01
198.86
0.67680E-01
0.11734E-01
231.28
0.62145E-01
0.12190E-01
258.28
0.56470E-01
0.12467E-01
279.65
0.51312E-01
0.12626E-01
296.36
0.47088E-01
0.12712E-01
300.00
0.47323E-01
0.12763E-01
149
150
8 Examples
XMISS = 1D35
CALL TKINI2(UNISET,2,1,3,RCPROP,4,RCUNIT,XMISS,IERR, 6)
8 Examples
151
ENDIF
CONTINUE
IF (INDEX .EQ. 0) THEN
WRITE (6,*)
+
'PROPERTY NAME NOT FOUND. PLEASE ENTER AGAIN.'
WRITE (6,*)
GO TO 120
ENDIF
151 CONTINUE
150
Call TKCLOS to close the files opened by the summary file toolkit.
Because the plot file was not opened with TKOPEN, close it with the Fortran
CLOSE statement directly:
C
Shut down the toolkit.
CALL TKCLOS (1, 2, 3, 4)
C
Close summary file.
CALL TKCLFL (2, IERR)
C
Close the plot file
CLOSE (7)
C
STOP
END
152
8 Examples
1
2
3
4
5
6
7
8
9
10
11
12
13
8 Examples
LEG1
10
LEG2
0
LEG3
0
LEG4
0
LEG5
0
45.872
36.130
34.708
34.474
34.434
34.427
34.425
34.007
32.150
32.000
31.987
31.986
31.986
153
14
15
31.986
31.986
Four results are selected from the list of values returned by TKBRES: Q1, QN,
RR, and BU_RATIO.
C
C
Get the basic scalar results for the column, to provide
C
values for Q1, QN, RR, and BR.
C
140 CONTINUE
CALL TKNRES(ID, NRES, NQUAL, IERR)
IF (NRES .EQ. 0 .OR. IERR .NE. 0) THEN
154
8 Examples
150
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
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
156
BTU/HR
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
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
Simulation was not completed normally, use status button for details
Data regression was completed with errors, use status button for details
Assay data analysis was completed with errors, use status button for
details
Calculations were completed with errors, use status button for details
10
Calculations were completed with warnings, use status button for details
TOTSTAT
TOTSTAT describes the most severe status of all errors / warnings.
159
Value
No error/warning
Error
Warning
ITSTAT
ITSTAT gives the input translation status.
Value
Meaning
No problems
Warnings
160
A Units
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
MM
SQ
CU
Suffixes
Units
Units
Description
**.5
Suffix meaning square root of the preceding unit. Used in a few types
of units such as dipole moment.
DELTA
VAC
161
Description
GAL
IN-WATER,
These units represent pressure in inches of water. IN-WATER is based
IN-WATER-60F on the density of water of 1 g/cc. IN-WATER-60F is based on the
density of water at 60 F.
162
L-TONS
Long tons (2240 pounds), the ton formerly used in the United Kingdom
and some Commonwealth countries
LB, LBF
Pound (mass unit approximately 0.454 kg) and pound force (weight of
one pound at standard gravity).
MILE
MMKCAL
MN
MilliNewtons
MLB
Thousand lbs
MU
NCM
NCMH
NCMD
PCU
PSIA
SCF
Standard cubic feet. Standard conditions for all standard cubic feet are
ideal gas at 14.696 psi and 60 degrees F.
SCFH
SCFD
SCM
SCMH
TCAL
TON
Short ton (2000 pounds), the ton commonly used in the United States,
see also L-TONS.
TONNE
Metric ton (1000 kg), the ton commonly used outside the United
States
UKGAL
Units
Code SI Set
ENG Set
MET Set
ANGLE
32
RAD
DEG
DEG
AREA
SQM
SQFT
SQM
AREA-PRICE
54
$/SQM
$/SQFT
$/SQM
$/SQCM, $/SQIN,
$/SQMILE, $/SQMM
AREA-USAGE
62
SQM/SEC
SQFT/HR
SQM/HR
SQM/DAY, SQM/YEAR
BOND-WORK-IN 34
J/KG
KWHR/TON
KWHR/TON
KJ/KG
CHROM-VEL
69
M/SEC
FT/SEC
CM/HR
COMPOSITION
MOL-FR
MOL-FR
MOL-FR
MASS-FR
CONTENTS
85
FRACTION
PERCENT
FRACTION
PPM
COST-RATE
119
$/SEC
$/HR
$/HR
CURRENT
114
AMP
AMP
AMP
MAMP
DELTA-T
31
C, R, DELTA-K, DELTA-F,
DELTA-C, DELTA-R
DENSITY
KG/CUM
LB/CUFT
GM/CC
DIFFUSIVITY
SQM/SEC
SQFT/HR
SQCM/SEC
CS
DIMENSIONLES 44
UNITLESS
UNITLESS
UNITLESS
UNTLESS, UNITLES
DIPOLEMOMENT 45
(J*CUM)**.5
(BTU*CUFT)**.5 DEBYE
ELEC-POWER
47
WATT
KW
KW
ELEC-PRICE
48
$/J
$/KWHR
$/KWHR
ENERGY
BTU
CAL
ENERGY-PRICE
30
$/J
$/BTU
$/CAL
ENERGY-VOL
117
CUM/J
BBL/BTU
CUM/J
BBL/MMBTU
ENTHALPY
J/KMOL
BTU/LBMOL
CAL/MOL
ENTHALPY-CYC
105
WATT/CYCLE
BTU/CYCLE
CAL/CYCLE
J/CYCLE, GJ/CYCLE,
KCAL/CYCLE,
MMKCAL/CYCLE,
MMBTU/CYCLE,
MMKCAL/CYCLE,
MMBTU/CYCLE,
PCU/CYCLE,
MMPCU/CYCLE, KJ/CYCLE,
KW/CYCLE, GCAL/CYCLE
Units
(KJ*CUM)**.5
163
Type of Units
Code SI Set
ENG Set
MET Set
ENTHALPY-FLO
13
WATT
BTU/HR
CAL/SEC
ENTHALPY-OPR 109
WATT/CYCLE
BTU/OP-HR
CAL/OP-SEC
J/OP-SEC, GJ/OP-HR,
KCAL/OP-HR,
MMKCAL/OP-HR,
MMBTU/OP-HR,
MMKCAL/OP-DAY,
MMBTU/OP-DAY, PCU/OPHR, MMPCU/OP-HR,
KJ/OP-SEC, KW/CYCLE,
GCAL/OP-HR, GCAL/OPDAY
ENTROPY
J/KMOL-K
BTU/LBMOL-R
CAL/MOL-K
J/KG-K, BTU/LB-R,
CAL/GM-K, MJ/KMOL-K,
KCAL/KMOL-K,
GCAL/KMOL-K,
MBTU/LBMOL-R
F-FACTOR
101
(KGCUM)**.5/SEC
(LBCUFT)**.5/HR
(GM-L)**.5/MIN (LB-GAL)**.5/MIN
FILTER-RESIS
35
1/METER
1/FT
1/METER
FISCAL
FLOW
KG/SEC
LB/HR
KG/HR
LB/SEC, MLB/HR,
TONS/DAY, MCFH,
TONNE/HR, LB/DAY,
KG/DAY, TONS/HR,
KG/MIN, KG/YEAR,
GM/MIN, GM/HR,
GM/DAY, MGM/HR,
GGM/HR, MGM/DAY,
GGM/DAY, LB/MIN,
MMLB/HR, MLB/DAY,
MMLB/DAY, LB/YEAR,
MLB/YEAR, MMLB/YEAR,
TONS/MIN, MTONS/YEAR,
MMTONS/YEAR, LTONS/MIN, L-TONS/HR,
L-TONS/DAY, MLTONS/YEAR, MMLTONS/YEAR,
KTONNE/YEAR
FLUX
61
CUM/SQM-SEC
CUFT/SQFT-SEC
L/SQM-SEC
L/SQM-HR, GAL/SQFTMIN
FLUX-HEAT-AR
120
WATT/SQM
BTU/HR-SQFT
CAL/SEC-SQM
FLUX-MOLE
121
KMOL/SQM-S
LBMOL/SQFT-HR KMOL/SQM-HR
FORCE
14
NEWTON
LBF
164
1/CM, 1/IN
LBMOL/SQFT-S,
MOL/SQCM-S
DYNE
Units
Type of Units
Code SI Set
ENG Set
MET Set
FREQUENCY
28
HZ
RPM
RPM
HEAD
33
J/KG
FT-LBF/LB
M-KGF/KG
HEAT
53
BTU
CAL
HEAT-FLUX
80
WATT/M
BTU/HR-FT
CAL/SEC-M
J/SEC-M, MMBTU/HR-FT
HEAT-RATE-V
122
WATT/CUM
BTU/HR-CUFT
CAL/SEC-CUM
HEAT-TRANS-C
16
WATT/SQM-K
BTU/HR-SQFT-R
CAL/SEC-SQCM- KCAL/SEC-SQM-K,
K
KCAL/HR-SQM-K,
PCU/HR-SQFT-K,
KW/SQM-K, J/SEC-SQMK, KJ/SEC-SQM-K,
MMBTU/HR-SQFT-R,
KJ/SEC-SQM-C, MJ/SECSQM-K, MJ/SEC-SQM-C,
GJ/HR-SQM-K, GJ/HRSQM-C, KCAL/HR-SQM-C,
BTU/HR-SQFT-F
INVERSE-AREA
78
1/SQM
1/SQFT
1/SQM
INVERSE-HT-C
87
SQM-K/WATT
HR-SQFT-R/BTU
SEC-SQCMK/CAL
INVERSE-LENG
68
1/M
1/FT
1/CM
1/IN, 1/MM
INVERSE-PRES
82
SQM/N
1/PSI
1/ATM
SQFT/LBF, 1/BAR,
1/TORR, 1/IN-WATER,
SQCM/KG, 1/MMHG,
1/KPA, 1/MM-WATER
INVERSE-TEMP
81
1/K
1/R
1/K
INVERSE-TIME
59
1/SEC
1/HR
1/HR
ITEM-PRICE
56
$/ITEM
$/ITEM
$/ITEM
LENGTH
17
METER
FT
METER
LN-INV-TIME
60
LN(1/SEC)
LN(1/HR)
LN(1/HR)
LN(1/MIN)
MASS
18
KG
LB
KG
MASS-CONC
58
KG/CUM
LB/CUFT
GM/L
MASS-CYCL
102
KG/CYCLE
LB/CYCLE
KG/CYCLE
LB/CYCLE, MLB/CYCLE,
TONS/CYCLE, GM/CYCLE,
TONNE/CYCLE, LB/CYCLE,
KG/CYCLE, TONS/CYCLE,
TONS/CYCLE
KG/CUM
LB/CUFT
GM/CC
MASS-DENSITY 38
Units
165
Type of Units
Code SI Set
ENG Set
MET Set
MASS-ENTHALP 40
J/KG
BTU/LB
CAL/GM
KCAL/KG, MMKCAL/KG,
MMBTU/LB, PCU/LB,
MMPCU/LB, KJ/KG,
MJ/KG, GCAL/KG,
MBTU/LB
MASS-ENTROPY 42
J/KG-K
BTU/LB-R
CAL/GM-K
KCAL/KG-K, KJ/KG-K,
MJ/KG-K, GCAL/KG-K,
MBTU/LB-R
MASS-FLOW
10
KG/SEC
LB/HR
KG/HR
LB/SEC, MLB/HR,
TONS/DAY, GM/SEC,
TONNE/HR, LB/DAY,
KG/DAY, TONS/YEAR,
TONS/HR, TONNE/DAY,
TONNE/YEAR, KG/MIN,
KG/YEAR, GM/MIN,
GM/HR, GM/DAY,
MGM/HR, GGM/HR,
MGM/DAY, GGM/DAY,
LB/MIN, MMLB/HR,
MLB/DAY, MMLB/DAY,
LB/YEAR, MLB/YEAR,
MMLB/YEAR, TONS/MIN,
MTONS/YEAR,
MMTONS/YEAR, LTONS/MIN, L-TONS/HR,
L-TONS/DAY, MLTONS/YEAR, MMLTONS/YEAR,
KTONNE/YEAR
MASS-FLUX
70
KG/SQM-S
LB/SQFT-HR
KG/SQM-HR
LB/SQFT-S, GM/SQCM-S,
KG/SQCM-S, MLB/SQFTHR, TONS/SQFT-HR, LTONS/SQFT-HR,
TONNE/SQFT-HR
MASS-HEAT-CA 49
J/KG-K
BTU/LB-R
CAL/GM-K
KCAL/GM-K, PCU/LB-K,
KJ/KG-K
MASS-OPER
106
KG/OP-SEC
LB/OP-HR
KG/OP-HR
LB/OP-SEC, MLB/OP-HR,
TONS/OP-DAY, GM/OPSEC, TONNE/OP-HR,
LB/OP-DAY, KG/OP-DAY,
TONS/OP-YEAR,
TONS/OP-HR
MASS-PER-LEN
116
KG/M
LB/FT
KG/M
MASS-TRANS-C 66
KG/S-SQMKG/CUM
LB/HR-SQFLB/CUF
GM/S-SQCMGM/CC
MASS-VOLUME
CUM/KG
CUFT/LB
CC/G
BPD/MLBPH, CC/KG
MOL-FLOW-LEN 89
KMOL/SEC-M
LBMOL/HR-FT
KMOL/HR-M
MOLE-CONC
KMOL/CUM
LBMOL/CUFT
MOL/CC
MOL/L, MMOL/CC,
MMOL/L
166
115
64
Units
Type of Units
Code SI Set
ENG Set
MET Set
MOLE-CYCL
103
KMOL/CYCLE
LBMOL/CYCLE
KMOL/CYCLE
MMSCFH/CYCLE,
MMSCMH/CYCLE,
MOL/CYCLE,
LBMOL/CYCLE,
SCMH/CYCLE,
LBMOL/CYCLE,
KMOL/CYCLE,
MMSCFD/CYCLE,
SCFM/CYCLE
MOLE-DENSITY 37
KMOL/CUM
LBMOL/CUFT
MOL/CC
LBMOL/GAL, MOL/L
MOLE-ENTHALP 39
J/KMOL
BTU/LBMOL
CAL/MOL
KCAL/MOL, TCAL/MOL,
MMKCAL/MOL,
MMBTU/LBMOL,
PCU/LBMOL,
MMPCU/LBMOL, KJ/KMOL,
GJ/KMOL, MJ/KMOL,
KCAL/KMOL, GCAL/KMOL,
MBTU/LBMOL, BTU/SCF,
GCAL/MOL
MOLE-ENTROPY 41
J/KMOL-K
BTU/LBMOL-R
CAL/MOL-K
KCAL/MOL-K, KJ/KMOL-K,
TCAL/MOL-K, MJ/KMOL-K,
KCAL/KMOL-K,
GCAL/KMOL-K,
MBTU/LBMOL-R
MOLE-FLOW
KMOL/SEC
LBMOL/HR
KMOL/HR
MMSCFH, MMSCMH,
MOL/SEC, LBMOL/SEC,
SCMH, LBMOL/DAY,
KMOL/DAY, MMSCFD,
MSCFD, SCFM, MOL/MIN,
KMOL/KHR, KMOL/MHR,
MOL/HR, MMOL/HR,
MLBMOL/HR, LBMOL/MHR,
LBMOL/MMHR, MSCFM,
SCFH, MSCFH, SCFD,
NCMH, NCMD
MOLE-HEAT-CA 15
J/KMOL-K
BTU/LBMOL-R
CAL/MOL-K
MOLE-OPER
107
KMOL/OP-SEC
LBMOL/OP-HR
KMOL/OP-HR
MMSCF/CYCLE-HR,
MMSCM/CYCLE-HR,
MOL/OP-SEC, LBMOL/OPSEC, SCM/CYCLE-HR,
LBMOL/OP-DAY,
KMOL/OP-DAY,
MMSCF/CYCLE-DAY,
SCF/CYCLE-MIN
MOLE-RXNRATE
123
KMOL/CUM-S
LBMOL/CUFT-HR KMOL/CUM-HR
MOL/CC-S
MOLE-VOLUME
43
CUM/KMOL
CUFT/LBMOL
CC/MOL
ML/MOL, BBL/MSCF
MOLES
51
KMOL
LBMOL
KMOL
MOM-INERTIA
112
KG-SQM
LB-SQFT
KG-SQM
GM-SQCM, LB-SQIN
Units
11
167
Type of Units
Code SI Set
ENG Set
MET Set
NUM-CON-RATE 77
NO/CUM-SEC
NO/CUFT-SEC
NO/L-SEC
NUM-CONC
NO/CUM
NO/CUFT
NO/L
NO/CC, 1E6/CC
57
PACK-FACTOR
76
1/M
1/FT
1/M
PDROP
75
N/SQM
PSI
ATM
PDROP-PER-HT
74
N/CUM
IN-WATER/FT
MM-WATER/M
MBAR/M, MMHG/FT
POP-DENSITY
86
NO/M/CUM
NO/FT/CUFT
NO/M/L
NO/MM/L, NO/MU/CC,
NO/IN/CUIN
POWER
19
WATT
HP
KW
POWERVOLUME
65
WATT/CUM
HP/CUFT
KW/L
KW/CUM
PRESSURE
20
N/SQM
PSI
ATM
RHO-VSQRD
110
KG/M-SQSEC
LB/FT-SQSEC
KG/M-SQSEC
SIEMENS-M
118
SIEMENS/M
SIEMENS/FT
SIEMENS/M
SIEMENS/CM
SOLUPARAM
46
(J/CUM)**.5
(BTU/CUFT)**.5
(CAL/CC)**.5
(KCAL/CUM)**.5,
(KJ/CUM)**.5,
(CAL/ML)**0.5
SOLUTE-PERM
72
SQM/M-HR
SQM/M-S
SQFT/FT-HR
SOLVENT-PERM 71
KG/SQM-S-PA
LB/SQFT-HR-ATM KG/SQM-HRATM
SOUND-LEVEL
111
DECIBELS
DECIBELS
DECIBELS
SPEC-FLT-RES
36
METER/KG
FT/LB
METER/KG
SPECIFICAREA
67
SQM/CUM
SQFT/CUFT
SQCM/CC
N/M
DYNE/CM
DYNE/CM
SURFACE-TENS 21
168
SQCM/CM-S, SQFT/FT-S
GM/SQCM-S-ATM,
GM/SQCM-S-PA
CM/GM
LBF/FT, MN/M
Units
Type of Units
Code SI Set
ENG Set
MET Set
TEMP-VOLUME
83
CUM-K/KMOL
CUFT-R/LBMOL
CC-K/MOL
TEMPERATURE
22
C, R
THERMAL-COND 23
WATT/M-K
BTU-FT/HRSQFT-R
KCAL-M/HRSQM-K
TIME
24
SEC
HR
HR
UA
50
J/SEC-K
BTU/HR-R
CAL/SEC-K
KJ/SEC-K, KCAL/SEC-K,
KCAL/HR-K
UNIT-PRICE
29
$/KG
$/LB
$/KG
USR-DUMMY0
90
USR-DUMMY1
91
USR-DUMMY2
92
USR-DUMMY3
93
USR-DUMMY4
94
USR-DUMMY5
95
USR-DUMMY6
96
USR-DUMMY7
97
USR-DUMMY8
98
USR-DUMMY9
99
VELOCITY
25
M/SEC
FT/SEC
M/SEC
VFLOW-LENGTH 84
SQM/SEC
GPM/FT
SQCM/SEC
SQM/HR, SQFT/MIN
VFLOW-RPM
100
CUM/SEC/RPM
CUFT/HR/RPM
L/MIN/RPM
GAL/MIN/RPM,
GAL/HR/RPM,
BBL/DAY/RPM,
CUM/HR/RPM,
CUFT/MIN/RPM,
BBL/HR/RPM,
CUFT/SEC/RPM,
CUM/DAY/RPM,
CUM/YEAR/RPM,
L/HR/RPM,
KBBL/DAY/RPM,
MMCUFT/HR/RPM,
MMCUFT/DAY/RPM,
MCUFT/DAY/RPM,
L/SEC/RPM, L/DAY/RPM,
CUM/MIN/RPM
VISCOSITY
26
N-SEC/SQM
CP
CP
LB/FT-HR, MN-SEC/SQM,
P, GM/SEC-CM, DYNSEC/SQCM, PA-SEC
VOL-ENTHALPY
88
J/CUM
BTU/CUFT
CAL/CC
KCAL/CUM, KJ/CUM,
MMBTU/BBL
VOL-HEAT-CAP
79
J/CUM-K
BTU/CUFT-R
CAL/CC-K
KCAL/CUM-K, KJ/CUM-K
Units
169
Type of Units
Code SI Set
ENG Set
MET Set
VOLTAGE
113
VOLT
VOLT
VOLT
KVOLT
VOLUME
27
CUM
CUFT
VOLUME-CYCL
104
CUM/CYCLE
CUFT/CYCLE
L/CYCLE
GAL/CYCLE, GAL/CYCLE,
BBL/CYCLE, CUM/CYCLE,
CUFT/CYCLE, BBL/CYCLE,
CUFT/CYCLE, CUM/CYCLE,
CUM/CYCLE, L/CYCLE,
KBBL/CYCLE,
MMCUFT/CYCLE
VOLUME-FLOW
12
CUM/SEC
CUFT/HR
L/MIN
GAL/MIN, GAL/HR,
BBL/DAY, CUM/HR,
CUFT/MIN, BBL/HR,
CUFT/SEC, CUM/DAY,
CUM/YEAR, L/HR,
KBBL/DAY, MMCUFT/HR,
MMCUFT/DAY,
MCUFT/DAY, L/SEC,
L/DAY, CUM/MIN,
KCUM/SEC, KCUM/HR,
KCUM/DAY, MCUM/SEC,
MCUM/HR, MCUM/DAY,
ACFM, CUFT/DAY,
MCUFT/MIN, MCUFT/HR,
MMCUFT/HR, MGAL/MIN,
MMGAL/MIN, MGAL/HR,
MMGAL/HR, MBBL/HR,
MMBBL/HR, MBBL/DAY,
MMBBL/DAY
VOLUME-OPER
108
CUM/OP-SEC
CUFT/OP-HR
L/OP-MIN
GAL/OP-MIN, GAL/OP-HR,
BBL/OP-DAY, CUM/OP-HR,
CUFT/OP-MIN, BBL/OPHR, CUFT/OP-SEC,
CUM/OP-DAY, CUM/OPYEAR, L/OP-HR, KBBL/OPDAY, MMCUFT/OP-HR
VOLUME-PRICE
55
$/CUM
$/CUFT
$/L
VOLUME-USAGE 63
CUM/SEC
CUFT/HR
L/HR
WATER-RATE
KG/J
LB/HP-HR
KG/KW-HR
170
73
Units
Type of Units
Code SI Set
ENG Set
MET Set
WORK
52
HP-HR
KW-HR
Units
171
172
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.
B Property Names
173
174
Property Name
Description
ABVSRG
ACT_AREA
ACT_DPINLET
ACT_DPTAIL
ACT_REFLUX
ACT_STAGES
ALLW_DPINLET
ALLW_DPTAIL
ALLW_PRES
ALLW_TEMP
ANGLE
AREA_CALC
Calculated area
AREA_RATIO
AVGDP_HT
BACKUP_LOC
BAFFLE_CUT
BAFFLE_TYPE
BELSWL
BOTTHICK
BOTTOM_TEMP
Bottoms temperature
BOT_L1FLOW
BOT_L2FLOW
BOT_LFLOW
BOT_VFLOW
BR
Boilup ratio
BRAKE_POWER
Brake power
BU_RATIO
Boilup ratio
BWG
BYPASS
Bypass fraction
B_K
B_MASSFLOW
Mass flow
B_MASSFRAC
Mass fraction
B_MOLEFLOW
Mole flow
B_MOLEFRAC
Mole fraction
B_PRES
Block pressure
B_TEMP
Block temperature
B_VFRAC
B Property Names
Property Name
Description
CALC
CAPAC_FAC
Capacity factor
CAV_INDX
CEFF
Calculated efficiency
CHOK_STAT
CHOKE_POUT
CODE_COMPLY
Code compliance
COLDIN
COLDINP
COLDINT
COLDINVF
COLDOUT
COLD_FRAC
COLD_KODE
COLD_LRATIO
COLD_PRES
COLD_TEMP
COMP-ATTR
COMP-STAGES
Compressor stage
COMPFRAC
Component fraction
COMPRESS
Compressibility
COMPTYPE
Compressor type
COND_DUTY
Condenser duty
COND_Q_NSC
COND_RES_TIM
COND_VOL
COOL-PRES
Coolant pressure
COOL-TEMP
Coolant temperature
COOLANT_TEMP
Coolant temperature
COR_PDRP_FAC
COR_PREC_FAC
COSTID
CPCV_FAC
CRIT_PRS_FAC
CSCOST
CSD-PHASE
CUM_DPACC
CUM_DPELEV
CUM_DPFRIC
CUM_DPTOTL
CYCLE_TIME
Cycle time
C_LIQ_FLOW
C_VAP_FLOW
B Property Names
175
176
Property Name
Description
DCAREA
DCBACKUP
Downcomer backup
DCBSPACE
Backing/tray spacing
DCRATIO
DCVELOC
Downcomer velocity
DELT
Temperature change
DENSITY
Liquid density
DEVICE_TYPE
DIAM
Diameter
DIAM50
DIAM-RATIO
Diameter ratio
DIAM_CYL
Cylinder diameter
DIAM_OUT
Diameter of outlet
DIAM_SOL
Solid diameter
DIS
Displacement
DISTIL_TEMP
Distillate temperature
DIST_VS_FEED
Distillate-to-feed ratio
DPACC
DPELEV
DPFRIC
DPTOTL
DP_SECTION
DUTY
Calculated duty
EFF
Efficiency
EFFICIENCY
Fin efficiency
ELEC_POWER
Electrical power
ENTH_BAL
ENTH_CYCLE
ENTH_TIME
EPC
Polytropic efficiency
EQUIV-LEN
ERO_VEL
ERR
Error
ERR_TOL
Error/tolerance
EV
Volumetric efficiency
EXHTS
EXP_FAC
Expansion factor
EXTENT
Reaction extent
FACTOR
FEED-QUALITY
Feed quality
FEED_FLOW
Feed flow
FEED_LFLOW
B Property Names
Property Name
Description
FEED_LOCATN
FEED_TRAY_T
FEED_VFLOW
FHEIGHT
Fin height
FILT_DIAM
Filter diameter
FILT_RESIST
Filter resistance
FINDEX
Fractionation index
FIN_PRES
Final pressure
FIN_TEMP
Final temperature
FIRE-FACTOR
FLOOD
Percentage flooding
FLOOD_FAC
Flooding factor
FLOOD_PANEL
FLOW_COEF
FLOW-COF
FLOWP
Flow parameter
FLUID_POWER
Fluid power
FTHICKNESS
Fin thickness
FWDECANT
FWREFLUX
GAS-VEL
GAS_FLOW
HCRATIO
HEAD
Head
HEAD-COF
HEAT_FLUX
Heat flux
HEAT_RATE
HEAT_REAC
Heat of reaction
HEIGHT
Height
HETP
HOLDUP
HOTIN
HOTINP
HOTINT
HOTINVF
HOTOUT
HOT_KODE
HOT_LRATIO
HOT_PRES
HOT_TEMP
HOT_VFRAC
HT_FROM_TOP
HX_AREAC
B Property Names
177
178
Property Name
Description
HX_AREAP
HX_DELT
HX_DTLM
HX_DUTY
HX_FMTD
HX_NTUC
HX_OVERD
HX_PTNO
HX_SBDP
HX_SFLM
HX_SMCR
HX_SMCV
HX_SMWR
HX_SMWV
HX_SNDP
HX_SPR
HX_STDP
HX_STMP
HX_TBDP
HX_TFLM
HX_TMR
HX_TMV
HX_TNDP
HX_TPR
HX_TTDP
HX_TTMP
HX_UAVC
HX_UAVD
HX_WTMP
Wall temperature
HX_XIC
Thermal effectiveness
HX_ZNNO
HYD_FFR
Reduced F factor
HYD_FMIDX
HYD_LMF
HYD_LVF
HYD_MUL
HYD_MUV
HYD_MWV
HYD_PARM
HYD_QR
HYD_RHOL
HYD_RHOV
HYD_STEN
B Property Names
Property Name
Description
HYD_VMF
HYD_VVF
H_GAS
H_LIQ
H_MIX
Mixture enthalpy
IN-MACH
IND_POWER
Indicated horsepower
INIT_PRES
INIT_TEMP
INLET_D80
INSIDE_DIAM
IN_BFL_SP
IN_EROVEL
IN_LVFRAC
IN_NODE
IN_PRES
Inlet pressure
IN_REGIME
IN_REYNO
IN_TEMP
Inlet temperature
IN_VELOC
Velocity at inlet
IN_VF
IN_VVFRAC
INT_TEMP
Interface temperature
INT_X
INT_Y
ITYPE
Type of pump
Equilibrium constant
K1
Vapor-liquid1 K-value
K2
Vapor-liquid2 K-value
KLL
Liquid1-liquid2 K-value
KODE
L1_ENTH
Liquid1 enthalpy
L1_FLOW
Liquid1 flow
L1_MW
L2_ENTH
Liquid2 enthalpy
L2_FLOW
Liquid2 flow
L2_MW
LENGTH
Length
LEN_CONE
Cone length
LEN_CYL
Length of cylinder
LEN_OUT
Length of outlet
LEN_VORTEX
Length of vortex
LIQ_ENTH
Liquid enthalpy
B Property Names
179
180
Property Name
Description
LIQ_FLOW
Liquid flow
LIQ_FRAC
LIQ_MF_TOT
LIQ_RATIO
LIQ_VEL
LIQ_VOL
LIQ1_VOL
L_CONDUC
LL_RATIO
Liquid/liquid ratio
LMTD
MASSFLWS
MASSFRC_CAKE
MASS_ABS
MASS_CYCLE
MASS_RATE
MASS_REL
MASS_TIME
MATERIAL
MATFAC
MATFAC1
MAXBACKUP
MAXFLOOD
MAXSTAGE
MAXVELOC
MAX_MASSFLOW
MAX_MOLEFLOW
MAX_PRES
MAX_TEMP
MAX_VENTFLOW
MAX_VOLFLOW
MF_LIQ
MF_VAP
MID_BFL_SP
MIN_REFLUX
MIN_STAGES
MODE
Filter mode
MOISTURE
Moisture content
MOLE_ABS
MOLE_CYCLE
MOLE_REL
MOLE_TIME
MW
Molecular weight
MW_LIQ
B Property Names
Property Name
Description
NBAGS
Number of bags
NCELLS
Number of cells
NCLEAN
NODENAME
Node name
NOMINAL-SIZE
NPER_LENGTH
NPHASE
Number of phases
NPSH-AVAIL
NSBAFFLE
NSEAL_STRIP
NTRAIN
Number of trains
NTURNS
Number of turns
NUMBER
Number of cyclones
OIL_FLOW
OIL_VISC
Oil viscosity
OPER_TIME
Operating time
ORIENTATION
OUTLET_D80
OUTSIDE_DIAM
OUTSTREAM
Outlet stream ID
OUT_BFL_SP
OUT_EROVEL
OUT_LVFRAC
OUT_NODE
OUT_PRES
Outlet pressure
OUT_REGIME
OUT_REYNO
OUT_TEMP
Outlet temperature
OUT_VELOC
Velocity at outlet
OUT_VVFRAC
PART_DIAM
Particle diameter
PATTERN
PCOST
PDROP
PDROP_FAC
PDRP
Pressure drop
PHASE
Phase
PHASE-FRAC
Phase fraction
PIPE_FIT_FAC
PITCH
PLACED-STRM
POC
Outlet pressure
POROSITY
Porosity
B Property Names
181
182
Property Name
Description
POS
POWER
Calculated power
PPOINT
Pinch point
PPSTAT
PRES-RATIO
Pressure ratio
PROD_L1FLOW
PROD_L2FLOW
PROD_LFLOW
Product flow
PROD_VFLOW
PRREC_FAC
PVOLS
PWGHT
P_OUT
QCALC
Calculated duty
QNET
QZONE
Q-FIRE
RADIUS
Radius
REAC_LRATE
REAC_VRATE
REB_DUTY
Reboiler duty
RECT_STAGES
REGIME
REL_VOL
Relative volatility
RES_TIME
Residence time
REYNO
Reynolds Number
RHOS
Solid density
RHO_GAS
RHO_LIQ
RING_INDIAM
RING_OUTDIAM
ROD_BFL_SP
ROD_DIAM
ROD_LENGTH
ROOT_DIAM
RR
Reflux ratio
RUN_TYPE
Run type
RXN_GEN
Reaction generation
S-SONICV
SADD
SALT_VOL
SAUTER_DIAM
Sauter diameter
SCDUTY
Subcooled duty
B Property Names
Property Name
Description
SCENARIO
Scenario
SCTEMP
Subcooled temperature
SECTION
Section ID
SELECT
Selectivity
SETPOINT
Set point
SH-SPEED
SHELL_BFL_SP
SHELL_BND_SP
SHELL_DIAM
SHELL_MIXED
SIDE
SIDE_AREA
SIDE_DRAW
SNOZ_INDIAM
SNOZ_OUTDIAM
SOL_FLOW
Solid flow
SONVEL
Sonic velocity
SP-DIAM
SP-SPEED
SPACE
SPAREA
SPCHNG
Phase change
SPC_MASSFLOW
SPC_MOLEFLOW
SPC_VOLFLOW
SPEC
SPEED
Speed
STAGE_NO
Stage number
START_STG
STATUS
STDVFLOW
STDVFRAC
STDVOL_CYCLE
STDVOL_TIME
STEAM-FLOW
STEN
Surface tension
STICH1
STICH2
STICH3
STOP-CRIT
Stop criterion
STOP-TIME
Stop time
STOP_STG
STREAMFRAC
Stream fraction
B Property Names
183
184
Property Name
Description
STRENGTH
Strength
SUBS-ATTR
SURFTEN
Surface tension
S_LINEAR
S_LOG
TAMBIENT
TB
TEMA_TYPE
THGHT
THICKNESS
Thickness
TH_BETA
TH_DUTY
Thermosiphon duty
TH_MOLEFLOW
TH_PRES
Thermosiphon pressure
TH_TEMP
Thermosiphon temperature
TH_VFRAC
TH_X
TH_X1
TH_X2
TH_Y
TIME
Time
TIP-MACH
TMAX
Maximum temperature
TMIN
Minimum temperature
TNOZ_INDIAM
TNOZ_OUTDIAM
TOC
Outlet temperature
TOLERANCE
Tolerance
TOPTHICK
TOP_L1FLOW
TOP_L2FLOW
TOP_LFLOW
TOP_TEMP
TOP_VFLOW
TOS
TOTAL-MASS
Total mass
TOTAL_NUMBER
TOT_AREA
TOT_ENTH_ABS
TOT_ENTH_REL
TOT_MASS_ABS
TOT_MASS_REL
TOT_MOLE_ABS
B Property Names
Property Name
Description
TOT_MOLE_REL
TRAY_NUMBER
TRYSPS
TTLEN
TUBES_IN_WIN
TUBE_BFL_SP
TUBE_FLOW
TUBE_LENGTH
TUBE_MIXED
TUBE_NPASS
TUBE_TYPE
TWGHT
TYPE
Type of cyclone
UA
UAZONE
VALVE_DP
VALVE_POSN
VAP_ENTH
Vapor enthalpy
VAP_FLOW
Vapor flow
VAP_MF_TOT
VAP_RES_TIM
VAP_VOL
VELOCITY
Velocity
VELOC_LOC
VENT_FLOW
VFLOW
Volume flow
VL_RATIO
Vapor/liquid ratio
VMIX
VOIDFR
VOLFLOW
Volumetric flow
VOLTAGE
Voltage
VSTD
V_CONDUC
V_CONVEC
WALL-THICK
WATER-FRAC
WATER_FLOW
WEIRLEN
WETTED_AREA
WIDTH
Width
WNET
X1
B Property Names
185
Property Name
Description
X2
Description
RHOLSTD
RHOMX
Density
VLSTDMX
VMX
Volume
VVSTDMX
Description
BETA
LFRAC
Liquid fraction
MASSFLMX
MASSVFRAC
MASSSFRAC
MOLEFLMX
SFRAC
Solid fraction
VFRAC
VOLFLMX
186
Property Name
Description
AVAILMX
CPCVMX
CPIGMX
CPMX
CSATMX
CVMX
DGMIX
DGMX
B Property Names
Property Name
Description
DHMX
Enthalpy departure
DSMX
Entropy departure
GIGMX
GMX
Free energy
GXS
HIGMX
HMX
Enthalpy
HXS
Excess enthalpy
SIGMX
SMX
Entropy
Other properties
Property Name
Description
ABSHUMID
Absolute humidity
COMB-02
MWMX
Molecular weight
PBUB
PCMX
Critical pressure
PDEW
PRES
Pressure
PRMX
Reduced pressure
RELHUMID
SONVELMX
Sonic velocity
TBUB
TCMX
Critical temperature
TDEW
TEMP
Temperature
TRMX
Reduced temperature
VCMX
Critical volume
ZCMX
ZMX
Compressibility factor
B Property Names
187
188
Property Name
Description
GAMMA
Activity coefficient
GAMPC
GAMUS
KLL2
Liquid-liquid K-value
KVL
Vapor-liquid K-value
KVL2
Vapor-liquid2 K-value
MASSCONC
Mass concentration
MASSFLOW
MASSFRAC
Mass fraction
MOLECONC
Molar concentration
MOLEFLOW
MOLEFRAC
Mole fraction
PHIMX
Fugacity coefficient
PPMX
Partial pressure
SSOLFACT
SSOLUB
TFREEZ
TFRZMARG
VLSTD
VLSTDFR
VVSTD
VVSTDFR
B Property Names
Description
AVAIL
CP
CPCV
CPIG
CV
DG
DGPC
DH
Enthalpy departure
DHVL
Enthalpy of vaporization
DHPC
DS
Entropy departure
Free energy
GIG
Enthalpy
HIG
PHI
Fugacity coefficient
PHIPC
PL
Vapor pressure
RHO
Density
Entropy
SIG
SONVEL
Sonic velocity
Volume
B Property Names
189
190
Property Name
Description
FAPP
FTRUE
GXTRUE
GMTRUE
IONSM
IONSX
MAPP
MTRUE
OSMOT
Osmotic coefficient
PH25
pH at 25C
PH
pH
POH25
pOH at 25C
POH
pOH
SOLINDEX
WAPP
WTRUE
WXAPP
WXTRUE
XAPP
XTRUE
B Property Names
Description
KINVISC
Kinematic viscosity
KMX
Thermal conductivity
MUMX
Viscosity
PR
Prandtl Number
SIGMAMX
Surface tension
THRMDIFF
Thermal diffusivity
Component in a Mixture
Property Name
Description
DMX
Diffusion coefficient
Pure Components
Property Name
Description
Thermal conductivity
MU
Viscosity
SIGMA
Surface tension
Description
ANILPT
Aniline point
API
API gravity
CETANENO
Cetane number
CHRATIO
FLPT-API
MABP
PHYDRATE
PRPT-API
QVALGRS
QVALNET
B Property Names
191
Property Name
Description
REFINDEX
Refractive index
RVP-ASTM
RVP-API
SG
Specific gravity
SGAIR
THYDRATE
VABP
VISINDEX
WAT
Distillation Curves
Property Name
Description
APICRV
APICRVWT
D86CRK
D86CRV
D86CRVWT
D86WTCRK
D1160CRV
D1160CVW
D2887CRV
GRVCRV
GRVCRVWT
MWCRV
MWCRVWT
TBPCRV
TBPCRVWT
VACCRV
VACCRVWT
Distillation Temperature
192
Property Name
Description
D2887T
D86TCK
D86TWTCK
D86T
D86TWT
B Property Names
Property Name
Description
D1160T
D1160TWT
TBPT
TBPTWT
VACT
VACTWT
Description
D2887WT
D86LVCK
D86WTCK
D86LV
D86WT
D1160LV
D1160WT
TBPLV
TBPWT
VACLV
VACWT
Description
ANILPT
Aniline point
AROMATIC
Aromatic content
BASIC-N2
CARBON
Carbon content
FLASHPT
Flash point
FREEZEPT
Freeze point
HYDROGEN
Hydrogen content
IRON
Iron content
KNOCKIDX
KVISC
Kinematic viscosity
LUMI-NO
Luminometer number
MERCAPTAN
Mercaptan content
METAL
Metal content
MOC-NO
NAPHTHENE
Naphthene content
NICKEL
Nickel content
B Property Names
193
Property Name
Description
OLEFIN
Olefin content
OXYGEN
Oxygen content
PARAFFIN
Paraffin content
POURPT
Pour point
REFINDEX
Refractive index
ROC-NO
RVP
SMOKEPT
Smoke point
SULFUR
Sulfur content
TOTAL-N2
VANADIUM
Vanadium
VISC
Viscosity
VLOCKIDX
WARMIDX
Warm-up index
Petroleum Cuts
194
Property Name
Description
<100F
100-200F
Flow rates for petroleum cuts boiling between 100 and 200F
200-300F
Flow rates for petroleum cuts boiling between 200 and 300F
300-400F
Flow rates for petroleum cuts boiling between 300 and 400F
400-500F
Flow rates for petroleum cuts boiling between 400 and 500F
500-600F
Flow rates for petroleum cuts boiling between 500 and 600F
600-700F
Flow rates for petroleum cuts boiling between 600 and 700F
700-800F
Flow rates for petroleum cuts boiling between 700 and 800F
800-900F
Flow rates for petroleum cuts boiling between 800 and 900F
900-999F
Flow rates for petroleum cuts boiling between 900 and 1000F
>1000F
50-100C
100-150C
Flow rates for petroleum cuts boiling between 100 and 150C
150-200C
Flow rates for petroleum cuts boiling between 150 and 200C
200-250C
Flow rates for petroleum cuts boiling between 200 and 250C
250-300C
Flow rates for petroleum cuts boiling between 250 and 300C
300-350C
Flow rates for petroleum cuts boiling between 300 and 350C
350-400C
Flow rates for petroleum cuts boiling between 350 and 400C
400-450C
Flow rates for petroleum cuts boiling between 400 and 450C
450-500C
Flow rates for petroleum cuts boiling between 450 and 500C
B Property Names
Property Name
Description
500-550C
Flow rates for petroleum cuts boiling between 500 and 550C
>550C
CUTS-E
CUTS-M
LT-ENDS
Description
ANILCRV
AROMCRV
BAS-NCRV
CARBCRV
FLASHCRV
FREEZECRV
HYDROCRV
IRONCRV
KNOCKCRV
KVISCCRV
LUM-NCRV
MERCCRV
METALCRV
MOCNCRV
NAPHCRV
NICKCRV
OLEFCRV
OXYGCRV
PARACRV
POURCRV
REFICRV
ROCNCRV
RVPCRV
SMOKCRV
SULFCRV
TOT-NCRV
UOPKCRV
VANACRV
VISCCRV
Viscosity curve
VLOCKCRV
WARMICRV
B Property Names
195
196
Property Name
Description
MOLEFLC
MOLEFLH
MOLEFLN
MOLEFLS
MOLEFLF
MOLEFLCL
MOLEFLBR
MOLEFLI
MOLEFLAR
MOLEFLHE
MASSFLC
MASSFLH
MASSFLO
MASSFLN
MASSFLS
MASSFLF
MASSFLCL
MASSFLBR
MASSFLI
MASSFLHE
MOLEFRC
MOLEFRH
MOLEFRO
MOLEFRN
MOLEFRS
MOLEFRF
MOLEFRCL
MOLEFRBR
MOLEFRI
MOLEFRAR
MOLEFRHE
MASSFRC
MASSFRH
MASSFRO
MASSFRN
MASSFRS
MASSFRF
B Property Names
Property Name
Description
MASSFRCL
MASSFRBR
MASSFRI
MASSFRAR
MASSFRHE
Description
DENSITY
Density
ENTHALPY
Enthalpy
HEAT-CAPACITY
Heat capacity
Description
NUMBER
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
PAREAS
AREA_CALC
SCDUTY
LMTD
FACTOR
Description
NUMBER
CSCOST
B Property Names
197
Property Name
Description
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
PAREAS
AREA_CALC
SCDUTY
LMTD
Description
NUMBER
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
SCDUTY
DUTY
QCALC
B_PRES
Defaulted pressure
198
Property Name
Description
NUMBER
ITYPE
Pump type
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
PROD_VFLOW
L1_FLOW
B_PRES
Pressure rise
HEAD
Pump head
DENSITY
Liquid density
EFF
Pump efficiency
CEFF
Motor efficiency
B Property Names
Property Name
Description
ELEC_POWER
ITYPE
Compressor type
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
POWER
Indicated horsepower
MATFAC
LIQ_FLOW
VAP_FLOW
B_PRES
Pressure rise
HCRATIO
EFF
Compressor efficiency
ELEC_POWER
TYPE
Blower class
SPEED
Motor speed
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
PAREAS
AREA_CALC
LIQ_FLOW
VAP_FLOW
VELOCITY
B_PRES
EFF
Motor efficiency
CEFF
Blower efficiency
ELEC_POWER
B Property Names
199
Description
NUMBER
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
MATFAC1
TWGHT
THGHT
THICKNESS
Description
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
200
Property Name
Description
NUMBER
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
VAR_VAL
Scaled capacity
B Property Names
Description
NUMBER
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
VAP_FLOW
LIQ_FLOW
VOLUME
DIAMETER
Diameter
TTLEN
Tangent-to-tangent length
TOPTHICK
BOTTHICK
TWGHT
Description
NUMBER
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
VAP_FLOW
LIQ_FLOW
VOLUME
DIAMETER
Diameter
TTLEN
Tangent-to-tangent length
TOPTHICK
BOTTHICK
TWGHT
B Property Names
201
202
Property Name
Description
NUMBER
TYPE
Tank type
CSCOST
PCOST
VARID
Material of construction
BBCOST
TCOST
MATFAC
LIQ_FLOW
VOLUME
PVOLS
B Property Names
Index
AspenTech support, 4
AspenTech Support Center, 4
customer support, 4
e-bulletins, 4
help desk, 4
support, technical, 4
technical support, 4
TKACCT, 21
TKALIS, 25
TKBIDS, 30
TKBRES, 35
TKCASN, 26
TKCIDS, 25
TKCLFL, 19
TKCLOS, 18
TKCNCT, 31
TKCNTN, 31
TKCNVT, 23
TKCOMP, 24
TKCPRP, 26
TKEIDS, 120
TKEQCR, 121
TKEQSR, 122
TKFLWB, 21
TKFRCM, 58
TKHCID, 99
TKHCPR, 98
TKHCUR, 97
TKHXBA, 45
TKHXD1, 41
TKHXD2, 42
TKHXNO, 45
TKHXPF, 46
TKHXPP, 47
TKHXPR, 47
TKHXSH, 43
TKHXTU, 44
TKHXZO, 43
TKICST, 53
Index
TKINFO, 19
TKINI2, 17
TKINIT, 16
TKLABL, 24
TKLHCR, 95
TKLRRP, 82
TKLSEC, 66
TKMCCP, 40
TKMCPR, 39
TKNBLK, 30
TKNCOL, 48
TKNENV, 114
TKNEQ, 120
TKNEQP, 121
TKNEQS, 122
TKNEXT, 27
TKNHCP, 97
TKNHCR, 95
TKNHXD, 41
TKNHXT, 42
TKNICS, 53
TKNMCP, 39
TKNPER, 37
TKNPET, 55
TKNPEV, 116
TKNPIP, 93
TKNPPR, 113
TKNPPT, 112
TKNPRS, 124
TKNRES, 34
TKNRRP, 83
TKNSEC, 65
TKNSEN, 27
TKNSPR, 109
TKNSTR, 102
TKNTPR, 63
TKNWHL, 38
TKNXPR, 125
TKOPEN, 18
203
TKPAPF, 131
TKPAPR, 132
TKPAR1, 132
TKPAR2, 133
TKPERF, 37
TKPIDS, 124
TKPINP, 91
TKPIPR, 91
TKPISP, 91
TKPLCO, 87
TKPLCP, 86
TKPLIO, 86
TKPLND, 89
TKPLNP, 88
TKPLPP, 89
TKPLPR, 90
TKPLSG, 88
TKPLSP, 87
TKPLSZ, 85
TKPORT, 32
TKPPEV, 117
TKPPRP, 113
TKPRO1, 50
TKPRO2, 50
TKPROF, 49
TKPROP, 49
TKPSEC, 67
TKPSR1, 129
TKPSR2, 130
TKPSRF, 126
TKPSRP, 127
TKPSS1, 131
TKPSSP, 127
TKPSSR, 128
TKPSSS, 129
TKPSUB, 126
TKPTAD, 56
TKPTCN, 59
TKPTEV, 115
TKPTFR, 57
TKPTPP, 58
TKPTPR, 56
TKPTRS, 55
TKPVPF, 133
TKPVR1, 134
TKPVR2, 135
TKPVRP, 134
TKRCAT, 73
TKRFSP, 74
TKRNAC, 72
TKRNCA, 72
TKRNFS, 74
TKRPIP, 93
204
TKRPR1, 71
TKRPR2, 71
TKRPRF, 69
TKRPRP, 70
TKRRHR, 80
TKRRNS, 81
TKRRPF, 79
TKRRPR, 80
TKRRRP, 84
TKRRSL, 81
TKRSCA, 73
TKRSUB, 69
TKRTNL, 62
TKRTNR, 60
TKRTRS, 60
TKRTSP, 61
TKRTSR, 61
TKSCAT, 107
TKSCPR, 68
TKSCRS, 67
TKSENS, 28
TKSENV, 115
TKSHCR, 96
TKSIDS, 101
TKSINF, 102
TKSNAC, 105
TKSNCA, 106
TKSNSA, 107
TKSPIR, 92
TKSPPT, 112
TKSPRP, 109
TKSRRP, 83
TKSSAT, 108
TKSSCA, 106
TKSSEC, 66
TKSSID, 103
TKSSSA, 108
TKSTRA, 104
TKSTRM, 103
TKSVAL, 104
TKTITL, 20
TKTPRP, 64
TKTREP, 63
TKTRNR, 51
TKTRRS, 52
TKUNIT, 23
TKVAPF, 75
TKVAPR, 75
TKVAR1, 76
TKVAR2, 76
TKVLE, 94
TKVTPF, 77
TKVTPR, 77
Index
TKVTR1, 78
TKVTR2, 78
TKWHLR, 38
web site, technical support, 4
Index
205