ReversibleReaction.H
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration | Website: https://openfoam.org
5  \\ / A nd | Copyright (C) 2011-2019 OpenFOAM Foundation
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8 License
9  This file is part of OpenFOAM.
10 
11  OpenFOAM is free software: you can redistribute it and/or modify it
12  under the terms of the GNU General Public License as published by
13  the Free Software Foundation, either version 3 of the License, or
14  (at your option) any later version.
15 
16  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
17  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19  for more details.
20 
21  You should have received a copy of the GNU General Public License
22  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
23 
24 Class
25  Foam::ReversibleReaction
26 
27 Description
28  Simple extension of Reaction to handle reversible reactions using
29  equilibrium thermodynamics.
30 
31 SourceFiles
32  ReversibleReaction.C
33 
34 \*---------------------------------------------------------------------------*/
35 
36 #ifndef ReversibleReaction_H
37 #define ReversibleReaction_H
38 
39 #include "Reaction.H"
40 
41 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
42 
43 namespace Foam
44 {
45 
46 /*---------------------------------------------------------------------------*\
47  Class ReversibleReaction Declaration
48 \*---------------------------------------------------------------------------*/
49 
50 template<class ReactionThermo, class ReactionRate>
52 :
53  public Reaction<ReactionThermo>
54 {
55  // Private Data
56 
57  ReactionRate k_;
58 
59 
60 public:
61 
62  //- Runtime type information
63  TypeName("reversible");
64 
65 
66  // Constructors
67 
68  //- Construct from components
70  (
72  const ReactionRate& k
73  );
74 
75  //- Construct as copy given new speciesTable
77  (
79  const speciesTable& species
80  );
81 
82  //- Construct from dictionary
84  (
85  const speciesTable& species,
86  const HashPtrTable<ReactionThermo>& thermoDatabase,
87  const dictionary& dict
88  );
89 
90  //- Construct from objectRegistry and dictionary
92  (
93  const speciesTable& species,
94  const HashPtrTable<ReactionThermo>& thermoDatabase,
95  const objectRegistry& ob,
96  const dictionary& dict
97  );
98 
99  //- Construct and return a clone
100  virtual autoPtr<Reaction<ReactionThermo>> clone() const
101  {
103  (
105  );
106  }
107 
108  //- Construct and return a clone with new speciesTable
110  (
111  const speciesTable& species
112  ) const
113  {
115  (
117  (
118  *this,
119  species
120  )
121  );
122  }
123 
124 
125  //- Destructor
126  virtual ~ReversibleReaction()
127  {}
128 
129 
130  // Member Functions
131 
132  // ReversibleReaction rate coefficients
133 
134  //- Forward rate constant
135  virtual scalar kf
136  (
137  const scalar p,
138  const scalar T,
139  const scalarField& c,
140  const label li
141  ) const;
142 
143  //- Reverse rate constant from the given formard rate constant
144  virtual scalar kr
145  (
146  const scalar kfwd,
147  const scalar p,
148  const scalar T,
149  const scalarField& c,
150  const label li
151  ) const;
152 
153  //- Reverse rate constant.
154  // Note this evaluates the forward rate constant and divides by
155  // the equilibrium constant
156  virtual scalar kr
157  (
158  const scalar p,
159  const scalar T,
160  const scalarField& c,
161  const label li
162  ) const;
163 
164 
165  // ReversibleReaction Jacobian functions
166 
167  //- Temperature derivative of forward rate
168  virtual scalar dkfdT
169  (
170  const scalar p,
171  const scalar T,
172  const scalarField& c,
173  const label li
174  ) const;
175 
176  //- Temperature derivative of backward rate
177  virtual scalar dkrdT
178  (
179  const scalar p,
180  const scalar T,
181  const scalarField& c,
182  const label li,
183  const scalar dkfdT,
184  const scalar kr
185  ) const;
186 
187  //- Third-body efficiencies (beta = 1-alpha)
188  // non-empty only for third-body reactions
189  // with enhanced molecularity (alpha != 1)
190  virtual const List<Tuple2<label, scalar>>& beta() const;
191 
192  //- Species concentration derivative of the pressure dependent term
193  // By default this value is 1 as it multiplies the third-body term
194  virtual void dcidc
195  (
196  const scalar p,
197  const scalar T,
198  const scalarField& c,
199  const label li,
201  ) const;
202 
203  //- Temperature derivative of the pressure dependent term
204  // By default this value is 0 since ddT of molecularity is approx.0
205  virtual scalar dcidT
206  (
207  const scalar p,
208  const scalar T,
209  const scalarField& c,
210  const label li
211  ) const;
212 
213 
214  //- Write
215  virtual void write(Ostream&) const;
216 
217 
218  // Member Operators
219 
220  //- Disallow default bitwise assignment
221  void operator=
222  (
224  ) = delete;
225 };
226 
227 
228 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
229 
230 } // End namespace Foam
231 
232 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
233 
234 #ifdef NoRepository
235  #include "ReversibleReaction.C"
236 #endif
237 
238 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
239 
240 #endif
241 
242 // ************************************************************************* //
dictionary dict
intWM_LABEL_SIZE_t label
A label is an int32_t or int64_t as specified by the pre-processor macro WM_LABEL_SIZE.
Definition: label.H:59
virtual const List< Tuple2< label, scalar > > & beta() const
Third-body efficiencies (beta = 1-alpha)
A list of keyword definitions, which are a keyword followed by any number of values (e...
Definition: dictionary.H:158
A 1D array of objects of type <T>, where the size of the vector is known and used for subscript bound...
Definition: HashTable.H:59
label k
Boltzmann constant.
A HashTable specialization for hashing pointers.
Definition: HashPtrTable.H:50
virtual ~ReversibleReaction()
Destructor.
const dimensionedScalar & c
Speed of light in a vacuum.
virtual scalar dcidT(const scalar p, const scalar T, const scalarField &c, const label li) const
Temperature derivative of the pressure dependent term.
virtual void dcidc(const scalar p, const scalar T, const scalarField &c, const label li, scalarField &dcidc) const
Species concentration derivative of the pressure dependent term.
Simple extension of ReactionThermo to handle reaction kinetics in addition to the equilibrium thermod...
Definition: Reaction.H:56
const speciesTable & species() const
Return the specie list.
Definition: Reaction.C:715
virtual scalar kr(const scalar kfwd, const scalar p, const scalar T, const scalarField &c, const label li) const
Reverse rate constant from the given formard rate constant.
virtual void write(Ostream &) const
Write.
CombustionModel< rhoReactionThermo > & reaction
virtual scalar kf(const scalar p, const scalar T, const scalarField &c, const label li) const
Forward rate constant.
virtual scalar dkfdT(const scalar p, const scalar T, const scalarField &c, const label li) const
Temperature derivative of forward rate.
An Ostream is an abstract base class for all output systems (streams, files, token lists...
Definition: Ostream.H:54
void T(FieldField< Field, Type > &f1, const FieldField< Field, Type > &f2)
virtual autoPtr< Reaction< ReactionThermo > > clone() const
Construct and return a clone.
A wordList with hashed indices for faster lookup by name.
virtual scalar dkrdT(const scalar p, const scalar T, const scalarField &c, const label li, const scalar dkfdT, const scalar kr) const
Temperature derivative of backward rate.
ReversibleReaction(const Reaction< ReactionThermo > &reaction, const ReactionRate &k)
Construct from components.
An auto-pointer similar to the STL auto_ptr but with automatic casting to a reference to the type and...
Definition: PtrList.H:52
TypeName("reversible")
Runtime type information.
volScalarField & p
Registry of regIOobjects.
Namespace for OpenFOAM.
Simple extension of Reaction to handle reversible reactions using equilibrium thermodynamics.