https://mooseframework.inl.gov
IntegratedBC.C
Go to the documentation of this file.
1 //* This file is part of the MOOSE framework
2 //* https://mooseframework.inl.gov
3 //*
4 //* All rights reserved, see COPYRIGHT for full restrictions
5 //* https://github.com/idaholab/moose/blob/master/COPYRIGHT
6 //*
7 //* Licensed under LGPL 2.1, please see LICENSE for details
8 //* https://www.gnu.org/licenses/lgpl-2.1.html
9 
10 #include "IntegratedBC.h"
11 
12 // MOOSE includes
13 #include "Assembly.h"
14 #include "SubProblem.h"
15 #include "SystemBase.h"
16 #include "MooseVariableFE.h"
17 #include "MooseVariableScalar.h"
18 #include "FEProblemBase.h"
19 
20 #include "libmesh/quadrature.h"
21 
24 {
26  return params;
27 }
28 
30  : IntegratedBCBase(parameters),
32  false,
33  "variable",
36  _var(*mooseVariable()),
37  _normals(_assembly.normals()),
38  _phi(_assembly.phiFace(_var)),
39  _grad_phi(_assembly.gradPhiFace(_var)),
40  _test(_var.phiFace()),
41  _grad_test(_var.gradPhiFace()),
42  _u(_is_implicit ? _var.sln() : _var.slnOld()),
43  _grad_u(_is_implicit ? _var.gradSln() : _var.gradSlnOld())
44 {
46 
47  _save_in.resize(_save_in_strings.size());
48  _diag_save_in.resize(_diag_save_in_strings.size());
49 
50  for (unsigned int i = 0; i < _save_in_strings.size(); i++)
51  {
53 
54  if (var->feType() != _var.feType())
55  paramError(
56  "save_in",
57  "saved-in auxiliary variable is incompatible with the object's nonlinear variable: ",
59  _save_in[i] = var;
62  }
63 
64  _has_save_in = _save_in.size() > 0;
65 
66  for (unsigned int i = 0; i < _diag_save_in_strings.size(); i++)
67  {
69 
70  if (var->feType() != _var.feType())
71  paramError(
72  "diag_save_in",
73  "saved-in auxiliary variable is incompatible with the object's nonlinear variable: ",
75 
76  _diag_save_in[i] = var;
79  }
80 
81  _has_diag_save_in = _diag_save_in.size() > 0;
82 }
83 
84 void
86 {
88 
90 
91  for (_qp = 0; _qp < _qrule->n_points(); _qp++)
92  {
94  for (_i = 0; _i < _test.size(); _i++)
96  }
97 
99 
100  if (_has_save_in)
101  for (unsigned int i = 0; i < _save_in.size(); i++)
102  _save_in[i]->sys().solution().add_vector(_local_re, _save_in[i]->dofIndices());
103 }
104 
105 void
107 {
109 
111 
112  for (_qp = 0; _qp < _qrule->n_points(); _qp++)
113  {
115  for (_i = 0; _i < _test.size(); _i++)
116  for (_j = 0; _j < _phi.size(); _j++)
118  }
119 
121 
122  if (_has_diag_save_in)
123  {
124  unsigned int rows = _local_ke.m();
125  DenseVector<Number> diag(rows);
126  for (unsigned int i = 0; i < rows; i++)
127  diag(i) = _local_ke(i, i);
128 
129  for (unsigned int i = 0; i < _diag_save_in.size(); i++)
130  _diag_save_in[i]->sys().solution().add_vector(diag, _diag_save_in[i]->dofIndices());
131  }
132 }
133 
134 void
135 IntegratedBC::computeOffDiagJacobian(const unsigned int jvar_num)
136 {
137  const auto & jvar = getVariable(jvar_num);
138 
139  if (jvar_num == _var.number())
140  {
141  computeJacobian();
142  return;
143  }
144 
145  prepareMatrixTag(_assembly, _var.number(), jvar_num);
146 
147  precalculateOffDiagJacobian(jvar_num);
148 
149  const auto n_dofs = jvar.dofIndices().size();
150  const auto phi_size = n_dofs / jvar.count();
151  mooseAssert(n_dofs == _local_ke.n(),
152  "The size of the phi container does not match the number of local Jacobian columns");
153 
154  for (_qp = 0; _qp < _qrule->n_points(); _qp++)
155  {
157  for (_i = 0; _i < _test.size(); _i++)
158  for (_j = 0; _j < phi_size; _j++)
159  _local_ke(_i, _j) += _JxW[_qp] * _coord[_qp] * computeQpOffDiagJacobian(jvar_num);
160  }
161 
163 }
164 
165 void
167 {
169 
171  for (_qp = 0; _qp < _qrule->n_points(); _qp++)
172  for (_i = 0; _i < _test.size(); _i++)
173  for (_j = 0; _j < jv.order(); _j++)
175 
177 }
178 
179 void
181 {
182  computeResidual();
183 
184  for (const auto & [ivariable, jvariable] : _fe_problem.couplingEntries(_tid, _sys.number()))
185  {
186  const unsigned int ivar = ivariable->number();
187  const unsigned int jvar = jvariable->number();
188 
189  if (ivar != _var.number())
190  continue;
191 
192  if (_is_implicit)
193  {
194  prepareShapes(jvar);
196  }
197  }
198 
200 }
const VariableTestValue & _test
test function values (in QPs)
Definition: IntegratedBC.h:97
VarFieldType
Definition: MooseTypes.h:770
const libMesh::FEType & feType() const
Get the type of finite element object.
virtual void computeOffDiagJacobian(unsigned int jvar) override
Computes d-ivar-residual / d-jvar...
Definition: IntegratedBC.C:135
virtual Real computeQpJacobian()
Method for computing the diagonal Jacobian at quadrature points.
Definition: IntegratedBC.h:49
std::vector< std::pair< MooseVariableFEBase *, MooseVariableFEBase * > > & couplingEntries(const THREAD_ID tid, const unsigned int nl_sys_num)
void accumulateTaggedLocalResidual()
Local residual blocks will be appended by adding the current local kernel residual.
std::vector< MooseVariableFEBase * > _diag_save_in
Class for stuff related to variables.
Definition: Adaptivity.h:33
void paramError(const std::string &param, Args... args) const
Emits an error prefixed with the file and line number of the given param (from the input file) along ...
Definition: MooseBase.h:467
std::string incompatVarMsg(MooseVariableFieldBase &var1, MooseVariableFieldBase &var2)
Builds and returns a string of the form:
Definition: MooseError.C:26
std::vector< MooseVariableFEBase * > _save_in
virtual void precalculateOffDiagJacobian(unsigned int)
unsigned int number() const
Get variable number coming from libMesh.
virtual Real computeQpOffDiagJacobian(unsigned int)
Method for computing an off-diagonal jacobian component at quadrature points.
Definition: IntegratedBC.h:54
IntegratedBC(const InputParameters &parameters)
Definition: IntegratedBC.C:29
virtual void precalculateResidual()
static InputParameters validParams()
Definition: IntegratedBC.C:23
The main MOOSE class responsible for handling user-defined parameters in almost every MOOSE system...
unsigned int _i
i-th, j-th index for enumerating test and shape functions
unsigned int m() const
THREAD_ID _tid
The thread ID for this kernel.
const VariablePhiValue & _phi
shape function values (in QPs)
Definition: IntegratedBC.h:90
DenseMatrix< Number > _local_ke
Holds local Jacobian entries as they are accumulated by this Kernel.
const MooseVariableFieldBase & getVariable(unsigned int jvar_num) const
Retrieve the variable object from our system associated with jvar_num.
unsigned int _qp
quadrature point index
SystemBase & _sys
Reference to the EquationSystem object.
virtual void computeJacobian() override
Compute this object&#39;s contribution to the diagonal Jacobian entries.
Definition: IntegratedBC.C:106
virtual Real computeQpResidual()=0
Method for computing the residual at quadrature points.
MooseVariableFE< Real > * mooseVariable() const
Return the MooseVariableFE object that this interface acts on.
unsigned int size() const
The number of elements that can currently be stored in the array.
Definition: MooseArray.h:259
virtual void precalculateJacobian()
std::vector< AuxVariableName > _save_in_strings
SubProblem & _subproblem
Reference to this kernel&#39;s SubProblem.
VarKindType
Framework-wide stuff.
Definition: MooseTypes.h:763
virtual void precalculateQpResidual()
Insertion point for evaluations that depend on qp but are independent of the test functions...
Definition: IntegratedBC.h:68
FEProblemBase & _fe_problem
Reference to this kernel&#39;s FEProblemBase.
void computeOffDiagJacobianScalar(unsigned int jvar) override
Computes jacobian block with respect to a scalar variable.
Definition: IntegratedBC.C:166
virtual MooseVariable & getStandardVariable(const THREAD_ID tid, const std::string &var_name)=0
Returns the variable reference for requested MooseVariable which may be in any system.
virtual Real computeQpOffDiagJacobianScalar(unsigned int jvar)
Method for computing an off-diagonal jacobian component from a scalar var.
Definition: IntegratedBC.h:59
void prepareShapes(unsigned int var_num) override final
Prepare shape functions.
unsigned int number() const
Gets the number of this system.
Definition: SystemBase.C:1158
void accumulateTaggedLocalMatrix()
Local Jacobian blocks will be appended by adding the current local kernel Jacobian.
const MooseArray< Real > & _coord
coordinate transformation
bool _has_save_in
The aux variables to save the residual contributions to.
Assembly & _assembly
Reference to this Kernel&#39;s assembly object.
virtual void computeResidualAndJacobian() override
Compute this object&#39;s contribution to the residual and Jacobian simultaneously.
Definition: IntegratedBC.C:180
MooseVariable & _var
Definition: IntegratedBC.h:82
virtual MooseVariableScalar & getScalarVariable(THREAD_ID tid, const std::string &var_name) const
Gets a reference to a scalar variable with specified number.
Definition: SystemBase.C:146
const QBase *const & _qrule
active quadrature rule
void addMooseVariableDependency(MooseVariableFieldBase *var)
Call this function to add the passed in MooseVariableFieldBase as a variable that this object depends...
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
std::vector< AuxVariableName > _diag_save_in_strings
virtual void addVariableToZeroOnResidual(std::string var_name)
Adds this variable to the list of variables to be zeroed during each residual evaluation.
Definition: SystemBase.C:175
DenseVector< Number > _local_re
Holds local residual entries as they are accumulated by this Kernel.
static InputParameters validParams()
Interface for objects that need to get values of MooseVariables.
Class for scalar variables (they are different).
Base class for deriving any boundary condition of a integrated type.
virtual void addVariableToZeroOnJacobian(std::string var_name)
Adds this variable to the list of variables to be zeroed during each Jacobian evaluation.
Definition: SystemBase.C:181
virtual void computeResidual() override
Compute this object&#39;s contribution to the residual.
Definition: IntegratedBC.C:85
MOOSE now contains C++17 code, so give a reasonable error message stating what the user can do to add...
unsigned int n() const
void prepareVectorTag(Assembly &assembly, unsigned int ivar)
Prepare data for computing element residual according to active tags.
void prepareMatrixTag(Assembly &assembly, unsigned int ivar, unsigned int jvar)
Prepare data for computing element jacobian according to the active tags.
bool _has_diag_save_in
The aux variables to save the diagonal Jacobian contributions to.
SystemBase & sys()
Get the system this variable is part of.
bool _is_implicit
If the object is using implicit or explicit form.
const MooseArray< Real > & _JxW
transformed Jacobian weights
virtual void precalculateQpJacobian()
Insertion point for evaluations that depend on qp but are independent of the test and shape functions...
Definition: IntegratedBC.h:74
virtual void precalculateQpOffDiagJacobian(const MooseVariableFEBase &)
Insertion point for evaluations that depend on qp but are independent of the test and shape functions...
Definition: IntegratedBC.h:80