Base class for phases of matter. More...

#include <Phase.h>

Inheritance diagram for Phase:

Collaboration diagram for Phase:

Public Member Functions
	Phase ()
	Default constructor. More...

virtual	~Phase ()
	Destructor. More...

	Phase (const Phase &right)
	Copy Constructor. More...

Phase &	operator= (const Phase &right)
	Assignment operator. More...

XML_Node &	xml ()
	Returns a reference to the XML_Node stored for the phase. More...

void	saveState (vector_fp &state) const
	Save the current internal state of the phase Write to vector 'state' the current internal state. More...

void	saveState (size_t lenstate, doublereal *state) const
	Write to array 'state' the current internal state. More...

void	restoreState (const vector_fp &state)
	Restore a state saved on a previous call to saveState. More...

void	restoreState (size_t lenstate, const doublereal *state)
	Restore the state of the phase from a previously saved state vector. More...

doublereal	molecularWeight (size_t k) const
	Molecular weight of species `k`. More...

void	getMolecularWeights (vector_fp &weights) const
	Copy the vector of molecular weights into vector weights. More...

void	getMolecularWeights (doublereal *weights) const
	Copy the vector of molecular weights into array weights. More...

const vector_fp &	molecularWeights () const
	Return a const reference to the internal vector of molecular weights. More...

doublereal	size (size_t k) const
	This routine returns the size of species k. More...

doublereal	charge (size_t k) const
	Dimensionless electrical charge of a single molecule of species k The charge is normalized by the the magnitude of the electron charge. More...

doublereal	chargeDensity () const
	Charge density [C/m^3]. More...

size_t	nDim () const
	Returns the number of spatial dimensions (1, 2, or 3) More...

void	setNDim (size_t ndim)
	Set the number of spatial dimensions (1, 2, or 3). More...

virtual void	freezeSpecies ()
	Call when finished adding species. More...

bool	speciesFrozen ()
	True if freezeSpecies has been called. More...

virtual bool	ready () const

int	stateMFNumber () const
	Return the State Mole Fraction Number. More...

Name and ID
Class Phase contains two strings that identify a phase. The ID is the value of the ID attribute of the XML phase node that is used to initialize a phase when it is read. The name field is also initialized to the value of the ID attribute of the XML phase node. However, the name field may be changed to another value during the course of a calculation. For example, if a phase is located in two places, but has the same constitutive input, the ids of the two phases will be the same, but the names of the two phases may be different. It is an error to have two phases in a single problem with the same name or the same id (or the name from one phase being the same as the id of another phase). Thus, it is expected that there is a 1-1 correspondence between names and unique phases within a Cantera problem.
std::string	id () const
	Return the string id for the phase. More...

void	setID (const std::string &id)
	Set the string id for the phase. More...

std::string	name () const
	Return the name of the phase. More...

void	setName (const std::string &nm)
	Sets the string name for the phase. More...

Element and Species Information
std::string	elementName (size_t m) const
	Name of the element with index m. More...

size_t	elementIndex (const std::string &name) const
	Return the index of element named 'name'. More...

const std::vector< std::string > &	elementNames () const
	Return a read-only reference to the vector of element names. More...

doublereal	atomicWeight (size_t m) const
	Atomic weight of element m. More...

doublereal	entropyElement298 (size_t m) const
	Entropy of the element in its standard state at 298 K and 1 bar. More...

int	atomicNumber (size_t m) const
	Atomic number of element m. More...

int	elementType (size_t m) const
	Return the element constraint type Possible types include: More...

int	changeElementType (int m, int elem_type)
	Change the element type of the mth constraint Reassigns an element type. More...

const vector_fp &	atomicWeights () const
	Return a read-only reference to the vector of atomic weights. More...

size_t	nElements () const
	Number of elements. More...

void	checkElementIndex (size_t m) const
	Check that the specified element index is in range Throws an exception if m is greater than nElements()-1. More...

void	checkElementArraySize (size_t mm) const
	Check that an array size is at least nElements() Throws an exception if mm is less than nElements(). More...

doublereal	nAtoms (size_t k, size_t m) const
	Number of atoms of element `m` in species `k`. More...

void	getAtoms (size_t k, double *atomArray) const
	Get a vector containing the atomic composition of species k. More...

size_t	speciesIndex (const std::string &name) const
	Returns the index of a species named 'name' within the Phase object. More...

std::string	speciesName (size_t k) const
	Name of the species with index k. More...

std::string	speciesSPName (int k) const
	Returns the expanded species name of a species, including the phase name This is guaranteed to be unique within a Cantera problem. More...

const std::vector< std::string > &	speciesNames () const
	Return a const reference to the vector of species names. More...

size_t	nSpecies () const
	Returns the number of species in the phase. More...

void	checkSpeciesIndex (size_t k) const
	Check that the specified species index is in range Throws an exception if k is greater than nSpecies()-1. More...

void	checkSpeciesArraySize (size_t kk) const
	Check that an array size is at least nSpecies() Throws an exception if kk is less than nSpecies(). More...

Set thermodynamic state
Set the internal thermodynamic state by setting the internally stored temperature, density and species composition. Note that the composition is always set first. Temperature and density are held constant if not explicitly set.
void	setMoleFractionsByName (compositionMap &xMap)
	Set the species mole fractions by name. More...

void	setMoleFractionsByName (const std::string &x)
	Set the mole fractions of a group of species by name. More...

void	setMassFractionsByName (compositionMap &yMap)
	Set the species mass fractions by name. More...

void	setMassFractionsByName (const std::string &x)
	Set the species mass fractions by name. More...

void	setState_TRX (doublereal t, doublereal dens, const doublereal *x)
	Set the internally stored temperature (K), density, and mole fractions. More...

void	setState_TRX (doublereal t, doublereal dens, compositionMap &x)
	Set the internally stored temperature (K), density, and mole fractions. More...

void	setState_TRY (doublereal t, doublereal dens, const doublereal *y)
	Set the internally stored temperature (K), density, and mass fractions. More...

void	setState_TRY (doublereal t, doublereal dens, compositionMap &y)
	Set the internally stored temperature (K), density, and mass fractions. More...

void	setState_TNX (doublereal t, doublereal n, const doublereal *x)
	Set the internally stored temperature (K), molar density (kmol/m^3), and mole fractions. More...

void	setState_TR (doublereal t, doublereal rho)
	Set the internally stored temperature (K) and density (kg/m^3) More...

void	setState_TX (doublereal t, doublereal *x)
	Set the internally stored temperature (K) and mole fractions. More...

void	setState_TY (doublereal t, doublereal *y)
	Set the internally stored temperature (K) and mass fractions. More...

void	setState_RX (doublereal rho, doublereal *x)
	Set the density (kg/m^3) and mole fractions. More...

void	setState_RY (doublereal rho, doublereal *y)
	Set the density (kg/m^3) and mass fractions. More...

Composition
void	getMoleFractionsByName (compositionMap &x) const
	Get the mole fractions by name. More...

doublereal	moleFraction (size_t k) const
	Return the mole fraction of a single species. More...

doublereal	moleFraction (const std::string &name) const
	Return the mole fraction of a single species. More...

doublereal	massFraction (size_t k) const
	Return the mass fraction of a single species. More...

doublereal	massFraction (const std::string &name) const
	Return the mass fraction of a single species. More...

void	getMoleFractions (doublereal *const x) const
	Get the species mole fraction vector. More...

virtual void	setMoleFractions (const doublereal *const x)
	Set the mole fractions to the specified values There is no restriction on the sum of the mole fraction vector. More...

virtual void	setMoleFractions_NoNorm (const doublereal *const x)
	Set the mole fractions to the specified values without normalizing. More...

void	getMassFractions (doublereal *const y) const
	Get the species mass fractions. More...

const doublereal *	massFractions () const
	Return a const pointer to the mass fraction array. More...

virtual void	setMassFractions (const doublereal *const y)
	Set the mass fractions to the specified values and normalize them. More...

virtual void	setMassFractions_NoNorm (const doublereal *const y)
	Set the mass fractions to the specified values without normalizing. More...

void	getConcentrations (doublereal *const c) const
	Get the species concentrations (kmol/m^3). More...

doublereal	concentration (const size_t k) const
	Concentration of species k. More...

virtual void	setConcentrations (const doublereal *const conc)
	Set the concentrations to the specified values within the phase. More...

const doublereal *	moleFractdivMMW () const
	Returns a const pointer to the start of the moleFraction/MW array. More...

Thermodynamic Properties
doublereal	temperature () const
	Temperature (K). More...

virtual doublereal	density () const
	Density (kg/m^3). More...

doublereal	molarDensity () const
	Molar density (kmol/m^3). More...

doublereal	molarVolume () const
	Molar volume (m^3/kmol). More...

virtual void	setDensity (const doublereal density_)
	Set the internally stored density (kg/m^3) of the phase Note the density of a phase is an independent variable. More...

virtual void	setMolarDensity (const doublereal molarDensity)
	Set the internally stored molar density (kmol/m^3) of the phase. More...

virtual void	setTemperature (const doublereal temp)
	Set the internally stored temperature of the phase (K). More...

Mean Properties
doublereal	mean_X (const doublereal *const Q) const
	Evaluate the mole-fraction-weighted mean of an array Q. More...

doublereal	mean_Y (const doublereal *const Q) const
	Evaluate the mass-fraction-weighted mean of an array Q. More...

doublereal	meanMolecularWeight () const
	The mean molecular weight. Units: (kg/kmol) More...

doublereal	sum_xlogx () const
	Evaluate \( \sum_k X_k \log X_k \). More...

doublereal	sum_xlogQ (doublereal *const Q) const
	Evaluate \( \sum_k X_k \log Q_k \). More...

Adding Elements and Species
These methods are used to add new elements or species. These are not usually called by user programs. Since species are checked to insure that they are only composed of declared elements, it is necessary to first add all elements before adding any species.
void	addElement (const std::string &symbol, doublereal weight=-12345.0)
	Add an element. More...

void	addElement (const XML_Node &e)
	Add an element from an XML specification. More...

void	addUniqueElement (const std::string &symbol, doublereal weight=-12345.0, int atomicNumber=0, doublereal entropy298=ENTROPY298_UNKNOWN, int elem_type=CT_ELEM_TYPE_ABSPOS)
	Add an element, checking for uniqueness The uniqueness is checked by comparing the string symbol. More...

void	addUniqueElement (const XML_Node &e)
	Add an element, checking for uniqueness The uniqueness is checked by comparing the string symbol. More...

void	addElementsFromXML (const XML_Node &phase)
	Add all elements referenced in an XML_Node tree. More...

void	freezeElements ()
	Prohibit addition of more elements, and prepare to add species. More...

bool	elementsFrozen ()
	True if freezeElements has been called. More...

size_t	addUniqueElementAfterFreeze (const std::string &symbol, doublereal weight, int atomicNumber, doublereal entropy298=ENTROPY298_UNKNOWN, int elem_type=CT_ELEM_TYPE_ABSPOS)
	Add an element after elements have been frozen, checking for uniqueness The uniqueness is checked by comparing the string symbol. More...

void	addSpecies (const std::string &name, const doublereal *comp, doublereal charge=0.0, doublereal size=1.0)

void	addUniqueSpecies (const std::string &name, const doublereal *comp, doublereal charge=0.0, doublereal size=1.0)
	Add a species to the phase, checking for uniqueness of the name This routine checks for uniqueness of the string name. More...

Protected Member Functions
void	init (const vector_fp &mw)

void	setMolecularWeight (const int k, const double mw)
	Set the molecular weight of a single species to a given value. More...

Protected Attributes
size_t	m_kk
	Number of species in the phase. More...

size_t	m_ndim
	Dimensionality of the phase. More...

vector_fp	m_speciesComp
	Atomic composition of the species. More...

vector_fp	m_speciesSize
	Vector of species sizes. More...

vector_fp	m_speciesCharge
	Vector of species charges. length m_kk. More...

Private Attributes
XML_Node *	m_xml
	XML node containing the XML info for this phase. More...

std::string	m_id
	ID of the phase. More...

std::string	m_name
	Name of the phase. More...

doublereal	m_temp
	Temperature (K). This is an independent variable. More...

doublereal	m_dens
	Density (kg m-3). More...

doublereal	m_mmw
	mean molecular weight of the mixture (kg kmol-1) More...

vector_fp	m_ym
	m_ym[k] = mole fraction of species k divided by the mean molecular weight of mixture. More...

vector_fp	m_y
	species mass fractions More...

vector_fp	m_molwts
	species molecular weights (kg kmol-1) More...

vector_fp	m_rmolwts
	inverse of species molecular weights (kmol kg-1) More...

int	m_stateNum
	State Change variable. More...

bool	m_speciesFrozen
	Boolean indicating whether the number of species has been frozen. More...

bool	m_elementsFrozen
	If this is true, then no elements may be added to the object. More...

std::vector< std::string >	m_speciesNames
	Vector of the species names. More...

size_t	m_mm
	Number of elements. More...

vector_fp	m_atomicWeights
	element atomic weights (kg kmol-1) More...

vector_int	m_atomicNumbers
	element atomic numbers More...

std::vector< std::string >	m_elementNames
	element names More...

vector_int	m_elem_type
	Vector of element types. More...

vector_fp	m_entropy298
	Entropy at 298.15 K and 1 bar of stable state pure elements (J kmol-1) More...

Detailed Description

Base class for phases of matter.

Class Phase manages the species and elements in a phase, as well as the independent variables of temperature, mass density, and species mass/mole fraction that define the thermodynamic state.

Class Phase provides information about the elements and species in a phase - names, index numbers (location in arrays), atomic or molecular weights, etc. The set of elements must include all those that compose the species, but may include additional elements.

It also stores an array of species molecular weights, which are used to convert between mole and mass representations of the composition. For efficiency in mass/mole conversion, the vector of mass fractions divided by molecular weight \( Y_k/M_k \) is also stored.

Class Phase is not usually used directly. Its primary use is as a base class for class ThermoPhase. It is not generally necessary to overloaded any of class Phase's methods, with the exception of incompressible phases. In that case, the density must be replaced by the pressure as the independent variable and functions such as setMassFraction within class Phase must actually now calculate the density (at constant T and P) instead of leaving it alone as befits an independent variable. This also applies for nearly- incompressible phases or phases which utilize standard states based on a T and P, in which case they need to overload these functions too.

Class Phase contains a number of utility functions that will set the state of the phase in its entirety, by first setting the composition, then the temperature and then the density. An example of this is the function Phase::setState_TRY(double t, double dens, const double* y).

Class Phase contains method for saving and restoring the full internal states of each phase. These are saveState() and restoreState(). These functions operate on a state vector, which is in general of length (2 + nSpecies()). The first two entries of the state vector are temperature and density.

A species name may be referred to via three methods:

"speciesName"
"PhaseId:speciesName"
"phaseName:speciesName"

The first two methods of naming may not yield a unique species within complicated assemblies of Cantera Phases.

Todo:: Make the concept of saving state vectors more general, so that it can handle other cases where there are additional internal state variables, such as the voltage, a potential energy, or a strain field.

Definition at line 98 of file Phase.h.

Constructor & Destructor Documentation

Phase ( )

Default constructor.

Definition at line 18 of file Phase.cpp.

~Phase ( )

virtual

Destructor.

Definition at line 106 of file Phase.cpp.

References Phase::m_xml.

Phase ( const Phase & right )

Copy Constructor.

Parameters

right Reference to the class to be used in the copy

Definition at line 35 of file Phase.cpp.

References Phase::operator=().

Member Function Documentation

Phase & operator= ( const Phase & right )

Assignment operator.

Parameters

right Reference to the class to be used in the copy

Definition at line 54 of file Phase.cpp.

References Phase::m_atomicNumbers, Phase::m_atomicWeights, Phase::m_dens, Phase::m_elem_type, Phase::m_elementNames, Phase::m_elementsFrozen, Phase::m_entropy298, Phase::m_id, Phase::m_kk, Phase::m_mm, Phase::m_mmw, Phase::m_molwts, Phase::m_name, Phase::m_ndim, Phase::m_rmolwts, Phase::m_speciesCharge, Phase::m_speciesComp, Phase::m_speciesFrozen, Phase::m_speciesNames, Phase::m_speciesSize, Phase::m_stateNum, Phase::m_temp, Phase::m_xml, Phase::m_y, and Phase::m_ym.

Referenced by Phase::Phase().

XML_Node & xml ( )

Returns a reference to the XML_Node stored for the phase.

The XML_Node for the phase contains all of the input data used to set up the model for the phase, during its initialization.

Definition at line 114 of file Phase.cpp.

References Phase::m_xml.

Referenced by IonsFromNeutralVPSSTP::constructPhaseFile(), Cantera::importPhase(), SimpleTransport::initLiquid(), TransportFactory::newTransport(), TransportFactory::setupLiquidTransport(), and TransportFactory::setupSolidTransport().

std::string id ( ) const

Return the string id for the phase.

Definition at line 119 of file Phase.cpp.

References Phase::m_id.

Referenced by Kinetics::assignShallowPointers(), Cantera::equilibrate(), Cantera::getEfficiencies(), Cantera::importPhase(), LatticeSolidPhase::installSlavePhases(), Kinetics::kineticsSpeciesIndex(), MultiPhase::phaseIndex(), MultiPhase::phaseName(), solveProb::print_header(), LatticeSolidPhase::setParametersFromXML(), vcs_VolPhase::transferElementsFM(), and Cantera::vcs_equilibrate().

void setID ( const std::string & id )

Set the string id for the phase.

Parameters

id	String id of the phase

Definition at line 124 of file Phase.cpp.

References Phase::m_id.

Referenced by FixedChemPotSSTP::FixedChemPotSSTP(), and Cantera::importPhase().

std::string name ( ) const

Return the name of the phase.

Definition at line 129 of file Phase.cpp.

References Phase::m_name.

Referenced by Cantera::operator<<(), PseudoBinaryVPSSTP::report(), MolarityIonicVPSSTP::report(), PureFluidPhase::report(), MolalityVPSSTP::report(), ThermoPhase::report(), vcs_MultiPhaseEquil::reportCSV(), TransportFactory::setupSolidTransport(), and VCSnonideal::vcs_Cantera_to_vprob().

void setName ( const std::string & nm )

Sets the string name for the phase.

Parameters

nm	String name of the phase

Definition at line 134 of file Phase.cpp.

References Phase::m_name.

Referenced by FixedChemPotSSTP::FixedChemPotSSTP(), and Cantera::importPhase().

string elementName ( size_t m ) const

Name of the element with index m.

Parameters

m	Element index.

Definition at line 158 of file Phase.cpp.

References Phase::checkElementIndex(), and Phase::m_elementNames.

Referenced by MultiPhase::addPhase(), Cantera::checkRxnElementBalance(), Cantera::convertDGFormation(), PDSS_HKFT::convertDGFormation(), ChemEquil::equilibrate(), ChemEquil::equilResidual(), ChemEquil::estimateElementPotentials(), ChemEquil::estimateEP_Brinkley(), MolalityVPSSTP::findCLMIndex(), ChemEquil::initialize(), LatticeSolidPhase::installSlavePhases(), Cantera::installSpecies(), ChemEquil::setInitialMoles(), and vcs_VolPhase::transferElementsFM().

size_t elementIndex ( const std::string & name ) const

Return the index of element named 'name'.

The index is an integer assigned to each element in the order it was added. Returns npos if the specified element is not found.

Parameters

name	Name of the element

Definition at line 164 of file Phase.cpp.

References Phase::m_elementNames, Phase::m_mm, and Cantera::npos.

Referenced by Phase::addUniqueElementAfterFreeze(), MultiPhase::init(), WaterSSTP::initThermoXML(), LatticeSolidPhase::installSlavePhases(), Cantera::installSpecies(), Cantera::LookupGe(), and PDSS_HKFT::LookupGe().

const vector< string > & elementNames ( ) const

Return a read-only reference to the vector of element names.

Definition at line 174 of file Phase.cpp.

References Phase::m_elementNames.

Referenced by ChemEquil::equilibrate(), ChemEquil::estimateEP_Brinkley(), and IonsFromNeutralVPSSTP::initThermoXML().

doublereal atomicWeight ( size_t m ) const

Atomic weight of element m.

Parameters

m	Element index

Definition at line 179 of file Phase.cpp.

References Phase::m_atomicWeights.

Referenced by ChemEquil::initialize(), and WaterSSTP::initThermoXML().

doublereal entropyElement298 ( size_t m ) const

Entropy of the element in its standard state at 298 K and 1 bar.

Parameters

m	Element index

Definition at line 184 of file Phase.cpp.

References AssertThrowMsg, AssertTrace, ENTROPY298_UNKNOWN, Phase::m_entropy298, and Phase::m_mm.

Referenced by LatticeSolidPhase::installSlavePhases(), Cantera::LookupGe(), and PDSS_HKFT::LookupGe().

int atomicNumber ( size_t m ) const

Atomic number of element m.

Parameters

m	Element index

Definition at line 198 of file Phase.cpp.

References Phase::m_atomicNumbers.

Referenced by MultiPhase::addPhase(), and LatticeSolidPhase::installSlavePhases().

int elementType ( size_t m ) const

Return the element constraint type Possible types include:

CT_ELEM_TYPE_TURNEDOFF -1 CT_ELEM_TYPE_ABSPOS 0 CT_ELEM_TYPE_ELECTRONCHARGE 1 CT_ELEM_TYPE_CHARGENEUTRALITY 2 CT_ELEM_TYPE_LATTICERATIO 3 CT_ELEM_TYPE_KINETICFROZEN 4 CT_ELEM_TYPE_SURFACECONSTRAINT 5 CT_ELEM_TYPE_OTHERCONSTRAINT 6

The default is CT_ELEM_TYPE_ABSPOS.

Parameters

m	Element index

Returns: Returns the element type

Definition at line 203 of file Phase.cpp.

References Phase::m_elem_type.

Referenced by LatticeSolidPhase::installSlavePhases(), and vcs_VolPhase::transferElementsFM().

int changeElementType	(	int	m,
		int	elem_type
	)

Change the element type of the mth constraint Reassigns an element type.

Parameters

m	Element index
elem_type	New elem type to be assigned

Returns: Returns the old element type

Definition at line 208 of file Phase.cpp.

References Phase::m_elem_type.

const vector_fp & atomicWeights ( ) const

Return a read-only reference to the vector of atomic weights.

Definition at line 193 of file Phase.cpp.

References Phase::m_atomicWeights.

Referenced by LatticeSolidPhase::installSlavePhases().

size_t nElements ( ) const

Number of elements.

Definition at line 139 of file Phase.cpp.

References Phase::m_mm.

Referenced by MultiPhase::addPhase(), Cantera::checkRxnElementBalance(), Cantera::convertDGFormation(), PDSS_HKFT::convertDGFormation(), ChemEquil::equilibrate(), MolalityVPSSTP::findCLMIndex(), FixedChemPotSSTP::FixedChemPotSSTP(), ThermoPhase::getElementPotentials(), ChemEquil::initialize(), IonsFromNeutralVPSSTP::initThermoXML(), LatticeSolidPhase::installSlavePhases(), Cantera::installSpecies(), ThermoPhase::setElementPotentials(), IdealSolidSolnPhase::setToEquilState(), vcs_VolPhase::transferElementsFM(), and VCSnonideal::vcs_Cantera_to_vprob().

void checkElementIndex ( size_t m ) const

Check that the specified element index is in range Throws an exception if m is greater than nElements()-1.

Definition at line 144 of file Phase.cpp.

References Phase::m_mm.

Referenced by Phase::elementName(), and Phase::nAtoms().

void checkElementArraySize ( size_t mm ) const

Check that an array size is at least nElements() Throws an exception if mm is less than nElements().

Used before calls which take an array pointer.

Definition at line 151 of file Phase.cpp.

References Phase::m_mm.

doublereal nAtoms	(	size_t	k,
		size_t	m
	)		const

Number of atoms of element m in species k.

Parameters

k	species index
m	element index

Definition at line 215 of file Phase.cpp.

References Phase::checkElementIndex(), Phase::checkSpeciesIndex(), Phase::m_mm, and Phase::m_speciesComp.

Referenced by Cantera::checkRxnElementBalance(), Cantera::convertDGFormation(), PDSS_HKFT::convertDGFormation(), MolalityVPSSTP::findCLMIndex(), MultiPhase::init(), ChemEquil::initialize(), IonsFromNeutralVPSSTP::initThermoXML(), IdealSolidSolnPhase::setToEquilState(), and vcs_VolPhase::transferElementsFM().

void getAtoms	(	size_t	k,
		double *	atomArray
	)		const

Get a vector containing the atomic composition of species k.

Parameters

k	species index
atomArray	vector containing the atomic number in the species. Length: m_mm

Definition at line 222 of file Phase.cpp.

References Phase::m_mm, and Phase::m_speciesComp.

Referenced by LatticeSolidPhase::installSlavePhases().

size_t speciesIndex ( const std::string & name ) const

Returns the index of a species named 'name' within the Phase object.

The first species in the phase will have an index 0, and the last one will have an index of nSpecies() - 1.

Parameters

name	String name of the species. It may also be in the form phaseName:speciesName

Returns: The index of the species. If the name is not found, the value npos is returned.

Definition at line 229 of file Phase.cpp.

References Phase::m_id, Phase::m_kk, Phase::m_name, Phase::m_speciesNames, Cantera::npos, and Cantera::parseSpeciesName().

Referenced by ConstPressureReactor::componentIndex(), FlowReactor::componentIndex(), Reactor::componentIndex(), PDSS_IonsFromNeutral::constructPDSSXML(), TransportFactory::getLiquidInteractionsTransportData(), TransportFactory::getLiquidSpeciesTransportData(), Cantera::getStick(), HMWSoln::HMWSoln(), Cantera::importSolution(), LiquidTranInteraction::init(), DebyeHuckel::initThermoXML(), FlowDevice::install(), Kinetics::kineticsSpeciesIndex(), MargulesVPSSTP::MargulesVPSSTP(), Phase::massFraction(), MixedSolventElectrolyte::MixedSolventElectrolyte(), Phase::moleFraction(), PhaseCombo_Interaction::PhaseCombo_Interaction(), RedlichKisterVPSSTP::readXMLBinarySpecies(), MixedSolventElectrolyte::readXMLBinarySpecies(), MargulesVPSSTP::readXMLBinarySpecies(), PhaseCombo_Interaction::readXMLBinarySpecies(), RedlichKwongMFTP::readXMLCrossFluid(), RedlichKwongMFTP::readXMLPureFluid(), RedlichKisterVPSSTP::RedlichKisterVPSSTP(), MolalityVPSSTP::report(), StFlow::restore(), Inlet1D::restore(), OutletRes1D::restore(), ReactingSurf1D::restore(), and Kinetics::speciesPhase().

string speciesName ( size_t k ) const

Name of the species with index k.

Parameters

k	index of the species

Definition at line 246 of file Phase.cpp.

References Phase::checkSpeciesIndex(), and Phase::m_speciesNames.

Referenced by StFlow::componentName(), ReactingSurf1D::componentName(), ChemEquil::estimateElementPotentials(), ChemEquil::estimateEP_Brinkley(), MolalityVPSSTP::findCLMIndex(), TransportFactory::fitProperties(), AqueousTransport::getLiquidTransportData(), Phase::getMoleFractionsByName(), Cantera::importSolution(), MultiPhase::init(), ChemEquil::initialize(), LiquidTransport::initLiquid(), SimpleTransport::initLiquid(), IdealMolalSoln::initThermoXML(), DebyeHuckel::initThermoXML(), FlowDevice::install(), LatticeSolidPhase::installSlavePhases(), Kinetics::kineticsSpeciesName(), solveProb::print_header(), HMWSoln::printCoeffs(), PecosTransport::read_blottner_transport_table(), RedlichKisterVPSSTP::readXMLBinarySpecies(), MixedSolventElectrolyte::readXMLBinarySpecies(), MargulesVPSSTP::readXMLBinarySpecies(), PhaseCombo_Interaction::readXMLBinarySpecies(), MolalityVPSSTP::report(), ThermoPhase::report(), vcs_MultiPhaseEquil::reportCSV(), ThermoPhase::reportCSV(), StFlow::restore(), HMWSoln::s_updatePitzer_d2lnMolalityActCoeff_dT2(), HMWSoln::s_updatePitzer_dlnMolalityActCoeff_dP(), HMWSoln::s_updatePitzer_dlnMolalityActCoeff_dT(), HMWSoln::s_updatePitzer_lnMolalityActCoeff(), StFlow::save(), Inlet1D::save(), OutletRes1D::save(), ReactingSurf1D::save(), SurfPhase::setCoveragesByName(), ChemEquil::setInitialMoles(), Phase::setMassFractionsByName(), MolalityVPSSTP::setMolalitiesByName(), Phase::setMoleFractionsByName(), Transport::setThermo(), Inlet1D::showSolution(), ReactingSurf1D::showSolution(), Phase::speciesSPName(), and ChemEquil::update().

std::string speciesSPName ( int k ) const

Returns the expanded species name of a species, including the phase name This is guaranteed to be unique within a Cantera problem.

Parameters

k	Species index within the phase

Returns: The "phaseName:speciesName" string

Definition at line 271 of file Phase.cpp.

References Phase::m_name, and Phase::speciesName().

const vector< string > & speciesNames ( ) const

size_t nSpecies ( ) const

inline

Returns the number of species in the phase.

Definition at line 252 of file Phase.h.

References Phase::m_kk.

Referenced by MultiPhase::addPhase(), InterfaceKinetics::applyButlerVolmerCorrection(), Kinetics::assignShallowPointers(), MultiPhase::calcElemAbundances(), Phase::chargeDensity(), ConstPressureReactor::componentIndex(), Reactor::componentIndex(), MultiPhaseEquil::computeReactionSteps(), PDSS_IonsFromNeutral::constructPDSSXML(), RedlichKisterVPSSTP::cp_mole(), MixedSolventElectrolyte::cp_mole(), MargulesVPSSTP::cp_mole(), PhaseCombo_Interaction::cp_mole(), SolidTransport::electricalConductivity(), RedlichKisterVPSSTP::enthalpy_mole(), MixedSolventElectrolyte::enthalpy_mole(), MargulesVPSSTP::enthalpy_mole(), PhaseCombo_Interaction::enthalpy_mole(), RedlichKisterVPSSTP::entropy_mole(), MixedSolventElectrolyte::entropy_mole(), MargulesVPSSTP::entropy_mole(), PhaseCombo_Interaction::entropy_mole(), ChemEquil::equilibrate(), vcs_MultiPhaseEquil::equilibrate_TP(), ChemEquil::estimateElementPotentials(), ConstPressureReactor::evalEqs(), IdealGasReactor::evalEqs(), IdealGasConstPressureReactor::evalEqs(), Reactor::evalEqs(), ThermoPhase::getActivities(), MetalPhase::getActivityConcentrations(), MetalPhase::getChemPotentials(), ImplicitSurfChem::getConcSpecies(), MolalityVPSSTP::getCsvReportData(), ThermoPhase::getCsvReportData(), MetalPhase::getEnthalpy_RT(), MetalPhase::getEntropy_R(), AqueousKinetics::getEquilibriumConstants(), InterfaceKinetics::getEquilibriumConstants(), IdealGasReactor::getInitialConditions(), ConstPressureReactor::getInitialConditions(), IdealGasConstPressureReactor::getInitialConditions(), Reactor::getInitialConditions(), MultiTransport::getMassFluxes(), LTI_Pairwise_Interaction::getMatrixTransProp(), LTI_StefanMaxwell_PPN::getMatrixTransProp(), SolidTransport::getMixDiffCoeffs(), LTI_MoleFracs::getMixTransProp(), LTI_MassFracs::getMixTransProp(), LTI_Log_MoleFracs::getMixTransProp(), LTI_Pairwise_Interaction::getMixTransProp(), LTI_StefanMaxwell_PPN::getMixTransProp(), LTI_MoleFracs_ExpT::getMixTransProp(), SolidTransport::getMobilities(), MultiTransport::getMolarFluxes(), Phase::getMoleFractionsByName(), MultiPhase::getMoles(), MetalPhase::getStandardChemPotentials(), VCSnonideal::hasChargedSpecies(), ImplicitSurfChem::ImplicitSurfChem(), Cantera::importSolution(), LiquidTranInteraction::init(), GasKinetics::init(), AqueousKinetics::init(), MultiPhase::init(), InterfaceKinetics::init(), GasTransport::initGas(), PecosTransport::initGas(), ChemEquil::initialize(), DustyGasTransport::initialize(), PseudoBinaryVPSSTP::initLengths(), MolarityIonicVPSSTP::initLengths(), IdealSolnGasVPSS::initLengths(), GibbsExcessVPSSTP::initLengths(), VPStandardStateTP::initLengths(), IonsFromNeutralVPSSTP::initLengths(), RedlichKisterVPSSTP::initLengths(), MixtureFugacityTP::initLengths(), MixedSolventElectrolyte::initLengths(), MargulesVPSSTP::initLengths(), VPSSMgr::initLengths(), PhaseCombo_Interaction::initLengths(), MolalityVPSSTP::initLengths(), IdealMolalSoln::initLengths(), DebyeHuckel::initLengths(), HMWSoln::initLengths(), LiquidTransport::initLiquid(), SimpleTransport::initLiquid(), AqueousTransport::initLiquid(), ConstDensityThermo::initThermo(), StoichSubstanceSSTP::initThermo(), SingleSpeciesTP::initThermo(), FlowDevice::install(), rxninfo::installReaction(), LatticeSolidPhase::installSlavePhases(), IonsFromNeutralVPSSTP::IonsFromNeutralVPSSTP(), Kinetics::nTotalSpecies(), solveProb::print_header(), PseudoBinaryVPSSTP::report(), MolarityIonicVPSSTP::report(), MolalityVPSSTP::report(), ThermoPhase::report(), vcs_MultiPhaseEquil::reportCSV(), ThermoPhase::reportCSV(), StFlow::restore(), Phase::restoreState(), IonsFromNeutralVPSSTP::s_update_dlnActCoeff_dlnN(), Phase::saveState(), Kinetics::selectPhase(), ImplicitSurfChem::setConcSpecies(), SurfPhase::setCoveragesByName(), Wall::setKinetics(), Phase::setMassFractionsByName(), MolalityVPSSTP::setMolalitiesByName(), Phase::setMoleFractionsByName(), MultiPhase::setMoles(), SolidTransport::setParameters(), LTI_Pairwise_Interaction::setParameters(), LTI_StefanMaxwell_PPN::setParameters(), MultiPhase::setPhaseMoleFractions(), Transport::setThermo(), ReactorBase::setThermoMgr(), TransportFactory::setupLiquidTransport(), TransportFactory::setupMM(), TransportFactory::setupSolidTransport(), Inlet1D::showSolution(), solveSP::solveSP(), StFlow::StFlow(), vcs_VolPhase::transferElementsFM(), AqueousKinetics::updateKc(), InterfaceKinetics::updateKc(), ConstPressureReactor::updateState(), IdealGasReactor::updateState(), IdealGasConstPressureReactor::updateState(), Reactor::updateState(), MultiPhase::uploadMoleFractionsFromPhases(), VCSnonideal::vcs_Cantera_to_vprob(), and VCSnonideal::vcs_Cantera_update_vprob().

void checkSpeciesIndex ( size_t k ) const

Check that the specified species index is in range Throws an exception if k is greater than nSpecies()-1.

Definition at line 257 of file Phase.cpp.

References Phase::m_kk.

Referenced by Phase::concentration(), Phase::massFraction(), Phase::molecularWeight(), Phase::moleFraction(), Phase::nAtoms(), and Phase::speciesName().

void checkSpeciesArraySize ( size_t kk ) const

Check that an array size is at least nSpecies() Throws an exception if kk is less than nSpecies().

Used before calls which take an array pointer.

Definition at line 264 of file Phase.cpp.

References Phase::m_kk.

void saveState ( vector_fp & state ) const

Save the current internal state of the phase Write to vector 'state' the current internal state.

Parameters

state output vector. Will be resized to nSpecies() + 2.

Definition at line 277 of file Phase.cpp.

References Phase::nSpecies().

Referenced by ChemEquil::equilibrate(), ChemEquil::estimateEP_Brinkley(), TransportFactory::newTransport(), ReactorBase::setThermoMgr(), FlowReactor::updateState(), ConstPressureReactor::updateState(), and Reactor::updateState().

void saveState	(	size_t	lenstate,
		doublereal *	state
	)		const

Write to array 'state' the current internal state.

Parameters

lenstate	length of the state array. Must be >= nSpecies()+2
state	output vector. Must be of length nSpecies() + 2 or greater.

Definition at line 282 of file Phase.cpp.

References Phase::density(), Phase::getMassFractions(), and Phase::temperature().

void restoreState ( const vector_fp & state )

Restore a state saved on a previous call to saveState.

Parameters

state State vector containing the previously saved state.

Definition at line 289 of file Phase.cpp.

Referenced by ChemEquil::equilibrate(), ChemEquil::estimateEP_Brinkley(), FlowReactor::evalEqs(), ConstPressureReactor::evalEqs(), Reactor::evalEqs(), FlowReactor::getInitialConditions(), ConstPressureReactor::getInitialConditions(), Reactor::getInitialConditions(), MultiTransport::getMassFluxes(), FlowReactor::initialize(), ConstPressureReactor::initialize(), Reactor::initialize(), TransportFactory::newTransport(), and ReactorBase::restoreState().

void restoreState	(	size_t	lenstate,
		const doublereal *	state
	)

Restore the state of the phase from a previously saved state vector.

Parameters

lenstate	Length of the state vector
state	Vector of state conditions.

Definition at line 294 of file Phase.cpp.

References Phase::nSpecies(), Phase::setDensity(), Phase::setMassFractions_NoNorm(), and Phase::setTemperature().

void setMoleFractionsByName ( compositionMap & xMap )

Set the species mole fractions by name.

Species not listed by name in xMap are set to zero.

Parameters

xMap	map from species names to mole fraction values.

Definition at line 354 of file Phase.cpp.

References Phase::nSpecies(), Phase::setMoleFractions(), and Phase::speciesName().

Referenced by Inlet1D::setMoleFractions(), OutletRes1D::setMoleFractions(), Phase::setMoleFractionsByName(), ThermoPhase::setState_TPX(), Phase::setState_TRX(), MixtureFugacityTP::setStateFromXML(), and ThermoPhase::setStateFromXML().

void setMoleFractionsByName ( const std::string & x )

Set the mole fractions of a group of species by name.

Species which are not listed by name in the composition map are set to zero.

Parameters

x	string x in the form of a composition map

Definition at line 368 of file Phase.cpp.

References Cantera::parseCompString(), Phase::setMoleFractionsByName(), and Phase::speciesNames().

void setMassFractionsByName ( compositionMap & yMap )

Set the species mass fractions by name.

Species not listed by name in yMap are set to zero.

Parameters

yMap	map from species names to mass fraction values.

Definition at line 399 of file Phase.cpp.

References Phase::nSpecies(), Phase::setMassFractions(), and Phase::speciesName().

Referenced by Phase::setMassFractionsByName(), ThermoPhase::setState_TPY(), Phase::setState_TRY(), MixtureFugacityTP::setStateFromXML(), and ThermoPhase::setStateFromXML().

void setMassFractionsByName ( const std::string & x )

Set the species mass fractions by name.

Species not listed by name in x are set to zero.

Parameters

x	String containing a composition map

Definition at line 413 of file Phase.cpp.

References Cantera::parseCompString(), Phase::setMassFractionsByName(), and Phase::speciesNames().

void setState_TRX	(	doublereal	t,
		doublereal	dens,
		const doublereal *	x
	)

Set the internally stored temperature (K), density, and mole fractions.

Parameters

t	Temperature in kelvin
dens	Density (kg/m^3)
x	vector of species mole fractions, length m_kk

Definition at line 419 of file Phase.cpp.

References Phase::setDensity(), Phase::setMoleFractions(), and Phase::setTemperature().

void setState_TRX	(	doublereal	t,
		doublereal	dens,
		compositionMap &	x
	)

Set the internally stored temperature (K), density, and mole fractions.

Parameters

t	Temperature in kelvin
dens	Density (kg/m^3)
x	Composition Map containing the mole fractions. Species not included in the map are assumed to have a zero mole fraction.

Definition at line 433 of file Phase.cpp.

References Phase::setDensity(), Phase::setMoleFractionsByName(), and Phase::setTemperature().

void setState_TRY	(	doublereal	t,
		doublereal	dens,
		const doublereal *	y
	)

Set the internally stored temperature (K), density, and mass fractions.

Parameters

t	Temperature in kelvin
dens	Density (kg/m^3)
y	vector of species mass fractions, length m_kk

Definition at line 440 of file Phase.cpp.

References Phase::setDensity(), Phase::setMassFractions(), and Phase::setTemperature().

void setState_TRY	(	doublereal	t,
		doublereal	dens,
		compositionMap &	y
	)

Set the internally stored temperature (K), density, and mass fractions.

Parameters

t	Temperature in kelvin
dens	Density (kg/m^3)
y	Composition Map containing the mass fractions. Species not included in the map are assumed to have a zero mass fraction.

Definition at line 447 of file Phase.cpp.

References Phase::setDensity(), Phase::setMassFractionsByName(), and Phase::setTemperature().

void setState_TNX	(	doublereal	t,
		doublereal	n,
		const doublereal *	x
	)

Set the internally stored temperature (K), molar density (kmol/m^3), and mole fractions.

Parameters

t	Temperature in kelvin
n	molar density (kmol/m^3)
x	vector of species mole fractions, length m_kk

Definition at line 426 of file Phase.cpp.

References Phase::setMolarDensity(), Phase::setMoleFractions(), and Phase::setTemperature().

void setState_TR	(	doublereal	t,
		doublereal	rho
	)

Set the internally stored temperature (K) and density (kg/m^3)

Parameters

t	Temperature in kelvin
rho	Density (kg/m^3)

Definition at line 454 of file Phase.cpp.

References Phase::setDensity(), and Phase::setTemperature().

Referenced by PureFluidPhase::setState_HP(), PureFluidPhase::setState_SP(), PureFluidPhase::setState_SV(), PureFluidPhase::setState_UV(), and Reactor::updateState().

void setState_TX	(	doublereal	t,
		doublereal *	x
	)

Set the internally stored temperature (K) and mole fractions.

Parameters

t	Temperature in kelvin
x	vector of species mole fractions, length m_kk

Definition at line 460 of file Phase.cpp.

References Phase::setMoleFractions(), and Phase::setTemperature().

void setState_TY	(	doublereal	t,
		doublereal *	y
	)

Set the internally stored temperature (K) and mass fractions.

Parameters

t	Temperature in kelvin
y	vector of species mass fractions, length m_kk

Definition at line 466 of file Phase.cpp.

References Phase::setMassFractions(), and Phase::setTemperature().

void setState_RX	(	doublereal	rho,
		doublereal *	x
	)

Set the density (kg/m^3) and mole fractions.

Parameters

rho	Density (kg/m^3)
x	vector of species mole fractions, length m_kk

Definition at line 472 of file Phase.cpp.

References Phase::setDensity(), and Phase::setMoleFractions().

void setState_RY	(	doublereal	rho,
		doublereal *	y
	)

Set the density (kg/m^3) and mass fractions.

Parameters

rho	Density (kg/m^3)
y	vector of species mass fractions, length m_kk

Definition at line 478 of file Phase.cpp.

References Phase::setDensity(), and Phase::setMassFractions().

doublereal molecularWeight ( size_t k ) const

Molecular weight of species k.

Parameters

k	index of species `k`

Returns: Returns the molecular weight of species k.

Definition at line 484 of file Phase.cpp.

References Phase::checkSpeciesIndex(), and Phase::m_molwts.

Referenced by VPSSMgr_Water_ConstVol::_updateRefStateThermo(), VPSSMgr_Water_HKFT::_updateRefStateThermo(), VPSSMgr_Water_ConstVol::_updateStandardStateThermo(), VPSSMgr_Water_HKFT::_updateStandardStateThermo(), SingleSpeciesTP::cv_mole(), SingleSpeciesTP::getPartialMolarVolumes(), SingleSpeciesTP::getStandardVolumes(), VPSSMgr_Water_ConstVol::getStandardVolumes_ref(), PDSS::initThermo(), VPSSMgr_Water_ConstVol::initThermoXML(), VPSSMgr_Water_HKFT::initThermoXML(), PDSS_ConstVol::initThermoXML(), PDSS_SSVol::initThermoXML(), MineralEQ3::initThermoXML(), MolalityVPSSTP::setSolvent(), LiquidTransport::stefan_maxwell_solve(), and VCSnonideal::vcs_Cantera_to_vprob().

void getMolecularWeights ( vector_fp & weights ) const

Copy the vector of molecular weights into vector weights.

Parameters

weights Output vector of molecular weights (kg/kmol)

Definition at line 490 of file Phase.cpp.

References Phase::molecularWeights().

void getMolecularWeights ( doublereal * weights ) const

Copy the vector of molecular weights into array weights.

Parameters

weights Output array of molecular weights (kg/kmol)

Definition at line 499 of file Phase.cpp.

References Phase::molecularWeights().

const vector_fp & molecularWeights ( ) const

Return a const reference to the internal vector of molecular weights.

units = kg / kmol

Definition at line 505 of file Phase.cpp.

References Phase::m_molwts.

Referenced by ReactingSurf1D::eval(), FlowReactor::evalEqs(), ConstPressureReactor::evalEqs(), Reactor::evalEqs(), Phase::freezeSpecies(), Phase::getMolecularWeights(), PecosTransport::getSpeciesFluxes(), MixTransport::getSpeciesFluxes(), AqueousTransport::getSpeciesFluxesExt(), SimpleTransport::getSpeciesFluxesExt(), Cantera::getStick(), GasTransport::initGas(), PecosTransport::initGas(), DustyGasTransport::initialize(), LiquidTransport::initLiquid(), SimpleTransport::initLiquid(), AqueousTransport::initLiquid(), TransportFactory::setupLiquidTransport(), TransportFactory::setupMM(), TransportFactory::setupSolidTransport(), AqueousTransport::stefan_maxwell_solve(), LiquidTransport::stefan_maxwell_solve(), and StFlow::StFlow().

doublereal size ( size_t k ) const

inline

This routine returns the size of species k.

Parameters

k	index of the species

Returns: The size of the species. Units are meters.

Definition at line 398 of file Phase.h.

References Phase::m_speciesSize.

Referenced by ReactingSurf1D::eval(), ConstPressureReactor::evalEqs(), IdealGasReactor::evalEqs(), IdealGasConstPressureReactor::evalEqs(), Reactor::evalEqs(), SurfPhase::getCoverages(), SurfPhase::initThermo(), MolarityIonicVPSSTP::initThermoXML(), PhaseCombo_Interaction::initThermoXML(), LatticeSolidPhase::installSlavePhases(), SurfPhase::setCoverages(), SurfPhase::setCoveragesNoNorm(), and SurfPhase::standardConcentration().

void getMoleFractionsByName ( compositionMap & x ) const

Get the mole fractions by name.

Parameters

[out] x composition map containing the species mole fractions.

Definition at line 510 of file Phase.cpp.

References Phase::moleFraction(), Phase::nSpecies(), and Phase::speciesName().

doublereal moleFraction ( size_t k ) const

Return the mole fraction of a single species.

Parameters

k	species index

Returns: Mole fraction of the species

Definition at line 524 of file Phase.cpp.

References Phase::checkSpeciesIndex(), Phase::m_mmw, and Phase::m_ym.

doublereal moleFraction ( const std::string & name ) const

Return the mole fraction of a single species.

Parameters

name	String name of the species

Returns: Mole fraction of the species

Definition at line 530 of file Phase.cpp.

References Phase::moleFraction(), Cantera::npos, and Phase::speciesIndex().

doublereal massFraction ( size_t k ) const

Return the mass fraction of a single species.

Parameters

k	species index

Returns: Mass fraction of the species

Definition at line 545 of file Phase.cpp.

References Phase::checkSpeciesIndex(), and Phase::m_y.

doublereal massFraction ( const std::string & name ) const

Return the mass fraction of a single species.

Parameters

name	String name of the species

Returns: Mass Fraction of the species

Definition at line 551 of file Phase.cpp.

References Phase::massFractions(), Cantera::npos, and Phase::speciesIndex().

void getMoleFractions ( doublereal *const x ) const

Get the species mole fraction vector.

Parameters

x	On return, x contains the mole fractions. Must have a length greater than or equal to the number of species.

Definition at line 519 of file Phase.cpp.

References Phase::m_mmw, Phase::m_ym, and Cantera::scale().

Referenced by IdealMolalSoln::calcDensity(), DebyeHuckel::calcDensity(), HMWSoln::calcDensity(), IonsFromNeutralVPSSTP::calcIonMoleFractions(), MolalityVPSSTP::calcMolalities(), HMWSoln::calcMolalitiesCropped(), IdealMolalSoln::enthalpy_mole(), HMWSoln::enthalpy_mole(), ChemEquil::estimateElementPotentials(), ChemEquil::estimateEP_Brinkley(), GibbsExcessVPSSTP::getActivities(), LatticePhase::getActivityConcentrations(), MolalityVPSSTP::getCsvReportData(), ThermoPhase::getCsvReportData(), MultiTransport::getMassFluxes(), LTI_Pairwise_Interaction::getMatrixTransProp(), LTI_StefanMaxwell_PPN::getMatrixTransProp(), LTI_MoleFracs::getMixTransProp(), LTI_Log_MoleFracs::getMixTransProp(), LTI_Pairwise_Interaction::getMixTransProp(), LTI_StefanMaxwell_PPN::getMixTransProp(), LTI_MoleFracs_ExpT::getMixTransProp(), LatticeSolidPhase::getMoleFractions(), DustyGasTransport::initialize(), GibbsExcessVPSSTP::initThermo(), HMWSoln::printCoeffs(), HMWSoln::relative_molal_enthalpy(), PseudoBinaryVPSSTP::report(), MolarityIonicVPSSTP::report(), MolalityVPSSTP::report(), ThermoPhase::report(), ThermoPhase::reportCSV(), MixtureFugacityTP::setConcentrations(), GibbsExcessVPSSTP::setConcentrations(), MixtureFugacityTP::setMassFractions(), GibbsExcessVPSSTP::setMassFractions(), MixtureFugacityTP::setMassFractions_NoNorm(), GibbsExcessVPSSTP::setMassFractions_NoNorm(), MolalityVPSSTP::setMolalitiesByName(), MixtureFugacityTP::setMoleFractions(), GibbsExcessVPSSTP::setMoleFractions(), MixtureFugacityTP::setMoleFractions_NoNorm(), GibbsExcessVPSSTP::setMoleFractions_NoNorm(), MultiPhase::setMoles(), ThermoPhase::setReferenceComposition(), MixtureFugacityTP::setState_TP(), MixtureFugacityTP::setState_TR(), AqueousTransport::stefan_maxwell_solve(), ChemEquil::update(), PecosTransport::update_C(), MixTransport::update_C(), MultiTransport::update_C(), AqueousTransport::update_C(), SimpleTransport::update_C(), LiquidTransport::update_C(), solveSP::updateMFKinSpecies(), DustyGasTransport::updateTransport_C(), and MultiPhase::uploadMoleFractionsFromPhases().

void setMoleFractions ( const doublereal *const x )

virtual

Set the mole fractions to the specified values There is no restriction on the sum of the mole fraction vector.

Internally, the Phase object will normalize this vector before storing its contents.

Parameters

x	Array of unnormalized mole fraction values (input). Must have a length greater than or equal to the number of species, m_kk.

Reimplemented in IonsFromNeutralVPSSTP, LatticePhase, GibbsExcessVPSSTP, MixtureFugacityTP, LatticeSolidPhase, IdealSolidSolnPhase, and RedlichKwongMFTP.

Definition at line 306 of file Phase.cpp.

References Phase::m_kk, Phase::m_mmw, Phase::m_molwts, Phase::m_stateNum, Phase::m_y, and Phase::m_ym.

Referenced by ChemEquil::calcEmoles(), ChemEquil::equilibrate(), ChemEquil::estimateElementPotentials(), ChemEquil::estimateEP_Brinkley(), PureFluidPhase::initThermo(), SingleSpeciesTP::initThermo(), WaterSSTP::initThermoXML(), IonsFromNeutralVPSSTP::setConcentrations(), IonsFromNeutralVPSSTP::setMassFractions(), IonsFromNeutralVPSSTP::setMassFractions_NoNorm(), MolalityVPSSTP::setMolalities(), MolalityVPSSTP::setMolalitiesByName(), Inlet1D::setMoleFractions(), IdealSolidSolnPhase::setMoleFractions(), OutletRes1D::setMoleFractions(), LatticeSolidPhase::setMoleFractions(), MixtureFugacityTP::setMoleFractions(), GibbsExcessVPSSTP::setMoleFractions(), LatticePhase::setMoleFractions(), IonsFromNeutralVPSSTP::setMoleFractions(), IdealSolidSolnPhase::setMoleFractions_NoNorm(), LatticePhase::setMoleFractions_NoNorm(), Phase::setMoleFractionsByName(), ThermoPhase::setState_PX(), Phase::setState_RX(), Phase::setState_TNX(), ThermoPhase::setState_TPX(), Phase::setState_TRX(), and Phase::setState_TX().

void setMoleFractions_NoNorm ( const doublereal *const x )

virtual

Set the mole fractions to the specified values without normalizing.

This is useful when the normalization condition is being handled by some other means, for example by a constraint equation as part of a larger set of equations.

Parameters

x	Input vector of mole fractions. Length is m_kk.

Reimplemented in IonsFromNeutralVPSSTP, LatticePhase, GibbsExcessVPSSTP, MixtureFugacityTP, IdealSolidSolnPhase, and RedlichKwongMFTP.

Definition at line 344 of file Phase.cpp.

References Cantera::dot(), Phase::m_kk, Phase::m_mmw, Phase::m_molwts, Phase::m_stateNum, Phase::m_y, and Phase::m_ym.

Referenced by MixtureFugacityTP::setMoleFractions_NoNorm(), GibbsExcessVPSSTP::setMoleFractions_NoNorm(), and IonsFromNeutralVPSSTP::setMoleFractions_NoNorm().

void getMassFractions ( doublereal *const y ) const

Get the species mass fractions.

Parameters

[out] y Array of mass fractions, length nSpecies()

Definition at line 561 of file Phase.cpp.

References Phase::m_y.

Referenced by StFlow::_getInitialSoln(), ThermoPhase::getCsvReportData(), FlowReactor::getInitialConditions(), ConstPressureReactor::getInitialConditions(), Reactor::getInitialConditions(), LTI_MassFracs::getMixTransProp(), Cantera::importSolution(), ThermoPhase::report(), Phase::saveState(), Inlet1D::setMoleFractions(), OutletRes1D::setMoleFractions(), and LiquidTransport::update_C().

const doublereal* massFractions ( ) const

inline

Return a const pointer to the mass fraction array.

Definition at line 454 of file Phase.h.

References Phase::m_y.

Referenced by ConstPressureReactor::evalEqs(), Reactor::evalEqs(), MultiTransport::getMassFluxes(), MultiTransport::getSpeciesFluxes(), PecosTransport::getSpeciesFluxes(), MixTransport::getSpeciesFluxes(), AqueousTransport::getSpeciesFluxesExt(), SimpleTransport::getSpeciesFluxesExt(), SimpleTransport::getSpeciesVdiff(), SimpleTransport::getSpeciesVdiffES(), and Phase::massFraction().

void setMassFractions ( const doublereal *const y )

virtual

Set the mass fractions to the specified values and normalize them.

Parameters

[in] y Array of unnormalized mass fraction values. Length must be greater than or equal to the number of species. The Phase object will normalize this vector before storing its contents.

Reimplemented in IonsFromNeutralVPSSTP, LatticePhase, GibbsExcessVPSSTP, MixtureFugacityTP, LatticeSolidPhase, IdealSolidSolnPhase, and RedlichKwongMFTP.

Definition at line 374 of file Phase.cpp.

References Phase::m_kk, Phase::m_mmw, Phase::m_rmolwts, Phase::m_stateNum, Phase::m_y, Phase::m_ym, and Cantera::scale().

Referenced by Cantera::importSolution(), IdealSolidSolnPhase::setMassFractions(), MixtureFugacityTP::setMassFractions(), GibbsExcessVPSSTP::setMassFractions(), LatticePhase::setMassFractions(), Phase::setMassFractionsByName(), ThermoPhase::setState_PY(), Phase::setState_RY(), ThermoPhase::setState_TPY(), Phase::setState_TRY(), Phase::setState_TY(), and FlowReactor::updateState().

void setMassFractions_NoNorm ( const doublereal *const y )

virtual

Set the mass fractions to the specified values without normalizing.

This is useful when the normalization condition is being handled by some other means, for example by a constraint equation as part of a larger set of equations.

Parameters

y	Input vector of mass fractions. Length is m_kk.

Reimplemented in IonsFromNeutralVPSSTP, LatticePhase, GibbsExcessVPSSTP, MixtureFugacityTP, LatticeSolidPhase, IdealSolidSolnPhase, and RedlichKwongMFTP.

Definition at line 388 of file Phase.cpp.

References Phase::m_kk, Phase::m_mmw, Phase::m_rmolwts, Phase::m_stateNum, Phase::m_y, and Phase::m_ym.

Referenced by Phase::restoreState(), StFlow::setGas(), StFlow::setGasAtMidpoint(), IdealSolidSolnPhase::setMassFractions_NoNorm(), MixtureFugacityTP::setMassFractions_NoNorm(), GibbsExcessVPSSTP::setMassFractions_NoNorm(), LatticePhase::setMassFractions_NoNorm(), ConstPressureReactor::updateState(), and Reactor::updateState().

void getConcentrations ( doublereal *const c ) const

Get the species concentrations (kmol/m^3).

Parameters

[out] c Array of species concentrations Length must be greater than or equal to the number of species.

Definition at line 572 of file Phase.cpp.

References Phase::m_dens, Phase::m_ym, and Cantera::scale().

Referenced by ConstDensityThermo::getActivityConcentrations(), IdealSolnGasVPSS::getActivityConcentrations(), SurfPhase::getActivityConcentrations(), IdealGasPhase::getActivityConcentrations(), ImplicitSurfChem::getConcSpecies(), SurfPhase::getCoverages(), solveSP::solveSurfProb(), SimpleTransport::update_C(), and LiquidTransport::update_C().

doublereal concentration ( const size_t k ) const

Concentration of species k.

If k is outside the valid range, an exception will be thrown.

Parameters

k	Index of species

Definition at line 566 of file Phase.cpp.

References Phase::checkSpeciesIndex(), Phase::m_dens, Phase::m_rmolwts, and Phase::m_y.

void setConcentrations ( const doublereal *const conc )

virtual

Set the concentrations to the specified values within the phase.

We set the concentrations here and therefore we set the overall density of the phase. We hold the temperature constant during this operation. Therefore, we have possibly changed the pressure of the phase by calling this routine.

Parameters

[in] conc Array of concentrations in dimensional units. For bulk phases c[k] is the concentration of the kth species in kmol/m3. For surface phases, c[k] is the concentration in kmol/m2. The length of the vector is the number of species in the phase.

Reimplemented in IonsFromNeutralVPSSTP, LatticePhase, GibbsExcessVPSSTP, MixtureFugacityTP, LatticeSolidPhase, IdealSolidSolnPhase, and RedlichKwongMFTP.

Definition at line 577 of file Phase.cpp.

References Phase::m_kk, Phase::m_mmw, Phase::m_molwts, Phase::m_stateNum, Phase::m_y, Phase::m_ym, and Phase::setDensity().

Referenced by IdealSolidSolnPhase::setConcentrations(), MixtureFugacityTP::setConcentrations(), GibbsExcessVPSSTP::setConcentrations(), LatticePhase::setConcentrations(), ImplicitSurfChem::setConcSpecies(), SurfPhase::setCoverages(), and SurfPhase::setCoveragesNoNorm().

const doublereal * moleFractdivMMW ( ) const

Returns a const pointer to the start of the moleFraction/MW array.

This array is the array of mole fractions, each divided by the mean molecular weight.

Definition at line 540 of file Phase.cpp.

References Phase::m_ym.

Referenced by IdealSolnGasVPSS::calcDensity(), RedlichKwongMFTP::calcDensity(), IdealSolidSolnPhase::calcDensity(), and IdealSolidSolnPhase::getActivityConcentrations().

doublereal charge ( size_t k ) const

inline

Dimensionless electrical charge of a single molecule of species k The charge is normalized by the the magnitude of the electron charge.

Parameters

k	species index

Definition at line 504 of file Phase.h.

References Phase::m_speciesCharge.

Referenced by InterfaceKinetics::applyButlerVolmerCorrection(), HMWSoln::applyphScale(), HMWSoln::calcMolalitiesCropped(), Phase::chargeDensity(), PDSS_HKFT::constructPDSSXML(), SolidTransport::electricalConductivity(), PureFluidPhase::getElectrochemPotentials(), PseudoBinaryVPSSTP::getElectrochemPotentials(), MolarityIonicVPSSTP::getElectrochemPotentials(), GibbsExcessVPSSTP::getElectrochemPotentials(), RedlichKisterVPSSTP::getElectrochemPotentials(), MixedSolventElectrolyte::getElectrochemPotentials(), MargulesVPSSTP::getElectrochemPotentials(), PhaseCombo_Interaction::getElectrochemPotentials(), MolalityVPSSTP::getElectrochemPotentials(), ThermoPhase::getElectrochemPotentials(), InterfaceKinetics::getEquilibriumConstants(), PecosTransport::getMobilities(), VCSnonideal::hasChargedSpecies(), LiquidTransport::initLiquid(), SimpleTransport::initLiquid(), PDSS_HKFT::initThermo(), IonsFromNeutralVPSSTP::initThermoXML(), DebyeHuckel::initThermoXML(), LatticeSolidPhase::installSlavePhases(), HMWSoln::printCoeffs(), RedlichKisterVPSSTP::readXMLBinarySpecies(), MixedSolventElectrolyte::readXMLBinarySpecies(), MargulesVPSSTP::readXMLBinarySpecies(), PhaseCombo_Interaction::readXMLBinarySpecies(), HMWSoln::relative_molal_enthalpy(), HMWSoln::s_updatePitzer_CoeffWRTemp(), HMWSoln::s_updatePitzer_d2lnMolalityActCoeff_dT2(), HMWSoln::s_updatePitzer_dlnMolalityActCoeff_dP(), HMWSoln::s_updatePitzer_dlnMolalityActCoeff_dT(), HMWSoln::s_updatePitzer_lnMolalityActCoeff(), HMWSoln::s_updateScaling_pHScaling(), HMWSoln::s_updateScaling_pHScaling_dP(), HMWSoln::s_updateScaling_pHScaling_dT(), HMWSoln::s_updateScaling_pHScaling_dT2(), MolalityVPSSTP::setMolalitiesByName(), vcs_VolPhase::transferElementsFM(), InterfaceKinetics::updateKc(), and VCSnonideal::vcs_Cantera_to_vprob().

doublereal chargeDensity ( ) const

Charge density [C/m^3].

Definition at line 612 of file Phase.cpp.

References Phase::charge(), Phase::moleFraction(), and Phase::nSpecies().

size_t nDim ( ) const

inline

Returns the number of spatial dimensions (1, 2, or 3)

Definition at line 512 of file Phase.h.

References Phase::m_ndim.

Referenced by Kinetics::addPhase(), EdgeKinetics::finalize(), InterfaceKinetics::finalize(), IdealSolnGasVPSS::getUnitsStandardConc(), RedlichKwongMFTP::getUnitsStandardConc(), IdealMolalSoln::getUnitsStandardConc(), IdealSolidSolnPhase::getUnitsStandardConc(), MolalityVPSSTP::getUnitsStandardConc(), ThermoPhase::getUnitsStandardConc(), DebyeHuckel::getUnitsStandardConc(), and HMWSoln::getUnitsStandardConc().

void setNDim ( size_t ndim )

inline

Set the number of spatial dimensions (1, 2, or 3).

The number of spatial dimensions is used for vector involving directions.

Parameters

ndim	Input number of dimensions.

Definition at line 519 of file Phase.h.

References Phase::m_ndim.

Referenced by EdgePhase::EdgePhase(), FixedChemPotSSTP::FixedChemPotSSTP(), Cantera::importPhase(), EdgePhase::operator=(), and SurfPhase::SurfPhase().

doublereal temperature ( ) const

inline

Temperature (K).

Returns: The temperature of the phase

Definition at line 528 of file Phase.h.

References Phase::m_temp.

virtual doublereal density ( ) const

inlinevirtual

Density (kg/m^3).

Returns: The density of the phase

Reimplemented in HMWSoln.

Definition at line 534 of file Phase.h.

References Phase::m_dens.

Referenced by MixtureFugacityTP::calculatePsat(), SingleSpeciesTP::cv_mole(), HMWSoln::density(), WaterSSTP::dthermalExpansionCoeffdT(), FlowReactor::evalEqs(), WaterSSTP::getCp_R_ref(), WaterSSTP::getEnthalpy_RT_ref(), WaterSSTP::getEntropy_R_ref(), WaterSSTP::getGibbs_RT_ref(), ConstPressureReactor::getInitialConditions(), Reactor::getInitialConditions(), MultiTransport::getMassFluxes(), ConstDensityThermo::getParameters(), StoichSubstance::getParameters(), MineralEQ3::getParameters(), StoichSubstanceSSTP::getParameters(), MetalSHEelectrons::getParameters(), SingleSpeciesTP::getPartialMolarVolumes(), MultiTransport::getSpeciesFluxes(), SimpleTransport::getSpeciesVdiff(), SimpleTransport::getSpeciesVdiffES(), SingleSpeciesTP::getStandardVolumes(), WaterSSTP::getStandardVolumes_ref(), RedlichKwongMFTP::hresid(), Phase::molarDensity(), MixtureFugacityTP::phaseState(), RedlichKwongMFTP::pressure(), PseudoBinaryVPSSTP::report(), MolarityIonicVPSSTP::report(), PureFluidPhase::report(), MolalityVPSSTP::report(), ThermoPhase::report(), WaterSSTP::satPressure(), Phase::saveState(), IdealSolidSolnPhase::setDensity(), IdealMolalSoln::setDensity(), DebyeHuckel::setDensity(), WaterSSTP::setPressure(), MixtureFugacityTP::setState_TP(), IonsFromNeutralVPSSTP::setState_TP(), MixtureFugacityTP::setStateFromXML(), MixtureFugacityTP::setTemperature(), WaterSSTP::setTemperature(), PureFluidPhase::setTPXState(), RedlichKwongMFTP::sresid(), ChemEquil::update(), SimpleTransport::update_C(), LiquidTransport::update_C(), ConstPressureReactor::updateState(), StFlow::updateThermo(), WaterSSTP::vaporFraction(), and MixtureFugacityTP::z().

doublereal molarDensity ( ) const

Molar density (kmol/m^3).

Returns: The molar density of the phase

Definition at line 597 of file Phase.cpp.

References Phase::density(), and Phase::meanMolecularWeight().

Referenced by solveSP::calc_t(), SolidTransport::electricalConductivity(), ConstDensityThermo::enthalpy_mole(), StoichSubstance::enthalpy_mole(), IdealSolidSolnPhase::enthalpy_mole(), LatticePhase::enthalpy_mole(), ConstDensityThermo::getChemPotentials(), MineralEQ3::getEnthalpy_RT(), StoichSubstanceSSTP::getEnthalpy_RT(), MineralEQ3::getIntEnergy_RT(), StoichSubstanceSSTP::getIntEnergy_RT(), MineralEQ3::getIntEnergy_RT_ref(), StoichSubstanceSSTP::getIntEnergy_RT_ref(), MetalSHEelectrons::getIntEnergy_RT_ref(), LatticePhase::getParameters(), PureFluidPhase::getPartialMolarVolumes(), StoichSubstance::getPartialMolarVolumes(), IdealGasPhase::getPartialMolarVolumes(), PecosTransport::getSpeciesFluxes(), MixTransport::getSpeciesFluxes(), AqueousTransport::getSpeciesFluxesExt(), SimpleTransport::getSpeciesFluxesExt(), StoichSubstance::getStandardVolumes(), IdealGasPhase::getStandardVolumes(), ConstDensityThermo::intEnergy_mole(), IdealSolnGasVPSS::intEnergy_mole(), StoichSubstance::intEnergy_mole(), RedlichKwongMFTP::intEnergy_mole(), IdealSolidSolnPhase::intEnergy_mole(), IonsFromNeutralVPSSTP::intEnergy_mole(), LatticePhase::intEnergy_mole(), DebyeHuckel::intEnergy_mole(), HMWSoln::intEnergy_mole(), ConstDensityThermo::logStandardConc(), Phase::molarVolume(), IdealGasPhase::pressure(), MixTransport::pressure_ig(), PecosTransport::pressure_ig(), IdealMolalSoln::setMolarDensity(), DebyeHuckel::setMolarDensity(), ConstDensityThermo::standardConcentration(), and GasKinetics::update_rates_C().

doublereal molarVolume ( ) const

Molar volume (m^3/kmol).

Returns: The molar volume of the phase

Definition at line 607 of file Phase.cpp.

References Phase::molarDensity().

Referenced by RedlichKwongMFTP::cp_mole(), HMWSoln::cv_mole(), RedlichKwongMFTP::getActivityCoefficients(), RedlichKwongMFTP::getChemPotentials(), LTI_StefanMaxwell_PPN::getMatrixTransProp(), RedlichKwongMFTP::getPartialMolarEnthalpies(), RedlichKwongMFTP::getPartialMolarEntropies(), RedlichKwongMFTP::getPartialMolarVolumes(), ThermoPhase::intEnergy_mole(), RedlichKwongMFTP::pressureDerivatives(), MixtureFugacityTP::setState_TR(), and LiquidTransport::stefan_maxwell_solve().

virtual void setDensity ( const doublereal density_ )

inlinevirtual

Set the internally stored density (kg/m^3) of the phase Note the density of a phase is an independent variable.

Parameters

[in] density_ density (kg/m^3).

Reimplemented in HMWSoln, DebyeHuckel, WaterSSTP, IdealMolalSoln, and IdealSolidSolnPhase.

Definition at line 549 of file Phase.h.

References Phase::m_dens.

Referenced by IdealSolnGasVPSS::calcDensity(), RedlichKwongMFTP::calcDensity(), GibbsExcessVPSSTP::calcDensity(), IdealSolidSolnPhase::calcDensity(), IdealMolalSoln::calcDensity(), LatticeSolidPhase::calcDensity(), DebyeHuckel::calcDensity(), HMWSoln::calcDensity(), MineralEQ3::initThermoXML(), WaterSSTP::initThermoXML(), StoichSubstanceSSTP::initThermoXML(), MetalSHEelectrons::initThermoXML(), electrodeElectron::initThermoXML(), Phase::restoreState(), Phase::setConcentrations(), WaterSSTP::setDensity(), ConstDensityThermo::setParameters(), StoichSubstance::setParameters(), MineralEQ3::setParameters(), StoichSubstanceSSTP::setParameters(), MetalSHEelectrons::setParameters(), electrodeElectron::setParameters(), SemiconductorPhase::setParametersFromXML(), MetalPhase::setParametersFromXML(), ConstDensityThermo::setParametersFromXML(), StoichSubstance::setParametersFromXML(), StoichSubstanceSSTP::setParametersFromXML(), MetalSHEelectrons::setParametersFromXML(), PureFluidPhase::setPressure(), IdealGasPhase::setPressure(), ThermoPhase::setState_HPorUV(), PureFluidPhase::setState_Psat(), Phase::setState_RX(), Phase::setState_RY(), ThermoPhase::setState_SPorSV(), SingleSpeciesTP::setState_SV(), MixtureFugacityTP::setState_TP(), IonsFromNeutralVPSSTP::setState_TP(), Phase::setState_TR(), MixtureFugacityTP::setState_TR(), Phase::setState_TRX(), Phase::setState_TRY(), PureFluidPhase::setState_Tsat(), SingleSpeciesTP::setState_UV(), ThermoPhase::setStateFromXML(), and Reactor::updateState().

void setMolarDensity ( const doublereal molarDensity )

virtual

Set the internally stored molar density (kmol/m^3) of the phase.

Parameters

[in] molarDensity Input molar density (kmol/m^3).

Reimplemented in HMWSoln, DebyeHuckel, IdealMolalSoln, and IdealSolidSolnPhase.

Definition at line 602 of file Phase.cpp.

References Phase::m_dens, and Phase::meanMolecularWeight().

Referenced by LatticePhase::calcDensity(), LatticePhase::setParameters(), and Phase::setState_TNX().

virtual void setTemperature ( const doublereal temp )

inlinevirtual

Set the internally stored temperature of the phase (K).

Parameters

temp	Temperature in Kelvin

Reimplemented in HMWSoln, DebyeHuckel, IonsFromNeutralVPSSTP, WaterSSTP, MixtureFugacityTP, VPStandardStateTP, and RedlichKwongMFTP.

Definition at line 562 of file Phase.h.

References Phase::m_temp.

Referenced by ChemEquil::equilibrate(), ReactingSurf1D::eval(), ConstPressureReactor::evalEqs(), IdealGasReactor::evalEqs(), IdealGasConstPressureReactor::evalEqs(), Reactor::evalEqs(), TransportFactory::fitProperties(), WaterSSTP::initThermoXML(), Phase::restoreState(), StFlow::setGas(), StFlow::setGasAtMidpoint(), ThermoPhase::setState_conditional_TP(), PureFluidPhase::setState_Psat(), SingleSpeciesTP::setState_SV(), Phase::setState_TNX(), IdealMolalSoln::setState_TP(), VPStandardStateTP::setState_TP(), MixtureFugacityTP::setState_TP(), GibbsExcessVPSSTP::setState_TP(), DebyeHuckel::setState_TP(), ThermoPhase::setState_TP(), HMWSoln::setState_TP(), SingleSpeciesTP::setState_TPX(), SingleSpeciesTP::setState_TPY(), Phase::setState_TR(), MixtureFugacityTP::setState_TR(), Phase::setState_TRX(), Phase::setState_TRY(), PureFluidPhase::setState_Tsat(), Phase::setState_TX(), Phase::setState_TY(), SingleSpeciesTP::setState_UV(), SurfPhase::setStateFromXML(), ThermoPhase::setStateFromXML(), RedlichKwongMFTP::setTemperature(), WaterSSTP::setTemperature(), and ChemEquil::setToEquilState().

doublereal mean_X ( const doublereal *const Q ) const

Evaluate the mole-fraction-weighted mean of an array Q.

\[ \sum_k X_k Q_k. \]

Q should contain pure-species molar property values.

Parameters

[in] Q Array of length m_kk that is to be averaged.

Returns: mole-fraction-weighted mean of Q

Definition at line 623 of file Phase.cpp.

References Phase::m_mmw, and Phase::m_ym.

Referenced by ConstDensityThermo::cp_mole(), IdealSolnGasVPSS::cp_mole(), RedlichKwongMFTP::cp_mole(), IdealSolidSolnPhase::cp_mole(), IdealMolalSoln::cp_mole(), IonsFromNeutralVPSSTP::cp_mole(), LatticePhase::cp_mole(), IdealGasPhase::cp_mole(), DebyeHuckel::cp_mole(), HMWSoln::cp_mole(), IonsFromNeutralVPSSTP::cv_mole(), ConstDensityThermo::enthalpy_mole(), IdealSolnGasVPSS::enthalpy_mole(), RedlichKwongMFTP::enthalpy_mole(), IdealSolidSolnPhase::enthalpy_mole(), IdealMolalSoln::enthalpy_mole(), IonsFromNeutralVPSSTP::enthalpy_mole(), SurfPhase::enthalpy_mole(), LatticePhase::enthalpy_mole(), IdealGasPhase::enthalpy_mole(), DebyeHuckel::enthalpy_mole(), HMWSoln::enthalpy_mole(), ConstDensityThermo::entropy_mole(), IdealSolnGasVPSS::entropy_mole(), RedlichKwongMFTP::entropy_mole(), IdealSolidSolnPhase::entropy_mole(), IdealMolalSoln::entropy_mole(), IonsFromNeutralVPSSTP::entropy_mole(), LatticePhase::entropy_mole(), IdealGasPhase::entropy_mole(), DebyeHuckel::entropy_mole(), HMWSoln::entropy_mole(), IdealSolidSolnPhase::gibbs_mole(), IdealMolalSoln::gibbs_mole(), IonsFromNeutralVPSSTP::gibbs_mole(), DebyeHuckel::gibbs_mole(), HMWSoln::gibbs_mole(), ConstDensityThermo::intEnergy_mole(), IdealSolidSolnPhase::intEnergy_mole(), IdealMolalSoln::intEnergy_mole(), LatticePhase::intEnergy_mole(), IdealGasPhase::intEnergy_mole(), and HMWSoln::relative_enthalpy().

doublereal mean_Y ( const doublereal *const Q ) const

Evaluate the mass-fraction-weighted mean of an array Q.

\[ \sum_k Y_k Q_k \]

Parameters

[in] Q Array of species property values in mass units.

Returns: The mass-fraction-weighted mean of Q.

Definition at line 628 of file Phase.cpp.

References Cantera::dot(), and Phase::m_y.

doublereal meanMolecularWeight ( ) const

inline

The mean molecular weight. Units: (kg/kmol)

Definition at line 588 of file Phase.h.

References Phase::m_mmw.

Referenced by IdealSolnGasVPSS::calcDensity(), GibbsExcessVPSSTP::calcDensity(), IdealMolalSoln::calcDensity(), LatticePhase::calcDensity(), DebyeHuckel::calcDensity(), HMWSoln::calcDensity(), MixtureFugacityTP::calculatePsat(), ThermoPhase::cp_mass(), RedlichKwongMFTP::critDensity(), ThermoPhase::cv_mass(), RedlichKwongMFTP::densityCalc(), MixtureFugacityTP::densityCalc(), RedlichKwongMFTP::densSpinodalGas(), RedlichKwongMFTP::densSpinodalLiquid(), ThermoPhase::enthalpy_mass(), ThermoPhase::entropy_mass(), IdealSolidSolnPhase::getActivityConcentrations(), GasTransport::getMixDiffCoeffs(), PecosTransport::getMixDiffCoeffs(), AqueousTransport::getMixDiffCoeffs(), GasTransport::getMixDiffCoeffsMass(), PecosTransport::getMixDiffCoeffsMass(), MultiTransport::getMultiDiffCoeffs(), WaterSSTP::getStandardVolumes_ref(), ThermoPhase::gibbs_mass(), RedlichKwongMFTP::hresid(), ThermoPhase::intEnergy_mass(), Phase::molarDensity(), MixtureFugacityTP::phaseState(), RedlichKwongMFTP::pressure(), PseudoBinaryVPSSTP::report(), MolarityIonicVPSSTP::report(), PureFluidPhase::report(), MolalityVPSSTP::report(), ThermoPhase::report(), Phase::setMolarDensity(), IdealGasPhase::setPressure(), RedlichKwongMFTP::sresid(), SimpleTransport::update_C(), LiquidTransport::update_C(), StFlow::updateThermo(), StFlow::updateTransport(), and MixtureFugacityTP::z().

doublereal sum_xlogx ( ) const

Evaluate \( \sum_k X_k \log X_k \).

Returns: The indicated sum. Dimensionless.

Definition at line 633 of file Phase.cpp.

References Phase::m_mmw, Phase::m_ym, and Cantera::sum_xlogx().

Referenced by ConstDensityThermo::entropy_mole(), IdealSolnGasVPSS::entropy_mole(), RedlichKwongMFTP::entropy_mole(), IdealSolidSolnPhase::entropy_mole(), LatticePhase::entropy_mole(), IdealGasPhase::entropy_mole(), and IdealSolidSolnPhase::gibbs_mole().

doublereal sum_xlogQ ( doublereal *const Q ) const

Evaluate \( \sum_k X_k \log Q_k \).

Parameters

Q	Vector of length m_kk to take the log average of

Returns: The indicated sum.

Definition at line 638 of file Phase.cpp.

References Phase::m_mmw, Phase::m_ym, and Cantera::sum_xlogQ().

void addElement	(	const std::string &	symbol,
		doublereal	weight = `-12345.0`
	)

Add an element.

Parameters

symbol	Atomic symbol std::string.
weight	Atomic mass in amu.

Definition at line 643 of file Phase.cpp.

References CT_ELEM_TYPE_ABSPOS, CT_ELEM_TYPE_ELECTRONCHARGE, Cantera::LookupWtElements(), Phase::m_atomicWeights, Phase::m_elem_type, Phase::m_elementNames, Phase::m_elementsFrozen, and Phase::m_mm.

Referenced by Phase::addElement().

void addElement ( const XML_Node & e )

Add an element from an XML specification.

Parameters

e	Reference to the XML_Node where the element is described.

Definition at line 666 of file Phase.cpp.

References Phase::addElement(), and Cantera::fpValue().

void addUniqueElement	(	const std::string &	symbol,
		doublereal	weight = `-12345.0`,
		int	atomicNumber = `0`,
		doublereal	entropy298 = `ENTROPY298_UNKNOWN`,
		int	elem_type = `CT_ELEM_TYPE_ABSPOS`
	)

Add an element, checking for uniqueness The uniqueness is checked by comparing the string symbol.

If not unique, nothing is done.

Parameters

symbol	String symbol of the element
weight	Atomic weight of the element (kg kmol-1).
atomicNumber	Atomic number of the element (unitless)
entropy298	Entropy of the element at 298 K and 1 bar in its most stable form. The default is the value ENTROPY298_UNKNOWN, which is interpreted as an unknown, and if used will cause Cantera to throw an error.
elem_type	Specifies the type of the element constraint equation. This defaults to CT_ELEM_TYPE_ABSPOS, i.e., an element.

Definition at line 673 of file Phase.cpp.

References CT_ELEM_TYPE_ELECTRONCHARGE, Cantera::LookupWtElements(), Phase::m_atomicNumbers, Phase::m_atomicWeights, Phase::m_elem_type, Phase::m_elementNames, Phase::m_elementsFrozen, Phase::m_entropy298, and Phase::m_mm.

Referenced by Phase::addElementsFromXML(), Phase::addUniqueElement(), Phase::addUniqueElementAfterFreeze(), and FixedChemPotSSTP::FixedChemPotSSTP().

void addUniqueElement ( const XML_Node & e )

Add an element, checking for uniqueness The uniqueness is checked by comparing the string symbol.

If not unique, nothing is done.

Parameters

e	Reference to the XML_Node where the element is described.

Definition at line 720 of file Phase.cpp.

References Phase::addUniqueElement(), XML_Node::child(), ENTROPY298_UNKNOWN, Cantera::fpValue(), Cantera::fpValueCheck(), XML_Node::hasAttrib(), XML_Node::hasChild(), and Cantera::stripws().

void addElementsFromXML ( const XML_Node & phase )

Add all elements referenced in an XML_Node tree.

Parameters

phase Reference to the root XML_Node of a phase

Definition at line 745 of file Phase.cpp.

References Phase::addUniqueElement(), XML_Node::child(), XML_Node::findByAttr(), Cantera::get_XML_File(), ctml::getStringArray(), XML_Node::hasAttrib(), XML_Node::hasChild(), and XML_Node::root().

Referenced by Cantera::importPhase().

void freezeElements ( )

Prohibit addition of more elements, and prepare to add species.

Definition at line 796 of file Phase.cpp.

References Phase::m_elementsFrozen.

Referenced by FixedChemPotSSTP::FixedChemPotSSTP().

bool elementsFrozen ( )

True if freezeElements has been called.

Definition at line 801 of file Phase.cpp.

References Phase::m_elementsFrozen.

size_t addUniqueElementAfterFreeze	(	const std::string &	symbol,
		doublereal	weight,
		int	atomicNumber,
		doublereal	entropy298 = `ENTROPY298_UNKNOWN`,
		int	elem_type = `CT_ELEM_TYPE_ABSPOS`
	)

Add an element after elements have been frozen, checking for uniqueness The uniqueness is checked by comparing the string symbol.

If not unique, nothing is done.

Parameters

symbol	String symbol of the element
weight	Atomic weight of the element (kg kmol-1).
atomicNumber	Atomic number of the element (unitless)
entropy298	Entropy of the element at 298 K and 1 bar in its most stable form. The default is the value ENTROPY298_UNKNOWN, which if used will cause Cantera to throw an error.
elem_type	Specifies the type of the element constraint equation. This defaults to CT_ELEM_TYPE_ABSPOS, i.e., an element.

Definition at line 806 of file Phase.cpp.

References Phase::addUniqueElement(), Phase::elementIndex(), Phase::m_elementsFrozen, Phase::m_kk, Phase::m_mm, Phase::m_speciesComp, and Cantera::npos.

Referenced by LatticeSolidPhase::installSlavePhases().

void addUniqueSpecies	(	const std::string &	name,
		const doublereal *	comp,
		doublereal	charge = `0.0`,
		doublereal	size = `1.0`
	)

Add a species to the phase, checking for uniqueness of the name This routine checks for uniqueness of the string name.

It only adds the species if it is unique.

Parameters

name	String name of the species
comp	Array containing the elemental composition of the species.
charge	Charge of the species. Defaults to zero.
size	Size of the species (meters). Defaults to 1 meter.

Definition at line 884 of file Phase.cpp.

References Phase::m_kk, Phase::m_mm, Phase::m_speciesCharge, Phase::m_speciesComp, Phase::m_speciesNames, and Phase::m_speciesSize.

Referenced by FixedChemPotSSTP::FixedChemPotSSTP(), LatticeSolidPhase::installSlavePhases(), and Cantera::installSpecies().

void freezeSpecies ( )

virtual

Call when finished adding species.

Prepare to use them for calculation of mixture properties.

Definition at line 913 of file Phase.cpp.

References Phase::init(), Phase::m_speciesFrozen, and Phase::molecularWeights().

Referenced by FixedChemPotSSTP::FixedChemPotSSTP(), and Cantera::importPhase().

bool speciesFrozen ( )

inline

True if freezeSpecies has been called.

Definition at line 690 of file Phase.h.

References Phase::m_speciesFrozen.

int stateMFNumber ( ) const

inline

Return the State Mole Fraction Number.

Definition at line 697 of file Phase.h.

References Phase::m_stateNum.

Referenced by SimpleTransport::update_C(), and LiquidTransport::update_C().

void init ( const vector_fp & mw )

protected

Initialize. Make a local copy of the vector of molecular weights, and resize the composition arrays to the appropriate size.

Parameters

mw	Vector of molecular weights of the species.

Definition at line 919 of file Phase.cpp.

References Cantera::int2str(), Phase::m_kk, Phase::m_mmw, Phase::m_molwts, Phase::m_rmolwts, Phase::m_y, Phase::m_ym, and Cantera::Tiny.

Referenced by Phase::freezeSpecies().

void setMolecularWeight	(	const int	k,
		const double	mw
	)

inlineprotected

Set the molecular weight of a single species to a given value.

Parameters

k	id of the species
mw	Molecular Weight (kg kmol-1)

Definition at line 711 of file Phase.h.

References Phase::m_molwts, and Phase::m_rmolwts.

Referenced by PureFluidPhase::initThermo(), and WaterSSTP::initThermoXML().

Member Data Documentation

size_t m_kk

protected

Number of species in the phase.

Definition at line 716 of file Phase.h.

size_t m_ndim

protected

Dimensionality of the phase.

Volumetric phases have dimensionality 3 and surface phases have dimensionality 2.

Definition at line 720 of file Phase.h.

Referenced by Phase::nDim(), Phase::operator=(), and Phase::setNDim().

vector_fp m_speciesComp

protected

Atomic composition of the species.

The number of atoms of element i in species k is equal to m_speciesComp[k * m_mm + i] The length of this vector is equal to m_kk * m_mm

Definition at line 725 of file Phase.h.

Referenced by Phase::addUniqueElementAfterFreeze(), Phase::addUniqueSpecies(), Phase::getAtoms(), LatticeSolidPhase::installSlavePhases(), Phase::nAtoms(), and Phase::operator=().

vector_fp m_speciesSize

protected

Vector of species sizes.

length m_kk. Used in some equations of state which employ the constant partial molar volume approximation.

Definition at line 729 of file Phase.h.

Referenced by Phase::addUniqueSpecies(), DebyeHuckel::initLengths(), HMWSoln::initLengths(), MineralEQ3::initThermoXML(), DebyeHuckel::initThermoXML(), Phase::operator=(), Phase::size(), and DebyeHuckel::standardConcentration().

vector_fp m_speciesCharge

protected

Vector of species charges. length m_kk.

Definition at line 731 of file Phase.h.

Referenced by Phase::addUniqueSpecies(), MolarityIonicVPSSTP::calcPseudoBinaryMoleFractions(), Phase::charge(), IonsFromNeutralVPSSTP::getDissociationCoeffs(), MolarityIonicVPSSTP::initThermo(), DebyeHuckel::initThermoXML(), Phase::operator=(), DebyeHuckel::s_update_d2lnMolalityActCoeff_dT2(), DebyeHuckel::s_update_dlnMolalityActCoeff_dP(), DebyeHuckel::s_update_dlnMolalityActCoeff_dT(), and DebyeHuckel::s_update_lnMolalityActCoeff().

XML_Node* m_xml

private

XML node containing the XML info for this phase.

Definition at line 734 of file Phase.h.

Referenced by Phase::operator=(), Phase::xml(), and Phase::~Phase().

std::string m_id

private

ID of the phase.

This is the value of the ID attribute of the XML phase node. The field will stay that way even if the name is changed.

Definition at line 738 of file Phase.h.

Referenced by Phase::id(), Phase::operator=(), Phase::setID(), and Phase::speciesIndex().

std::string m_name

private

Name of the phase.

Initially, this is the value of the ID attribute of the XML phase node. It may be changed to another value during the course of a calculation.

Definition at line 743 of file Phase.h.

Referenced by Phase::name(), Phase::operator=(), Phase::setName(), Phase::speciesIndex(), and Phase::speciesSPName().

doublereal m_temp

private

Temperature (K). This is an independent variable.

Definition at line 745 of file Phase.h.

Referenced by Phase::operator=(), Phase::setTemperature(), and Phase::temperature().

doublereal m_dens

private

Density (kg m-3).

This is an independent variable except in the incompressible degenerate case. Thus, the pressure is determined from this variable rather than other way round.

Definition at line 750 of file Phase.h.

Referenced by Phase::concentration(), Phase::density(), Phase::getConcentrations(), Phase::operator=(), Phase::setDensity(), and Phase::setMolarDensity().