 ThermophysicalData[CoolProp] - Maple Programming Help

Home : Support : Online Help : Science and Engineering : ThermophysicalData : CoolProp : ThermophysicalData/CoolProp/PropsSI

ThermophysicalData[CoolProp]

 PropsSI
 access CoolProp thermophysical fluid data

 Calling Sequence PropsSI(output, input1, value1, input2, value2, fluid, opts)

Parameters

 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

Description

 • 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? Description DELTA, Delta reduceddensity, reduced_density - Yes Reduced density (rho/rhoc) DMOLAR, Dmolar molardensity, molar_density mol/m^3 Yes Molar density D, DMASS, Dmass density, mass_density, massdensity kg/m^3 Yes Mass density HMOLAR, Hmolar molar_specific_enthalpy, molarspecificenthalpy J/mol Yes Molar specific enthalpy H, HMASS, Hmass massspecificenthalpy, enthalpy, mass_specific_enthalpy J/kg Yes Mass specific enthalpy P pressure Pa Yes Pressure Q mass_vapor_quality, massvaporquality, vapor_quality, vapour_quality, mass_vapour_quality, massvapourquality, vapourquality, vaporquality - Yes Mass vapor quality SMOLAR, Smolar molar_specific_entropy, molarspecificentropy J/mol/K Yes Molar specific entropy S, SMASS, Smass massspecificentropy, entropy, mass_specific_entropy J/kg/K Yes Mass specific entropy TAU, Tau reciprocalreducedtemperature, reciprocal_reduced_temperature - Yes Reciprocal reduced temperature (Tc/T) T temperature K Yes Temperature UMOLAR, Umolar molar_specific_internal_energy, molarspecificinternalenergy J/mol Yes Molar specific internal energy U, UMASS, Umass internal_energy, internalenergy, massspecificinternalenergy, mass_specific_internal_energy J/kg Yes Mass specific internal energy ACENTRIC, acentric acentricfactor, acentric_factor - No Acentric factor ALPHA0, alpha0 idealhelmholtzenergy, ideal_helmholtz_energy - No Ideal Helmholtz energy ALPHAR, alphar residual_helmholtz_energy, residualhelmholtzenergy - No Residual Helmholtz energy A, SPEED_OF_SOUND, speed_of_sound speedofsound m/s No Speed of sound BVIRIAL, Bvirial secondvirialcoefficient, second_virial_coefficient - No Second virial coefficient CONDUCTIVITY, L, conductivity thermal_conductivity, thermalconductivity W/m/K No Thermal conductivity CP0MASS, Cp0mass idealgasmassspecificconstantpressurespecificheat, ideal_gas_mass_specific_constant_pressure_specific_heat J/kg/K No Ideal gas mass specific constant pressure specific heat CP0MOLAR, Cp0molar idealgasmolarspecificconstantpressurespecificheat, ideal_gas_molar_specific_constant_pressure_specific_heat J/mol/K No Ideal gas molar specific constant pressure specific heat CPMOLAR, Cpmolar molar_specific_constant_pressure_specific_heat, molarspecificconstantpressurespecificheat J/mol/K No Molar specific constant pressure specific heat CVIRIAL, Cvirial third_virial_coefficient, thirdvirialcoefficient - No Third virial coefficient CVMASS, Cvmass, O massspecificconstantvolumespecificheat, mass_specific_constant_volume_specific_heat J/kg/K No Mass specific constant volume specific heat CVMOLAR, Cvmolar molar_specific_constant_volume_specific_heat, molarspecificconstantvolumespecificheat J/mol/K No Molar specific constant volume specific heat C, CPMASS, Cpmass massspecificconstantpressurespecificheat, mass_specific_constant_pressure_specific_heat J/kg/K No Mass specific constant pressure specific heat DALPHA0_DDELTA_CONSTTAU, dalpha0_ddelta_consttau d_ideal_helmholtz_energy_d_delta - No Derivative of ideal Helmholtz energy with delta DALPHA0_DTAU_CONSTDELTA, dalpha0_dtau_constdelta d_ideal_helmholtz_energy_d_tau - No Derivative of ideal Helmholtz energy with tau DALPHAR_DDELTA_CONSTTAU, dalphar_ddelta_consttau d_residual_helmholtz_energy_d_delta - No Derivative of residual Helmholtz energy with delta DALPHAR_DTAU_CONSTDELTA, dalphar_dtau_constdelta d_residual_helmholtz_energy_d_tau - No Derivative of residual Helmholtz energy with tau DBVIRIAL_DT, dBvirial_dT d_second_virial_coefficient_d_temperature - No Derivative of second virial coefficient with respect to T DCVIRIAL_DT, dCvirial_dT d_third_virial_coefficient_d_temperature - No Derivative of third virial coefficient with respect to T DIPOLE_MOMENT, dipole_moment - C*m No Dipole moment FH flammabilityhazard, flammability_hazard - No Flammability hazard FRACTION_MAX, fraction_max fractionmax - No Fraction (mole, mass, volume) maximum value for incompressible solutions FRACTION_MIN, fraction_min fractionmin - No Fraction (mole, mass, volume) minimum value for incompressible solutions FUNDAMENTAL_DERIVATIVE_OF_GAS_DYNAMICS, fundamental_derivative_of_gas_dynamics fundamentalderivativeofgasdynamics - No Fundamental derivative of gas dynamics GAS_CONSTANT, gas_constant gasconstant J/mol/K No Molar gas constant GMOLAR, Gmolar molar_specific_gibbs_energy, molarspecificgibbsenergy J/mol No Molar specific Gibbs energy GWP100 global_warming_potential_100, globalwarmingpotential100 - No 100-year global warming potential GWP20 globalwarmingpotential20, global_warming_potential_20 - No 20-year global warming potential GWP500 global_warming_potential_500, globalwarmingpotential500 - No 500-year global warming potential G, GMASS, Gmass gibbs_energy, gibbsenergy, mass_specific_gibbs_energy, massspecificgibbsenergy J/kg No Mass specific Gibbs energy HELMHOLTZMASS, Helmholtzmass - J/kg No Mass specific Helmholtz energy HELMHOLTZMOLAR, Helmholtzmolar - J/mol No Molar specific Helmholtz energy HH healthhazard, health_hazard - No Health hazard ISOBARIC_EXPANSION_COEFFICIENT, isobaric_expansion_coefficient isobaricexpansioncoefficient 1/K No Isobaric expansion coefficient ISOTHERMAL_COMPRESSIBILITY, isothermal_compressibility isothermalcompressibility 1/Pa No Isothermal compressibility I, SURFACE_TENSION, surface_tension surfacetension N/m No Surface tension M, MOLARMASS, MOLAR_MASS, MOLEMASS, molar_mass, molarmass, molemass - kg/mol No Molar mass ODP ozonedepletionpotential, ozone_depletion_potential - No Ozone depletion potential PCRIT, P_CRITICAL, Pcrit, p_critical, pcrit pcritical Pa No Pressure at the critical point PHASE, Phase phase - No Phase index as a float PH physicalhazard, physical_hazard - No Physical hazard PIP - - No Phase identification parameter PMAX, P_MAX, P_max, pmax pressure_max, p_max, pressuremax Pa No Maximum pressure limit PMIN, P_MIN, P_min, pmin pressuremin, p_min, pressure_min Pa No Minimum pressure limit PRANDTL, Prandtl prandtl - No Prandtl number PTRIPLE, P_TRIPLE, p_triple, ptriple pressure_triple, pressuretriple Pa No Pressure at the triple point (pure only) P_REDUCING, p_reducing preducing, pressurereducing, pressure_reducing Pa No Pressure at the reducing point RHOCRIT, RHOMASS_CRITICAL, rhocrit, rhomass_critical densitycritical, density_critical kg/m^3 No Mass density at critical point RHOMASS_REDUCING, rhomass_reducing densityreducing, massdensityreducing, mass_density_reducing, density_reducing kg/m^3 No Mass density at reducing point RHOMOLAR_CRITICAL, rhomolar_critical molardensitycritical, molar_density_critical mol/m^3 No Molar density at critical point RHOMOLAR_REDUCING, rhomolar_reducing molar_density_reducing, molardensityreducing mol/m^3 No Molar density at reducing point SMOLAR_RESIDUAL, Smolar_residual - J/mol/K No Residual molar entropy (sr/R = taudar_dtau-ar) TCRIT, T_CRITICAL, T_critical, Tcrit temperature_critical, temperaturecritical K No Temperature at the critical point TMAX, T_MAX, T_max, Tmax temperaturemax, temperature_max K No Maximum temperature limit TMIN, T_MIN, T_min, Tmin temperaturemin, temperature_min K No Minimum temperature limit TTRIPLE, T_TRIPLE, T_triple, Ttriple temperaturetriple, temperature_triple K No Temperature at the triple point T_FREEZE, T_freeze temperaturefreeze, temperaturefreezing, temperature_freeze, temperature_freezing K No Freezing temperature for incompressible solutions T_REDUCING, T_reducing temperaturereducing, temperature_reducing K No Temperature at the reducing point V, VISCOSITY, viscosity - Pa*s No Viscosity Z compressibility_factor, compressibilityfactor - No Compressibility factor

Examples

 > $\mathrm{with}\left(\mathrm{ThermophysicalData}\right)$
 $\left[{\mathrm{Chemicals}}{,}{\mathrm{CoolProp}}{,}{\mathrm{PHTChart}}{,}{\mathrm{Property}}{,}{\mathrm{PsychrometricChart}}{,}{\mathrm{TemperatureEntropyChart}}\right]$ (1)
 > $\mathrm{with}\left(\mathrm{CoolProp}\right)$
 $\left[{\mathrm{HAPropsSI}}{,}{\mathrm{PhaseSI}}{,}{\mathrm{Property}}{,}{\mathrm{Props1SI}}{,}{\mathrm{PropsSI}}\right]$ (2)

Determine the saturation temperature of water at 1 atmosphere in kelvin.

 > $\mathrm{PropsSI}\left(T,P,101325,Q,0,\mathrm{Water}\right)$
 ${373.124295847684380}$ (3)
 > $\mathrm{PropsSI}\left(T,P,101325,Q,0,\mathrm{Water},\mathrm{useunits}\right)$
 ${373.1242958}{}⟦{K}⟧$ (4)
 > $\mathrm{PropsSI}\left(T,P,1.0\mathrm{Unit}\left(\mathrm{atm}\right),Q,0,\mathrm{Water}\right)$
 ${373.1242958}{}⟦{K}⟧$ (5)
 > $\mathrm{PropsSI}\left(T,P,1.0\mathrm{Unit}\left(\mathrm{atm}\right),Q,0,\mathrm{Water},\mathrm{useunits}=\mathrm{false}\right)$
 ${373.124295847684380}$ (6)

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".

 > $\mathrm{PropsSI}\left(C,P,1.0\mathrm{Unit}\left(\mathrm{atm}\right),T,300,\mathrm{Water}\right)$
 ${4180.635777}{}⟦\frac{{J}}{{\mathrm{kg}}{}{K}}⟧$ (7)
 > $\mathrm{PropsSI}\left("d\left(Hmass\right)/d\left(T\right)|P",P,1.0\mathrm{Unit}\left(\mathrm{atm}\right),T,300,\mathrm{Water}\right)$
 ${4180.635777}{}⟦\frac{{J}}{{\mathrm{kg}}{}{K}}⟧$ (8)

References

 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/.

Compatibility

 • The ThermophysicalData[CoolProp][PropsSI] command was introduced in Maple 2016.