armi.materials.water module

Basic water materials: SaturatedSteam and SaturatedWater.

This is an example of a material implemented purely in Python, without any matProps YAML inputs.

class armi.materials.water.Water[source]

Bases: Fluid

Water.

This is a good faith implementation of the Revised Supplementary Properties of Ordinary Water Substance (1992) by IAPWS – International Association for the Properties of Water and Steam.

This is an abstract class implemented on the Saturated Water Material and the Saturated Steam Material Class, which should be good enough for most uses.

http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry

references = {'density (saturated steam)': 'IAPWS SR1-86 Revised Supplementary Release on Saturation Properties of Ordinary Water and Steam', 'density (saturated water)': 'IAPWS SR1-86 Revised Supplementary Release on Saturation Properties of Ordinary Water and Steam', 'enthalpy (saturated steam)': 'IAPWS SR1-86 Revised Supplementary Release on Saturation Properties of Ordinary Water and Steam', 'enthalpy (saturated water)': 'IAPWS SR1-86 Revised Supplementary Release on Saturation Properties of Ordinary Water and Steam', 'entropy (saturated steam)': 'IAPWS SR1-86 Revised Supplementary Release on Saturation Properties of Ordinary Water and Steam', 'entropy (saturated water)': 'IAPWS SR1-86 Revised Supplementary Release on Saturation Properties of Ordinary Water and Steam', 'vapor pressure': 'IAPWS SR1-86 Revised Supplementary Release on Saturation Properties of Ordinary Water and Steam'}

citation}

Type:

The literature references {property

TEMPERATURE_CRITICAL_K = 647.096
DENSITY_CRITICAL_KGPERCUBICMETER = 322.0
DENSITY_CRITICAL_GPERCUBICCENTIMETER = 0.322
VAPOR_PRESSURE_CRITICAL_MPA = 22.064
VAPOR_PRESSURE_CRITICAL_PA = 22064000.0
ALPHA_0 = 1000
PHI_0 = 1.5453657571674064
d = {'alpha': -1135.905627715, 'phi': 2319.5246, 1: -5.65134998e-08, 2: 2690.66631, 3: 127.287297, 4: -135.003439, 5: 0.981825814}
setDefaultMassFracs() None[source]
theta(Tk: float = None, Tc: float = None) float[source]

Returns temperature normalized to the critical temperature.

tau(Tc: float = None, Tk: float = None) float[source]

Returns 1 - temperature normalized to the critical temperature.

Notes

thermophysical correlations are give in Tau rather than Tk or Tc

vaporPressure(Tk: float = None, Tc: float = None) float[source]

Returns vapor pressure in (Pa).

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Returns:

vaporPressure – vapor pressure in Pa

Return type:

float

Notes

IAPWS-IF97 http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry

vaporPressurePrime(Tk: float = None, Tc: float = None, dT: float = 1e-06) float[source]

Approximation of derivative of vapor pressure wrt temperature.

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Note

This uses a numerical approximation

auxiliaryQuantitySpecificEnthalpy(Tk: float = None, Tc: float = None) float[source]

Returns the auxiliary quantity for specific enthalpy.

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Returns:

alpha – specific quantity for enthalpy in J/kg

Return type:

float

Notes

IAPWS-IF97 http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry

alpha is used in the relations for enthalpy h = alpha + T/pressure*dp/dT

auxiliaryQuantitySpecificEntropy(Tk: float = None, Tc: float = None) float[source]

Returns the auxiliary quantity for specific entropy.

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Returns:

phi – specific quantity for entropy in J/(kgK)

Return type:

float

Notes

IAPWS-IF97 http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry

alpha is used in the relations for enthalpy s = phi + 1/pressure*dp/dT

enthalpy(Tk: float = None, Tc: float = None) float[source]

Returns enthalpy of saturated water.

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Returns:

enthalpy – vapor pressure in J/kg

Return type:

float

Notes

IAPWS-IF97 http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry

entropy(Tk: float = None, Tc: float = None) float[source]

Returns entropy of saturated water.

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Returns:

entropy – entropy in J/(kgK)

Return type:

float

Notes

IAPWS-IF97 http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry

class armi.materials.water.SaturatedWater[source]

Bases: Water

Saturated Water.

This is a good faith implementation of the Revised Supplementary Properties of Ordinary Water Substance (1992) by IAPWS – International Association for the Properties of Water and Steam.

This is the Saturated Liquid Water Material Class. For steam look to the Saturated Steam Material Class.

density(Tk: float = None, Tc: float = None) float[source]

Returns density in g/cc.

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Returns:

density – density in g/cc

Return type:

float

Note

In ARMI, we define pseudoDensity() and density() as the same for Fluids. IAPWS-IF97 http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry

class armi.materials.water.SaturatedSteam[source]

Bases: Water

Saturated Steam.

This is a good faith implementation of the Revised Supplementary Properties of Ordinary Water Substance (1992) by IAPWS – International Association for the Properties of Water and Steam.

This is the Saturated Liquid Water Material Class. For steam look to the Saturated Steam Material Class.

density(Tk: float = None, Tc: float = None) float[source]

Returns density in g/cc.

Parameters:
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celsius

Returns:

density – density in g/cc

Return type:

float

Notes

In ARMI, we define pseudoDensity() and density() as the same for Fluids. IAPWS-IF97 http://www.iapws.org/relguide/supsat.pdf IAPWS-IF97 is now the international standard for calculations in the steam power industry