SIM4ME Thermo Release Notes for

REFPROP 9.1 Addon

© 2018 AVEVA Group plc and its subsidiaries. All rights reserved.

No part of this documentation shall be reproduced, stored in a ret rieval system, or transmitted by any
means, electronic, mechanical, photocopying, rec ording, or otherwise, without the prior written
permission of AVEVA. No liability is assumed with respect to the use of the information contained herein.
Although precaution has been taken in the preparation of this documentation, AVE VA assumes no
responsibility for errors or omissions. The information in this documentation is subject to change without
notice and does not represent a commitment on the part of AVEVA. The soft ware described in this
documentation is furnished under a lice nse agreement. This soft ware may be used or copied only in
accordance with the terms of such license agreement.
ArchestrA, Aquis, Avantis, DYNS IM, eDNA, EYESIM, InBatch, InduSoft, InStep, IntelaTrac, InTouch,
PIPEPHASE, PRiSM, PRO/II, PROV IS ION, ROMeo, SIM4ME, SimCentral, SimSci, Skelta,
SmartGlance, Spiral Software, Termis, WindowMaker, WindowViewer, and Wonderware are trademarks
of AVEVA and/or its subsidiaries. An extensive listing of AVEVA trademarks can be found at:
https://sw.aveva.com/legal. All other brands may be trademarks of their respective owners.
Publication date: 10/4/2018
Contact Information
AVEVA Group plc
High Cross
Madingley Road
Cambridge
CB3 OHB. UK
https://sw.aveva.com/
For information on how to cont act sales, customer training, and technical support, see
https://sw.aveva.com/contact.
 SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

Contents
Contact Information.................................................................................................................. 3
Introduction................................................................................................................................ 7
The REFPROP Addon............................................................................................................. 9
Addon A vailability through Products ........................................................................................... 9
REFPROP and Licensing ........................................................................................................ 10
Workflow Overview ................................................................................................................. 10

Appendix A Known Issues and Limitations...................................................................... 13

Appendix B List of Supported Fluids in the REFPROP Addon..................................... 15
Appendix C Supported Properties in the SIM4ME Thermo REFPROP Addon ......... 21

5
 SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

Introduction
This document describes the SIM4ME Thermo REFP ROP Addon available in Thermo 4.3. It also
indicates what items need to be shipped with Products.

7
 SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

The REFPROP Addon

The REFP ROP Addon provides a link between SIM4ME Thermo and the REFPROP calculation engine
(refprop.dll) available from NIS T. More specifically, the REFP ROP Addon has been implemented to be
consistent with REFPROP 9.1. The link provides access to the thermodynamic and transport prop erties
available from a list of advanced equations of states for a specific list of components.
The following table describes in more detail the three (3) method selections available through t he Addon.

Method Description What it can do

GERG08 Provides access to the GERG 2008 Phase equilibrium calculations; thermodynamic
method. properties (enthalpy, density, etc.); transport
properties. This method supports 21 fluids (think
"components").
AGA8 Provides access to the AGA 8 Thermodynamic properties (enthalpy, density, etc.);
method. transport properties. This method supports 22 fluids
(think "components").
Limitation: AGA 8 does not calculate phase
equilibrium; it only calculates vapor phase
properties.
NIST23 Provides access to the set of default Phase equilibrium calculations; thermodynamic
methods available in REFP ROP. properties (enthalpy, density, etc.); transport
The REFP ROP engine properties. This method supports 118 fluids (think
automatically decides which "components").
methods are most suitable for the
situation at hand.

Addon Availability through Products

The REFP ROP Addon is shipped with Product installs. Actually, the Addon, the RE FPROP engine
(refprop.dll) and a few support programs are bundled into an install kit that Products install as part of t heir
installation procedure. Once the Addon is installed, the installation remains in effect until the user
initiates the uninstall procedure. The essential details about this are as follows:
 The name of the Addon install kit is RefPropA ddonSetup.exe.
 The Addon install kit is copied to the "bin" folder in the Product install area. The Product install takes
care of installing the Addon.
 Upon installation, the Addon DLL and the REFPROP engine (refprop.dll), both are copied to a
predefined location under "Program Files\Common Files". The Addon also is registered as a COM
server.
 In addition, the file RefProp.ini is created and copied to a predefined location under "All
Users\Application Data". This file tells the Addon where to find refprop. dll and the fluid files (more on
this below).

Note: As of September 2014, only PRO/ II includes the REFPROP Addon kit as part of its install kit.

9
SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon The REFPROP Addon

REFPROP and Licensing

Users can purchase the entire REFP ROP package directly from NIS T. The Addon install deploys the
REFPROP engine (refprop.dll); this by itself is not sufficient to run the engine. The engine needs the fluid
files that are available in the REFPROP package.
Users, who have not purchased REFP ROP from NIS T, can request AVEVA support for t he installation of
the fluid files. Users can go to https://softwaresupport.aveva.com/ to make a product request and look for
NIS T REFPROP 9.1 Fluid Files. The fluid files will be provided only to the customers who have also
requested for PRO/ II 9. 3.1.
The fluid files should be installed before installing the Addon. Without the fluid files, the Addon and
engine do not work.
If the Addon is installed prior to the fluid files, the REFP ROP Addon configuration should be called
through Start/All Programs/SimSci/RefPropAddOn only after the fluid files are installed.
If earlier version of REFP ROP Addon is already installed then the user needs to uninstall the old version
before installing the latest version.

Workflow Overview
The REFP ROP Addon seamlessly provides access to three thermo methods: NIS T23, GERG08 and
AGA8. The following screenshots illustrate how to access these methods in PRO/II.

 The NIS T23 and GERG08 methods can be chosen for Equilibrium, Enthalpy, Entropy, Density and
Trans port properties (any phase in all cases).

10
The REFPROP Addon SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

 Remember that the AGA8 method is only available for vapor phase calculation of Equilibrium,
Enthalpy, Entropy, Density and Transport properties.

11
 SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

A PPENDIX A
Known Issues and Limitations
Users must be aware of the following limitations the RE FPROP A ddon has with respect to the standalone
REFPROP program from NIS T:
 Only the REFP ROP pure fluids are supported. The list of supported fluids also varies with each
method. The list of supported fluids is shown in Appendix B.
 The fluid files must all be located in the same folder. As explained earlier, the location is saved in the
RefProp.ini file as part of the Addon install step.
 Only three thermo met hods are supported at this time: NIS T23 (the default in REFPROP), GERG08
and AGA 8. Other method variations or combinations available through the standalone REFP ROP
application are not supported.
 The AGA8 method is only valid for vapor phas e properties (this is a limitation of AGA8, not the
Addon). Moreover, AGA8 cannot be used for equilibrium calculations.
 Air cannot be mixed with ot her pure components to form a mixture. Air must be used as the only
"component".
 Air is the only "pseudo pure fluid" supported at this time.
 The predefined mixtures in REFP ROP are not supported at this time.
 The Addon does not support direct calls to the various REFP ROP flash algorithms.

Note: PRO/II 9.3.1 is able to call the REFPROP flash directly.

13
 SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

A PPENDIX B
List of Supported Fluids in the REFPROP
Addon
The following table shows the list of REFPROP 9.1 fluids (components) the REFPROP Addon is able to
support. The items that start with C11 represent the 13 new fluids available in v9.1.

NIST GERG AGA

SimSci # Library ID Name Formula Fluid File
23 2008 8

11010010 1BUTE NE 1-BUTE NE C4H8 1BUTE NE.FLD Yes No No

13010010 ACE TONE ACE TONE C3H6O ACE TONE.FLD Yes No No
16020010 AIR AIR Mixture AIR.PPF Yes No No
16020020 AMMONIA AMMONIA NH3 AMMONIA.FLD Yes No No
19010030 ARGON ARGON Ar ARGON.FLD Yes Yes Yes
12010010 BENZENE BENZENE C6H6 BENZENE.FLD Yes No No
9010010 BUTANE n-BUTA NE C4H10 BUTANE.FLD Yes Yes Yes
9050010 DODECA NE n-DODECA NE C12H26 C12.FLD Yes No No
METHYLCYCLOHE XA
10030100 MCH C7H14 C1CC6.FLD Yes No No
NE
C2B UTENE.FL
11010020 C2B UTENE cis-2-BUTE NE C4H8 Yes No No
D
N-P ROPYLCYCLOHE X
10030011 PCH C9H18 C3CC6.FLD Yes No No
ANE
DECAFLUOROBUTA N
8030062 PFC4 C4F10 C4F10.FLD Yes No No
E
PERFLUOROPENTA N
8030069 PFPENTAN C5F12 C5F12.FLD Yes No No
E
16020050 CO CARBON MONOXIDE CO CO.FLD Yes Yes Yes
16020040 CO2 CARBON DIOXIDE CO2 CO2.FLD Yes Yes Yes
15010020 CRB LSULF CARBONYL S ULFIDE COS COS.FLD Yes No No
CYCLOHE X.FL
10030010 CH CYCLOHE XA NE C6H12 Yes No No
D
CYCLOPEN.FL
10020020 CYPNTA NE CYCLOPENTA NE C5H10 Yes No No
D
CYCLOPRO.FL
10010001 CYPROPA N CYCLOPROPANE C3H6 Yes No No
D
16020085 DEUTRIUM DEUTE RIUM D2 D2.FLD Yes No No

15
SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon List of Supported Fluids in the REFPROP Addon

NIST GERG AGA

SimSci # Library ID Name Formula Fluid File
23 2008 8

16020086 DTRIUMOX DEUTE RIUM OXIDE D2O D2O.FLD Yes No No

OCTAME THYLCYCLO C8H24O4S
17030049 OMCTS LN D4.FLD Yes No No
TE TRASILOXA NE i4
DECAME THYLCYCLO C10H30O5
17030029 DMCPS LN D5.FLD Yes No No
PENTASILOXANE Si5
DODECAME THYLCYC C12H36O6
17030040 DDMCHSLN D6.FLD Yes No No
LOHE XAS ILOXA NE Si6
9040010 DECA NE n-DE CA NE C10H22 DECA NE.FLD Yes Yes Yes
DIME THYL ES TE R
16050080 DMCA RB C3H6O3 DMC.FLD Yes No No
CARBONIC A CID
6010040 DME THE R DIME THYL E THER C2H6O DME.FLD Yes No No
9010050 ETHANE ETHANE C2H6 ETHANE.FLD Yes Yes Yes
2010060 EA ETHANOL C2H6O ETHANOL.FLD Yes No No
11010040 ETHYLE NE ETHYLE NE C2H4 ETHYLE NE.FLD Yes No No
19010200 FLUORINE FLUORINE F2 FLUORINE.FLD Yes No No
16020140 HYSULFID HYDROGEN SULFIDE H2S H2S.FLD Yes Yes Yes
16020088 HE4 HELIUM-4 He HELIUM.FLD Yes Yes Yes
9020130 HEP TANE n-HEP TA NE C7H16 HEP TANE.FLD Yes Yes Yes
9010060 HE XA NE n-HE XA NE C6H14 HE XA NE.FLD Yes Yes Yes
HYDROGEN.FL
16020090 HYDROGEN HYDROGEN H2 Yes Yes Yes
D
11010060 IB TE ISOB UTENE C4H8 IBUTE NE.FLD Yes No No
9010100 2MPENTA N 2-ME THYLPENTA NE C6H14 IHE XA NE.FLD Yes No No
9010080 IPENTA NE ISOPENTA NE C5H12 IPENTA NE.FLD Yes Yes Yes
9010070 IBUTA NE ISOB UTANE C4H10 ISOB UTAN.FLD Yes Yes Yes
19010370 KRYPTON KRYPTON Kr KRYPTON.FLD Yes No No
DECAME THYLTE TRA C10H30O3
17030033 DMTSN MD2M.FLD Yes No No
SILOXA NE Si4
DODECAME THYL C12H36O4
17030067 DDMPS N MD3M.FLD Yes No No
PENTASILOXANE Si5
TE TRADE CAME THYL C14H42O5
17030067 TDMHSLN MD4M.FLD Yes No No
HE XAS ILOXANE Si6
OCTAME THYL C8H24O2S
17030051 OMSLOXA N MDM.FLD Yes No No
TRIS ILOXANE i3
9010090 METHANE METHANE CH4 METHANE.FLD Yes Yes Yes
METHANOL.FL
2010120 METHALC METHANOL CH4O Yes No No
D

16
List of Supported Fluids in the REFPROP Addon SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

NIST GERG AGA

SimSci # Library ID Name Formula Fluid File
23 2008 8

HE XAME THYLDISILOX C6H18OSi

17030043 HMSLOXA N MM.FLD Yes No No
ANE 2
METHYL
7010075 MOLEA TE CIS -9-OCTADE CENOA C19H36O2 MOLEA TE.FLD Yes No No
TE
16020167 NITRSOXD NITROUS OXIDE N2O N2O.FLD Yes No No
19010500 NEON NEON Ne NEON.FLD Yes No No
NEOPENTN.FL
9010040 22PR NEOPENTA NE C5H12 Yes No No
D
NITROGEN
16020165 NITRIF NF3 NF3.FLD Yes No No
TRIFLUORIDE
16020160 NITROGEN NITROGEN N2 NITROGEN.FLD Yes Yes Yes
9030100 NONANE n-NONANE C9H20 NONANE.FLD Yes Yes Yes
9020210 OCTA NE n-OCTA NE C8H18 OCTA NE.FLD Yes Yes Yes
6020170 OXY GEN OXY GEN O2 OXY GEN.FLD Yes Yes Yes
16020091 H2PARA HYDROGEN (para) H2 PARAHYD.FLD Yes No Yes
9010120 PENTANE n-PENTA NE C5H12 PENTANE.FLD Yes Yes Yes
9010130 PROPANE PROPANE C3H8 PROPANE.FLD Yes Yes Yes
PROPYLE N.FL
11010160 PROPENE PROPYLE NE C3H6 Yes No No
D
11070030 MACE TYLN PROPYNE C3H4 PROPYNE.FLD Yes No No
TRICHLOROFLUORO
8030135 R11 CCl3F R11.FLD Yes No No
METHANE
1,1,2-TRICHLOROTRIF
8030155 R113 C2Cl3F3 R113.FLD Yes No No
LUOROE THA NE
1,2-DICHLOROTE TRA
8030039 R114 C2Cl2F4 R114.FLD Yes No No
FLUOROE THA NE
CHLOROPE NTAFLUO
8030034 R115 C2ClF5 R115.FLD Yes No No
ROE THANE
HE XAFLUOROE THAN
8030056 R116 C2F6 R116.FLD Yes No No
E
DICHLORODIFLUORO
8030032 R12 CCl2F2 R12.FLD Yes No No
METHANE
2,2-DICHLORO-1,1, 1-T
8030043 11DCLTFE C2HCl2F3 R123.FLD Yes No No
RIFLUOROE THANE
2,3,3,3-TE TRAFLUOR
8030143 R1234YF C3F4H2 R1234YF.FLD Yes No No
OPROP -1-E NE
2-CHLORO-1,1,1,2-TE
8030041 R124 C2HClF4 R124.FLD Yes No No
TRAFLUOROE THANE

17
SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon List of Supported Fluids in the REFPROP Addon

NIST GERG AGA

SimSci # Library ID Name Formula Fluid File
23 2008 8

PENTAFLUOROE THA
8030031 R125 C2HF5 R125.FLD Yes No No
NE
CHLOROTRIFLUORO
8030035 R13 CClF3 R13.FLD Yes No No
METHANE
1,1,1,2-TE TRAFLUOR
8030085 R134A C2H2F4 R134A.FLD Yes No No
OETHA NE
CARBON
8030015 R14 CF4 R14.FLD Yes No No
TE TRAFLUORIDE
1,1-DICHLORO-1-FLU
8030021 R141B C2H3Cl2F R141B.FLD Yes No No
OROE THA NE
1-CHLORO-1,1-DIFLU
8030018 CFFE C2H3ClF2 R142B.FLD Yes No No
OROE THA NE
1,1,1-TRIFLUOROE TH
8030156 R143 C2H3F3 R143A.FLD Yes No No
ANE
1,1-DIFLUOROE THAN
8020164 R152A C2H4F2 R152A.FLD Yes No No
E
8010164 ETFL ETHYL FLUORIDE C2H5F R161.FLD Yes No No
DICHLOROFLUOROM
8030033 R21 CHCl2F R21.FLD Yes No No
ETHANE
OCTAFLUOROPROPA
8030072 PFC3 C3F8 R218.FLD Yes No No
NE
CHLORODIFLUOROM
8030020 R22 CHClF2 R22.FLD Yes No No
ETHANE
8030046 CHF3 TRIFLUOROME THANE CHF3 R23.FLD Yes No No
8020173 DIFM DIFLUOROME THANE CH2F2 R32.FLD Yes No No
8010166 MEFL METHYL FLUORIDE CH3F R41.FLD Yes No No
OCTAFLUOROCY CLO
8030053 R318 C4F8 RC318.FLD Yes No No
BUTANE
SULFUR
16020188 SULFHXF SF6 SF6.FLD Yes No No
HE XAFLUORIDE
16020190 SULFDIOX SULFUR DIOXIDE SO2 SO2.FLD Yes No No
11010030 T2BUTE NE trans-2-BUTENE C4H8 T2BUTE NE.FLD Yes No No
12010070 TOLUENE TOLUENE C7H8 TOLUENE.FLD Yes No No
16020200 H2O WATER H2O WATER.FLD Yes Yes Yes
19010730 XENON XENON Xe XENON.FLD Yes No No
9050050 C11 n-UNDECA NE C11H24 C11.FLD Yes No No
6010020 DEE DIE THYL E THER C4H10O DEE.FLD Yes No No
EBENZE NE.FL
12010030 EBENZE NE PHENYLE THA NE C8H10 Yes No No
D

18
List of Supported Fluids in the REFPROP Addon SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

NIST GERG AGA

SimSci # Library ID Name Formula Fluid File
23 2008 8

HYDROGEN
16020100 HCL HCL HCL.FLD Yes No No
CHLORIDE
2,2,4-TRIME THY LPEN
9020250 224P C8H18 IOCTANE.FLD Yes No No
TA NE
12010110 MXYLE NE m-XY LENE C8H10 MXYLE NE.FLD Yes No No
12010120 OXY LENE o-XYLE NE C8H10 OXY LENE.FLD Yes No No
12010130 P XYLE NE p-XYLE NE C8H10 P XYLE NE.FLD Yes No No
8010090 R40 METHYL CHLORIDE CH3Cl R40.FLD Yes No No
HE XAFLUOROPROPE
8030067 C3F6 C3F6 R1216.FLD Yes No No
NE
TRIFLUOROIODOME T
8303603 CF3I* CF3I CF3I.FLD Yes No No
HANE
PENTAFLUOROE THYL
8301610 RE245CB 2* C3H3F5O RE245CB 2.FLD Yes No No
METHYL E THE R
2-(DIFLUOROME THOX
8302868 RE245FA2* Y)-1,1,1-TRIFLUOROE C3H3F5O RE245FA2.FLD Yes No No
THAN
HEP TAFLUOROP ROP RE347MCC.FL
8307889 RE347MCC * C4H3F7O Yes No No
YL METHYL E THER D
trans-1,3,3,3-TE TRAFL
8303609 R1234ZE * C3H2F4 R1234ZE.FLD Yes No No
UOROP ROPENE
1,1,1,3,3,3-HE XAFLUO
8301620 R236FA* C3H2F6 R236FA.FLD Yes No No
ROP ROPANE
1,1,1,3,3-PE NTAFLUO
8302627 R245FA* C3H3F5 R245FA.FLD Yes No No
ROP ROPANE
1,1,2,2,3-PE NTAFLUO
8302628 R245CA* C3H3F5 R245CA.FLD Yes No No
ROP ROPANE
1,1,1,2,3,3,3-HEP TAFL
8302630 R227EA* C3HF7 R227EA.FLD Yes No No
UOROP ROPANE
1,1,1,2,3,3-HE XAFLUO
8302631 R236EA* C3H2F6 R236EA.FLD Yes No No
ROP ROPANE
1,1,1,3,3-PE NTAFLUO
8303606 R365MFC * C4H5F5 R365MFC.FLD Yes No No
ROB UTANE
7010343 MLINOLEA METHYL LINOLEA TE C19H34O2 MLINOLEA.FLD Yes No No
7010350 MLINOLEN METHYL LINOLE NA TE C19H32O2 MLINOLEN.FLD Yes No No
7010340 MPALMITA METHYL PALMITA TE C17H34O2 MPALMITA.FLD Yes No No
METHYL MSTEA RA T.FL
7010342 MSTEA RA T C19H38O2 Yes No No
OCTA DECA NOA TE D

(*) These components are available from the DIPPR library.

19
SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon List of Supported Fluids in the REFPROP Addon

20
 SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

A PPENDIX C
Supported Properties in the SIM4ME
Thermo REFPROP Addon
A summary of supported functionality in the REFPROP Addon follows. This is what the Applications can
get through the Addon.
Base properties – Thermo and Transport:
 Z
 ln PHI i
 H
 U
 S
 Rho
 Viscosity
 Thermal Conductivity
 Surface Tension
Derivatives that we expose but actually calculate numerically – Thermo and Transport:

21
SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon Supported Properties in the SIM4 ME Thermo REFPROP Addon

Equilibrium Enthalpy Internal Energy

d(lnP HIi) / dT d(H) / dT d(U) / dT

d2(lnPHIi) / dT2 d2(H) / dT2 d2(U) / dT2
d2(lnPHIi) / dT dP d2(H) / dT dP d2(U) / dT dP
d3(lnPHIi) / dT2 dP d2(H) / dT dnj d2(U) / dT dnj
d2(lnPHIi) / dT dnj d(H) / dP d(U) / dP
d3(lnPHIi) / dT3 d2(H) / dP2 d2(U) / dP2
d3(lnPHIi) / dT2 dnj d2(H) / dP dnj d2(U) / dP dnj
d3(lnPHIi) / dT dP dnj d(H) / dnj d(U) / dnj
d(lnP HIi) / dP d2(H) / dnj dnk dn(U) / dnj
d2(lnPHIi) / dP2 dn(H) / dnj d2(U) / dN2
d3(lnPHIi) / dT dP2 dn[dn(H) / dnj] / dnk
d2(lnPHIi) / dP dnj d[dn(H) / dnj] / dT
dn(lnPHIi) / dnj d[dn(H) / dnj] / dP
d3(lnPHIi) / dT dnj dnk
dn[dn(lnP HIi) / dnj] / dnk

Entropy Density

d(S) / dT d(RHO) / dT
d2(S ) / dT2 d2(RHO) / dT2
d2(S ) / dT dP d2(RHO) / dT dP
d2(S ) / dT dnj d2(RHO) / dT dnj
d(S) / dP d(RHO) / dP
d2(S ) / dP2 d2(RHO) / dP2
d2(S ) / dP dnj d2(RHO) / dP dnj
d(S) / dnj d(RHO) / dnj
d2(S ) / dnj dnk d2(RHO) / dnj dnk
dn(S ) / dnj
dn[dn(S) / dnj] / dnk
d[dn(S ) / dnj] / dT
d[dn(S ) / dnj] / dP

22
Supported Properties in the SIM4 ME Thermo REFPROP Addon SIM4 ME Thermo Release Notes for REFPROP 9.1 Addon

Viscosity Thermal Conductivity Surface Tension

d(VIS C) / dT d(COND) / dT d(SURF) / dT

d(VIS C) / dP d(COND) / dP d(SURF) / dP
d(VIS C) / dnj d(COND) / dnj d(SURF) / dnj
dn(V ISC) / dnj dn(COND) / dnj dn(S URF) / dnj

23