 ThermophysicalData[CoolProp] - Maple Programming Help

# Online Help

###### All Products    Maple    MapleSim

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

ThermophysicalData[CoolProp]

 Property
 access thermophysical fluid data

 Calling Sequence Property(output, fluid, inputopts, opts) Property(output, inputopts, fluid, opts)

Parameters

 output - symbol or string for the desired output quantity fluid - symbol or string representing the medium inputopts - (optional) equations of the form quantity = value opts - (optional) equation of the form useunits = true or useunits = false

Description

 • The Property function interrogates the CoolProp library for thermophysical data.
 • Property provides a uniform interface to the PropsSI, Props1SI, PhaseSI, and HAPropsSI commands in the CoolProp subpackage of the ThermophysicalData package. Those commands adhere relatively closely to the commands of the same name in interfaces to CoolProp in other programming languages. This command, on the other hand, conforms more closely to typical Maple calling sequences.
 • Most uses of this command require the use of two or three input options (represented by the inputopts argument in the calling sequence above). These are equations of the form quantity = value, where quantity is a name or string from one of the tables below, and value is a real constant, possibly with a unit. If a unit is given for a value, it will be converted to the appropriate SI unit from the table below. 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.
 • The Property command works as follows.
 – If the fluid given is HumidAir, then this command redirects to the HAPropsSI command. In this case, you need to supply three inputopts equations (just as you need to supply three inputs to the HAPropsSI command). In the following table, quantities that have Input or Both in the Input / Output column can be used for quantity in an inputopts equation; quantities that have Output or Both in the Input / Output column can be used for the output parameter.

 Quantity Maple-specific aliases Unit Input / Output Description B, Twb, T_wb, WetBulb temperature_wet_bulb, temperaturewetbulb K Both Wet-Bulb Temperature C, cp specific_heat_per_dry_air, specificheatperdryair, specific_heat, specificheat J/kg(dry_air)/K Output Mixture specific heat per unit dry air Cha, cp_ha specific_heat_per_humid_air, specificheatperhumidair J/kg(humid_air)/K Output Mixture specific heat per unit humid air D, Tdp, DewPoint, T_dp temperature_dew_point, temperaturedewpoint K Both Dew-Point Temperature H, Hda, Enthalpy enthalpy, enthalpy_per_dry_air, enthalpyperdryair J/kg(dry_air) Both Mixture enthalpy per dry air Hha enthalpy_per_humid_air, enthalpyperhumidair J/kg(humid_air) Both Mixture enthalpy per humid air K, k, Conductivity thermal_conductivity, thermalconductivity W/m/K Output Mixture thermal conductivity M, Visc, mu viscosity Pa*s Output Mixture viscosity psi_w, Y water_mole_fraction, watermolefraction, waterfraction, water_fraction mol(water)/mol(humid_air) Both Water mole fraction P pressure Pa Input Pressure P_w water_vapor_pressure, watervaporpressure, water_vapour_pressure, watervapourpressure Pa Input Partial pressure of water vapor R, RH, RelHum relative_humidity, relativehumidity, humidity - Both Relative humidity in [0, 1] S, Sda, Entropy entropy, entropy_per_dry_air, entropyperdryair J/kg(dry_air)/K Both Mixture entropy per unit dry air Sha entropy_per_humid_air, entropyperhumidair J/kg(humid_air)/K Both Mixture entropy per unit humid air T, Tdb, T_db temperature_dry_bulb, temperaturedrybulb K Both Dry-Bulb Temperature V, Vda volume_per_dry_air, volumeperdryair, volume m^3/kg(dry_air) Both Mixture volume per unit dry air Vha volume_per_humid_air, volumeperhumidair m^3/kg(humid_air) Both Mixture volume per unit humid air W, Omega, HumRat humidity_ratio, humidityratio kg(water)/kg(dry_air) Both Humidity Ratio Z compressibility_factor, compressibilityfactor - Output Compressibility factor ($Z=\frac{pv}{RT}$)

 – If the output parameter is PhaseString, then this command redirects to the PhaseSI command. In this case, you need to supply two inputopts equations (just as you need to supply two inputs to the PhaseSI command). This uses the same quantity names as the PropsSI command (see the following table). Quantities that have Yes in the Can be input column can be used for the quantity in an inputopts equation.
 – If there are no inputopts given, this command redirects to the Props1SI command. This uses the same quantity names as the Props1SI command. In the following table, the quantities that have No in the Needs input opts column can be used for the output parameter.
 – Otherwise, this command redirects to the PropsSI command, and you need to supply two inputopts equations (just as you need to supply two inputs to the PropsSI command). The following table lists the quantities that can be used for output and for the quantity in an inputopts equation.

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

 • Up to Maple 2017, this command was available as ThermophysicalData[Property]. With the introduction of the ThermophysicalData[Chemicals] package as a second data source for Maple 2018, that command was rewritten so that it can now redirect either to this command, i.e., ThermophysicalData[CoolProp][Property], or to ThermophysicalData[Chemicals][Property].

Examples

 > $\mathrm{with}\left(\mathrm{ThermophysicalData}\left[\mathrm{CoolProp}\right]\right):$

What is the density of water at 300 kelvin and a pressure of 1 atmosphere? (This example redirects to the PropsSI procedure.)

 > $\mathrm{Property}\left(\mathrm{density},\mathrm{temperature}=300,\mathrm{pressure}=1\mathrm{Unit}\left(\mathrm{atm}\right),\mathrm{Water}\right)$
 ${996.5569353}{}⟦\frac{{\mathrm{kg}}}{{{m}}^{{3}}}⟧$ (1)

You can see the redirection (for the following commands) if you set the value of the variable infolevel[ThermophysicalData] to two (or more).

 > $\mathrm{infolevel}\left[\mathrm{ThermophysicalData}\right]≔2:$

We can give the inputs before or after specifying the fluid.

 > $\mathrm{Property}\left(\mathrm{density},\mathrm{Water},\mathrm{temperature}=300\mathrm{Unit}\left(\mathrm{kelvin}\right),\mathrm{pressure}=101325\right)$
 Property:   "using PropsSI backend"
 ${996.5569353}{}⟦\frac{{\mathrm{kg}}}{{{m}}^{{3}}}⟧$ (2)

The useunits = false option suppresses the unit in the answer.

 > $\mathrm{Property}\left(\mathrm{density},\mathrm{Water},\mathrm{temperature}=300\mathrm{Unit}\left(\mathrm{kelvin}\right),\mathrm{pressure}=101325,'\mathrm{useunits}'=\mathrm{false}\right)$
 Property:   "using PropsSI backend"
 ${996.556935265202128}$ (3)

Alternatively, we can suppress units by not submitting any units in the input options.

 > $\mathrm{Property}\left(\mathrm{density},\mathrm{Water},\mathrm{temperature}=300,\mathrm{pressure}=101325\right)$
 Property:   "using PropsSI backend"
 ${996.556935265202128}$ (4)

This can be overridden by using the useunits = true option.

 > $\mathrm{Property}\left(\mathrm{density},\mathrm{Water},\mathrm{temperature}=300,\mathrm{pressure}=101325,'\mathrm{useunits}'=\mathrm{true}\right)$
 Property:   "using PropsSI backend"
 ${996.5569353}{}⟦\frac{{\mathrm{kg}}}{{{m}}^{{3}}}⟧$ (5)

We can use other name for the quantities. These can come from the Quantity or Maple-specific aliases columns in the preceding tables.

 > $\mathrm{Property}\left(\mathrm{D},\mathrm{Water},T=300\mathrm{Unit}\left(\mathrm{kelvin}\right),P=101325\right)$
 Property:   "using PropsSI backend"
 ${996.5569353}{}⟦\frac{{\mathrm{kg}}}{{{m}}^{{3}}}⟧$ (6)

We can also use different units.

 > $\mathrm{Property}\left(\mathrm{density},\mathrm{Water},\mathrm{temperature}=26.85\mathrm{Unit}\left(\mathrm{degC}\right),\mathrm{pressure}=760\mathrm{Unit}\left(\mathrm{mmHg}\right)\right)$
 Property:   "using PropsSI backend"
 ${996.5569353}{}⟦\frac{{\mathrm{kg}}}{{{m}}^{{3}}}⟧$ (7)

If we ask for properties of humid air, we need to supply three input equations.

 > $\mathrm{Property}\left(\mathrm{temperature_dew_point},\mathrm{HumidAir},\mathrm{temperature_dry_bulb}=300,\mathrm{pressure}=1\mathrm{Unit}\left(\mathrm{atm}\right),\mathrm{humidity}=\frac{1}{2}\right)$
 Property:   "using HAPropsSI backend"
 ${288.7139414}{}⟦{K}⟧$ (8)

Computing the PhaseString property results in a call to the PhaseSI procedure.

 > $\mathrm{Property}\left(\mathrm{PhaseString},\mathrm{temperature}=300\mathrm{Unit}\left(\mathrm{kelvin}\right),\mathrm{pressure}=101325,\mathrm{Water}\right)$
 Property:   "using PhaseSI backend"
 ${"liquid"}$ (9)

Finally, if you request a property that does not require input options, such as the minimal temperature that CoolProp can deal with for a particular fluid, you can call it as follows.

 > $\mathrm{Property}\left(\mathrm{temperature_min},\mathrm{Water}\right)$
 Property:   "using Props1SI backend"
 ${273.160000000000025}$ (10)

By specifying the useunits option, you can instruct the Property command to return a quantity with the appropriate unit attached.

 > $\mathrm{min_temp}≔\mathrm{Property}\left(\mathrm{temperature_min},\mathrm{Water},'\mathrm{useunits}'\right)$
 Property:   "using Props1SI backend"
 ${\mathrm{min_temp}}{≔}{273.1600000}{}⟦{K}⟧$ (11)
 > $\mathrm{convert}\left(\mathrm{min_temp},\mathrm{temperature},\mathrm{degC}\right)$
 ${0.0100000}{}⟦{\mathrm{°C}}⟧$ (12)
 > $\mathrm{convert}\left(\mathrm{min_temp},\mathrm{temperature},\mathrm{degF}\right)$
 ${32.0180000}{}⟦{\mathrm{°F}}⟧$ (13)

Compatibility

 • The ThermophysicalData[CoolProp][Property] command was introduced in Maple 2016.
 • For more information on Maple 2016 changes, see Updates in Maple 2016.
 • The ThermophysicalData[CoolProp][Property] command was updated in Maple 2018.

 See Also