Introduction To LIBMGR 1-1: LIBMGR and COMPS User's Guide October 1994 I
Introduction To LIBMGR 1-1: LIBMGR and COMPS User's Guide October 1994 I
Chapter 1
Introduction to LIBMGR 1-1
What is LIBMGR? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
How is This Manual Organized? . . . . . . . . . . . . . . . . . . . . . . . . 1-2
When Should You Use LIBMGR? . . . . . . . . . . . . . . . . . . . . . . . 1-2
How Does LIBMGR Interact with PRO/II and PROVISION? . . . . . . . . 1-3
How Does LIBMGR Work? . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Chapter 2
The LIBMGR Program 2-1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
General Input File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
LIBMGR Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Chapter 3
Creating and Running the Input File (LIBMGR) 3-1
General Data Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
ADDBANK Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
ADDCOMP Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
ADD Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Running LIBMGR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
Chapter 4
Sample Input Files - (LIBMGR) 4-1
Example 1, Henrys Law Correlation Parameters Databank . . . . . . . . . 4-1
Example 2, SRKM and ALPHA Databanks . . . . . . . . . . . . . . . . . . 4-2
Example 3, Azeotrope Databank . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Index I-1
When PROVISION locates your new USER.LB1 and USER.LB2 files in the correct
directory, the databanks within the USER files will be listed in the appropriate com-
ponent and thermodynamic windows in PROVISION.
Figure 1-1 gives a schematic of how LIBMGR interacts with PRO/II and
PROVISION.
NOTE: Although LIBMGR provides the capability to add pure component data to the
library through the ADDCOMP category, we recommend that you use
DATAPREPTM to generate pure component databanks. DATAPREP is specifically
designed for this purpose and provides an enhanced interface and expanded capabil-
ity for pure component databank generation. See the DATAPREP Users Guide for
more information.
LIBMGR creates a single file which contains databanks that are accessible and iden-
tifiable by a unique databank name. Table 2-1 lists the types of databanks that can
be built by LIBMGR. Parameters for methods other than those listed in Table 2-1
are not currently supported by LIBMGR.
ADDCOMP
Categories for Pure component 1 specifiers
Component Data ADDCOMP
component 2 specifiers
END Keyword
END
The last keyword in the input file for LIBMGR is an optional END statement.
Symbol or Description
Default
$ When the dollar sign appears as the first character on a line, the entire line is treated
as a comment. A dollar sign marks the beginning of a comment. Anything to the
right of the $ is ignored. Therefore, any continuation mark (& or *) appearing
on the same line to the right of the $ is ignored.
& and * An ampersand or an asterisk entered at the end of a line indicates continuation of a
statement on the following line. Any data appearing on the same line to the right of
the asterisk or ampersand is ignored.
ENGLISH Default units of measure.
Keyword Description
LIBMGR and COMPS Users Guide Creating and Running the LIBMGR Input File
October 1994 3-1
ADDBANK Statement
Following the General Data category, there can be one or more databanks present in
the file. These individual databanks are identified by ADDBANK statements.
There must be an ADDBANK statement for each individual databank. Depending
on the type of user data (pure components, SRK binary interaction parameters,
Henrys constants, Rackett parameters, etc.) the syntax for entering each of the
LIBMGR ADDBANK statements differs. Pure component ADDBANK statements,
produced by DATAPREP or LIBMGR, can be combined in the same file with other
ADDBANK statements containing other types of binary or unary data created by the
user.
The ADDBANK statement has three associated keywords as described in Table 3-2.
Keyword Description
TYPE Identifies what kind of databank is being created as summarized in Table 2-1.
NAME Gives the databank its name. You can have multiple databanks of the same TYPE of
data as long as each has a unique NAME. The name is how the databank is identified in
the appropriate PROVISION list box:
For the component property databank: Under the Component Selection window is the
Databank Hierarchy window.
Creating and Running the LIBMGR Input File LIBMGR and COMPS Users Guide
3-2 October 1994
ADDCOMP Category
This category is used in conjunction with the following statement:
ADDBANK TYPE=PURECOMP
These databanks consist of component identification material and both fixed and
temperature dependent property data. The syntax for these properties can differ
slightly from the corresponding PRO/II keyword input formats. These differences
will be discussed where appropriate.
The first statement after the ADDCOMP statement itself in an ADDCOMP cate-
gory is the LIBID statement. The LIBID statement has the keywords shown in
Table 3-3.
Keyword Description
IDNUMBER This number must be unique and range between 1000000 and 99999999. If the
component exists in a SIMSCI library, then that identifier can be used. SIMSCI
currently uses IDNUMBs between 1000000 and 19999999. DATAPREP arbitrarily
begins its assignments at 20000001. The id number for SIMSCI library components
can be found in the DATAPREP Users Guide.
IDNAME This keyword must also be unique. If the component exists in a SIMSCI library, then
that identifier can be used.
CASN The Chemical Abstract Number (optional).
ALIAS Multiple entries(10) of 8 characters can be assigned to each component, once again
these must be unique in each bank.
If you desire to use binary interaction data from existing SIMSCI binary databanks
for your nonlibrary components, then all the above identifiers must be the same
as those in the SIMSCI libraries.
For example, if you have WATER as a component in your pure component user dat-
abank and assign 16020200 as the IDNUMB, H2O as the IDNAME, and 7732185
as the CASN, all the equation of state and liquid activity parameters normally acces-
sible to the components from the system databanks can also be accessible to your
user pure component databank components. If you were to assign other identifiers to
an existing library component this would not be true.
LIBMGR and COMPS Users Guide Creating and Running the LIBMGR Input File
October 1994 3-3
Table 3-4 shows the remaining statements used in the ADDCOMP category.
Statement Description
Creating and Running the LIBMGR Input File LIBMGR and COMPS Users Guide
3-4 October 1994
An example file containing the ADDCOMP category is shown in Figure 3-1 below.
ADDCOMP
LIBID IDNUMBER= 2010120, IDNAME=METHANOL, CASN= 67561, &
ALIAS=MA ,MEOH ,METHALC ,CARBINOL
Structure, Name NAME METHANOL
and Identification FORMULA CH4O
Information REFERENCE PRIMARY=11005
PHASE VLS
STRUCTURE 1611, 1
PROPERTY &
MW = 32.042160 &
NBP(K) = 337.85001 &
NMT(K) = 175.47000 &
TTP(K) = 175.47000 &
Fixed Property PTP(KPA) = 1.11469009E-04 &
Data TC(K) = 512.64001&
PC(KPA) = 8097.0005 &
VC(M3/KG,MOLE) = 0.11800000 &
ZC = 0.2240000&
MOLV(M3/KG,MOLE) = 4.05810997E-02 &
HTFO(V,J/KG,MOLE) = -2.00940000E+08 &
FREE(V,J/KG,MOLE) = -1.62320000E+08 &
HFUS(J/KG,MOLE) = 3215000.0 &
HCOM(J/KG,MOLE) = -6.38200000E+08 &
GHV(KJ/KG,MOLE) = 765109.44 &
LHV(KJ/KG,MOLE) = 676311.56 &
ACEN = 0.56399101 &
RADI(ANG) = 1.5520000 &
SOLP = 14.464301 &
DIPO = 1.6998236 &
VDWV = 1.4311000 &
VDWA = 1.4320000 &
FLAS(K) = 284.00000 &
LOFL(PCT) = 7.3000002 &
HIFL(PCT) = 36.000000 &
IGNI(K) = 737.00000 &
SPGR = 0.79934138 &
CNUM = 1., ZNUM = 2.
$MISSING PARA, DIAL, TDIE
VP(PA) CORR=20, LIMITS(K)= 175.470, 512.640, LN, &
Temperature COEF= 81.76800, -6876.000, -8.707800, 7.1926002E-06, 2.000000
Dependent Data LATE(J/KG,MOLE) CORR=15, LIMITS(K)= 175.470, 512.640 &
COEF= 5.2390000E+07, 0.3682000
LIBMGR and COMPS Users Guide Creating and Running the LIBMGR Input File
October 1994 3-5
SURF(N/M) CORR= 1, LIMITS(K)= 273.100, 503.150 &
COEF= 3.5130002E-02,-7.0400001E-06,-1.2160000E-07
VVIS(PAS) CORR=19, LIMITS(K)= 240.000, 1000.000 &
COEF= 3.0663000E-07, 0.6965500 , 205.0000
VCON(W/MK) CORR=19, LIMITS(K)= 273.000, 1000.000 &
COEF= -7.763000, 1.027900,-7.4360000E+07, 6.7699999E+09
LVIS(PAS) CORR=20, LIMITS(K)= 175.470, 337.850, LN, &
COEF= -25.31700 , 1789.200 , 2.069000
LCON(W/MK) CORR= 1, LIMITS(K)= 175.470, 337.850 &
COEF= 0.2837000 ,-2.8099999E-04
LDEN(KG/M3,MOLE) CORR=16, LIMITS(K)= 175.470, 512.640 &
COEF= 2.288000, 0.2685000, 512.6400, 0.2453000
SDEN(KG/M3,MOLE) CORR= 1, LIMITS(K)= 163.150, 163.150 &
COEF= 30.58500
$MISSING SCON
$MISSING SVP
HLIQ(J/KG,MOLE) CORR= 1, LIMITS(K)= 175.470, 400.000 &
COEF=-2.1757572E+07, 105800.0 , -181.1150, 0.3126333
HIDE(J/KG,MOLE) CORR=17, LIMITS(K)= 200.000, 1500.000 &
Temperature COEF=-9.2596216E+07, 39252.00, 87900.00, 1916.500 , 53654.00 , 896.7000
Dependent Data, HSOL(J/KG,MOLE) CORR= 1, LIMITS(K)= 25.000, 150.000 &
continued COEF=-1.6518658E+07, -12706.00 , 479.3900, -1.744400 , 3.2879999E-03
PROPERTY &
SVTB = -0.26612750 &
SLTB = 104.34367 &
SLTM = 49.582611 &
HVTB = -0.30944625 &
HLTB = 35252.508 &
HLTM = 12450.395
Creating and Running the LIBMGR Input File LIBMGR and COMPS Users Guide
3-6 October 1994
ADD Statement
Each ADDBANK statement can have an unlimited amount of binary and unary data
entries associated with the databank. All data are added by means of the ADD state-
ment. Only the types of data identified in Table 3-5 are currently valid. Each type
of databank has its own syntax for the ADD statement. Remember, each binary data
set requires an ADD statement. Each entry must be unique. For example, if two or
more entries are given for the same binary pair, the second will overwrite the first.
The first entries following the ADD statement are the library ids of the components
involved. The libid entries are equivalent to the respective SIMSCI library id num-
bers. This number can be found in the DATAPREP Users Guide for library compo-
nents. This must correspond to the IDNUMB given by the user in his or her pure
component databank for all non-library components. Libids must appear in ascend-
ing numerical order.
The CODE keyword is not used by LIBMGR or PRO/II, but it is used in the
LIBMGR input file for the user to record a pedigree or reference for the data. The
CODEs used can be documented in the file itself as comments in the file header.
Either the CODE or REF keyword can be used for databank documentation pur-
poses and can be followed with an integer between 1 and 6.
Table 3-5 presents a description of the syntax and keywords associated with the
ADD Statement.
Keyword Description
TEMP, PRES These keywords currently serve only as documentation aids for the data. PRO/II
makes no use of this information. TEMP and PRES are used to give some indication of
the valid temperature and pressure range of the parameters.
CODE or REF This keyword is not used by LIBMGR or PRO/II, but it is used in the LIBMGR input file
for the user to record a pedigree or reference for the data. The CODEs or REFs used
can be documented in the file itself as comments in the file header. Either the CODE or
REF keyword can be used for databank documentation purposes and can be followed
with an integer between 1 and 6.
DATA This keyword identifies the method parameters. See Table 3-6 to determine the correct
parameter order.
LIBMGR and COMPS Users Guide Creating and Running the LIBMGR Input File
October 1994 3-7
Table 3-6 contains a keyword summary for the ADD statement for each type of bi-
nary databank.
Creating and Running the LIBMGR Input File LIBMGR and COMPS Users Guide
3-8 October 1994
The order of the parameters after each DATA keyword does not necessarily corre-
spond to either PRO/II or DATAPREP. Table 3-7 shows the order of the parameters
that must be used for LIBMGR input files.
NOTE: See Chapters 20-29 of the PRO/II Keyword Input Manual for a complete de-
scription of each of the parameters.
LIBMGR and COMPS Users Guide Creating and Running the LIBMGR Input File
October 1994 3-9
Table 3-7: Parameter Order for each DATA Statement , continued
NOTE: The ALPHA entry is present in Table 3-7. Since PRO/II allows a number of
different alpha forms to be used by the cubic Equations of State (EOS), it is neces-
sary to clearly define which alpha form the parameters in a given alpha databank
are associated with. This is accomplished by use of the alpha form code. The rela-
tion between the alpha form code and keyword description used in PRO/II and RE-
GRESS is given in Table 3-8 below. Refer to Table 23.5-1, Alpha Formulations, in
Chapter 23, Equations of State, in the PRO/II Keyword Input Manual. The first two
letters of the PRO/II keyword identify the form to be related to either the Soave-
Redlich-Kwong (SAnn), Peng-Robinson (PAnn), or van der Waals equation (VAnn)
(used by Uniwaals). The number comprising the final portion of the keyword is the
alpha form index as described in Chapter 23, Equations of State, in the PRO/II Key-
word Input Manual or in the PROVISION on-line Thermodynamic Reference Man-
ual.
Creating and Running the LIBMGR Input File LIBMGR and COMPS Users Guide
3-10 October 1994
Table 3-8: Alpha Form Codes for EOS Alpha Forms
alpha form code alpha keyword alpha form code alpha keyword alpha form code alpha keyword
101 SA01 201 PA01 301 VA01
102 SA02 202 PA02 302 VA02
103 SA03 203 PA03 303 VA03
104 SA04 204 PA04 304 VA04
105 SA05 205 PA05 305 VA05
106 SA06 206 PA06 306 VA06
107 SA07 207 PA07 307 VA07
108 SA08 208 PA08 308 VA08
109 SA09 209 PA09 309 VA09
110 SA10 210 PA10 310 VA10
111 SA11 211 PA11 311 VA11
LIBMGR and COMPS Users Guide Creating and Running the LIBMGR Input File
October 1994 3-11
Running LIBMGR
To run LIBMGR and create user databank USER.LB* files:
Move the input file to the LIBMGR directory. The input file should have the
name XXXX.INP.
NOTE: If the input file was generated from DATAPREP, it will have the filename con-
vention of UlibnameLIB.DAT, where the libname was the four character user li-
brary name assigned by the creator of the user databank in DATAPREP. Be sure to
rename the DATAPREP output file xxxx .INP before LIBMGR is executed or, if
merging files, append the DATAPREP output file to the LIBMGR xxxx.INP file .
LIBMGR will generate xxxx.LB1 and xxxx.LB2. Before these LIBMGR output files
can be used by PRO/II or PROVISION, they must be renamed USER.LB1 and
USER.LB2.
To execute LIBMGR, type the command BLDLIB XXXX where XXXX is the four
character file name. The results will be XXXX.OUT, XXXX.LB1 and XXXX.LB2
files. The *.LB* files need to be moved or copied to the appropriate library directory
and renamed USER.LB1 and USER.LB2. The default library directory for Version
4.0 of PRO/II is C:\SIMSCI\PROII\LIB, while for PROVISION Version 1.0 it is
C:\SIMSCI\PVISION\LIB.
You can view the output from LIBMGR by examining XXXX.OUT directly. Once
you are satisfied with the contents of the library and have moved the USER.LB*
files created by LIBMGR to the proper directory, access the information in the dat-
abanks in the following way:
In PRO/II:
Access any databank by the BANK keyword on the appropriate property state-
ment
In PROVISION:
For binary components: Look for the databank in the Databank Search Order
window that comes up under the Modify Thermodynamic Data window in PRO-
VISION.
For unary components: Look for the databank in the Databank Search Order
window that comes up under the Component Selection window.
Creating and Running the LIBMGR Input File LIBMGR and COMPS Users Guide
3-12 October 1994
Chapter 4
Sample LIBMGR Input Files
This chapter contains examples of input files for user-added databanks.
NOTE: The CODE keyword has been used to document the data source of each entry.
NOTE: The binary kij SRKM databank is available in PROVISION while the alpha
databank is not.
C:
CD \SIMSCI\COMPS
COMPS
2. Choose a search option from the main menu as described below and press
<Enter>. Press <Esc> at any time to exit. The main menu provides the fol-
lowing options:
Normal boiling point, molecular weight and specific gravity displayed are from the
reference databank indicated. The CAS number is the Chemical Abstract Service
reference number.
For components in electrolyte models, the program will identify the name which
must be used in building user-added electrolyte models next to the Elec Model Name
field.
NOTE: