armi.materials.water module

class armi.materials.water.Water[source]

Bases: armi.materials.material.Fluid

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 Class 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

name = 'Water'
thermalScatteringLaws = (<armi.nucDirectory.thermalScattering.ThermalScattering object>,)

A tuple of ThermalScattering instances with information about thermal scattering.

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'}

The literature references.

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]

mass fractions

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

returns temperature normalized to the critical temperature

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

returns 1 - temperature normalized to the critical temperature

Note

thermophysical correlations are give in Tau rather than Tk or Tc

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

Returns vapor pressure in (Pa)

Parameters
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celcius

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: Optional[float] = None, Tc: Optional[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 Celcius

Note

this uses a numerical approximation

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

Returns the auxiliary quantity for specific enthalpy

Parameters
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celcius

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: Optional[float] = None, Tc: Optional[float] = None) float[source]

Returns the auxiliary quantity for specific entropy

Parameters
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celcius

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: Optional[float] = None, Tc: Optional[float] = None) float[source]

Returns enthalpy of saturated water

Parameters
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celcius

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: Optional[float] = None, Tc: Optional[float] = None) float[source]

Returns entropy of saturated water

Parameters
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celcius

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

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

Return density that preserves mass when thermally expanded in 2D.

Warning

This density will not agree with the component density since this method only expands in 2 dimensions. The component has been manually expanded axially with the manually entered block hot height. The density returned by this should be a factor of 1 + dLL higher than the density on the component. density3 should be in agreement at both cold and hot temperatures as long as the block height is correct for the specified temperature. In the case of Fluids, density and density3 are the same as density is not driven by linear expansion, but rather an exilicit density function dependent on Temperature. linearExpansionPercent is zero for a fluid.

See also

armi.materials.density3

component density should be in agreement with this density

armi.reactor.blueprints._applyBlockDesign

2D expansion and axial density reduction occurs here.

paramCollectionType

alias of armi.reactor.parameters.parameterCollections.MaterialParameterCollection

class armi.materials.water.SaturatedWater[source]

Bases: armi.materials.water.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.

name = 'SaturatedWater'
density(Tk: Optional[float] = None, Tc: Optional[float] = None) float[source]

returns density in g/cc

Parameters
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celcius

Returns

density – density in g/cc

Return type

float

Note

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

paramCollectionType

alias of armi.reactor.parameters.parameterCollections.MaterialParameterCollection

class armi.materials.water.SaturatedSteam[source]

Bases: armi.materials.water.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.

name = 'SaturatedSteam'
density(Tk: Optional[float] = None, Tc: Optional[float] = None) float[source]

returns density in g/cc

Parameters
  • Tk (float) – temperature in Kelvin

  • Tc (float) – temperature in Celcius

Returns

density – density in g/cc

Return type

float

Note

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

paramCollectionType

alias of armi.reactor.parameters.parameterCollections.MaterialParameterCollection