Doxygen update.
Worked on general information for the Transport classes.
This commit is contained in:
parent
1ab5f6725a
commit
39ea7fdeab
2 changed files with 61 additions and 19 deletions
|
|
@ -131,7 +131,7 @@ namespace Cantera {
|
|||
}
|
||||
}
|
||||
//====================================================================================================================
|
||||
/**
|
||||
/*
|
||||
* Thermal Conductivity.
|
||||
* \f[
|
||||
* \lambda = A T^n \exp(-E/RT)
|
||||
|
|
@ -139,11 +139,10 @@ namespace Cantera {
|
|||
*/
|
||||
doublereal SolidTransport::thermalConductivity() {
|
||||
doublereal t = m_thermo->temperature();
|
||||
return m_Alam *pow(t, m_Nlam) * exp(-m_Elam/t);
|
||||
return m_Alam * pow(t, m_Nlam) * exp(-m_Elam/t);
|
||||
}
|
||||
//====================================================================================================================
|
||||
|
||||
/**
|
||||
/*
|
||||
* The diffusion coefficients are computed from
|
||||
*
|
||||
* \f[
|
||||
|
|
|
|||
|
|
@ -69,25 +69,61 @@ namespace Cantera {
|
|||
VB_MASSAVG = -1
|
||||
};
|
||||
|
||||
/**
|
||||
* Base class for transport property managers. All classes that
|
||||
* compute transport properties derive from this class. Class
|
||||
* Transport is meant to be used as a base class only. It is
|
||||
* possible to instantiate it, but its methods throw exceptions if
|
||||
* called.
|
||||
//! Base class for transport property managers.
|
||||
/*!
|
||||
* All classes that compute transport properties for a single phase
|
||||
* derive from this class. Class
|
||||
* %Transport is meant to be used as a base class only. It is
|
||||
* possible to instantiate it, but its methods throw exceptions if
|
||||
* called.
|
||||
*
|
||||
* Note, transport properties for multiphase situations have yet to be
|
||||
* fully developed within Cantera.
|
||||
*
|
||||
* All member functions are virtual, unless otherwise stated.
|
||||
*
|
||||
* <HR>
|
||||
* <H2> Relationship of the %Transport class to the %ThermoPhase Class </H2>
|
||||
* <HR>
|
||||
*
|
||||
* This section describes how calculations are carried out within
|
||||
* the %Transport class. The %Transport class and derived classes of the
|
||||
* the %Transport class necessarily use the %ThermoPhase class to obtain
|
||||
* the list of species and the thermodynamic state of the phase.
|
||||
*
|
||||
* No state information is storred within %Transport classes.
|
||||
* Queries to the underlying ThermoPhase object must be made to obtain
|
||||
* the state of the system.
|
||||
*
|
||||
* An exception to this however is the state information concerning the
|
||||
* the gradients of variables. This information is not storred within
|
||||
* the ThermoPhase objects. It may be collected within the Transport objects.
|
||||
* In fact, the meaning of const operations within the Transport class
|
||||
* refers to calculations which do not change the state of the
|
||||
* system nor the state of the first order gradients of the system.
|
||||
*
|
||||
* When a const operation is evoked within the Transport class, it is
|
||||
* also implicitly assumed that the underlying state within the ThermoPhase
|
||||
* object has not changed its values.
|
||||
*
|
||||
* @todo Provide a general mechanism to store the gradients of state variables
|
||||
* within the system.
|
||||
*
|
||||
* @ingroup tranprops
|
||||
*/
|
||||
class Transport {
|
||||
|
||||
public:
|
||||
|
||||
|
||||
/**
|
||||
* Constructor. New transport managers should be created using
|
||||
//! Constructor.
|
||||
/*!
|
||||
* New transport managers should be created using
|
||||
* TransportFactory, not by calling the constructor directly.
|
||||
*
|
||||
* @param thermo Pointer to the ThermoPhase class representing
|
||||
* this phase.
|
||||
* @param ndim Dimension of the flux vector used in the calculation.
|
||||
*
|
||||
* @see TransportFactory
|
||||
*/
|
||||
Transport(thermo_t* thermo=0, int ndim = 1);
|
||||
|
|
@ -123,7 +159,6 @@ namespace Cantera {
|
|||
// Note ->need working copy constructors and operator=() functions for all first
|
||||
virtual Transport *duplMyselfAsTransport() const;
|
||||
|
||||
|
||||
/**
|
||||
* Transport model. The transport model is the set of
|
||||
* equations used to compute the transport properties. This
|
||||
|
|
@ -159,7 +194,6 @@ namespace Cantera {
|
|||
*/
|
||||
int index() const ;
|
||||
|
||||
|
||||
//! Set an integer index number.
|
||||
/*!
|
||||
* This is for internal use of
|
||||
|
|
@ -489,19 +523,23 @@ namespace Cantera {
|
|||
{ err("getMultiDiffCoeffs"); }
|
||||
|
||||
|
||||
//! Returns a vector of mixture averaged diffusion coefficients
|
||||
/**
|
||||
* Mixture-averaged diffusion coefficients [m^2/s]. If the
|
||||
*
|
||||
* transport manager implements a mixture-averaged diffusion
|
||||
* model, then this method returns the array of
|
||||
* mixture-averaged diffusion coefficients. Otherwise it
|
||||
* throws an exception.
|
||||
*
|
||||
* @param d Return vector of mixture averaged diffusion coefficients
|
||||
* Units = m2/s. Length = n_sp
|
||||
*/
|
||||
virtual void getMixDiffCoeffs(doublereal* const d)
|
||||
{ err("getMixDiffCoeffs"); }
|
||||
|
||||
|
||||
|
||||
//! Set transport model parameters.
|
||||
//! Set model parameters for derived classes
|
||||
/*!
|
||||
* This method may be
|
||||
* overloaded in subclasses to set model-specific parameters.
|
||||
|
|
@ -627,13 +665,14 @@ namespace Cantera {
|
|||
//! Number of dimensions used in flux expresions
|
||||
int m_nDim;
|
||||
|
||||
//! Celocity basis from which diffusion velocities are computed.
|
||||
//! Velocity basis from which diffusion velocities are computed.
|
||||
//! Defaults to the mass averaged basis = -2
|
||||
int m_velocityBasis;
|
||||
|
||||
private:
|
||||
|
||||
/**
|
||||
//! Error routine
|
||||
/*!
|
||||
* Throw an exception if a method of this class is
|
||||
* invoked. This probably indicates that a transport manager
|
||||
* is being used that does not implement all virtual methods,
|
||||
|
|
@ -644,6 +683,10 @@ namespace Cantera {
|
|||
* meaningless. If the application invokes the viscosity()
|
||||
* method, the base class method will be called, resulting in
|
||||
* an exception being thrown.
|
||||
*
|
||||
* @param msg Descriptive message string to add to the error report
|
||||
*
|
||||
* @return returns a double, though we will never get there
|
||||
*/
|
||||
doublereal err(std::string msg) const;
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue