https://mooseframework.inl.gov
Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions | Static Protected Member Functions | Protected Attributes | List of all members
AqueousReactionsEquilibriumPhysics Class Reference

Creates all the objects needed to solve a reaction network of chemical reactions at equilibrium in an aqueous medium with a finite element continuous Galerkin discretization. More...

#include <AqueousReactionsEquilibriumPhysics.h>

Inheritance diagram for AqueousReactionsEquilibriumPhysics:
[legend]

Public Types

typedef DataFileName DataFileParameterType
 

Public Member Functions

 AqueousReactionsEquilibriumPhysics (const InputParameters &parameters)
 
void addComponent (const ActionComponent &component) override
 
virtual InputParameters getAdditionalRMParams () const
 
virtual void act () override final
 
virtual void actOnAdditionalTasks ()
 
void addBlocks (const std::vector< SubdomainName > &blocks)
 
void addBlocksById (const std::vector< SubdomainID > &block_ids)
 
const std::vector< SubdomainName > & blocks () const
 
bool checkBlockRestrictionIdentical (const std::string &object_name, const std::vector< SubdomainName > &blocks, const bool error_if_not_identical=true) const
 
bool hasBlocks (const std::vector< SubdomainName > &blocks) const
 
const TgetCoupledPhysics (const PhysicsName &phys_name, const bool allow_fail=false) const
 
const std::vector< T *> getCoupledPhysics (const bool allow_fail=false) const
 
unsigned int dimension () const
 
const ActionComponentgetActionComponent (const ComponentName &comp_name) const
 
void checkComponentType (const ActionComponent &component) const
 
const std::vector< VariableName > & solverVariableNames () const
 
const std::vector< VariableName > & auxVariableNames () const
 
void timedAct ()
 
MooseObjectName uniqueActionName () const
 
const std::string & specificTaskName () const
 
const std::set< std::string > & getAllTasks () const
 
void appendTask (const std::string &task)
 
MooseAppgetMooseApp () const
 
const std::string & type () const
 
const std::string & name () const
 
std::string typeAndName () const
 
MooseObjectParameterName uniqueParameterName (const std::string &parameter_name) const
 
MooseObjectName uniqueName () const
 
const InputParametersparameters () const
 
const hit::Node * getHitNode () const
 
bool hasBase () const
 
const std::string & getBase () const
 
const TgetParam (const std::string &name) const
 
std::vector< std::pair< T1, T2 > > getParam (const std::string &param1, const std::string &param2) const
 
const TqueryParam (const std::string &name) const
 
const TgetRenamedParam (const std::string &old_name, const std::string &new_name) const
 
T getCheckedPointerParam (const std::string &name, const std::string &error_string="") const
 
bool haveParameter (const std::string &name) const
 
bool isParamValid (const std::string &name) const
 
bool isParamSetByUser (const std::string &name) const
 
void connectControllableParams (const std::string &parameter, const std::string &object_type, const std::string &object_name, const std::string &object_parameter) const
 
void paramError (const std::string &param, Args... args) const
 
void paramWarning (const std::string &param, Args... args) const
 
void paramWarning (const std::string &param, Args... args) const
 
void paramInfo (const std::string &param, Args... args) const
 
std::string messagePrefix (const bool hit_prefix=true) const
 
std::string errorPrefix (const std::string &) const
 
void mooseError (Args &&... args) const
 
void mooseDocumentedError (const std::string &repo_name, const unsigned int issue_num, Args &&... args) const
 
void mooseErrorNonPrefixed (Args &&... args) const
 
void mooseWarning (Args &&... args) const
 
void mooseWarning (Args &&... args) const
 
void mooseWarningNonPrefixed (Args &&... args) const
 
void mooseWarningNonPrefixed (Args &&... args) const
 
void mooseDeprecated (Args &&... args) const
 
void mooseDeprecated (Args &&... args) const
 
void mooseDeprecatedNoTrace (Args &&... args) const
 
void mooseInfo (Args &&... args) const
 
void callMooseError (std::string msg, const bool with_prefix, const hit::Node *node=nullptr, const bool show_trace=true) const
 
std::string getDataFileName (const std::string &param) const
 
std::string getDataFileNameByName (const std::string &relative_path) const
 
std::string getDataFilePath (const std::string &relative_path) const
 
PerfGraphperfGraph ()
 
void assertParamDefined (const std::string &libmesh_dbg_var(param)) const
 
const Parallel::Communicator & comm () const
 
processor_id_type n_processors () const
 
processor_id_type processor_id () const
 

Static Public Member Functions

static InputParameters validParams ()
 
static void callMooseError (MooseApp *const app, const InputParameters &params, std::string msg, const bool with_prefix, const hit::Node *node, const bool show_trace=true)
 

Public Attributes

 usingCombinedWarningSolutionWarnings
 
const ConsoleStream _console
 

Static Public Attributes

static const std::string unique_action_name_param
 
static const std::string type_param
 
static const std::string name_param
 
static const std::string unique_name_param
 
static const std::string app_param
 
static const std::string moose_base_param
 
static const std::string kokkos_object_param
 
static constexpr auto SYSTEM
 
static constexpr auto NAME
 

Protected Member Functions

virtual void addAuxiliaryKernels () override
 
virtual void addFEKernels () override
 
void assertParamDefined (const std::string &param) const
 
bool isTransient () const
 
FactorygetFactory ()
 
FactorygetFactory () const
 
virtual FEProblemBasegetProblem ()
 
virtual const FEProblemBasegetProblem () const
 
void prepareCopyVariablesFromMesh () const
 
void copyVariablesFromMesh (const std::vector< VariableName > &variables_to_copy, bool are_nonlinear=true)
 
std::string prefix () const
 
void saveSolverVariableName (const VariableName &var_name)
 
void saveAuxVariableName (const VariableName &var_name)
 
bool variableExists (const VariableName &var_name, bool error_if_aux) const
 
bool solverVariableExists (const VariableName &var_name) const
 
const SolverSystemName & getSolverSystem (unsigned int variable_index) const
 
const SolverSystemName & getSolverSystem (const VariableName &variable_name) const
 
void addRequiredPhysicsTask (const std::string &task)
 
void assignBlocks (InputParameters &params, const std::vector< SubdomainName > &blocks) const
 
bool allMeshBlocks (const std::vector< SubdomainName > &blocks) const
 
bool allMeshBlocks (const std::set< SubdomainName > &blocks) const
 
std::set< SubdomainIDgetSubdomainIDs (const std::set< SubdomainName > &blocks) const
 
std::vector< std::string > getSubdomainNamesAndIDs (const std::set< SubdomainID > &blocks) const
 
void addPetscPairsToPetscOptions (const std::vector< std::pair< MooseEnumItem, std::string >> &petsc_pair_options)
 
bool isVariableFV (const VariableName &var_name) const
 
bool isVariableScalar (const VariableName &var_name) const
 
bool shouldCreateVariable (const VariableName &var_name, const std::vector< SubdomainName > &blocks, const bool error_if_aux)
 
bool shouldCreateIC (const VariableName &var_name, const std::vector< SubdomainName > &blocks, const bool ic_is_default_ic, const bool error_if_already_defined) const
 
bool shouldCreateTimeDerivative (const VariableName &var_name, const std::vector< SubdomainName > &blocks, const bool error_if_already_defined) const
 
void reportPotentiallyMissedParameters (const std::vector< std::string > &param_names, const std::string &object_type, const std::string &object_name="") const
 
virtual void checkIntegrity () const
 
bool addRelationshipManagers (Moose::RelationshipManagerType when_type, const InputParameters &moose_object_pars)
 
void associateWithParameter (const std::string &param_name, InputParameters &params) const
 
void associateWithParameter (const InputParameters &from_params, const std::string &param_name, InputParameters &params) const
 
const TgetMeshProperty (const std::string &data_name, const std::string &prefix)
 
const TgetMeshProperty (const std::string &data_name)
 
bool hasMeshProperty (const std::string &data_name, const std::string &prefix) const
 
bool hasMeshProperty (const std::string &data_name, const std::string &prefix) const
 
bool hasMeshProperty (const std::string &data_name) const
 
bool hasMeshProperty (const std::string &data_name) const
 
std::string meshPropertyName (const std::string &data_name) const
 
PerfID registerTimedSection (const std::string &section_name, const unsigned int level) const
 
PerfID registerTimedSection (const std::string &section_name, const unsigned int level, const std::string &live_message, const bool print_dots=true) const
 
std::string timedSectionName (const std::string &section_name) const
 
void flagInvalidSolutionInternal (const InvalidSolutionID invalid_solution_id) const
 
InvalidSolutionID registerInvalidSolutionInternal (const std::string &message, const bool warning) const
 
void checkParamsBothSetOrNotSet (const std::string &param1, const std::string &param2) const
 
void checkSecondParamSetOnlyIfFirstOneTrue (const std::string &param1, const std::string &param2) const
 
void checkSecondParamSetOnlyIfFirstOneSet (const std::string &param1, const std::string &param2) const
 
void checkSecondParamNotSetIfFirstOneSet (const std::string &param1, const std::string &param2) const
 
void checkVectorParamsSameLength (const std::string &param1, const std::string &param2) const
 
void checkVectorParamAndMultiMooseEnumLength (const std::string &param1, const std::string &param2) const
 
void checkTwoDVectorParamsSameLength (const std::string &param1, const std::string &param2) const
 
void checkVectorParamsNoOverlap (const std::vector< std::string > &param_vecs) const
 
void checkTwoDVectorParamsNoRespectiveOverlap (const std::vector< std::string > &param_vecs) const
 
void checkTwoDVectorParamInnerSameLengthAsOneDVector (const std::string &param1, const std::string &param2) const
 
void checkTwoDVectorParamMultiMooseEnumSameLength (const std::string &param1, const std::string &param2, const bool error_for_param2) const
 
void checkVectorParamNotEmpty (const std::string &param1) const
 
void checkVectorParamsSameLengthIfSet (const std::string &param1, const std::string &param2, const bool ignore_empty_default_param2=false) const
 
void checkVectorParamLengthSameAsCombinedOthers (const std::string &param1, const std::string &param2, const std::string &param3) const
 
void checkBlockwiseConsistency (const std::string &block_param_name, const std::vector< std::string > &parameter_names) const
 
bool parameterConsistent (const InputParameters &other_param, const std::string &param_name) const
 
void warnInconsistent (const InputParameters &parameters, const std::string &param_name) const
 
void errorDependentParameter (const std::string &param1, const std::string &value_not_set, const std::vector< std::string > &dependent_params) const
 
void errorInconsistentDependentParameter (const std::string &param1, const std::string &value_set, const std::vector< std::string > &dependent_params) const
 

Static Protected Member Functions

static std::string meshPropertyName (const std::string &data_name, const std::string &prefix)
 

Protected Attributes

std::vector< std::vector< Real > > _stos
 Stoichiometric coefficients for each primary species (outer indexing) in each reaction. More...
 
std::vector< std::vector< Real > > _sto_u
 Stoichiometric coefficients of primary/solver variables (outer indexing) in each reaction. More...
 
std::vector< std::vector< std::vector< Real > > > _sto_v
 Stoichiometric coefficients of coupled primary variables (outer indexing) in each reaction. More...
 
std::vector< std::vector< Real > > _weights
 Weight of each primary species (outer indexing) in each reaction. More...
 
std::vector< Real_log_eq_const
 log10(Equilibrium constants) for each reaction More...
 
std::vector< VariableName > _eq_species
 Equilibrium species: only one per reaction. This is a restriction of this implementation. More...
 
std::vector< std::vector< bool > > _primary_participation
 Vector of vectors, indexed by (i, j), of whether primary solver species 'i' is present in reaction 'j'. More...
 
std::vector< std::vector< std::vector< VariableName > > > _coupled_v
 Coupled primary species for each reaction (outer indexing is primary species, then reactions then innermost is the species in the reaction) More...
 
std::vector< std::vector< VariableName > > _solver_species_involved
 Primary species involved in the ith equilibrium reaction (outer indexing) More...
 
const std::vector< VariableName > & _pressure_var
 Name of the pressure variable. More...
 
const RealVectorValue _gravity
 Gravity vector. More...
 
const std::vector< VariableName > & _solver_species
 Name of the species variables to solve for in the reaction network. More...
 
const unsigned int _num_solver_species
 Number of species to solve for. More...
 
const std::vector< AuxVariableName > & _aux_species
 Name of the species variables that can be computed without additional solves, simply auxkernels. More...
 
const unsigned int _num_aux_species
 Number of auxiliary species. More...
 
std::vector< std::string > _reactions_input
 Reaction network as a vector of lines for pretty output. More...
 
const std::vector< ReactionNetworkUtils::Reaction_reactions
 Reaction network after being parsed in initializePhysics() More...
 
const unsigned int _num_reactions
 Number of reactions involved in the network. More...
 
std::vector< SolverSystemName > _system_names
 
std::vector< unsigned int_system_numbers
 
const bool _verbose
 
const MooseEnum_preconditioning
 
std::vector< SubdomainName > _blocks
 
std::string _registered_identifier
 
std::string _specific_task_name
 
std::set< std::string > _all_tasks
 
ActionWarehouse_awh
 
const std::string & _current_task
 
std::shared_ptr< MooseMesh > & _mesh
 
std::shared_ptr< MooseMesh > & _displaced_mesh
 
std::shared_ptr< FEProblemBase > & _problem
 
PerfID _act_timer
 
MooseApp_app
 
Factory_factory
 
ActionFactory_action_factory
 
const std::string & _type
 
const std::string & _name
 
const InputParameters_pars
 
MooseApp_pg_moose_app
 
const std::string _prefix
 
const Parallel::Communicator & _communicator
 

Detailed Description

Creates all the objects needed to solve a reaction network of chemical reactions at equilibrium in an aqueous medium with a finite element continuous Galerkin discretization.

Definition at line 18 of file AqueousReactionsEquilibriumPhysics.h.

Constructor & Destructor Documentation

◆ AqueousReactionsEquilibriumPhysics()

AqueousReactionsEquilibriumPhysics::AqueousReactionsEquilibriumPhysics ( const InputParameters parameters)

Definition at line 49 of file AqueousReactionsEquilibriumPhysics.C.

57  _pressure_var(getParam<std::vector<VariableName>>("pressure"))
58 {
59  // Further parse the reactions
60  // Keeping the data in these vectors of vectors as an intermediate processing step
61  for (const auto i : index_range(_reactions))
62  {
63  const auto & reaction = _reactions[i];
64  _solver_species_involved.push_back(reaction.getReactantSpecies());
65  _stos.push_back(reaction.getStoichiometricCoefficients());
66 
67  // There are only one equilibrium species. We look at the output species
68  const auto & products = reaction.getProductSpecies();
69  if (products.size() != 1)
70  mooseError("Reaction:\n" + _reactions_input[i] +
71  "\n has more than one product species (on the RHS). This Physics only supports "
72  "one product species per reaction");
73  _eq_species.push_back(products[0]);
74 
75  // If user passed log_K use that, else use K
76  if (reaction.hasMetaData<Real>("log10_K"))
77  _log_eq_const.push_back(std::stod(reaction.getMetaData("log10_K")));
78  else if (reaction.hasMetaData<Real>("K"))
79  _log_eq_const.push_back(std::log10(std::stod(reaction.getMetaData("K"))));
80  else if (reaction.hasMetaData("K") || reaction.hasMetaData("log10_K"))
81  paramError("reactions",
82  "Equilibrium constant species in square brackets must be specified as a float, "
83  "not a name");
84  else
85  paramError("reactions",
86  "Reaction: '" + _reactions_input[i] +
87  "'\n is missing an equilibrium constant [K=] or its logarithm [log10_K=] in "
88  "its metadata");
89  }
90 
91  // For each primary/solver species, we examine the reactions to get the coefficients
92  // and various constants
93  for (unsigned int i = 0; i < _solver_species.size(); ++i)
94  {
95  _sto_u[i].resize(_num_reactions, 0.0);
96  _sto_v[i].resize(_num_reactions);
97  _coupled_v[i].resize(_num_reactions);
98  _weights[i].resize(_num_reactions, 0.0);
99 
100  _primary_participation[i].resize(_num_reactions, false);
101  for (unsigned int j = 0; j < _num_reactions; ++j)
102  {
103  // Set the booleans for involvement in a reaction
104  for (unsigned int k = 0; k < _solver_species_involved[j].size(); ++k)
106  _primary_participation[i][j] = true;
107 
108  if (_primary_participation[i][j])
109  {
110  for (unsigned int k = 0; k < _solver_species_involved[j].size(); ++k)
111  {
112  // Re-sort the coefficients into a more convenient format
114  {
115  _sto_u[i][j] = _stos[j][k];
116  _weights[i][j] = _stos[j][k];
117  }
118  else
119  {
120  _sto_v[i][j].push_back(_stos[j][k]);
121  _coupled_v[i][j].push_back(_solver_species_involved[j][k]);
122  }
123  }
124  }
125  }
126  }
127 
128  // Parameter checks
129  checkSecondParamSetOnlyIfFirstOneTrue("add_darcy_advection_term", "pressure");
130  checkSecondParamSetOnlyIfFirstOneTrue("add_darcy_advection_term", "gravity");
131 }
const std::vector< ReactionNetworkUtils::Reaction > _reactions
Reaction network after being parsed in initializePhysics()
std::vector< std::vector< Real > > _stos
Stoichiometric coefficients for each primary species (outer indexing) in each reaction.
std::string reaction(const DenseMatrix< Real > &stoi, unsigned row, const std::vector< std::string > &names, Real stoi_tol=1.0E-6, int precision=4)
Returns a nicely formatted string corresponding to the reaction defined by the given row of the stoic...
void paramError(const std::string &param, Args... args) const
const T & getParam(const std::string &name) const
std::vector< std::string > _reactions_input
Reaction network as a vector of lines for pretty output.
const unsigned int _num_reactions
Number of reactions involved in the network.
const InputParameters & parameters() const
const std::vector< VariableName > & _solver_species
Name of the species variables to solve for in the reaction network.
std::vector< std::vector< VariableName > > _solver_species_involved
Primary species involved in the ith equilibrium reaction (outer indexing)
std::vector< std::vector< std::vector< Real > > > _sto_v
Stoichiometric coefficients of coupled primary variables (outer indexing) in each reaction...
std::vector< std::vector< std::vector< VariableName > > > _coupled_v
Coupled primary species for each reaction (outer indexing is primary species, then reactions then inn...
std::vector< std::vector< bool > > _primary_participation
Vector of vectors, indexed by (i, j), of whether primary solver species &#39;i&#39; is present in reaction &#39;j...
std::vector< std::vector< Real > > _sto_u
Stoichiometric coefficients of primary/solver variables (outer indexing) in each reaction.
std::vector< Real > _log_eq_const
log10(Equilibrium constants) for each reaction
void mooseError(Args &&... args) const
static const std::complex< double > j(0, 1)
Complex number "j" (also known as "i")
std::vector< std::vector< Real > > _weights
Weight of each primary species (outer indexing) in each reaction.
const std::vector< VariableName > & _pressure_var
Name of the pressure variable.
const unsigned int _num_solver_species
Number of species to solve for.
ReactionNetworkPhysicsBase(const InputParameters &parameters)
void checkSecondParamSetOnlyIfFirstOneTrue(const std::string &param1, const std::string &param2) const
static const std::string k
Definition: NS.h:134
auto index_range(const T &sizable)
std::vector< VariableName > _eq_species
Equilibrium species: only one per reaction. This is a restriction of this implementation.

Member Function Documentation

◆ addAuxiliaryKernels()

void AqueousReactionsEquilibriumPhysics::addAuxiliaryKernels ( )
overrideprotectedvirtual

Reimplemented from PhysicsBase.

Definition at line 196 of file AqueousReactionsEquilibriumPhysics.C.

197 {
198  // Add AqueousEquilibriumRxnAux AuxKernels for equilibrium species
199  for (const auto j : make_range(_num_reactions))
200  {
201  // Add these aux-kernels only for the aux species involved in the reaction
202  // we should not be adding them twice, since only 1 eq_species per reaction
203  if (std::find(_aux_species.begin(), _aux_species.end(), _eq_species[j]) != _aux_species.end())
204  {
205  InputParameters params_eq = _factory.getValidParams("AqueousEquilibriumRxnAux");
206  assignBlocks(params_eq, _blocks);
207  params_eq.set<AuxVariableName>("variable") = _eq_species[j];
208  params_eq.defaultCoupledValue("log_k", _log_eq_const[j]);
209  mooseAssert(_stos[j].size() >= _solver_species_involved[j].size(),
210  "Coefs are for solver + auxiliary");
211  std::vector<Real> stos_primary(_stos[j].begin(),
212  _stos[j].begin() + _solver_species_involved[j].size());
213  params_eq.set<std::vector<Real>>("sto_v") = stos_primary;
214  params_eq.set<std::vector<VariableName>>("v") = _solver_species_involved[j];
215  getProblem().addAuxKernel("AqueousEquilibriumRxnAux", "aux_" + _eq_species[j], params_eq);
216  }
217  }
218 }
void assignBlocks(InputParameters &params, const std::vector< SubdomainName > &blocks) const
std::vector< std::vector< Real > > _stos
Stoichiometric coefficients for each primary species (outer indexing) in each reaction.
const unsigned int _num_reactions
Number of reactions involved in the network.
Factory & _factory
T & set(const std::string &name, bool quiet_mode=false)
InputParameters getValidParams(const std::string &name) const
std::vector< std::vector< VariableName > > _solver_species_involved
Primary species involved in the ith equilibrium reaction (outer indexing)
virtual void addAuxKernel(const std::string &kernel_name, const std::string &name, InputParameters &parameters)
std::vector< SubdomainName > _blocks
virtual FEProblemBase & getProblem()
const std::vector< AuxVariableName > & _aux_species
Name of the species variables that can be computed without additional solves, simply auxkernels...
Real defaultCoupledValue(const std::string &coupling_name, unsigned int i=0) const
std::vector< Real > _log_eq_const
log10(Equilibrium constants) for each reaction
IntRange< T > make_range(T beg, T end)
static const std::complex< double > j(0, 1)
Complex number "j" (also known as "i")
std::vector< VariableName > _eq_species
Equilibrium species: only one per reaction. This is a restriction of this implementation.

◆ addComponent()

void ReactionNetworkPhysicsBase::addComponent ( const ActionComponent component)
overridevirtualinherited

Reimplemented from PhysicsBase.

Definition at line 133 of file ReactionNetworkPhysicsBase.C.

134 {
135  for (const auto & block : component.blocks())
136  _blocks.push_back(block);
137 }
static const std::string component
Definition: NS.h:157
std::vector< SubdomainName > _blocks

◆ addFEKernels()

void AqueousReactionsEquilibriumPhysics::addFEKernels ( )
overrideprotectedvirtual

Reimplemented from PhysicsBase.

Definition at line 134 of file AqueousReactionsEquilibriumPhysics.C.

135 {
136  // Add Kernels for each primary species
137  // Note that the equations are on a per-species basis!
138  // So equations are organized differently than reactions
139  for (const auto i : index_range(_solver_species))
140  {
141  for (const auto j : make_range(_num_reactions))
142  {
143  if (_primary_participation[i][j])
144  {
145  {
146  InputParameters params_sub = _factory.getValidParams("CoupledBEEquilibriumSub");
147  assignBlocks(params_sub, _blocks);
148  params_sub.set<NonlinearVariableName>("variable") = _solver_species[i];
149  params_sub.set<Real>("weight") = _weights[i][j];
150  params_sub.defaultCoupledValue("log_k", _log_eq_const[j]);
151  params_sub.set<Real>("sto_u") = _sto_u[i][j];
152  params_sub.set<std::vector<Real>>("sto_v") = _sto_v[i][j];
153  params_sub.set<std::vector<VariableName>>("v") = _coupled_v[i][j];
154  _problem->addKernel("CoupledBEEquilibriumSub",
155  _solver_species[i] + "_" + _eq_species[j] + "_sub",
156  params_sub);
157  }
158 
159  {
160  InputParameters params_cd = _factory.getValidParams("CoupledDiffusionReactionSub");
161  assignBlocks(params_cd, _blocks);
162  params_cd.set<NonlinearVariableName>("variable") = _solver_species[i];
163  params_cd.set<Real>("weight") = _weights[i][j];
164  params_cd.defaultCoupledValue("log_k", _log_eq_const[j]);
165  params_cd.set<Real>("sto_u") = _sto_u[i][j];
166  params_cd.set<std::vector<Real>>("sto_v") = _sto_v[i][j];
167  params_cd.set<std::vector<VariableName>>("v") = _coupled_v[i][j];
168  _problem->addKernel("CoupledDiffusionReactionSub",
169  _solver_species[i] + "_" + _eq_species[j] + "_cd",
170  params_cd);
171  }
172 
173  // If pressure is coupled, add a CoupledConvectionReactionSub Kernel as well
174  if (getParam<bool>("add_darcy_advection_term") && isParamValid("pressure"))
175  {
176  InputParameters params_conv = _factory.getValidParams("CoupledConvectionReactionSub");
177  assignBlocks(params_conv, _blocks);
178  params_conv.set<NonlinearVariableName>("variable") = _solver_species[i];
179  params_conv.set<Real>("weight") = _weights[i][j];
180  params_conv.defaultCoupledValue("log_k", _log_eq_const[j]);
181  params_conv.set<Real>("sto_u") = _sto_u[i][j];
182  params_conv.set<std::vector<Real>>("sto_v") = _sto_v[i][j];
183  params_conv.set<std::vector<VariableName>>("v") = _coupled_v[i][j];
184  params_conv.set<std::vector<VariableName>>("p") = _pressure_var;
185  params_conv.set<RealVectorValue>("gravity") = getParam<RealVectorValue>("gravity");
186  _problem->addKernel("CoupledConvectionReactionSub",
187  _solver_species[i] + "_" + _eq_species[j] + "_conv",
188  params_conv);
189  }
190  }
191  }
192  }
193 }
void assignBlocks(InputParameters &params, const std::vector< SubdomainName > &blocks) const
const unsigned int _num_reactions
Number of reactions involved in the network.
Factory & _factory
T & set(const std::string &name, bool quiet_mode=false)
InputParameters getValidParams(const std::string &name) const
const std::vector< VariableName > & _solver_species
Name of the species variables to solve for in the reaction network.
std::vector< SubdomainName > _blocks
Real defaultCoupledValue(const std::string &coupling_name, unsigned int i=0) const
std::vector< std::vector< std::vector< Real > > > _sto_v
Stoichiometric coefficients of coupled primary variables (outer indexing) in each reaction...
std::vector< std::vector< std::vector< VariableName > > > _coupled_v
Coupled primary species for each reaction (outer indexing is primary species, then reactions then inn...
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
std::vector< std::vector< bool > > _primary_participation
Vector of vectors, indexed by (i, j), of whether primary solver species &#39;i&#39; is present in reaction &#39;j...
std::vector< std::vector< Real > > _sto_u
Stoichiometric coefficients of primary/solver variables (outer indexing) in each reaction.
std::vector< Real > _log_eq_const
log10(Equilibrium constants) for each reaction
IntRange< T > make_range(T beg, T end)
std::shared_ptr< FEProblemBase > & _problem
static const std::complex< double > j(0, 1)
Complex number "j" (also known as "i")
std::vector< std::vector< Real > > _weights
Weight of each primary species (outer indexing) in each reaction.
bool isParamValid(const std::string &name) const
const std::vector< VariableName > & _pressure_var
Name of the pressure variable.
auto index_range(const T &sizable)
std::vector< VariableName > _eq_species
Equilibrium species: only one per reaction. This is a restriction of this implementation.

◆ validParams()

InputParameters AqueousReactionsEquilibriumPhysics::validParams ( )
static

Definition at line 19 of file AqueousReactionsEquilibriumPhysics.C.

20 {
22  params.addClassDescription("Forms the equations for the chemical reaction networks in a fluid"
23  " medium using a continuous Galerkin finite element discretization.");
24 
25  // Rename parameters to match the previously existing actions for AqueousEquilibrium
26  // ReactionNetwork
27  params.renameParam("solver_variables", "primary_species", "The list of primary species to add");
28  params.renameParam(
29  "auxiliary_variables", "secondary_species", "The list of secondary species to add");
30  params.renameParam(
31  "variable_order", "order", "Order of both the primary and secondary species variables");
32  params.renameParam("equation_scaling", "scaling", "");
33  params.setDocString("reactions", "The list of equilibrium reactions occuring in the fluid");
34 
35  // To preserve the legacy option to perform Darcy-advection with AqueousEquilibrium
36  // ReactionNetwork
37  params.addParam<bool>("add_darcy_advection_term",
38  false,
39  "Whether to add an advection term using the Darcy equation to compute the "
40  "advecting velocity");
41  params.addParam<std::vector<VariableName>>(
42  "pressure", {}, "Pressure variable (for Darcy advection)");
43  params.addParam<RealVectorValue>(
44  "gravity", RealVectorValue(0, 0, -9.81), "Gravity vector (for Darcy advection)");
45 
46  return params;
47 }
void renameParam(const std::string &old_name, const std::string &new_name, const std::string &new_docstring)
void addParam(const std::string &name, const std::initializer_list< typename T::value_type > &value, const std::string &doc_string)
void setDocString(const std::string &name, const std::string &doc)
static InputParameters validParams()
void addClassDescription(const std::string &doc_string)

Member Data Documentation

◆ _aux_species

const std::vector<AuxVariableName>& ReactionNetworkPhysicsBase::_aux_species
protectedinherited

Name of the species variables that can be computed without additional solves, simply auxkernels.

Definition at line 43 of file ReactionNetworkPhysicsBase.h.

Referenced by addAuxiliaryKernels(), ReactionNetworkPhysicsBase::addAuxiliaryVariables(), and ReactionNetworkPhysicsBase::ReactionNetworkPhysicsBase().

◆ _coupled_v

std::vector<std::vector<std::vector<VariableName> > > AqueousReactionsEquilibriumPhysics::_coupled_v
protected

Coupled primary species for each reaction (outer indexing is primary species, then reactions then innermost is the species in the reaction)

Definition at line 45 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addFEKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _eq_species

std::vector<VariableName> AqueousReactionsEquilibriumPhysics::_eq_species
protected

Equilibrium species: only one per reaction. This is a restriction of this implementation.

Definition at line 40 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addAuxiliaryKernels(), addFEKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _gravity

const RealVectorValue AqueousReactionsEquilibriumPhysics::_gravity
protected

Gravity vector.

Definition at line 52 of file AqueousReactionsEquilibriumPhysics.h.

◆ _log_eq_const

std::vector<Real> AqueousReactionsEquilibriumPhysics::_log_eq_const
protected

log10(Equilibrium constants) for each reaction

Definition at line 38 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addAuxiliaryKernels(), addFEKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _num_aux_species

const unsigned int ReactionNetworkPhysicsBase::_num_aux_species
protectedinherited

Number of auxiliary species.

Definition at line 45 of file ReactionNetworkPhysicsBase.h.

◆ _num_reactions

const unsigned int ReactionNetworkPhysicsBase::_num_reactions
protectedinherited

◆ _num_solver_species

const unsigned int ReactionNetworkPhysicsBase::_num_solver_species
protectedinherited

Number of species to solve for.

Definition at line 41 of file ReactionNetworkPhysicsBase.h.

◆ _pressure_var

const std::vector<VariableName>& AqueousReactionsEquilibriumPhysics::_pressure_var
protected

Name of the pressure variable.

Definition at line 50 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addFEKernels().

◆ _primary_participation

std::vector<std::vector<bool> > AqueousReactionsEquilibriumPhysics::_primary_participation
protected

Vector of vectors, indexed by (i, j), of whether primary solver species 'i' is present in reaction 'j'.

Definition at line 42 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addFEKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _reactions

const std::vector<ReactionNetworkUtils::Reaction> ReactionNetworkPhysicsBase::_reactions
protectedinherited

Reaction network after being parsed in initializePhysics()

Definition at line 49 of file ReactionNetworkPhysicsBase.h.

Referenced by AqueousReactionsEquilibriumPhysics().

◆ _reactions_input

std::vector<std::string> ReactionNetworkPhysicsBase::_reactions_input
protectedinherited

Reaction network as a vector of lines for pretty output.

Definition at line 47 of file ReactionNetworkPhysicsBase.h.

Referenced by AqueousReactionsEquilibriumPhysics(), and ReactionNetworkPhysicsBase::ReactionNetworkPhysicsBase().

◆ _solver_species

const std::vector<VariableName>& ReactionNetworkPhysicsBase::_solver_species
protectedinherited

◆ _solver_species_involved

std::vector<std::vector<VariableName> > AqueousReactionsEquilibriumPhysics::_solver_species_involved
protected

Primary species involved in the ith equilibrium reaction (outer indexing)

Definition at line 47 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addAuxiliaryKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _sto_u

std::vector<std::vector<Real> > AqueousReactionsEquilibriumPhysics::_sto_u
protected

Stoichiometric coefficients of primary/solver variables (outer indexing) in each reaction.

Definition at line 32 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addFEKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _sto_v

std::vector<std::vector<std::vector<Real> > > AqueousReactionsEquilibriumPhysics::_sto_v
protected

Stoichiometric coefficients of coupled primary variables (outer indexing) in each reaction.

Definition at line 34 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addFEKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _stos

std::vector<std::vector<Real> > AqueousReactionsEquilibriumPhysics::_stos
protected

Stoichiometric coefficients for each primary species (outer indexing) in each reaction.

Definition at line 30 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addAuxiliaryKernels(), and AqueousReactionsEquilibriumPhysics().

◆ _weights

std::vector<std::vector<Real> > AqueousReactionsEquilibriumPhysics::_weights
protected

Weight of each primary species (outer indexing) in each reaction.

Definition at line 36 of file AqueousReactionsEquilibriumPhysics.h.

Referenced by addFEKernels(), and AqueousReactionsEquilibriumPhysics().


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