ChemicalSpecies

java.lang.Object
- nce.base.ChemicalSpecies

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

Stream
```
public class ChemicalSpecies
extends java.lang.Object
implements java.io.Serializable
```
Definition of pure chemical species. This class is a container for all INTENSIVE properties and models for the evaluation of intensive properties.

Version:

20160215

Author:

Carlo Tegano

See Also:
Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`ChemicalSpecies.DensityModels`
`static class`	`ChemicalSpecies.InRangesDefs` Provides easier access to validity range variables identification strings for the ChemicalSpecies class
`static class`	`ChemicalSpecies.VaporPressureModels`
`static class`	`ChemicalSpecies.ViscosityModels`

Constructor Summary

Constructors
Constructor and Description

ChemicalSpecies()

Constructors
Constructor and Description
`ChemicalSpecies()`

Method Summary

Methods
Modifier and Type	Method and Description
`static ChemicalSpecies[]`	`buildChemicalSpeciesArray(int numSpecies)` Allocation of a new array of chemical species
`double`	`evalDensity(double sysT, double sysP)` Evaluates species density using the model specified in 'activeDensityModel' variable, taking into account also the physical state (liquid or vapor).
`double`	`evalHeatRelease(double t, double p)` Evaluates heat release using the predefined equation.
`double`	`evalLiquidVolumeWithEos(double p, double t)` Evaluation of liquid molar volume with an equation of state
`double`	`evalLiquidVolumeWithEqn(double sysT, double sysP)` Evaluates liquid molar volume with the predefined model equation.
`double`	`evalPressureWithEos(double v, double t)` Evaluation of P(V, T) by an equation of state
`double`	`evalSatLiquidVolumeWithEqn(double sysT)` Evaluates liquid molar volume at saturation the predefined model equation.
`double`	`evalSatPressure(double sysT)` Evaluates saturation pressure using the model specified in 'activeVaporPressureModel' variable For example, to use an the equation call useVaporPressureModel(ChemicalSpecies.VaporPressureModels.EQUATION)
`double`	`evalSatPressureWithEqn(double t)`
`double`	`evalSatTemperature(double sysP)` High level driver, evaluates saturation temperature using the model specified in 'activeVaporPressureModel' variable For example, to use an the equation call useVaporPressureModel(ChemicalSpecies.VaporPressureModels.EQUATION)
`double`	`evalSatTemperatureWithEqn(double p)`
`double`	`evalSpecificHeat(double t)` Evaluates Cp with the specific heat eqn as function of T
`double`	`evalSpecificHeatIntH(double t0, double t)` Evaluates the integral Cp useful for enthalpy calculations: Cp_av = Int_T0^T Cp dT; then H = Cp_av * (T - T0)
`double`	`evalSpecificHeatIntS(double t0, double t)` Evaluates the integral Cp useful for entropy calculations (Cp/T)_av = Int_T0^T Cp dT (Cp/T) = Int_T0^T (Cp / T) dT; then S = (Cp/T)_av * (T - T0)
`double`	`evalTemperatureWithEos(double p, double vv)` Evaluation of fluid absolute temperature with and equation of state
`double`	`evalThermCond(double t, double p)` Evaluates thermal conductivity with the predefined equation.
`double`	`evalVaporVolumeWithEos(double p, double t)` Evaluation of Vv(P, T) by an equation of state
`double`	`evalViscosity(double t, double p)` Evaluates species viscosity using the predefined equation.
`java.lang.String`	`getDescription()`
`GasEos`	`getEosg()` Get current equation of state
`DensityModel`	`getEqnDens()`
`HeatReleaseModel`	`getEqnHeatRelease()` Return the heat release equation
`LiqMolVolModel`	`getEqnLiqVol()` Returns the equation for the specific liquid volume
`VaporPressureModel`	`getEqnPvap()` Get current vapor pressure equation
`SpecHeatModel`	`getEqnSpecHeat()` Returns the specific heat equation
`ThermCondModel`	`getEqnThCond()` Return the thermal conductivity equation
`ViscosityModel`	`getEqnVisc()` Returns actual viscosity equation
`Range`	`getInRanges()`
`java.lang.String`	`getLabel()`
`double`	`getMoleMass()`
`double`	`getPc()`
`Phase`	`getPhase()`
`double`	`getSatPressure()` Returns previously computed saturation pressure from the active equation
`double`	`getSatTemperature()` Returns previously computed saturation temperature from the active equation
`double`	`getSpecHeatCp()` Gets the current value of Cp
`double`	`getTc()`
`double`	`getVc()`
`double`	`getZc()`
`void`	`setDescription(java.lang.String description)`
`void`	`setEosg(GasEos eosg)` Assign an externally defined equation of state
`void`	`setEqnDens(DensityModel eqnDens)`
`void`	`setEqnHeatRelease(HeatReleaseModel eqnHeatRelease)` Assign an externally defined viscosity equation
`void`	`setEqnPvap(VaporPressureModel eqnPvap)` Sets an externally defined vapor pressure equation
`void`	`setEqnSpecHeat(SpecHeatModel eqnCp)` Assign an externally defined specific heat equation
`void`	`setEqnThCond(ThermCondModel eqnThCond)` Assign an externally defined thermal conductivity equation
`void`	`setEqnVisc(ViscosityModel eqnVisc)` Assign an externally defined viscosity equation
`void`	`setInRanges(Range inRanges)`
`void`	`setLabel(java.lang.String label)`
`void`	`setLiquidVolume(double fixV)` Sets the constant value of liquid molar volume in the existing molar volume equation.
`void`	`setLiquidVolumeEqn(LiqMolVolModel eqnLiqVol)` Assigns an externally defined specific volume equation
`void`	`setMoleMass(double mW)`
`void`	`setPc(double pc)`
`void`	`setPcVcTcZc(double pc, double vc, double tc)` Sets critical constants in one step
`void`	`setPhase(Phase phase)`
`void`	`setSpecHeatCp(double Cp)` Sets a fixed value for Cp
`void`	`setTc(double tc)`
`void`	`setVc(double vc)`
`void`	`setZc(double zc)`
`void`	`useDensityModel(ChemicalSpecies.DensityModels model)`
`void`	`useSpecificHeatOnMassBase()`
`void`	`useSpecificHeatOnMoleBase()`
`void`	`useVaporPressureModel(ChemicalSpecies.VaporPressureModels model)`
`void`	`useViscosityModel(ChemicalSpecies.ViscosityModels model)`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ChemicalSpecies
```
public ChemicalSpecies()
```
- Method Detail
  - buildChemicalSpeciesArray
```
public static ChemicalSpecies[] buildChemicalSpeciesArray(int numSpecies)
```
    Allocation of a new array of chemical species
    
    Parameters:
    numSpecies - the number of chemical species in the array
    
    Returns:
    Array of type ChemicalSpecies
  - evalPressureWithEos
```
public double evalPressureWithEos(double v,
                         double t)
```
    Evaluation of P(V, T) by an equation of state
    
    Parameters:
    v - vapor or liquid volume [m3/mol]
    t - absolute temperature [K]
    
    Returns:
    fluid pressure [Pa]
  - evalVaporVolumeWithEos
```
public double evalVaporVolumeWithEos(double p,
                            double t)
```
    Evaluation of Vv(P, T) by an equation of state
    
    Parameters:
    p - fluid pressure [Pa]
    t - fluid temperature [K]
    
    Returns:
    vapor volume [m3/mol]
  - evalLiquidVolumeWithEos
```
public double evalLiquidVolumeWithEos(double p,
                             double t)
```
    Evaluation of liquid molar volume with an equation of state
    
    Parameters:
    p - pressure [Pa]
    t - temperature [K]
    
    Returns:
    liquid volume [m3/mol]
  - evalTemperatureWithEos
```
public double evalTemperatureWithEos(double p,
                            double vv)
```
    Evaluation of fluid absolute temperature with and equation of state
    
    Parameters:
    p - pressure [Pa]
    vv - vapor or liquid volume [m3/mol]
    
    Returns:
    fluid temperature [k]
  - getEosg
```
public GasEos getEosg()
```
    Get current equation of state
  - setEosg
```
public void setEosg(GasEos eosg)
```
    Assign an externally defined equation of state
  - useSpecificHeatOnMassBase
```
public void useSpecificHeatOnMassBase()
```
  - useSpecificHeatOnMoleBase
```
public void useSpecificHeatOnMoleBase()
```
  - setSpecHeatCp
```
public void setSpecHeatCp(double Cp)
```
    Sets a fixed value for Cp
    
    Parameters:
    Cp - the constant Cp
  - getSpecHeatCp
```
public double getSpecHeatCp()
```
    Gets the current value of Cp
  - evalSpecificHeat
```
public double evalSpecificHeat(double t)
```
    Evaluates Cp with the specific heat eqn as function of T
    
    Parameters:
    t - temperature
    
    Returns:
    specific heat at constant pressure
  - evalSpecificHeatIntH
```
public double evalSpecificHeatIntH(double t0,
                          double t)
```
    Evaluates the integral Cp useful for enthalpy calculations: Cp_av = Int_T0^T Cp dT; then H = Cp_av * (T - T0)
    
    Parameters:
    t0 - reference temperature in K
    t - system temperature in K
    
    Returns:
    average Cp in J/mol K or J/kg K
  - evalSpecificHeatIntS
```
public double evalSpecificHeatIntS(double t0,
                          double t)
```
    Evaluates the integral Cp useful for entropy calculations (Cp/T)_av = Int_T0^T Cp dT (Cp/T) = Int_T0^T (Cp / T) dT; then S = (Cp/T)_av * (T - T0)
    
    Parameters:
    t0 - reference temperature
    t - system temperature
    
    Returns:
    average Cp/T in J/mol K^2 or J/kg K^2
  - setEqnSpecHeat
```
public void setEqnSpecHeat(SpecHeatModel eqnCp)
```
    Assign an externally defined specific heat equation
    
    Parameters:
    eqnCp - specific heat equation object
  - getEqnSpecHeat
```
public SpecHeatModel getEqnSpecHeat()
```
    Returns the specific heat equation
    
    Returns:
    specific heat equation object
  - setLiquidVolume
```
public void setLiquidVolume(double fixV)
```
    Sets the constant value of liquid molar volume in the existing molar volume equation.
    
    Parameters:
    fixV - liquid volume in m3/mol
  - evalLiquidVolumeWithEqn
```
public double evalLiquidVolumeWithEqn(double sysT,
                             double sysP)
```
    Evaluates liquid molar volume with the predefined model equation.
    
    Parameters:
    sysT - liquid temperature [K]
    sysP - liquid pressure [Pa]
    
    Returns:
    liquid molar volume in [m3/mol]
  - evalSatLiquidVolumeWithEqn
```
public double evalSatLiquidVolumeWithEqn(double sysT)
```
    Evaluates liquid molar volume at saturation the predefined model equation.
    
    Parameters:
    sysT - liquid saturation temperature [K]
    
    Returns:
    liquid molar volume [m3/mol]
  - getEqnLiqVol
```
public LiqMolVolModel getEqnLiqVol()
```
    Returns the equation for the specific liquid volume
  - setLiquidVolumeEqn
```
public void setLiquidVolumeEqn(LiqMolVolModel eqnLiqVol)
```
    Assigns an externally defined specific volume equation
    
    Parameters:
    eqnLiqVol - equation object
  - useDensityModel
```
public void useDensityModel(ChemicalSpecies.DensityModels model)
```
  - evalDensity
```
public double evalDensity(double sysT,
                 double sysP)
```
    Evaluates species density using the model specified in 'activeDensityModel' variable, taking into account also the physical state (liquid or vapor). For example, to use an the equation of state call useDensityModel(ChemicalSpecies.DensityModels.EQUATION_OF_STATE)
    
    Parameters:
    sysT - system temperature in K
    sysP - system pressure in Pa
    
    Returns:
    density in kg/m3
  - useViscosityModel
```
public void useViscosityModel(ChemicalSpecies.ViscosityModels model)
```
  - evalViscosity
```
public double evalViscosity(double t,
                   double p)
```
    Evaluates species viscosity using the predefined equation.
    
    Parameters:
    t - system temperature [degK]
    p - system pressure [Pa]
    
    Returns:
    viscosity in [Pa s]
  - getEqnVisc
```
public ViscosityModel getEqnVisc()
```
    Returns actual viscosity equation
  - setEqnVisc
```
public void setEqnVisc(ViscosityModel eqnVisc)
```
    Assign an externally defined viscosity equation
  - evalThermCond
```
public double evalThermCond(double t,
                   double p)
```
    Evaluates thermal conductivity with the predefined equation.
    
    Parameters:
    t - system temperature [degK]
    p - system pressure [Pa]
    
    Returns:
    thermal conductivity [W/m degK]
  - getEqnThCond
```
public ThermCondModel getEqnThCond()
```
    Return the thermal conductivity equation
  - setEqnThCond
```
public void setEqnThCond(ThermCondModel eqnThCond)
```
    Assign an externally defined thermal conductivity equation
  - evalHeatRelease
```
public double evalHeatRelease(double t,
                     double p)
```
    Evaluates heat release using the predefined equation.
    
    Parameters:
    t - system temperature [degK]
    p - system pressure [Pa]
    
    Returns:
    heat release [J/kg] or [J/mol]
  - setEqnHeatRelease
```
public void setEqnHeatRelease(HeatReleaseModel eqnHeatRelease)
```
    Assign an externally defined viscosity equation
  - getEqnHeatRelease
```
public HeatReleaseModel getEqnHeatRelease()
```
    Return the heat release equation
  - evalSatPressureWithEqn
```
public double evalSatPressureWithEqn(double t)
```
  - evalSatTemperatureWithEqn
```
public double evalSatTemperatureWithEqn(double p)
```
  - getSatPressure
```
public double getSatPressure()
```
    Returns previously computed saturation pressure from the active equation
  - getSatTemperature
```
public double getSatTemperature()
```
    Returns previously computed saturation temperature from the active equation
  - getEqnPvap
```
public VaporPressureModel getEqnPvap()
```
    Get current vapor pressure equation
  - setEqnPvap
```
public void setEqnPvap(VaporPressureModel eqnPvap)
```
    Sets an externally defined vapor pressure equation
    
    Parameters:
    eqnPvap -
  - useVaporPressureModel
```
public void useVaporPressureModel(ChemicalSpecies.VaporPressureModels model)
```
  - evalSatPressure
```
public double evalSatPressure(double sysT)
```
    Evaluates saturation pressure using the model specified in 'activeVaporPressureModel' variable For example, to use an the equation call useVaporPressureModel(ChemicalSpecies.VaporPressureModels.EQUATION)
    
    Parameters:
    sysT - system temperature [degK]
    
    Returns:
    saturation pressure [Pa]
  - evalSatTemperature
```
public double evalSatTemperature(double sysP)
```
    High level driver, evaluates saturation temperature using the model specified in 'activeVaporPressureModel' variable For example, to use an the equation call useVaporPressureModel(ChemicalSpecies.VaporPressureModels.EQUATION)
    
    Parameters:
    sysP - system pressure [Pa]
    
    Returns:
    saturation temperature [K]
  - setPcVcTcZc
```
public void setPcVcTcZc(double pc,
               double vc,
               double tc)
                 throws java.lang.ArithmeticException
```
    Sets critical constants in one step
    
    Parameters:
    pc -
    vc -
    tc -
    
    Throws:
    
    java.lang.ArithmeticException
  - getLabel
```
public java.lang.String getLabel()
```
  - setLabel
```
public void setLabel(java.lang.String label)
```
  - getMoleMass
```
public double getMoleMass()
```
  - setMoleMass
```
public void setMoleMass(double mW)
```
  - getTc
```
public double getTc()
```
  - setTc
```
public void setTc(double tc)
```
  - getPc
```
public double getPc()
```
  - setPc
```
public void setPc(double pc)
```
  - getVc
```
public double getVc()
```
  - setVc
```
public void setVc(double vc)
```
  - getZc
```
public double getZc()
```
  - setZc
```
public void setZc(double zc)
```
  - getEqnDens
```
public DensityModel getEqnDens()
```
  - setEqnDens
```
public void setEqnDens(DensityModel eqnDens)
```
  - getPhase
```
public Phase getPhase()
```
  - setPhase
```
public void setPhase(Phase phase)
```
  - getDescription
```
public java.lang.String getDescription()
```
  - setDescription
```
public void setDescription(java.lang.String description)
```
  - getInRanges
```
public Range getInRanges()
```
  - setInRanges
```
public void setInRanges(Range inRanges)
```

Class ChemicalSpecies

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ChemicalSpecies

Method Detail

buildChemicalSpeciesArray

evalPressureWithEos

evalVaporVolumeWithEos

evalLiquidVolumeWithEos

evalTemperatureWithEos

getEosg

setEosg

useSpecificHeatOnMassBase

useSpecificHeatOnMoleBase

setSpecHeatCp

getSpecHeatCp

evalSpecificHeat

evalSpecificHeatIntH

evalSpecificHeatIntS

setEqnSpecHeat

getEqnSpecHeat

setLiquidVolume

evalLiquidVolumeWithEqn

evalSatLiquidVolumeWithEqn

getEqnLiqVol

setLiquidVolumeEqn

useDensityModel

evalDensity

useViscosityModel

evalViscosity

getEqnVisc

setEqnVisc

evalThermCond

getEqnThCond

setEqnThCond

evalHeatRelease

setEqnHeatRelease

getEqnHeatRelease

evalSatPressureWithEqn

evalSatTemperatureWithEqn

getSatPressure

getSatTemperature

getEqnPvap

setEqnPvap

useVaporPressureModel

evalSatPressure

evalSatTemperature

setPcVcTcZc

getLabel

setLabel

getMoleMass

setMoleMass

getTc

setTc

getPc

setPc

getVc

setVc

getZc

setZc

getEqnDens

setEqnDens

getPhase

setPhase

getDescription

setDescription

getInRanges

setInRanges