PropsSI - Maple Help

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 reduced_density, reduceddensity - Yes Reduced density (rho/rhoc) DMOLAR, Dmolar molar_density, molardensity 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 enthalpy, mass_specific_enthalpy, massspecificenthalpy J/kg Yes Mass specific enthalpy P pressure Pa Yes Pressure Q mass_vapor_quality, mass_vapour_quality, massvaporquality, massvapourquality, vapor_quality, vaporquality, vapour_quality, vapourquality - Yes Mass vapor quality SMOLAR, Smolar molar_specific_entropy, molarspecificentropy J/mol/K Yes Molar specific entropy S, SMASS, Smass entropy, mass_specific_entropy, massspecificentropy J/kg/K Yes Mass specific entropy TAU, Tau reciprocal_reduced_temperature, reciprocalreducedtemperature - 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, mass_specific_internal_energy, massspecificinternalenergy J/kg Yes Mass specific internal energy ACENTRIC, acentric acentric_factor, acentricfactor - No Acentric factor ALPHA0, alpha0 ideal_helmholtz_energy, idealhelmholtzenergy - 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 second_virial_coefficient, secondvirialcoefficient - No Second virial coefficient CONDUCTIVITY, L, conductivity thermal_conductivity, thermalconductivity W/m/K No Thermal conductivity CP0MASS, Cp0mass ideal_gas_mass_specific_constant_pressure_specific_heat, idealgasmassspecificconstantpressurespecificheat J/kg/K No Ideal gas mass specific constant pressure specific heat CP0MOLAR, Cp0molar ideal_gas_molar_specific_constant_pressure_specific_heat, idealgasmolarspecificconstantpressurespecificheat 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 mass_specific_constant_volume_specific_heat, massspecificconstantvolumespecificheat 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 mass_specific_constant_pressure_specific_heat, massspecificconstantpressurespecificheat 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 dipole_moment, dipolemoment C*m No Dipole moment FH flammability_hazard, flammabilityhazard - 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_RESIDUAL, Gmolar_residual gmolar_residual J/mol/K No Residual molar Gibbs energy 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 global_warming_potential_20, globalwarmingpotential20 - 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 helmholtz_mass, helmholtzmass J/kg No Mass specific Helmholtz energy HELMHOLTZMOLAR, Helmholtzmolar helmholtz_molar, helmholtzmolar J/mol No Molar specific Helmholtz energy HH health_hazard, healthhazard - No Health hazard HMOLAR_RESIDUAL, Hmolar_residual hmolar_residual J/mol/K No Residual molar enthalpy ISENTROPIC_EXPANSION_COEFFICIENT, isentropic_expansion_coefficient isentropicexpansioncoefficient - No Isentropic expansion coefficient 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 ozone_depletion_potential, ozonedepletionpotential - 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 physical_hazard, physicalhazard - No Physical hazard PIP phase_identification, phase_identification_parameter - No Phase identification parameter PMAX, P_MAX, P_max, pmax p_max, pressure_max, pressuremax Pa No Maximum pressure limit PMIN, P_MIN, P_min, pmin p_min, pressure_min, pressuremin 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, pressure_reducing, pressurereducing Pa No Pressure at the reducing point RHOCRIT, RHOMASS_CRITICAL, rhocrit, rhomass_critical density_critical, densitycritical kg/m^3 No Mass density at critical point RHOMASS_REDUCING, rhomass_reducing density_reducing, densityreducing, mass_density_reducing, massdensityreducing kg/m^3 No Mass density at reducing point RHOMOLAR_CRITICAL, rhomolar_critical molar_density_critical, molardensitycritical 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 residual_molar_entropy, smolar_residual, smolarresidual J/mol/K No Residual molar entropy (sr/R = s(T,rho) - s^0(T,rho)) TCRIT, T_CRITICAL, T_critical, Tcrit temperature_critical, temperaturecritical K No Temperature at the critical point TMAX, T_MAX, T_max, Tmax temperature_max, temperaturemax K No Maximum temperature limit TMIN, T_MIN, T_min, Tmin temperature_min, temperaturemin K No Minimum temperature limit TTRIPLE, T_TRIPLE, T_triple, Ttriple temperature_triple, temperaturetriple K No Temperature at the triple point T_FREEZE, T_freeze temperature_freeze, temperature_freezing, temperaturefreeze, temperaturefreezing K No Freezing temperature for incompressible solutions T_REDUCING, T_reducing temperature_reducing, temperaturereducing 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{Atmosphere}}{,}{\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{atm}⟧,Q,0,\mathrm{Water}\right)$
 ${373.1242958}{}⟦{K}⟧$ (5)
 > $\mathrm{PropsSI}\left(T,P,1.0⟦\mathrm{atm}⟧,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{atm}⟧,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{atm}⟧,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.