PropsSI - Maple Help

Online Help

All Products    Maple    MapleSim


ThermophysicalData[CoolProp]

  

PropsSI

  

access CoolProp thermophysical fluid data

 

Calling Sequence

Parameters

Description

Examples

References

Compatibility

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

withThermophysicalData

Atmosphere,Chemicals,CoolProp,PHTChart,Property,PsychrometricChart,TemperatureEntropyChart

(1)

withCoolProp

HAPropsSI,PhaseSI,Property,Props1SI,PropsSI

(2)

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

PropsSIT,P,101325,Q,0,Water

373.124295847684380

(3)

PropsSIT,P,101325,Q,0,Water,useunits

373.1242958K

(4)

PropsSIT,P,1.0Unitatm,Q,0,Water

373.1242958K

(5)

PropsSIT,P,1.0Unitatm,Q,0,Water,useunits=false

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

PropsSIC,P,1.0Unitatm,T,300,Water

4180.635777JkgK

(7)

PropsSId(Hmass)/d(T)|P,P,1.0Unitatm,T,300,Water

4180.635777JkgK

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

• 

For more information on Maple 2016 changes, see Updates in Maple 2016.

See Also

ThermophysicalData

ThermophysicalData/fluids