You are on page 1of 31

CoolProp

Installation

Installation Instructions
a) Download the CoolProp.dll and CoolProp_x64.dll files and place them in a folder called C:\CoolProp*
b) Download the CoolProp.xlam file and place it in a convenient location
c) Install the CoolProp Add-in from the Excel Options menu, Manage Add-ins
1) Open Excel
2) Go to the menu File→Options→Add-Ins
3) At the bottom of the panel, select Manage: Excel Add-ins, then click the Go… button.
4) Click the browse button on the Add-in Manager panel.
5) Browse to the file CoolProp.xlam that you copied above in step (b).
6) Make sure the CoolProp Add-in is selected (box checked) and close the add-in manager.
d) Open the file TextExcel.xlsx (this file) and try to re-evaluate one of the formula cells on the Sample Calcs tab. The

*Alternate CoolProp Location


If you need to place the CoolProp DLL files in a location other than on the C: drive, follow these instructions:
a) Download the CoolProp.dll and CollProp_64.dll files and place them in CoolProp directory in a reachable location
b) Open CoolProp.xlam
c) You will get an Excel error - File not found: C:\CoolProp\CoolProp.dll
d) Clicking Ok on the error dialog only brings up another. Try pressing and holding the <Enter> key until the errors
e) Go to File | Options on the main menu and select Customize Ribbon from the Excel Options panel menu
1) In the right hand pane under Main Tabs, make sure that the box in front of Developer is checked
2) Press OK
f) Under the Developer menu, select Visual Basic to bring up the visual basic editor
1) Select Edit | Replace… from the main menu
2) Enter the following on the panel
Find What: C:\CoolProp\CoolProp.dll
Replace With: (new location)
3) Press the Replace All button
4) Repeat for C:\CoolProp\CoolProp_64.dll
g) Press the Save button (disk image) or File | Save
h) Press File | Close and Return to Excel
i) Press <Alt>-<Ctrl>-<Shift>-F9 to recalculate the entire workshee on the Sample Calcs tab. All formulas should no
C:\CoolProp*

the Sample Calcs tab. The CoolProp formulas should all be working.

these instructions:
ory in a reachable location

nter> key until the errors go away


tions panel menu
per is checked

b. All formulas should now be working.


CoolProp
Example Calculations

Function Usage Units COOLPROP


Critical temperature of R410A: K 344.494
Critical density of propane: kg/m³ 220.4781
Density of Nitrogen at STP: kg/m³ 1.2503861303389
Density of Air at STP: kg/m³ 1.29306561632926
Boiling point of water at 1 atm: °C 99.9742958476844
Boiling point of water at 1 atm: °C #NAME?
Example of an error: Neither input to Props1SI [A,B] is a valid fluid
CoolProp DLL version installed: 6.4.1
CoolProp Git Revision: f5ebb4e655add4c23bb327ab5209f3dbf919bc6d

Phase Determination
Water phase @ RT liquid
Water phase @ 400 K and 1 atm gas
Water phase @ 400 K and 30 MPa supercritical_liquid
Water phase @ 1030 K and 10 MPa supercritical_gas
Water phase @ 1030 K and 30 MPa supercritical

Mixtures
mole
Components fraction
Nitrogen 0.7809
Oxygen 0.2095
Argon 0.0093
CO2 0.00039
Dewpoint of dry air at 1 atm: K 78.9334002792489
Density of dry Air at STP: kg/m³ 1.2931619487069

Humid Air Properties Units COOLPROP


Dewpoint of dry Air at 1 atm: K 149.395443936721
Dewpoint of air at 1 atm, 50% humidity: K 282.424425815133
Density of Dry Air at STP: kg/m³ 1.29309561547028
Density of 50% Humid Air at STP: kg/m³ 1.29162476814839
Enthalpy of 50% Humid Air at STP: J/kg 4723.43663209161
Temperature of Sat. Air at H=4723.44 J/kg: K 270.385684674573
* Air Temperature (T) = 20°C

Incompressible Fluid Properties Units COOLPROP


Viscosity of 20% Aqueous Ethylene Glycol: Pa-s 0.00138142216644215
Specifi Heat of Dowtherm Q @ 500 K, 1 atm J/kg-K 2288.16437586457
Density of Seawater @ RT, 3.5% Salinity kg/m° 1024.85984436413
op
Expected value
344.494
220.4781
1.2503861303389
1.29306561632926
99.974295847688
99.974295847698
ops1SI [A,B] is a valid fluid
[current version]
3bb327ab5209f3dbf919bc6d

liquid
gas
supercritical_liquid
supercritical_gas
supercritical

78.9334036422374
1.29316195370149

Expected value
149.395443936362
282.424425815013
1.2930956154536
1.29162476813186
4723.43663396286
270.385663973155

Expected value
0.0013814221664422
2288.16437586457
1024.85984436413
Function Call
=Props1SI("R410A","Tcrit")
=Props1SI("Propane","rhocrit")
=PropsSI("Dmass","T",298.15,"P",101325,"HEOS::Nitrogen")
=PropsSI("Dmass","T",298.15,"P",101325,"HEOS::Air")
=PropsSI("T","P",101325,"Q",0,"HEOS::Water")-273.15
=PropsSI("T","P",101325,"Q",0,"REFPROP::Water")-273.15
=Props1SI("A","B")
=get_global_param_string("version")
=get_global_param_string("gitrevision")

=PhaseSI("T",293.15,"P",101325,"Water")
=PhaseSI("T",400,"P",101325,"Water")
=PhaseSI("T",400,"P",30e6,"Water")
=PhaseSI("T",1030,"P",10e6,"Water")
=PhaseSI("T",1030,"P",30e6,"Water")

=PropsSI("T","P",101325,"Q",0,"HEOS::"&MixtureString(A17:A20,B17:B20))
=PropsSI("D","T",273.15,"P",101325,"HEOS::"&MixtureString(A17:A20,B17:B20))

Function Call
=HAPropsSI("D","T",293.15,"P",101325,"R",0)
=HAPropsSI("D","T",293.15,"P",101325,"R",0.5)
=1/HAPropsSI("Vda","T",273.15,"P",101325,"R",0)
=1/HAPropsSI("Vha","T",273.15,"P",101325,"R",0.5)
=HAPropsSI("H","T",273.15,"P",101325,"R",0.5)
=HAPropsSI("T","H",C31,"P",101325,"R",1)

Function Call
=PropsSI("V","T",300,"P",101.325,"INCOMP::MEG[0.2]")
=PropsSI("C","T",500,"P",101325,"INCOMP::DowQ")
=PropsSI("V","T",300,"P",101.325,"INCOMP::MEG[0.2]")
Saturation Table for water
Temperature Temperature Pressure Sat. Liq. Sat. Vap. Sat. Liq. Sat. Vap.
Density Density Enthalpy Enthalpy
°C K kPa kg/m³ kg/m³ kJ/kg kJ/kg

0 273.16 0.611655 999.792520 0.004855 0.000612 2500.915192


10 283.15 1.228199 999.654625 0.009407 42.021256 2519.208319
20 293.15 2.339318 998.161801 0.017314 83.914145 2537.433404
30 303.15 4.246971 995.606177 0.030415 125.733973 2555.545203
40 313.15 7.384938 992.175115 0.051242 167.533036 2573.510322
50 323.15 12.351946 987.996211 0.083147 209.341761 2591.288888
60 333.15 19.946434 983.160217 0.130425 251.180352 2608.834872
70 343.15 31.200930 977.733656 0.198431 293.065193 2626.096401
80 353.15 47.414474 971.766219 0.293672 335.012353 2643.015881
90 363.15 70.181766 965.295329 0.423898 377.039386 2659.530014
100 373.15 101.417997 958.349052 0.598170 419.166163 2675.569884
110 383.15 143.378713 950.948004 0.826930 461.415190 2691.061343
120 393.15 198.674420 943.106617 1.122067 503.811692 2705.925766
130 403.15 270.279977 934.833987 1.496996 546.383624 2720.081105
140 413.15 361.539099 926.134413 1.966745 589.161690 2733.442973
150 423.15 476.164538 917.007739 2.548077 632.179442 2745.925451
160 433.15 618.234621 907.449506 3.259644 675.473466 2757.441349
170 443.15 792.187007 897.450966 4.122193 719.083691 2767.901762
180 453.15 1002.810536 886.998961 5.158836 763.053826 2777.214926
190 463.15 1255.236155 876.075654 6.395419 807.431951 2785.284445
200 473.15 1554.927900 864.658102 7.860995 852.271294 2792.007023
210 483.15 1907.674994 852.717639 9.588466 897.631244 2797.269768
220 493.15 2319.586170 #NAME? 11.615433 943.578670 2800.947053
230 503.15 2797.087497 827.119167 13.985339 990.189655 2802.896758
240 513.15 3346.925144 813.365642 16.749019 1037.551817 2802.955605
250 523.15 3976.174931 #NAME? 19.966840 1085.767459 2800.933073
260 533.15 4692.260992 783.625693 23.711700 1134.957957 2796.603220
270 543.15 5502.986783 767.461167 28.073336 1185.269994 2789.693219
280 553.15 6416.582910 750.275161 33.164674 1236.884666 2779.866731
290 563.15 7441.778344 731.905200 39.131513 1290.031150 2766.699051
300 573.15 8587.904941 712.135639 46.167850 1345.007926 2749.638761
310 583.15 9865.051211 690.671546 54.541362 1402.217126 2727.945879
320 593.15 11284.292927 667.093848 64.638432 1462.223646 2700.585769
330 603.15 12858.051600 640.773215 77.050426 1525.868327 2666.031141
340 613.15 14600.677372 610.667598 92.758783 1594.528992 2621.845576
350 623.15 16529.415139 574.706517 113.605611 1670.889907 2563.636711
360 633.15 18666.006646 527.591629 143.898411 1761.664621 2481.492483
370 643.15 21043.563147 451.425647 201.839316 1890.687249 2334.518292
373.946 647.096 22064.000000 322.000000 322.000000 2084.256256 2084.256256
Water Saturation Curve
100000.0

10000.0
Pressure [kPa]

1000.0

100.0

10.0

1.0

0.1
200 250 300 350 400 450 500 550 600 650 700
Temperature [K]

Pressure-Density Plot for Water


100000.0

10000.0
Pressure [kPa]

1000.0

100.0

10.0 Sat. Liquid


Sat. Vapor
1.0

0.1
0 200 400 600 800 1000 1200
Density [kg/m³]

Pressure-Enthalpy Plot for Water


100000.0

10000.0
Pressure [kPa]

1000.0

100.0

10.0 Sat. Liquid


1.0 Sat. Vapor

0.1
0 500 1000 1500 2000 2500 3000
Enthalpy [kJ/kg]
1.0 Sat. Vapor

0.1
0 500 1000 1500 2000 2500 3000
Enthalpy [kJ/kg]
Property Calculator

Fluid Type PureFluids

Fluid Water

Output Name Hmass

Input Name 1 T
Input Value 1 400

Input Name 2 Q
Input Value 1 1

Result #NAME?
get_global_param_string("FluidsList") ==> #NAME?
Copy C2 and paste result as value here ==> 1-Butene Acetone Air
Select C3 and convert text to columns.
PureFluids
Copy C3:n3 and paste here Transposed ==> 1-Butene
This makes a list we can use in a dropdown. Acetone
Air
The same procedure can be used to extract Ammonia
the PredefinedMixtures list and the Argon
ParameterList. Benzene
CarbonDioxide
CarbonMonoxide
CarbonylSulfide
cis-2-Butene
CycloHexane
Cyclopentane
CycloPropane
D4
D5
D6
Deuterium
Dichloroethane
DiethylEther
DimethylCarbonate
DimethylEther
Ethane
Ethanol
EthylBenzene
Ethylene
EthyleneOxide
Fluorine
HeavyWater
Helium
HFE143m
Hydrogen
HydrogenChloride
HydrogenSulfide
IsoButane
IsoButene
Isohexane
Isopentane
Krypton
m-Xylene
MD2M
MD3M
MD4M
MDM
Methane
Methanol
MethylLinoleate
MethylLinolenate
MethylOleate
MethylPalmitate
MethylStearate
MM
n-Butane
n-Decane
n-Dodecane
n-Heptane
n-Hexane
n-Nonane
n-Octane
n-Pentane
n-Propane
n-Undecane
Neon
Neopentane
Nitrogen
NitrousOxide
Novec649
o-Xylene
OrthoDeuterium
OrthoHydrogen
Oxygen
p-Xylene
ParaDeuterium
ParaHydrogen
Propylene
Propyne
R11
R113
R114
R115
R116
R12
R123
R1233zd(E)
R1234yf
R1234ze(E)
R1234ze(Z)
R124
R125
R13
R134a
R13I1
R14
R141b
R142b
R143a
R152A
R161
R21
R218
R22
R227EA
R23
R236EA
R236FA
R245ca
R245fa
R32
R365MFC
R40
R404A
R407C
R41
R410A
R507A
RC318
SES36
SulfurDioxide
SulfurHexafluoride
Toluene
trans-2-Butene
Water
Xenon
Ammonia Argon Benzene CarbonDioxide CarbonMonoxide

PredefinedMixtures ParameterList FluidType


Air.mix A PureFluids
Amarillo.mix ACENTRIC PredefinedMixtures
Ekofisk.mix ALPHA0
GulfCoast.mix ALPHAR
GulfCoastGas(NIST1).mix BVIRIAL
HighCO2.mix Bvirial
HighN2.mix C
NaturalGasSample.mix CONDUCTIVITY
R401A.mix CP0MASS
R401B.mix CP0MOLAR
R401C.mix CPMASS
R402A.mix CPMOLAR
R402B.mix CVIRIAL
R403A.mix CVMASS
R403B.mix CVMOLAR
R404A.mix Cp0mass
R405A.mix Cp0molar
R406A.mix Cpmass
R407A.mix Cpmolar
R407B.mix Cvirial
R407C.mix Cvmass
R407D.mix Cvmolar
R407E.mix D
R407F.mix DALPHA0_DDELTA_CONSTTAU
R408A.mix DALPHA0_DTAU_CONSTDELTA
R409A.mix DALPHAR_DDELTA_CONSTTAU
R409B.mix DALPHAR_DTAU_CONSTDELTA
R410A.mix DBVIRIAL_DT
R410B.mix DCVIRIAL_DT
R411A.mix DELTA
R411B.mix DIPOLE_MOMENT
R412A.mix DMASS
R413A.mix DMOLAR
R414A.mix Delta
R414B.mix Dmass
R415A.mix Dmolar
R415B.mix FH
R416A.mix FRACTION_MAX
R417A.mix FRACTION_MIN
R417B.mix FUNDAMENTAL_DERIVATIVE_OF_GAS_DYNAMICS
R417C.mix G
R418A.mix GAS_CONSTANT
R419A.mix GMASS
R419B.mix GMOLAR
R420A.mix GWP100
R421A.mix GWP20
R421B.mix GWP500
R422A.mix Gmass
R422B.mix Gmolar
R422C.mix H
R422D.mix HH
R422E.mix HMASS
R423A.mix HMOLAR
R424A.mix Hmass
R425A.mix Hmolar
R426A.mix I
R427A.mix ISOBARIC_EXPANSION_COEFFICIENT
R428A.mix ISOTHERMAL_COMPRESSIBILITY
R429A.mix L
R430A.mix M
R431A.mix MOLARMASS
R432A.mix MOLAR_MASS
R433A.mix MOLEMASS
R433B.mix O
R433C.mix ODP
R434A.mix P
R435A.mix PCRIT
R436A.mix PH
R436B.mix PHASE
R437A.mix PIP
R438A.mix PMAX
R439A.mix PMIN
R440A.mix PRANDTL
R441A.mix PTRIPLE
R442A.mix P_CRITICAL
R443A.mix P_MAX
R444A.mix P_MIN
R444B.mix P_REDUCING
R445A.mix P_TRIPLE
R446A.mix P_max
R447A.mix P_min
R448A.mix Pcrit
R449A.mix Phase
R449B.mix Prandtl
R450A.mix Q
R451A.mix RHOCRIT
R451B.mix RHOMASS_CRITICAL
R452A.mix RHOMASS_REDUCING
R453A.mix RHOMOLAR_CRITICAL
R454A.mix RHOMOLAR_REDUCING
R454B.mix S
R500.mix SMASS
R501.mix SMOLAR
R502.mix SMOLAR_RESIDUAL
R503.mix SPEED_OF_SOUND
R504.mix SURFACE_TENSION
R507A.mix Smass
R508A.mix Smolar
R508B.mix Smolar_residual
R509A.mix T
R510A.mix TAU
R511A.mix TCRIT
R512A.mix TMAX
R513A.mix TMIN
TypicalNaturalGas.mix TTRIPLE
T_CRITICAL
T_FREEZE
T_MAX
T_MIN
T_REDUCING
T_TRIPLE
T_critical
T_freeze
T_max
T_min
T_reducing
T_triple
Tau
Tcrit
Tmax
Tmin
Ttriple
U
UMASS
UMOLAR
Umass
Umolar
V
VISCOSITY
Z
acentric
alpha0
alphar
conductivity
dBvirial_dT
dCvirial_dT
dalpha0_ddelta_consttau
dalpha0_dtau_constdelta
dalphar_ddelta_consttau
dalphar_dtau_constdelta
dipole_moment
fraction_max
fraction_min
fundamental_derivative_of_gas_dynamics
gas_constant
isobaric_expansion_coefficient
isothermal_compressibility
molar_mass
molarmass
molemass
p_critical
p_reducing
p_triple
pcrit
pmax
pmin
ptriple
rhocrit
rhomass_critical
rhomass_reducing
rhomolar_critical
rhomolar_reducing
speed_of_sound
surface_tension
viscosity
CarbonylSucis-2-Bute CycloHexa CyclopentaCycloPropaD4 D5 D6 DeuteriumDichloroet
DiethylEth DimethylCaDimethylEtEthane Ethanol EthylBenzeEthylene EthyleneOxFluorine HeavyWate
Helium HFE143m Hydrogen HydrogenCh
HydrogenSu
IsoButane IsoButene Isohexane IsopentaneKrypton
m-Xylene MD2M MD3M MD4M MDM Methane Methanol MethylLinoMethylLinoMethylOlea
MethylPalm
MethylSteaMM n-Butane n-Decane n-Dodecann-Heptanen-Hexane n-Nonane n-Octane
n-Pentane n-Propane n-UndecanNeon NeopentanNitrogen NitrousOxiNovec649 o-Xylene OrthoDeut
OrthoHydrOxygen p-Xylene ParaDeute ParaHydro Propylene Propyne R11 R113 R114
R115 R116 R12 R123 R1233zd(E)R1234yf R1234ze(E)R1234ze(Z)R124 R125
R13 R134a R13I1 R14 R141b R142b R143a R152A R161 R21
R218 R22 R227EA R23 R236EA R236FA R245ca R245fa R32 R365MFC
R40 R404A R407C R41 R410A R507A RC318 SES36 SulfurDioxiSulfurHexa
Toluene trans-2-Bu Water Xenon

You might also like