Reaktoro  v2.11.0
A unified framework for modeling chemically reactive systems
EquilibriumPredictor.hpp
1 // Reaktoro is a unified framework for modeling chemically reactive systems.
2 //
3 // Copyright © 2014-2024 Allan Leal
4 //
5 // This library is free software; you can redistribute it and/or
6 // modify it under the terms of the GNU Lesser General Public
7 // License as published by the Free Software Foundation; either
8 // version 2.1 of the License, or (at your option) any later version.
9 //
10 // This library is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 // Lesser General Public License for more details.
14 //
15 // You should have received a copy of the GNU Lesser General Public License
16 // along with this library. If not, see <http://www.gnu.org/licenses/>.
17 
18 #pragma once
19 
20 // Reaktoro includes
21 #include <Reaktoro/Common/Types.hpp>
22 #include <Reaktoro/Common/Matrix.hpp>
23 
24 namespace Reaktoro {
25 
26 // Forward declarations
27 class ChemicalState;
28 class EquilibriumConditions;
29 class EquilibriumSensitivity;
30 
33 {
34 public:
38  EquilibriumPredictor(ChemicalState const& state0, EquilibriumSensitivity const& sensitivity0);
39 
42 
45 
48 
52  auto predict(ChemicalState& state, EquilibriumConditions const& conditions) const -> void;
53 
58  auto predict(ChemicalState& state, VectorXdConstRef const& dw, VectorXdConstRef const& dc) const -> void;
59 
61  auto speciesChemicalPotentialPredicted(Index ispecies, VectorXdConstRef const& dw, VectorXdConstRef const& dc) const -> double;
62 
64  auto speciesChemicalPotentialReference(Index ispecies) const -> double;
65 
66 private:
67  struct Impl;
68 
69  Ptr<Impl> pimpl;
70 };
71 
72 } // namespace Reaktoro
The chemical state of a chemical system.
Definition: ChemicalState.hpp:41
The class used to define conditions to be satisfied at chemical equilibrium.
Definition: EquilibriumConditions.hpp:32
Used to predict a chemical equilibrium state at given conditions using first-order Taylor approximati...
Definition: EquilibriumPredictor.hpp:33
EquilibriumPredictor(ChemicalState const &state0, EquilibriumSensitivity const &sensitivity0)
Construct a EquilibriumPredictor object.
auto predict(ChemicalState &state, VectorXdConstRef const &dw, VectorXdConstRef const &dc) const -> void
Perform a first-order Taylor prediction of the chemical state at given conditions.
~EquilibriumPredictor()
Destroy this EquilibriumPredictor object.
auto speciesChemicalPotentialReference(Index ispecies) const -> double
Return the chemical potential of a species at given reference conditions.
auto predict(ChemicalState &state, EquilibriumConditions const &conditions) const -> void
Perform a first-order Taylor prediction of the chemical state at given conditions.
EquilibriumPredictor(EquilibriumPredictor const &other)
Construct a copy of a EquilibriumPredictor object.
auto operator=(EquilibriumPredictor other) -> EquilibriumPredictor &
Assign a copy of a EquilibriumPredictor object to this.
auto speciesChemicalPotentialPredicted(Index ispecies, VectorXdConstRef const &dw, VectorXdConstRef const &dc) const -> double
Perform a first-order Taylor prediction of the chemical potential of a species at given conditions.
The sensitivity derivatives of a chemical equilibrium state.
Definition: EquilibriumSensitivity.hpp:37
The namespace containing all components of the Reaktoro library.
Definition: Algorithms.hpp:29
std::size_t Index
Define a type that represents an index.
Definition: Index.hpp:26
std::unique_ptr< T > Ptr
Convenient alias for std::unique_ptr<T>.
Definition: Types.hpp:102
Eigen::Ref< const VectorXd > VectorXdConstRef
Convenient alias to Eigen type.
Definition: Matrix.hpp:76