Pure Virtual base class for the species thermo manager classes. More...

#include <SpeciesThermo.h>

Inheritance diagram for SpeciesThermo:

Public Member Functions
	SpeciesThermo ()
	Constructor.

virtual	~SpeciesThermo ()
	Destructor.

	SpeciesThermo (const SpeciesThermo &right)
	Copy Constructor for the SpeciesThermo object.

SpeciesThermo &	operator= (const SpeciesThermo &right)
	Assignment operator for the SpeciesThermo object.

virtual SpeciesThermo *	duplMyselfAsSpeciesThermo () const =0
	Duplication routine for objects which inherit from SpeciesThermo.

virtual void	install (std::string name, size_t index, int type, const doublereal *c, doublereal minTemp, doublereal maxTemp, doublereal refPressure)=0
	Install a new species thermodynamic property parameterization for one species.

virtual void	install_STIT (SpeciesThermoInterpType *stit_ptr)=0
	Install a new species thermodynamic property parameterization for one species.

virtual void	update (doublereal T, doublereal cp_R, doublereal h_RT, doublereal *s_R) const =0
	Compute the reference-state properties for all species.

virtual void	update_one (size_t k, doublereal T, doublereal cp_R, doublereal h_RT, doublereal *s_R) const
	Like update(), but only updates the single species k.

virtual doublereal	minTemp (size_t k=npos) const =0
	Minimum temperature.

virtual doublereal	maxTemp (size_t k=npos) const =0
	Maximum temperature.

virtual doublereal	refPressure (size_t k=npos) const =0
	The reference-state pressure for species k.

virtual int	reportType (size_t index=npos) const =0
	This utility function reports the type of parameterization used for the species with index number index.

virtual void	reportParams (size_t index, int &type, doublereal *const c, doublereal &minTemp, doublereal &maxTemp, doublereal &refPressure) const =0
	This utility function reports back the type of parameterization and all of the parameters for the species, index.

virtual void	modifyParams (size_t index, doublereal *c)=0
	Modify parameters for the standard state.

Detailed Description

Pure Virtual base class for the species thermo manager classes.

This class defines the interface which all subclasses must implement.

Class SpeciesThermo is the base class for a family of classes that compute properties of a set of species in their reference state at a range of temperatures. Note, the pressure dependence of the reference state is not handled by this particular species standard state model.

Definition at line 176 of file SpeciesThermo.h.

Constructor & Destructor Documentation

SpeciesThermo ( )

inline

Constructor.

Definition at line 182 of file SpeciesThermo.h.

virtual ~SpeciesThermo ( )

inlinevirtual

Destructor.

Definition at line 185 of file SpeciesThermo.h.

SpeciesThermo ( const SpeciesThermo & right )

inline

Copy Constructor for the SpeciesThermo object.

Parameters

right Reference to SpeciesThermo object to be copied into the current one.

Definition at line 192 of file SpeciesThermo.h.

Member Function Documentation

SpeciesThermo& operator= ( const SpeciesThermo & right )

inline

Assignment operator for the SpeciesThermo object.

This is NOT a virtual function.

Parameters

right Reference to SpeciesThermo object to be copied into the current one.

Definition at line 201 of file SpeciesThermo.h.

virtual SpeciesThermo* duplMyselfAsSpeciesThermo ( ) const

pure virtual

Duplication routine for objects which inherit from SpeciesThermo.

This virtual routine can be used to duplicate SpeciesThermo objects inherited from SpeciesThermo even if the application only has a pointer to SpeciesThermo to work with. ->commented out because we first need to add copy constructors and assignment operators to all of the derived classes.

Implemented in SpeciesThermoDuo< T1, T2 >, ShomateThermo, NasaThermo, SimpleThermo, and GeneralSpeciesThermo.

virtual void install	(	std::string	name,
		size_t	index,
		int	type,
		const doublereal *	c,
		doublereal	minTemp,
		doublereal	maxTemp,
		doublereal	refPressure
	)

pure virtual

Install a new species thermodynamic property parameterization for one species.

Parameters

name	Name of the species
index	The 'update' method will update the property values for this species at position i index in the property arrays.
type	int flag specifying the type of parameterization to be installed.
c	vector of coefficients for the parameterization. This vector is simply passed through to the parameterization constructor.
minTemp	minimum temperature for which this parameterization is valid.
maxTemp	maximum temperature for which this parameterization is valid.
refPressure	standard-state pressure for this parameterization.

See Also: speciesThermoTypes.h

Implemented in SpeciesThermoDuo< T1, T2 >, ShomateThermo, NasaThermo, SimpleThermo, and GeneralSpeciesThermo.

Referenced by FixedChemPotSSTP::FixedChemPotSSTP(), Cantera::installMinEQ3asShomateThermoFromXML(), Cantera::installMu0ThermoFromXML(), Cantera::installNasaThermoFromXML(), Cantera::installShomateThermoFromXML(), and Cantera::installSimpleThermoFromXML().

virtual void install_STIT ( SpeciesThermoInterpType * stit_ptr )

pure virtual

Install a new species thermodynamic property parameterization for one species.

Parameters

stit_ptr Pointer to the SpeciesThermoInterpType object This will set up the thermo for one species

Implemented in SpeciesThermoDuo< T1, T2 >, NasaThermo, ShomateThermo, SimpleThermo, and GeneralSpeciesThermo.

Referenced by Cantera::installNasa9ThermoFromXML().

virtual void update	(	doublereal	T,
		doublereal *	cp_R,
		doublereal *	h_RT,
		doublereal *	s_R
	)		const

pure virtual

Compute the reference-state properties for all species.

Given temperature T in K, this method updates the values of the non-dimensional heat capacity at constant pressure, enthalpy, and entropy, at the reference pressure, Pref of each of the standard states.

Parameters

T	Temperature (Kelvin)
cp_R	Vector of Dimensionless heat capacities. (length m_kk).
h_RT	Vector of Dimensionless enthalpies. (length m_kk).
s_R	Vector of Dimensionless entropies. (length m_kk).

Implemented in NasaThermo, ShomateThermo, SpeciesThermoDuo< T1, T2 >, SimpleThermo, and GeneralSpeciesThermo.

Referenced by MixtureFugacityTP::_updateReferenceStateThermo(), VPSSMgr_Water_ConstVol::_updateRefStateThermo(), VPSSMgr::_updateRefStateThermo(), ConstDensityThermo::_updateThermo(), SurfPhase::_updateThermo(), SingleSpeciesTP::_updateThermo(), IdealGasPhase::_updateThermo(), LatticePhase::_updateThermo(), IdealSolidSolnPhase::_updateThermo(), and SpeciesThermo::update_one().

virtual void update_one	(	size_t	k,
		doublereal	T,
		doublereal *	cp_R,
		doublereal *	h_RT,
		doublereal *	s_R
	)		const

inlinevirtual

Like update(), but only updates the single species k.

The default treatment is to just call update() which means that potentially the operation takes a m_kk*m_kk hit.

Parameters

k	species index
T	Temperature (Kelvin)
cp_R	Vector of Dimensionless heat capacities. (length m_kk).
h_RT	Vector of Dimensionless enthalpies. (length m_kk).
s_R	Vector of Dimensionless entropies. (length m_kk).

Reimplemented in NasaThermo, SimpleThermo, ShomateThermo, and GeneralSpeciesThermo.

Definition at line 285 of file SpeciesThermo.h.

References SpeciesThermo::update().

Referenced by PureFluidPhase::initThermo(), PDSS_ConstVol::setTemperature(), PDSS_IdealGas::setTemperature(), and PDSS_SSVol::setTemperature().

virtual doublereal minTemp ( size_t k = npos ) const

pure virtual

Minimum temperature.

If no argument is supplied, this method returns the minimum temperature for which all parameterizations are valid. If an integer index k is supplied, then the value returned is the minimum temperature for species k in the phase.

Parameters

k	Species index

Implemented in NasaThermo, ShomateThermo, SpeciesThermoDuo< T1, T2 >, SimpleThermo, and GeneralSpeciesThermo.

Referenced by IdealSolidSolnPhase::initLengths(), ConstDensityThermo::initThermo(), StoichSubstance::initThermo(), PDSS_IdealGas::initThermo(), PDSS_IonsFromNeutral::initThermo(), StoichSubstanceSSTP::initThermo(), SingleSpeciesTP::initThermo(), IdealGasPhase::initThermo(), LatticePhase::initThermo(), PDSS_ConstVol::initThermoXML(), PDSS_SSVol::initThermoXML(), and ThermoPhase::minTemp().

virtual doublereal maxTemp ( size_t k = npos ) const

pure virtual

Maximum temperature.

If no argument is supplied, this method returns the maximum temperature for which all parameterizations are valid. If an integer index k is supplied, then the value returned is the maximum temperature for parameterization k.

Parameters

k	Species Index

Implemented in NasaThermo, ShomateThermo, SimpleThermo, SpeciesThermoDuo< T1, T2 >, and GeneralSpeciesThermo.

Referenced by IdealSolidSolnPhase::initLengths(), ConstDensityThermo::initThermo(), StoichSubstance::initThermo(), PDSS_IdealGas::initThermo(), PDSS_IonsFromNeutral::initThermo(), StoichSubstanceSSTP::initThermo(), SingleSpeciesTP::initThermo(), IdealGasPhase::initThermo(), LatticePhase::initThermo(), PDSS_ConstVol::initThermoXML(), PDSS_SSVol::initThermoXML(), and ThermoPhase::maxTemp().

virtual doublereal refPressure ( size_t k = npos ) const

pure virtual

The reference-state pressure for species k.

returns the reference state pressure in Pascals for species k. If k is left out of the argument list, it returns the reference state pressure for the first species. Note that some SpeciesThermo implementations, such as those for ideal gases, require that all species in the same phase have the same reference state pressures.

Parameters

k	Species Index

Implemented in NasaThermo, ShomateThermo, SimpleThermo, SpeciesThermoDuo< T1, T2 >, and GeneralSpeciesThermo.

Referenced by PDSS_ConstVol::constructPDSSXML(), PDSS_SSVol::constructPDSSXML(), VPSSMgr_IdealGas::createInstallPDSS(), ConstDensityThermo::enthalpy_mole(), LatticePhase::enthalpy_mole(), RedlichKwongMFTP::entropy_mole(), IdealGasPhase::entropy_mole(), ConstDensityThermo::getChemPotentials(), MixtureFugacityTP::getEntropy_R(), IdealGasPhase::getEntropy_R(), PureFluidPhase::getEntropy_R_ref(), MixtureFugacityTP::getGibbs_RT(), IdealGasPhase::getGibbs_RT(), PureFluidPhase::getGibbs_RT_ref(), IdealGasPhase::getPartialMolarEntropies(), MixtureFugacityTP::getPureGibbs(), IdealGasPhase::getPureGibbs(), MixtureFugacityTP::getStandardChemPotentials(), IdealGasPhase::getStandardChemPotentials(), PDSS_ConstVol::initThermo(), PDSS_IdealGas::initThermo(), PDSS_IonsFromNeutral::initThermo(), PDSS_SSVol::initThermo(), PDSS_ConstVol::initThermoXML(), PDSS_SSVol::initThermoXML(), VPSSMgr::initThermoXML(), VPSSMgr::installSTSpecies(), ConstDensityThermo::intEnergy_mole(), LatticePhase::intEnergy_mole(), and ThermoPhase::refPressure().

virtual int reportType ( size_t index = npos ) const

pure virtual

This utility function reports the type of parameterization used for the species with index number index.

Parameters

index Species index

Implemented in NasaThermo, ShomateThermo, SimpleThermo, SpeciesThermoDuo< T1, T2 >, and GeneralSpeciesThermo.

virtual void reportParams	(	size_t	index,
		int &	type,
		doublereal *const	c,
		doublereal &	minTemp,
		doublereal &	maxTemp,
		doublereal &	refPressure
	)		const

pure virtual

This utility function reports back the type of parameterization and all of the parameters for the species, index.

Parameters

index	Species index
type	Integer type of the standard type
c	Vector of coefficients used to set the parameters for the standard state.
minTemp	output - Minimum temperature
maxTemp	output - Maximum temperature
refPressure	output - reference pressure (Pa).

Implemented in NasaThermo, ShomateThermo, SimpleThermo, SpeciesThermoDuo< T1, T2 >, and GeneralSpeciesThermo.

virtual void modifyParams	(	size_t	index,
		doublereal *	c
	)

pure virtual

Modify parameters for the standard state.

Parameters

index	Species index
c	Vector of coefficients used to set the parameters for the standard state.

Deprecated:

Implemented in NasaThermo, ShomateThermo, SimpleThermo, SpeciesThermoDuo< T1, T2 >, and GeneralSpeciesThermo.

The documentation for this class was generated from the following file:

SpeciesThermo.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation