Thursday, June 19, 2014

"CoolProp" fluid thermodynamic properties Excel add-in

After searching over the internet for "Engineering Equation Solver EES package for Excel", I came through some other alternatives for Engineering Equations Solver thermodynamic properties calculator:

RefProp: Open source (free)

CoolProp: Open source (free)


XProps: Commercial package


1. CoolProp


Download the package (zipped file) from the following link


http://sourceforge.net/projects/coolprop/files/CoolProp/


1.1. Installation in Excel:


Unpack the zip file you downloaded to any folder on your hard disk "New folder"

Open "New folder\dist_temp\windows_superpack\Excel and DLL" and copy its contents

Create a folder in your partition C: "C:\CoolProp". It should be placed in C: partition even if it is not your system (default) partition.

Paste the copied files to the folder "CoolProp" you have created

Copy CoolProp.xlam to the default directory of Excel add-ins. To know the default directory of Excel add-ins in your PC, just create a new book and save it as Excel add-in file (*.xlam). Copy the address and discard saving this file.


Open Excel options and select add-Ins



Press "Go..." button shown highlighted by the red box in the image above and you will get a window like below. Check the "CoolProp" add-In so it will be automatically loaded each time you open excel.




It is done...


This is a demo after installation of add-in (see equation in equation bar). You can use cell references instead of direct values for sure.



and this is a snapshot after I have implemented this add-in in my Ref Analysis add-in




1.2. Comparison with EES:


1.2.1 Fluid properties


For real fluids the following are the available properties in EES and CoolProp (units displayed are as displayed in EES):



Property name
EES
CoolProp
Accentric factor
Conductivity [W/m.K]
Cp [kJ/kg.K]
Cv [kJ/kg.K]
Density [kg/m3]
Dipole [debye]

Ek_Lj [K]

Enthalpy [kJ/kg.K]
Entropy [kJ/kg.K]
Fugacity [kPa]

IntEnergy [kJ/kg]
isIdealGas [-]

MolarMass [kg/kmol]
P_crit [kPa]
P_sat [kPa]
Phase$

Prandtl [-]

Pressure [kPa]
Quality [-]
Sigma_LJ [m]

SoundSpeed [m/s]
SpecHeat [kJ/kg.K]
SurfaceTension [N/m]
T_crit [C]
T_triple [C]
Temperature [C]
V_crit [m3/kg]
Viscosity [kg/m.s]
VolExpCoef [1/K]

Volume [m3/kg]




1.2.2 Reference state

The reference state used in CoolProp is International Institute of Refrigeration IIR reference which assumes that the specific enthalpy of saturated liquid fluid Q=0 at 0 C equals 200 kJ/kg and the specific entropy at the same conditions equals 1 kJ/kg.K . From the other side EES uses three reference states IIR, Normal Boiling Point NBP, and ASHRAE, but they can be manually-correlated by adding constants in CoolProp.

1.2.3 Properties abbreviations (names) in CoolProp

Property name
Properties CoolProp codes
w
Thermal conductivity
L
Cp
C
Cv
O
Density
D
Specific enthalpy
H
Specific entropy
S
Internal energy
U
Molar mass
molemass
Critical pressure
pcrit
Pressure
P
Quality
Q
Sound speed
A
Gibbs function
G
Surface tension
I
Critical temperature
Tcrit
Triple temperature
Ttriple
Triple pressure
ptriple
Minimum temperature
Tmin
Ozone depletion potential
ODP
Temperature
T
Dynamic Viscosity
V

Later, I will update this post and illustrate the notations, units.



2 comments:

  1. Thanks a lot Eng. Shady of this very useful blog.
    Mohamed

    ReplyDelete
  2. Thank you. I was searching for the Coolprop default reference state for h, s but could not find it in their documentation.

    ReplyDelete