Cantera  2.1.2
Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | Friends | List of all members
MultiTransport Class Reference

Class MultiTransport implements multicomponent transport properties for ideal gas mixtures. More...

#include <MultiTransport.h>

Inheritance diagram for MultiTransport:
[legend]
Collaboration diagram for MultiTransport:
[legend]

Public Member Functions

virtual int model () const
 Transport model. More...
 
virtual void getThermalDiffCoeffs (doublereal *const dt)
 Return the thermal diffusion coefficients (kg/m/s) More...
 
virtual doublereal thermalConductivity ()
 Returns the mixture thermal conductivity in W/m/K. More...
 
virtual void getMultiDiffCoeffs (const size_t ld, doublereal *const d)
 Return the Multicomponent diffusion coefficients. Units: [m^2/s]. More...
 
virtual void getSpeciesFluxes (size_t ndim, const doublereal *const grad_T, size_t ldx, const doublereal *const grad_X, size_t ldf, doublereal *const fluxes)
 Get the species diffusive mass fluxes wrt to the mass averaged velocity, given the gradients in mole fraction and temperature. More...
 
virtual void getMolarFluxes (const doublereal *const state1, const doublereal *const state2, const doublereal delta, doublereal *const fluxes)
 Get the molar diffusional fluxes [kmol/m^2/s] of the species, given the thermodynamic state at two nearby points. More...
 
virtual void getMassFluxes (const doublereal *state1, const doublereal *state2, doublereal delta, doublereal *fluxes)
 Get the mass diffusional fluxes [kg/m^2/s] of the species, given the thermodynamic state at two nearby points. More...
 
virtual bool initGas (GasTransportParams &tr)
 Initialize the transport operator with parameters from GasTransportParams object. More...
 
- Public Member Functions inherited from GasTransport
 GasTransport (const GasTransport &right)
 
GasTransportoperator= (const GasTransport &right)
 
virtual doublereal viscosity ()
 Viscosity of the mixture (kg /m /s) More...
 
virtual void getSpeciesViscosities (doublereal *const visc)
 Get the pure-species viscosities. More...
 
virtual void getBinaryDiffCoeffs (const size_t ld, doublereal *const d)
 Returns the matrix of binary diffusion coefficients. More...
 
virtual void getMixDiffCoeffs (doublereal *const d)
 Returns the Mixture-averaged diffusion coefficients [m^2/s]. More...
 
virtual void getMixDiffCoeffsMole (doublereal *const d)
 Returns the mixture-averaged diffusion coefficients [m^2/s]. More...
 
virtual void getMixDiffCoeffsMass (doublereal *const d)
 Returns the mixture-averaged diffusion coefficients [m^2/s]. More...
 
- Public Member Functions inherited from Transport
 Transport (thermo_t *thermo=0, size_t ndim=1)
 Constructor. More...
 
 Transport (const Transport &right)
 
Transportoperator= (const Transport &right)
 
virtual TransportduplMyselfAsTransport () const
 Duplication routine for objects which inherit from Transport. More...
 
thermo_tthermo ()
 
bool ready ()
 
void setNDim (const int ndim)
 Set the number of dimensions to be expected in flux expressions. More...
 
size_t nDim () const
 Return the number of dimensions in flux expressions. 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() 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...
 
virtual doublereal getElectricConduct ()
 Compute the mixture electrical conductivity (S m-1) at the current conditions of the phase (Siemens m-1) More...
 
virtual void getElectricCurrent (int ndim, const doublereal *grad_T, int ldx, const doublereal *grad_X, int ldf, const doublereal *grad_V, doublereal *current)
 Compute the electric current density in A/m^2. More...
 
virtual void getSpeciesFluxesES (size_t ndim, const doublereal *grad_T, size_t ldx, const doublereal *grad_X, size_t ldf, const doublereal *grad_Phi, doublereal *fluxes)
 Get the species diffusive mass fluxes wrt to the mass averaged velocity, given the gradients in mole fraction, temperature and electrostatic potential. More...
 
virtual void getSpeciesVdiff (size_t ndim, const doublereal *grad_T, int ldx, const doublereal *grad_X, int ldf, doublereal *Vdiff)
 Get the species diffusive velocities wrt to the mass averaged velocity, given the gradients in mole fraction and temperature. More...
 
virtual void getSpeciesVdiffES (size_t ndim, const doublereal *grad_T, int ldx, const doublereal *grad_X, int ldf, const doublereal *grad_Phi, doublereal *Vdiff)
 Get the species diffusive velocities wrt to the mass averaged velocity, given the gradients in mole fraction, temperature, and electrostatic potential. More...
 
virtual void setParameters (const int type, const int k, const doublereal *const p)
 Set model parameters for derived classes. More...
 
void setVelocityBasis (VelocityBasis ivb)
 Sets the velocity basis. More...
 
VelocityBasis getVelocityBasis () const
 Gets the velocity basis. More...
 
virtual doublereal bulkViscosity ()
 The bulk viscosity in Pa-s. More...
 
virtual doublereal ionConductivity ()
 The ionic conductivity in 1/ohm/m. More...
 
virtual void getSpeciesIonConductivity (doublereal *const ionCond)
 Returns the pure species ionic conductivity. More...
 
virtual void mobilityRatio (double *mobRat)
 Returns the pointer to the mobility ratios of the species in the phase. More...
 
virtual void getSpeciesMobilityRatio (double **mobRat)
 Returns the pure species limit of the mobility ratios. More...
 
virtual void selfDiffusion (doublereal *const selfDiff)
 Returns the self diffusion coefficients of the species in the phase. More...
 
virtual void getSpeciesSelfDiffusion (double **selfDiff)
 Returns the pure species self diffusion in solution of each species. More...
 
virtual doublereal electricalConductivity ()
 
virtual void getMobilities (doublereal *const mobil_e)
 Get the Electrical mobilities (m^2/V/s). More...
 
virtual void getFluidMobilities (doublereal *const mobil_f)
 Get the fluid mobilities (s kmol/kg). More...
 
virtual bool initSolid (SolidTransportData &tr)
 Called by TransportFactory to set parameters. More...
 
virtual void setThermo (thermo_t &thermo)
 Specifies the ThermoPhase object. More...
 

Public Attributes

vector_fp m_crot
 
vector_fp m_cinternal
 
vector_fp m_zrot
 
vector_fp m_eps
 
vector_fp m_sigma
 
vector_fp m_alpha
 
DenseMatrix m_dipole
 

Protected Member Functions

 MultiTransport (thermo_t *thermo=0)
 default constructor More...
 
void update_T ()
 Update basic temperature-dependent quantities if the temperature has changed. More...
 
void update_C ()
 Update basic concentration-dependent quantities if the concentrations have changed. More...
 
void updateThermal_T ()
 Update the temperature-dependent terms needed to compute the thermal conductivity and thermal diffusion coefficients. More...
 
void correctBinDiffCoeffs ()
 
void eval_L0000 (const doublereal *const x)
 Evaluate the L0000 matrices. More...
 
void eval_L0010 (const doublereal *const x)
 Evaluate the L0010 matrices. More...
 
void eval_L1000 ()
 Evaluate the L1000 matrices. More...
 
void eval_L0100 ()
 
void eval_L0001 ()
 
void eval_L1010 (const doublereal *x)
 
void eval_L1001 (const doublereal *x)
 
void eval_L0110 ()
 
void eval_L0101 (const doublereal *x)
 
bool hasInternalModes (size_t j)
 
doublereal pressure_ig ()
 
virtual void solveLMatrixEquation ()
 
- Protected Member Functions inherited from GasTransport
 GasTransport (ThermoPhase *thermo=0)
 
virtual void updateViscosity_T ()
 Update the temperature-dependent viscosity terms. More...
 
virtual void updateSpeciesViscosities ()
 Update the pure-species viscosities. More...
 
virtual void updateDiff_T ()
 Update the binary diffusion coefficients. More...
 
- Protected Member Functions inherited from Transport
virtual bool initLiquid (LiquidTransportParams &tr)
 Called by TransportFactory to set parameters. More...
 
void finalize ()
 Enable the transport object for use. More...
 

Protected Attributes

doublereal m_thermal_tlast
 
std::vector< std::vector< int > > m_poly
 
std::vector< vector_fpm_astar_poly
 
std::vector< vector_fpm_bstar_poly
 
std::vector< vector_fpm_cstar_poly
 
std::vector< vector_fpm_om22_poly
 
DenseMatrix m_astar
 Dense matrix for astar. More...
 
DenseMatrix m_bstar
 Dense matrix for bstar. More...
 
DenseMatrix m_cstar
 Dense matrix for cstar. More...
 
DenseMatrix m_om22
 Dense matrix for omega22. More...
 
vector_fp m_sqrt_eps_k
 
DenseMatrix m_log_eps_k
 
vector_fp m_frot_298
 
vector_fp m_rotrelax
 
doublereal m_lambda
 
DenseMatrix m_Lmatrix
 
DenseMatrix m_aa
 
vector_fp m_a
 
vector_fp m_b
 
vector_fp m_spwork1
 
vector_fp m_spwork2
 
vector_fp m_spwork3
 
vector_fp m_molefracs_last
 Mole fraction vector from last L-matrix evaluation. More...
 
bool m_abc_ok
 Boolean indicating viscosity is up to date. More...
 
bool m_l0000_ok
 
bool m_lmatrix_soln_ok
 
DenseMatrix incl
 
bool m_debug
 
- Protected Attributes inherited from GasTransport
vector_fp m_molefracs
 Vector of species mole fractions. More...
 
doublereal m_viscmix
 Internal storage for the viscosity of the mixture (kg /m /s) More...
 
bool m_visc_ok
 Update boolean for mixture rule for the mixture viscosity. More...
 
bool m_viscwt_ok
 Update boolean for the weighting factors for the mixture viscosity. More...
 
bool m_spvisc_ok
 Update boolean for the species viscosities. More...
 
bool m_bindiff_ok
 Update boolean for the binary diffusivities at unit pressure. More...
 
int m_mode
 Type of the polynomial fits to temperature. More...
 
DenseMatrix m_phi
 m_phi is a Viscosity Weighting Function. size = m_nsp * n_nsp More...
 
vector_fp m_spwork
 work space length = m_kk More...
 
vector_fp m_visc
 vector of species viscosities (kg /m /s). More...
 
std::vector< vector_fpm_visccoeffs
 Polynomial fits to the viscosity of each species. More...
 
vector_fp m_mw
 Local copy of the species molecular weights. More...
 
DenseMatrix m_wratjk
 Holds square roots of molecular weight ratios. More...
 
DenseMatrix m_wratkj1
 Holds square roots of molecular weight ratios. More...
 
vector_fp m_sqvisc
 vector of square root of species viscosities sqrt(kg /m /s). More...
 
vector_fp m_polytempvec
 Powers of the ln temperature, up to fourth order. More...
 
doublereal m_temp
 Current value of the temperature at which the properties in this object are calculated (Kelvin). More...
 
doublereal m_kbt
 Current value of Boltzman's constant times the temperature (Joules) More...
 
doublereal m_sqrt_kbt
 current value of Boltzman's constant times the temperature. More...
 
doublereal m_sqrt_t
 current value of temperature to 1/2 power More...
 
doublereal m_logt
 Current value of the log of the temperature. More...
 
doublereal m_t14
 Current value of temperature to 1/4 power. More...
 
doublereal m_t32
 Current value of temperature to the 3/2 power. More...
 
std::vector< vector_fpm_diffcoeffs
 Polynomial fits to the binary diffusivity of each species. More...
 
DenseMatrix m_bdiff
 Matrix of binary diffusion coefficients at the reference pressure and the current temperature Size is nsp x nsp. More...
 
- Protected Attributes inherited from Transport
thermo_tm_thermo
 pointer to the object representing the phase More...
 
bool m_ready
 true if finalize has been called More...
 
size_t m_nsp
 Number of species. More...
 
size_t m_nDim
 Number of dimensions used in flux expressions. More...
 
int m_velocityBasis
 Velocity basis from which diffusion velocities are computed. More...
 

Friends

class TransportFactory
 

Detailed Description

Class MultiTransport implements multicomponent transport properties for ideal gas mixtures.

The implementation generally follows the procedure outlined in Kee, Coltrin, and Glarborg, "Theoretical and Practical Aspects of Chemically Reacting Flow Modeling," Wiley Interscience.

Definition at line 29 of file MultiTransport.h.

Constructor & Destructor Documentation

MultiTransport ( thermo_t thermo = 0)
protected

default constructor

Parameters
thermoOptional parameter for the pointer to the ThermoPhase object

Definition at line 42 of file MultiTransport.cpp.

Member Function Documentation

virtual int model ( ) const
inlinevirtual

Transport model.

The transport model is the set of equations used to compute the transport properties. This method returns an integer flag that identifies the transport model implemented. The base class returns 0.

Reimplemented from Transport.

Definition at line 40 of file MultiTransport.h.

References GasTransport::m_mode.

void getThermalDiffCoeffs ( doublereal *const  dt)
virtual

Return the thermal diffusion coefficients (kg/m/s)

Eqn. (12.126) displays how they are calculated. The reference work is from Dixon-Lewis.

Eqns. (12.168) shows how they are used in an expression for the species flux.

Parameters
dtVector of thermal diffusion coefficients. Units = kg/m/s

Reimplemented from Transport.

Definition at line 128 of file MultiTransport.cpp.

References Cantera::GasConstant, GasTransport::m_molefracs, GasTransport::m_mw, and Transport::m_nsp.

Referenced by MultiTransport::getMassFluxes(), and MultiTransport::getSpeciesFluxes().

doublereal thermalConductivity ( )
virtual

Returns the mixture thermal conductivity in W/m/K.

Units are in W / m K or equivalently kg m / s3 K

Returns
returns thermal conductivity in W/m/K.

Reimplemented from Transport.

Definition at line 118 of file MultiTransport.cpp.

References Transport::m_nsp.

void getMultiDiffCoeffs ( const size_t  ld,
doublereal *const  d 
)
virtual

Return the Multicomponent diffusion coefficients. Units: [m^2/s].

If the transport manager implements a multicomponent diffusion model, then this method returns the array of multicomponent diffusion coefficients. Otherwise it throws an exception.

Parameters
[in]ldThe dimension of the inner loop of d (usually equal to m_nsp)
[out]dflat vector of diffusion coefficients, fortran ordering. d[ld*j+i] is the D_ij diffusion coefficient (the diffusion coefficient for species i due to species j).

Reimplemented from Transport.

Definition at line 446 of file MultiTransport.cpp.

References DATA_PTR, MultiTransport::eval_L0000(), Cantera::int2str(), Cantera::invert(), GasTransport::m_molefracs, GasTransport::m_mw, Transport::m_nsp, GasTransport::m_temp, Transport::m_thermo, Phase::meanMolecularWeight(), MultiTransport::update_C(), MultiTransport::update_T(), and MultiTransport::updateThermal_T().

void getSpeciesFluxes ( size_t  ndim,
const doublereal *const  grad_T,
size_t  ldx,
const doublereal *const  grad_X,
size_t  ldf,
doublereal *const  fluxes 
)
virtual

Get the species diffusive mass fluxes wrt to the mass averaged velocity, given the gradients in mole fraction and temperature.

Units for the returned fluxes are kg m-2 s-1.

Parameters
ndimNumber of dimensions in the flux expressions
grad_TGradient of the temperature (length = ndim)
ldxLeading dimension of the grad_X array (usually equal to m_nsp but not always)
grad_XGradients of the mole fraction Flat vector with the m_nsp in the inner loop. length = ldx * ndim
ldfLeading dimension of the fluxes array (usually equal to m_nsp but not always)
fluxesOutput of the diffusive mass fluxes Flat vector with the m_nsp in the inner loop. length = ldx * ndim

Reimplemented from Transport.

Definition at line 215 of file MultiTransport.cpp.

References DATA_PTR, Phase::density(), MultiTransport::getThermalDiffCoeffs(), DenseMatrix::ipiv(), GasTransport::m_bdiff, GasTransport::m_molefracs, Transport::m_nsp, GasTransport::m_spwork, GasTransport::m_temp, Transport::m_thermo, Phase::massFractions(), Array2D::nColumns(), Array2D::nRows(), Array2D::ptrColumn(), MultiTransport::update_T(), and GasTransport::updateDiff_T().

void getMolarFluxes ( const doublereal *const  state1,
const doublereal *const  state2,
const doublereal  delta,
doublereal *const  fluxes 
)
virtual

Get the molar diffusional fluxes [kmol/m^2/s] of the species, given the thermodynamic state at two nearby points.

The molar diffusional fluxes are calculated with reference to the mass averaged velocity. This is a one-dimensional vector

Parameters
state1Array of temperature, density, and mass fractions for state 1.
state2Array of temperature, density, and mass fractions for state 2.
deltaDistance from state 1 to state 2 (m).
fluxesOutput molar fluxes of the species. (length = m_nsp)

Reimplemented from Transport.

Definition at line 435 of file MultiTransport.cpp.

References MultiTransport::getMassFluxes(), GasTransport::m_mw, Transport::m_thermo, and Phase::nSpecies().

void getMassFluxes ( const doublereal *  state1,
const doublereal *  state2,
doublereal  delta,
doublereal *  fluxes 
)
virtual

Get the mass diffusional fluxes [kg/m^2/s] of the species, given the thermodynamic state at two nearby points.

The specific diffusional fluxes are calculated with reference to the mass averaged velocity. This is a one-dimensional vector

Parameters
state1Array of temperature, density, and mass fractions for state 1.
state2Array of temperature, density, and mass fractions for state 2.
deltaDistance from state 1 to state 2 (m).
fluxesOutput mass fluxes of the species. (length = m_nsp)

Reimplemented from Transport.

Definition at line 329 of file MultiTransport.cpp.

References DATA_PTR, Phase::density(), Phase::getMoleFractions(), MultiTransport::getThermalDiffCoeffs(), Cantera::int2str(), DenseMatrix::ipiv(), GasTransport::m_bdiff, GasTransport::m_molefracs, Transport::m_nsp, GasTransport::m_spwork, GasTransport::m_temp, Transport::m_thermo, Phase::massFractions(), Array2D::nColumns(), Array2D::nRows(), Phase::nSpecies(), ThermoPhase::pressure(), Array2D::ptrColumn(), Phase::restoreState(), ThermoPhase::setState_TPX(), MultiTransport::update_T(), and GasTransport::updateDiff_T().

Referenced by MultiTransport::getMolarFluxes().

bool initGas ( GasTransportParams tr)
virtual
void update_T ( void  )
protectedvirtual

Update basic temperature-dependent quantities if the temperature has changed.

Reimplemented from GasTransport.

Definition at line 486 of file MultiTransport.cpp.

References MultiTransport::m_abc_ok, GasTransport::m_temp, Transport::m_thermo, and Phase::temperature().

Referenced by MultiTransport::getMassFluxes(), MultiTransport::getMultiDiffCoeffs(), and MultiTransport::getSpeciesFluxes().

void update_C ( )
protectedvirtual

Update basic concentration-dependent quantities if the concentrations have changed.

Implements GasTransport.

Definition at line 501 of file MultiTransport.cpp.

References DATA_PTR, Phase::getMoleFractions(), GasTransport::m_molefracs, MultiTransport::m_molefracs_last, Transport::m_nsp, Transport::m_thermo, and Cantera::Tiny.

Referenced by MultiTransport::getMultiDiffCoeffs().

void updateThermal_T ( )
protected
void eval_L0000 ( const doublereal *const  x)
protected

Evaluate the L0000 matrices.

Evaluate the upper-left block of the L matrix.

Parameters
xvector of species mole fractions

Definition at line 23 of file L_matrix.h.

References GasTransport::m_bdiff, GasTransport::m_mw, Transport::m_nsp, and GasTransport::m_temp.

Referenced by MultiTransport::getMultiDiffCoeffs().

void eval_L0010 ( const doublereal *const  x)
protected

Evaluate the L0010 matrices.

Parameters
xvector of species mole fractions

Definition at line 46 of file L_matrix.h.

References GasTransport::m_bdiff, MultiTransport::m_cstar, GasTransport::m_mw, Transport::m_nsp, and GasTransport::m_temp.

void eval_L1000 ( )
protected

Evaluate the L1000 matrices.

Definition at line 69 of file L_matrix.h.

References Transport::m_nsp.

Member Data Documentation

DenseMatrix m_astar
protected

Dense matrix for astar.

Definition at line 152 of file MultiTransport.h.

Referenced by MultiTransport::initGas(), and MultiTransport::updateThermal_T().

DenseMatrix m_bstar
protected

Dense matrix for bstar.

Definition at line 155 of file MultiTransport.h.

Referenced by MultiTransport::initGas(), and MultiTransport::updateThermal_T().

DenseMatrix m_cstar
protected

Dense matrix for cstar.

Definition at line 158 of file MultiTransport.h.

Referenced by MultiTransport::eval_L0010(), MultiTransport::initGas(), and MultiTransport::updateThermal_T().

DenseMatrix m_om22
protected

Dense matrix for omega22.

Definition at line 161 of file MultiTransport.h.

Referenced by MultiTransport::initGas(), and MultiTransport::updateThermal_T().

vector_fp m_molefracs_last
protected

Mole fraction vector from last L-matrix evaluation.

Definition at line 191 of file MultiTransport.h.

Referenced by MultiTransport::initGas(), and MultiTransport::update_C().

bool m_abc_ok
protected

Boolean indicating viscosity is up to date.

Definition at line 196 of file MultiTransport.h.

Referenced by MultiTransport::initGas(), MultiTransport::update_T(), and MultiTransport::updateThermal_T().


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