Cantera  3.1.0a1
ConstPressureReactor.cpp
Go to the documentation of this file.
1 //! @file ConstPressureReactor.cpp A constant pressure zero-dimensional reactor
2 
3 // This file is part of Cantera. See License.txt in the top-level directory or
4 // at https://cantera.org/license.txt for license and copyright information.
5 
8 #include "cantera/zeroD/Wall.h"
12 #include "cantera/base/utilities.h"
13 
14 namespace Cantera
15 {
16 
18 {
19  if (m_thermo == 0) {
20  throw CanteraError("ConstPressureReactor::getState",
21  "Error: reactor is empty.");
22  }
23  m_thermo->restoreState(m_state);
24 
25  // set the first component to the total mass
26  y[0] = m_thermo->density() * m_vol;
27 
28  // set the second component to the total enthalpy
29  y[1] = m_thermo->enthalpy_mass() * m_thermo->density() * m_vol;
30 
31  // set components y+2 ... y+K+1 to the mass fractions Y_k of each species
32  m_thermo->getMassFractions(y+2);
33 
34  // set the remaining components to the surface species
35  // coverages on the walls
37 }
38 
40 {
42  m_nv -= 1; // Constant pressure reactor has one fewer state variable
43 }
44 
46 {
47  // The components of y are [0] the total mass, [1] the total enthalpy,
48  // [2...K+2) are the mass fractions of each species, and [K+2...] are the
49  // coverages of surface species on each wall.
50  m_mass = y[0];
51  m_thermo->setMassFractions_NoNorm(y+2);
52  if (m_energy) {
53  m_thermo->setState_HP(y[1]/m_mass, m_pressure);
54  } else {
55  m_thermo->setPressure(m_pressure);
56  }
57  m_vol = m_mass / m_thermo->density();
58  updateConnected(false);
59  updateSurfaceState(y + m_nsp + 2);
60 }
61 
62 void ConstPressureReactor::eval(double time, double* LHS, double* RHS)
63 {
64  double& dmdt = RHS[0];
65  double* mdYdt = RHS + 2; // mass * dY/dt
66 
67  dmdt = 0.0;
68 
69  evalWalls(time);
70 
71  m_thermo->restoreState(m_state);
72  const vector<double>& mw = m_thermo->molecularWeights();
73  const double* Y = m_thermo->massFractions();
74 
75  evalSurfaces(LHS + m_nsp + 2, RHS + m_nsp + 2, m_sdot.data());
76  double mdot_surf = dot(m_sdot.begin(), m_sdot.end(), mw.begin());
77  dmdt += mdot_surf;
78 
79  if (m_chem) {
80  m_kin->getNetProductionRates(&m_wdot[0]); // "omega dot"
81  }
82 
83  for (size_t k = 0; k < m_nsp; k++) {
84  // production in gas phase and from surfaces
85  mdYdt[k] = (m_wdot[k] * m_vol + m_sdot[k]) * mw[k];
86  // dilution by net surface mass flux
87  mdYdt[k] -= Y[k] * mdot_surf;
88  //Assign left-hand side of dYdt ODE as total mass
89  LHS[k+2] = m_mass;
90  }
91 
92  // external heat transfer
93  double dHdt = m_Qdot;
94 
95  // add terms for outlets
96  for (auto outlet : m_outlet) {
97  double mdot = outlet->massFlowRate();
98  dmdt -= mdot;
99  dHdt -= mdot * m_enthalpy;
100  }
101 
102  // add terms for inlets
103  for (auto inlet : m_inlet) {
104  double mdot = inlet->massFlowRate();
105  dmdt += mdot; // mass flow into system
106  for (size_t n = 0; n < m_nsp; n++) {
107  double mdot_spec = inlet->outletSpeciesMassFlowRate(n);
108  // flow of species into system and dilution by other species
109  mdYdt[n] += mdot_spec - mdot * Y[n];
110  }
111  dHdt += mdot * inlet->enthalpy_mass();
112  }
113 
114  if (m_energy) {
115  RHS[1] = dHdt;
116  } else {
117  RHS[1] = 0.0;
118  }
119 }
120 
121 size_t ConstPressureReactor::componentIndex(const string& nm) const
122 {
123  size_t k = speciesIndex(nm);
124  if (k != npos) {
125  return k + 2;
126  } else if (nm == "mass") {
127  return 0;
128  } else if (nm == "enthalpy") {
129  return 1;
130  } else {
131  return npos;
132  }
133 }
134 
136  if (k == 0) {
137  return "mass";
138  } else if (k == 1) {
139  return "enthalpy";
140  } else if (k >= 2 && k < neq()) {
141  k -= 2;
142  if (k < m_thermo->nSpecies()) {
143  return m_thermo->speciesName(k);
144  } else {
145  k -= m_thermo->nSpecies();
146  }
147  for (auto& S : m_surfaces) {
148  ThermoPhase* th = S->thermo();
149  if (k < th->nSpecies()) {
150  return th->speciesName(k);
151  } else {
152  k -= th->nSpecies();
153  }
154  }
155  }
156  throw CanteraError("ConstPressureReactor::componentName",
157  "Index is out of bounds.");
158 }
159 
160 }
Base class for kinetics managers and also contains the kineticsmgr module documentation (see Kinetics...
Header file for class ReactorSurface.
Header for a simple thermodynamics model of a surface phase derived from ThermoPhase,...
Header file for base class WallBase.
Base class for exceptions thrown by Cantera classes.
Definition: ctexceptions.h:66
void eval(double t, double *LHS, double *RHS) override
Evaluate the reactor governing equations.
size_t componentIndex(const string &nm) const override
Return the index in the solution vector for this reactor of the component named nm.
void getState(double *y) override
Get the the current state of the reactor.
string componentName(size_t k) override
Return the name of the solution component with index i.
void updateState(double *y) override
Set the state of the reactor to correspond to the state vector y.
void initialize(double t0=0.0) override
Initialize the reactor.
double outletSpeciesMassFlowRate(size_t k)
Mass flow rate (kg/s) of outlet species k.
Definition: FlowDevice.cpp:72
double enthalpy_mass()
specific enthalpy
Definition: FlowDevice.cpp:84
double massFlowRate()
Mass flow rate (kg/s).
Definition: FlowDevice.h:39
virtual void getNetProductionRates(double *wdot)
Species net production rates [kmol/m^3/s or kmol/m^2/s].
Definition: Kinetics.cpp:363
void restoreState(const vector< double > &state)
Restore a state saved on a previous call to saveState.
Definition: Phase.cpp:260
size_t nSpecies() const
Returns the number of species in the phase.
Definition: Phase.h:231
virtual void setMassFractions_NoNorm(const double *const y)
Set the mass fractions to the specified values without normalizing.
Definition: Phase.cpp:355
virtual void setPressure(double p)
Set the internally stored pressure (Pa) at constant temperature and composition.
Definition: Phase.h:616
string speciesName(size_t k) const
Name of the species with index k.
Definition: Phase.cpp:142
const double * massFractions() const
Return a const pointer to the mass fraction array.
Definition: Phase.h:442
const vector< double > & molecularWeights() const
Return a const reference to the internal vector of molecular weights.
Definition: Phase.cpp:395
virtual double density() const
Density (kg/m^3).
Definition: Phase.h:587
void getMassFractions(double *const y) const
Get the species mass fractions.
Definition: Phase.cpp:471
FlowDevice & outlet(size_t n=0)
Return a reference to the n-th outlet FlowDevice connected to this reactor.
double m_pressure
Current pressure in the reactor [Pa].
Definition: ReactorBase.h:259
FlowDevice & inlet(size_t n=0)
Return a reference to the n-th inlet FlowDevice connected to this reactor.
double m_vol
Current volume of the reactor [m^3].
Definition: ReactorBase.h:256
size_t m_nsp
Number of homogeneous species in the mixture.
Definition: ReactorBase.h:253
double m_enthalpy
Current specific enthalpy of the reactor [J/kg].
Definition: ReactorBase.h:257
virtual void evalSurfaces(double *LHS, double *RHS, double *sdot)
Evaluate terms related to surface reactions.
Definition: Reactor.cpp:287
virtual void updateSurfaceState(double *y)
Update the state of SurfPhase objects attached to this reactor.
Definition: Reactor.cpp:175
Kinetics * m_kin
Pointer to the homogeneous Kinetics object that handles the reactions.
Definition: Reactor.h:277
vector< double > m_wdot
Species net molar production rates.
Definition: Reactor.h:289
virtual void evalWalls(double t)
Evaluate terms related to Walls.
Definition: Reactor.cpp:275
size_t neq()
Number of equations (state variables) for this reactor.
Definition: Reactor.h:103
double m_Qdot
net heat transfer into the reactor, through walls [W]
Definition: Reactor.h:281
double m_mass
total mass
Definition: Reactor.h:283
vector< double > m_sdot
Production rates of gas phase species on surfaces [kmol/s].
Definition: Reactor.h:287
virtual void getSurfaceInitialConditions(double *y)
Get initial conditions for SurfPhase objects attached to this reactor.
Definition: Reactor.cpp:75
void initialize(double t0=0.0) override
Initialize the reactor.
Definition: Reactor.cpp:84
virtual size_t speciesIndex(const string &nm) const
Return the index in the solution vector for this reactor of the species named nm, in either the homog...
Definition: Reactor.cpp:426
virtual void updateConnected(bool updatePressure)
Update the state information needed by connected reactors, flow devices, and reactor walls.
Definition: Reactor.cpp:184
Base class for a phase with thermodynamic properties.
Definition: ThermoPhase.h:390
virtual void setState_HP(double h, double p, double tol=1e-9)
Set the internally stored specific enthalpy (J/kg) and pressure (Pa) of the phase.
double enthalpy_mass() const
Specific enthalpy. Units: J/kg.
Definition: ThermoPhase.h:1028
double dot(InputIter x_begin, InputIter x_end, InputIter2 y_begin)
Function that calculates a templated inner product.
Definition: utilities.h:82
Namespace for the Cantera kernel.
Definition: AnyMap.cpp:564
const size_t npos
index returned by functions to indicate "no position"
Definition: ct_defs.h:180
Various templated functions that carry out common vector and polynomial operations (see Templated Arr...