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

Parameters

Description

Examples

Compatibility

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=pvRT)

 

– 

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

withThermophysicalDataCoolProp:

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

Propertydensity,temperature=300,pressure=1Unitatm,Water

996.5569353kgm3

(1)

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

infolevelThermophysicalData2:

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

Propertydensity,Water,temperature=300Unitkelvin,pressure=101325

Property:   "using PropsSI backend"

996.5569353kgm3

(2)

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

Propertydensity,Water,temperature=300Unitkelvin,pressure=101325,useunits=false

Property:   "using PropsSI backend"

996.556935265202128

(3)

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

Propertydensity,Water,temperature=300,pressure=101325

Property:   "using PropsSI backend"

996.556935265202128

(4)

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

Propertydensity,Water,temperature=300,pressure=101325,useunits=true

Property:   "using PropsSI backend"

996.5569353kgm3

(5)

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

PropertyD,Water,T=300Unitkelvin,P=101325

Property:   "using PropsSI backend"

996.5569353kgm3

(6)

We can also use different units.

Propertydensity,Water,temperature=26.85UnitdegC,pressure=760UnitmmHg

Property:   "using PropsSI backend"

996.5569353kgm3

(7)

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

Propertytemperature_dew_point,HumidAir,temperature_dry_bulb=300,pressure=1Unitatm,humidity=12

Property:   "using HAPropsSI backend"

288.7139414K

(8)

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

PropertyPhaseString,temperature=300Unitkelvin,pressure=101325,Water

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.

Propertytemperature_min,Water

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.

min_tempPropertytemperature_min,Water,useunits

Property:   "using Props1SI backend"

min_temp273.1600000K

(11)

convertmin_temp,temperature,degC

0.0100000°C

(12)

convertmin_temp,temperature,degF

32.0180000°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

ThermophysicalData

ThermophysicalData/fluids