Cantera  3.0.0
Loading...
Searching...
No Matches

The 3- or 4-parameter Troe falloff parameterization. More...

#include <Falloff.h>

Inheritance diagram for TroeRate:
[legend]

Detailed Description

The 3- or 4-parameter Troe falloff parameterization.

The falloff function defines the value of \( F \) in the following rate expression [7]

\[ k = k_{\infty} \left( \frac{P_r}{1 + P_r} \right) F(T, P_r) \]

where

\[ P_r = \frac{k_0 [M]}{k_{\infty}} \]

This parameterization is defined by

\[ \log_{10} F(T, P_r) = \frac{\log_{10} F_{cent}(T)}{1 + f_1^2} \]

where

\[ F_{cent}(T) = (1 - A)\exp\left(\frac{-T}{T_3}\right) + A \exp\left(\frac{-T}{T_1}\right) + \exp\left(\frac{-T_2}{T}\right) \]

\[ f_1 = \frac{\log_{10} P_r + C}{N - 0.14 (\log_{10} P_r + C)} \]

\[ C = -0.4 - 0.67 \log_{10} F_{cent} \]

\[ N = 0.75 - 1.27 \log_{10} F_{cent} \]

  • If \( T_3 \) is zero, then the corresponding term is set to zero.
  • If \( T_1 \) is zero, then the corresponding term is set to zero.
  • If \( T_2 \) is zero, then the corresponding term is set to zero.

Definition at line 333 of file Falloff.h.

Public Member Functions

 TroeRate ()
 Constructor.
 
 TroeRate (const AnyMap &node, const UnitStack &rate_units={})
 
 TroeRate (const ArrheniusRate &low, const ArrheniusRate &high, const vector< double > &c)
 
unique_ptr< MultiRateBasenewMultiRate () const override
 Create a rate evaluator for reactions of a particular derived type.
 
void setFalloffCoeffs (const vector< double > &c) override
 Set coefficients used by parameterization.
 
void getFalloffCoeffs (vector< double > &c) const override
 Retrieve coefficients of the falloff parameterization.
 
void updateTemp (double T, double *work) const override
 Update the temperature parameters in the representation.
 
double F (double pr, const double *work) const override
 The falloff function.
 
size_t workSize () const override
 The size of the work array required.
 
const string subType () const override
 String identifying sub-type of reaction rate specialization.
 
size_t nParameters () const override
 Returns the number of parameters used by this parameterization.
 
void setParameters (const AnyMap &node, const UnitStack &rate_units) override
 Set parameters.
 
void getParameters (double *params) const override
 Sets params to contain, in order,.
 
void getParameters (AnyMap &node) const override
 Get parameters.
 
- Public Member Functions inherited from FalloffRate
 FalloffRate (const AnyMap &node, const UnitStack &rate_units={})
 
void init (const vector< double > &c)
 Initialize.
 
virtual void setFalloffCoeffs (const vector< double > &c)
 Set coefficients of the falloff parameterization.
 
virtual void getFalloffCoeffs (vector< double > &c) const
 Retrieve coefficients of the falloff parameterization.
 
virtual void updateTemp (double T, double *work) const
 Update the temperature-dependent portions of the falloff function, if any, and store them in the 'work' array.
 
virtual double F (double pr, const double *work) const
 The falloff function.
 
double evalF (double T, double conc3b)
 Evaluate falloff function at current conditions.
 
virtual size_t workSize () const
 The size of the work array required.
 
const string type () const override
 String identifying reaction rate specialization.
 
virtual size_t nParameters () const
 Returns the number of parameters used by this parameterization.
 
void setParameters (const AnyMap &node, const UnitStack &rate_units) override
 Set parameters.
 
virtual void getParameters (double *params) const
 Get the values of the parameters for this object.
 
void getParameters (AnyMap &node) const override
 Get parameters.
 
double evalFromStruct (const FalloffData &shared_data)
 Evaluate reaction rate.
 
void check (const string &equation) override
 Check basic syntax and settings of reaction rate expression.
 
void validate (const string &equation, const Kinetics &kin) override
 Validate the reaction rate expression.
 
bool allowNegativePreExponentialFactor () const
 Get flag indicating whether negative A values are permitted.
 
void setAllowNegativePreExponentialFactor (bool value)
 Set flag indicating whether negative A values are permitted.
 
bool chemicallyActivated () const
 Get flag indicating whether reaction is chemically activated.
 
void setChemicallyActivated (bool activated)
 Set flag indicating whether reaction is chemically activated.
 
ArrheniusRatelowRate ()
 Get reaction rate in the low-pressure limit.
 
void setLowRate (const ArrheniusRate &low)
 Set reaction rate in the low-pressure limit.
 
ArrheniusRatehighRate ()
 Get reaction rate in the high-pressure limit.
 
void setHighRate (const ArrheniusRate &high)
 Set reaction rate in the high-pressure limit.
 
- Public Member Functions inherited from ReactionRate
 ReactionRate (const ReactionRate &other)
 
ReactionRateoperator= (const ReactionRate &other)
 
virtual unique_ptr< MultiRateBasenewMultiRate () const
 Create a rate evaluator for reactions of a particular derived type.
 
virtual const string type () const =0
 String identifying reaction rate specialization.
 
virtual const string subType () const
 String identifying sub-type of reaction rate specialization.
 
virtual void setParameters (const AnyMap &node, const UnitStack &units)
 Set parameters.
 
AnyMap parameters () const
 Return the parameters such that an identical Reaction could be reconstructed using the newReaction() function.
 
const UnitsconversionUnits () const
 Get the units for converting the leading term in the reaction rate expression.
 
virtual void setRateUnits (const UnitStack &rate_units)
 Set the units of the reaction rate expression.
 
virtual void check (const string &equation)
 Check basic syntax and settings of reaction rate expression.
 
void check (const string &equation, const AnyMap &node)
 Check basic syntax and settings of reaction rate expression.
 
virtual void validate (const string &equation, const Kinetics &kin)
 Validate the reaction rate expression.
 
virtual void validate (const string &equation)
 Validate the reaction rate expression (legacy call)
 
size_t rateIndex () const
 Reaction rate index within kinetics evaluator.
 
void setRateIndex (size_t idx)
 Set reaction rate index within kinetics evaluator.
 
virtual void setContext (const Reaction &rxn, const Kinetics &kin)
 Set context of reaction rate evaluation.
 
double eval (double T)
 Evaluate reaction rate based on temperature.
 
double eval (double T, double extra)
 Evaluate reaction rate based on temperature and an extra parameter.
 
double eval (double T, const vector< double > &extra)
 Evaluate reaction rate based on temperature and an extra vector parameter.
 
bool valid () const
 Get flag indicating whether reaction rate is set up correctly.
 
bool compositionDependent ()
 Boolean indicating whether rate has compositional dependence.
 
void setCompositionDependence (bool comp_dep)
 Set rate compositional dependence.
 

Protected Attributes

double m_a
 parameter a in the 4-parameter Troe falloff function. Dimensionless
 
double m_rt3
 parameter 1/T_3 in the 4-parameter Troe falloff function. [K^-1]
 
double m_rt1
 parameter 1/T_1 in the 4-parameter Troe falloff function. [K^-1]
 
double m_t2
 parameter T_2 in the 4-parameter Troe falloff function. [K]
 
- Protected Attributes inherited from FalloffRate
ArrheniusRate m_lowRate
 The reaction rate in the low-pressure limit.
 
ArrheniusRate m_highRate
 The reaction rate in the high-pressure limit.
 
bool m_chemicallyActivated = false
 Flag labeling reaction as chemically activated.
 
bool m_negativeA_ok = false
 Flag indicating whether negative A values are permitted.
 
double m_rc_low = NAN
 Evaluated reaction rate in the low-pressure limit.
 
double m_rc_high = NAN
 Evaluated reaction rate in the high-pressure limit.
 
vector< double > m_work
 Work vector.
 
- Protected Attributes inherited from ReactionRate
AnyMap m_input
 Input data used for specific models.
 
size_t m_rate_index = npos
 Index of reaction rate within kinetics evaluator.
 
bool m_valid = false
 Flag indicating whether reaction rate is set up correctly.
 
bool m_composition_dependent_rate = false
 Flag indicating composition dependent rate.
 
Units m_conversion_units {0.}
 Units of the leading term in the reaction rate expression.
 

Additional Inherited Members

virtual void getParameters (AnyMap &node) const
 Get parameters.
 

Constructor & Destructor Documentation

◆ TroeRate() [1/3]

TroeRate ( )
inline

Constructor.

Definition at line 337 of file Falloff.h.

◆ TroeRate() [2/3]

TroeRate ( const AnyMap node,
const UnitStack rate_units = {} 
)

Definition at line 225 of file Falloff.cpp.

◆ TroeRate() [3/3]

TroeRate ( const ArrheniusRate low,
const ArrheniusRate high,
const vector< double > &  c 
)

Definition at line 231 of file Falloff.cpp.

Member Function Documentation

◆ newMultiRate()

unique_ptr< MultiRateBase > newMultiRate ( ) const
inlineoverridevirtual

Create a rate evaluator for reactions of a particular derived type.

Derived classes usually implement this as:

unique_ptr<MultiRateBase> newMultiRate() const override {
return make_unique<MultiRate<RateType, DataType>>();
unique_ptr< MultiRateBase > newMultiRate() const override
Create a rate evaluator for reactions of a particular derived type.
Definition Falloff.h:345

where RateType is the derived class name and DataType is the corresponding container for parameters needed to evaluate reactions of that type.

Reimplemented from ReactionRate.

Definition at line 345 of file Falloff.h.

◆ setFalloffCoeffs()

void setFalloffCoeffs ( const vector< double > &  c)
overridevirtual

Set coefficients used by parameterization.

Parameters
cVector of three or four doubles: The doubles are the parameters, a, T_3, T_1, and (optionally) T_2 of the Troe parameterization

Reimplemented from FalloffRate.

Definition at line 240 of file Falloff.cpp.

◆ getFalloffCoeffs()

void getFalloffCoeffs ( vector< double > &  c) const
overridevirtual

Retrieve coefficients of the falloff parameterization.

Parameters
cVector of coefficients of the parameterization. The number and meaning of these coefficients is subclass-dependent.

Reimplemented from FalloffRate.

Definition at line 277 of file Falloff.cpp.

◆ updateTemp()

void updateTemp ( double  T,
double *  work 
) const
overridevirtual

Update the temperature parameters in the representation.

Parameters
TTemperature (Kelvin)
workVector of working space, length 1, representing the temperature-dependent part of the parameterization.

Reimplemented from FalloffRate.

Definition at line 290 of file Falloff.cpp.

◆ F()

double F ( double  pr,
const double *  work 
) const
overridevirtual

The falloff function.

Parameters
prreduced pressure (dimensionless).
workarray of size workSize() containing cached temperature-dependent intermediate results from a prior call to updateTemp.
Returns
the value of the falloff function \( F \) defined above

Reimplemented from FalloffRate.

Definition at line 299 of file Falloff.cpp.

◆ workSize()

size_t workSize ( ) const
inlineoverridevirtual

The size of the work array required.

Deprecated:
To be removed after Cantera 3.0; unused.

Reimplemented from FalloffRate.

Definition at line 368 of file Falloff.h.

◆ subType()

const string subType ( ) const
inlineoverridevirtual

String identifying sub-type of reaction rate specialization.

Reimplemented from ReactionRate.

Definition at line 372 of file Falloff.h.

◆ nParameters()

size_t nParameters ( ) const
inlineoverridevirtual

Returns the number of parameters used by this parameterization.

The values of these parameters can be obtained from getParameters().

Reimplemented from FalloffRate.

Definition at line 376 of file Falloff.h.

◆ setParameters()

void setParameters ( const AnyMap node,
const UnitStack units 
)
overridevirtual

Set parameters.

Parameters
nodeAnyMap object containing reaction rate specification
unitsunit definitions specific to rate information

Reimplemented from FalloffRate.

Definition at line 309 of file Falloff.cpp.

◆ getParameters() [1/2]

void getParameters ( double *  params) const
overridevirtual

Sets params to contain, in order,.

\[ (A, T_3, T_1, T_2) \]

Deprecated:
To be removed after Cantera 3.0; superseded by getFalloffCoeffs()

Reimplemented from FalloffRate.

Definition at line 331 of file Falloff.cpp.

◆ getParameters() [2/2]

void getParameters ( AnyMap node) const
overridevirtual

Get parameters.

Parameters
nodeAnyMap containing rate information Store the parameters of a ReactionRate needed to reconstruct an identical object. Does not include user-defined fields available in the m_input map.

Reimplemented from FalloffRate.

Definition at line 340 of file Falloff.cpp.

Member Data Documentation

◆ m_a

double m_a
protected

parameter a in the 4-parameter Troe falloff function. Dimensionless

Definition at line 392 of file Falloff.h.

◆ m_rt3

double m_rt3
protected

parameter 1/T_3 in the 4-parameter Troe falloff function. [K^-1]

Definition at line 395 of file Falloff.h.

◆ m_rt1

double m_rt1
protected

parameter 1/T_1 in the 4-parameter Troe falloff function. [K^-1]

Definition at line 398 of file Falloff.h.

◆ m_t2

double m_t2
protected

parameter T_2 in the 4-parameter Troe falloff function. [K]

Definition at line 401 of file Falloff.h.


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