ThermophysicalData[CoolProp]
PropsSI
access CoolProp thermophysical fluid data
Calling Sequence
Parameters
Description
Examples
References
Compatibility
PropsSI(output, input1, value1, input2, value2, fluid, opts)
output
-
symbol or string for the desired output quantity
input1, input2
symbol or string giving the input quantities
value1, value2
real numbers for the input quantities, optionally with units
fluid
symbol or string representing the medium
opts
(optional) equation of the form useunits = true or useunits = false
The PropsSI function interrogates the CoolProp library for thermophysical data.
The output parameter can, in principle, be any of the numerical thermophysical properties in the Quantity and Maple-specific aliases columns of the following table, whenever that property makes sense for the given fluid.
Only quantities with Yes in the Input? column can be used for input1 and input2, and only some combinations of these inputs will work.
The quantities for input1, input2, and output should be entered as strings or symbols. If a variable with the same name is already in use, it is best to use a string or to use unevaluation quotes to prevent evaluation of the variable name. In almost all circumstances, you can use either one of the names used by the CoolProp library, or an alias defined by the Maple package.
In some situations, the output parameter can be used to compute the partial derivative of one quantity with respect to another, while keeping a third quantity constant. This is done by specifying output in the form "d(OF)/d(WRT)|CONSTANT", where OF, WRT, and CONSTANT are valid CoolProp-recognized quantity names. In this case, OF represents the quantity CoolProp takes the derivative of, WRT is the quantity with respect to which CoolProp takes the derivative, and CONSTANT is the quantity kept constant.
For example, the constant pressure specific heat is the partial derivative of the mass specific enthalpy (Hmass) with respect to the temperature (T) at constant pressure (P); consequently, it can be represented as "d(Hmass)/d(T)|P". (There is also a dedicated representation for this quantity: C.) Specifying a partial derivative is the only situation where the Maple-defined aliases are not recognized.
You should use real constants for value1 and value2. Optionally, you can affix a unit to the value you give; the default unit for any quantity is given in the Unit column of the following table. If you supply a unit with any of the quantities you submit, the answer will have the appropriate unit as well. This behavior can be overridden by using the useunits option: if you supply useunits = true (which can be shortened to just useunits), then the result will always have the appropriate unit, and if you supply useunits = false, the result will never have a unit.
Quantity
Maple-specific aliases
Unit
Input?
DELTA, Delta
reduced_density, reduceddensity
Yes
Reduced density (rho/rhoc)
DMOLAR, Dmolar
molar_density, molardensity
mol/m^3
Molar density
D, DMASS, Dmass
density, mass_density, massdensity
kg/m^3
Mass density
HMOLAR, Hmolar
molar_specific_enthalpy, molarspecificenthalpy
J/mol
Molar specific enthalpy
H, HMASS, Hmass
enthalpy, mass_specific_enthalpy, massspecificenthalpy
J/kg
Mass specific enthalpy
P
pressure
Pa
Pressure
Q
mass_vapor_quality, mass_vapour_quality, massvaporquality, massvapourquality, vapor_quality, vaporquality, vapour_quality, vapourquality
Mass vapor quality
SMOLAR, Smolar
molar_specific_entropy, molarspecificentropy
J/mol/K
Molar specific entropy
S, SMASS, Smass
entropy, mass_specific_entropy, massspecificentropy
J/kg/K
Mass specific entropy
TAU, Tau
reciprocal_reduced_temperature, reciprocalreducedtemperature
Reciprocal reduced temperature (Tc/T)
T
temperature
K
Temperature
UMOLAR, Umolar
molar_specific_internal_energy, molarspecificinternalenergy
Molar specific internal energy
U, UMASS, Umass
internal_energy, internalenergy, mass_specific_internal_energy, massspecificinternalenergy
Mass specific internal energy
ACENTRIC, acentric
acentric_factor, acentricfactor
No
Acentric factor
ALPHA0, alpha0
ideal_helmholtz_energy, idealhelmholtzenergy
Ideal Helmholtz energy
ALPHAR, alphar
residual_helmholtz_energy, residualhelmholtzenergy
Residual Helmholtz energy
A, SPEED_OF_SOUND, speed_of_sound
speedofsound
m/s
Speed of sound
BVIRIAL, Bvirial
second_virial_coefficient, secondvirialcoefficient
Second virial coefficient
CONDUCTIVITY, L, conductivity
thermal_conductivity, thermalconductivity
W/m/K
Thermal conductivity
CP0MASS, Cp0mass
ideal_gas_mass_specific_constant_pressure_specific_heat, idealgasmassspecificconstantpressurespecificheat
Ideal gas mass specific constant pressure specific heat
CP0MOLAR, Cp0molar
ideal_gas_molar_specific_constant_pressure_specific_heat, idealgasmolarspecificconstantpressurespecificheat
Ideal gas molar specific constant pressure specific heat
CPMOLAR, Cpmolar
molar_specific_constant_pressure_specific_heat, molarspecificconstantpressurespecificheat
Molar specific constant pressure specific heat
CVIRIAL, Cvirial
third_virial_coefficient, thirdvirialcoefficient
Third virial coefficient
CVMASS, Cvmass, O
mass_specific_constant_volume_specific_heat, massspecificconstantvolumespecificheat
Mass specific constant volume specific heat
CVMOLAR, Cvmolar
molar_specific_constant_volume_specific_heat, molarspecificconstantvolumespecificheat
Molar specific constant volume specific heat
C, CPMASS, Cpmass
mass_specific_constant_pressure_specific_heat, massspecificconstantpressurespecificheat
Mass specific constant pressure specific heat
DALPHA0_DDELTA_CONSTTAU, dalpha0_ddelta_consttau
d_ideal_helmholtz_energy_d_delta
Derivative of ideal Helmholtz energy with delta
DALPHA0_DTAU_CONSTDELTA, dalpha0_dtau_constdelta
d_ideal_helmholtz_energy_d_tau
Derivative of ideal Helmholtz energy with tau
DALPHAR_DDELTA_CONSTTAU, dalphar_ddelta_consttau
d_residual_helmholtz_energy_d_delta
Derivative of residual Helmholtz energy with delta
DALPHAR_DTAU_CONSTDELTA, dalphar_dtau_constdelta
d_residual_helmholtz_energy_d_tau
Derivative of residual Helmholtz energy with tau
DBVIRIAL_DT, dBvirial_dT
d_second_virial_coefficient_d_temperature
Derivative of second virial coefficient with respect to T
DCVIRIAL_DT, dCvirial_dT
d_third_virial_coefficient_d_temperature
Derivative of third virial coefficient with respect to T
DIPOLE_MOMENT, dipole_moment
dipole_moment, dipolemoment
C*m
Dipole moment
FH
flammability_hazard, flammabilityhazard
Flammability hazard
FRACTION_MAX, fraction_max
fractionmax
Fraction (mole, mass, volume) maximum value for incompressible solutions
FRACTION_MIN, fraction_min
fractionmin
Fraction (mole, mass, volume) minimum value for incompressible solutions
FUNDAMENTAL_DERIVATIVE_OF_GAS_DYNAMICS, fundamental_derivative_of_gas_dynamics
fundamentalderivativeofgasdynamics
Fundamental derivative of gas dynamics
GAS_CONSTANT, gas_constant
gasconstant
Molar gas constant
GMOLAR_RESIDUAL, Gmolar_residual
gmolar_residual
Residual molar Gibbs energy
GMOLAR, Gmolar
molar_specific_gibbs_energy, molarspecificgibbsenergy
Molar specific Gibbs energy
GWP100
global_warming_potential_100, globalwarmingpotential100
100-year global warming potential
GWP20
global_warming_potential_20, globalwarmingpotential20
20-year global warming potential
GWP500
global_warming_potential_500, globalwarmingpotential500
500-year global warming potential
G, GMASS, Gmass
gibbs_energy, gibbsenergy, mass_specific_gibbs_energy, massspecificgibbsenergy
Mass specific Gibbs energy
HELMHOLTZMASS, Helmholtzmass
helmholtz_mass, helmholtzmass
Mass specific Helmholtz energy
HELMHOLTZMOLAR, Helmholtzmolar
helmholtz_molar, helmholtzmolar
Molar specific Helmholtz energy
HH
health_hazard, healthhazard
Health hazard
HMOLAR_RESIDUAL, Hmolar_residual
hmolar_residual
Residual molar enthalpy
ISENTROPIC_EXPANSION_COEFFICIENT, isentropic_expansion_coefficient
isentropicexpansioncoefficient
Isentropic expansion coefficient
ISOBARIC_EXPANSION_COEFFICIENT, isobaric_expansion_coefficient
isobaricexpansioncoefficient
1/K
Isobaric expansion coefficient
ISOTHERMAL_COMPRESSIBILITY, isothermal_compressibility
isothermalcompressibility
1/Pa
Isothermal compressibility
I, SURFACE_TENSION, surface_tension
surfacetension
N/m
Surface tension
M, MOLARMASS, MOLAR_MASS, MOLEMASS, molar_mass, molarmass, molemass
kg/mol
Molar mass
ODP
ozone_depletion_potential, ozonedepletionpotential
Ozone depletion potential
PCRIT, P_CRITICAL, Pcrit, p_critical, pcrit
pcritical
Pressure at the critical point
PHASE, Phase
phase
Phase index as a float
PH
physical_hazard, physicalhazard
Physical hazard
PIP
phase_identification, phase_identification_parameter
Phase identification parameter
PMAX, P_MAX, P_max, pmax
p_max, pressure_max, pressuremax
Maximum pressure limit
PMIN, P_MIN, P_min, pmin
p_min, pressure_min, pressuremin
Minimum pressure limit
PRANDTL, Prandtl
prandtl
Prandtl number
PTRIPLE, P_TRIPLE, p_triple, ptriple
pressure_triple, pressuretriple
Pressure at the triple point (pure only)
P_REDUCING, p_reducing
preducing, pressure_reducing, pressurereducing
Pressure at the reducing point
RHOCRIT, RHOMASS_CRITICAL, rhocrit, rhomass_critical
density_critical, densitycritical
Mass density at critical point
RHOMASS_REDUCING, rhomass_reducing
density_reducing, densityreducing, mass_density_reducing, massdensityreducing
Mass density at reducing point
RHOMOLAR_CRITICAL, rhomolar_critical
molar_density_critical, molardensitycritical
Molar density at critical point
RHOMOLAR_REDUCING, rhomolar_reducing
molar_density_reducing, molardensityreducing
Molar density at reducing point
SMOLAR_RESIDUAL, Smolar_residual
residual_molar_entropy, smolar_residual, smolarresidual
Residual molar entropy (sr/R = s(T,rho) - s^0(T,rho))
TCRIT, T_CRITICAL, T_critical, Tcrit
temperature_critical, temperaturecritical
Temperature at the critical point
TMAX, T_MAX, T_max, Tmax
temperature_max, temperaturemax
Maximum temperature limit
TMIN, T_MIN, T_min, Tmin
temperature_min, temperaturemin
Minimum temperature limit
TTRIPLE, T_TRIPLE, T_triple, Ttriple
temperature_triple, temperaturetriple
Temperature at the triple point
T_FREEZE, T_freeze
temperature_freeze, temperature_freezing, temperaturefreeze, temperaturefreezing
Freezing temperature for incompressible solutions
T_REDUCING, T_reducing
temperature_reducing, temperaturereducing
Temperature at the reducing point
V, VISCOSITY, viscosity
Pa*s
Viscosity
Z
compressibility_factor, compressibilityfactor
Compressibility factor
withThermophysicalData
Atmosphere,Chemicals,CoolProp,PHTChart,Property,PsychrometricChart,TemperatureEntropyChart
withCoolProp
HAPropsSI,PhaseSI,Property,Props1SI,PropsSI
Determine the saturation temperature of water at 1 atmosphere in kelvin.
PropsSIT,P,101325,Q,0,Water
373.124295847684380
PropsSIT,P,101325,Q,0,Water,useunits
373.1242958K
PropsSIT,P,1.0Unitatm,Q,0,Water
PropsSIT,P,1.0Unitatm,Q,0,Water,useunits=false
Determine the constant pressure specific heat of water at 300 kelvin and 1 atmosphere, in two ways. The first way uses the dedicated representation of this quantity, C, for output. The second way uses the the partial derivative of the mass specific enthalpy (Hmass) with respect to the temperature (T) at constant pressure (P), "d(Hmass)/d(T)|P".
PropsSIC,P,1.0Unitatm,T,300,Water
4180.635777JkgK
PropsSId(Hmass)/d(T)|P,P,1.0Unitatm,T,300,Water
Bell, Ian H.; Wronski, Jorrit; Quoilin, Sylvain; and Lemort, Vincent. Pure and Pseudo-pure Fluid Thermophysical Property Evaluation and the Open-Source Thermophysical Property Library CoolProp. Industrial & Engineering Chemistry Research, Vol. 53 No. 6 (2014): 2498-2508; http://www.coolprop.org/.
The ThermophysicalData[CoolProp][PropsSI] command was introduced in Maple 2016.
For more information on Maple 2016 changes, see Updates in Maple 2016.
See Also
ThermophysicalData
ThermophysicalData/fluids
Download Help Document
