PropsSI - Maple Help

All Products Maple MapleSim

Home : Support : Online Help : Science and Engineering : 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	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

>	$with (ThermophysicalData)$

$[Atmosphere, Chemicals, CoolProp, PHTChart, Property, PsychrometricChart, TemperatureEntropyChart]$

(1)

>	$with (CoolProp)$

$[HAPropsSI, PhaseSI, Property, Props1SI, PropsSI]$

(2)

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

>	$PropsSI (T, P, 101325, Q, 0, Water)$

$373.124295847684380$

(3)

>	$PropsSI (T, P, 101325, Q, 0, Water, useunits)$

$373.1242958 ⟦K⟧$

(4)

>	$PropsSI (T, P, 1.0 Unit (atm), Q, 0, Water)$

$373.1242958 ⟦K⟧$

(5)

>	$PropsSI (T, P, 1.0 Unit (atm), 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".

>	$PropsSI (C, P, 1.0 Unit (atm), T, 300, Water)$

$4180.635777 ⟦\frac{J}{kg K}⟧$

(7)

>	$PropsSI (d(Hmass)/d(T)\|P, P, 1.0 Unit (atm), T, 300, Water)$

$4180.635777 ⟦\frac{J}{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.

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

Maple

Maple Add-Ons

MapleSim

MapleSim Add-Ons

Systems Engineering

Consulting Services

Maple T.A. and Möbius

Education

Industries

Automotive and Aerospace

Robotics

Machine Design & Industrial Automation

Other

Application Areas

Product Pricing

Purchasing

Institutional Student Licensing

Maplesoft Elite Maintenance (EMP)

Support

Product Training

Online Product Help

Webinars & Events

Publications

Content Hubs

Examples & Applications

Community

About Maplesoft

Media Center

User Community

Contact

Online Help

All Products Maple MapleSim

Maple

Powerful math software that is easy to use

Maple Add-Ons

MapleSim

Advanced System Level Modeling

MapleSim Add-Ons

Systems Engineering

Consulting Services

Maple T.A. and Möbius

Education

Industries

Automotive and Aerospace

Robotics

Machine Design & Industrial Automation

Other

Application Areas

Product Pricing

Purchasing

Institutional Student Licensing

Maplesoft Elite Maintenance (EMP)

Support

Product Training

Online Product Help

Webinars & Events

Publications

Content Hubs

Examples & Applications

Community

About Maplesoft

Media Center

User Community

Contact

Online Help

All Products Maple MapleSim