https://mooseframework.inl.gov
PicardSolve.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 "PicardSolve.h"
11 
12 #include "Executioner.h"
13 #include "FEProblemBase.h"
14 #include "NonlinearSystem.h"
16 #include "Console.h"
17 
20 {
22  return params;
23 }
24 
26 
27 void
28 PicardSolve::allocateStorage(const bool primary)
29 {
30  if (!performingRelaxation(primary))
31  return;
32 
33  const std::vector<PostprocessorName> * transformed_pps;
34  std::vector<std::vector<PostprocessorValue>> * transformed_pps_values;
35  if (primary)
36  {
37  _old_tag_id =
40 
41  transformed_pps = &_transformed_pps;
42  transformed_pps_values = &_transformed_pps_values;
43  }
44  else
45  {
48 
49  transformed_pps = &_secondary_transformed_pps;
50  transformed_pps_values = &_secondary_transformed_pps_values;
51  }
52 
53  // Allocate storage for the previous postprocessor values
54  (*transformed_pps_values).resize((*transformed_pps).size());
55  for (const auto i : index_range(*transformed_pps))
56  (*transformed_pps_values)[i].resize(1);
57 }
58 
59 void
61 {
62  // Primary is copied back by _solver_sys.copyPreviousFixedPointSolutions()
63  if (!performingRelaxation(primary) || primary)
64  return;
65 
66  // Check to make sure allocateStorage has been called
68  "allocateStorage has not been called with primary = " + Moose::stringify(primary));
69 
70  // Save variable previous values
73  transformed_old = solution;
74 }
75 
76 void
78 {
79  if (!performingRelaxation(primary))
80  return;
81 
82  const std::vector<PostprocessorName> * transformed_pps;
83  std::vector<std::vector<PostprocessorValue>> * transformed_pps_values;
84  if (primary)
85  {
86  transformed_pps = &_transformed_pps;
87  transformed_pps_values = &_transformed_pps_values;
88  }
89  else
90  {
91  transformed_pps = &_secondary_transformed_pps;
92  transformed_pps_values = &_secondary_transformed_pps_values;
93  }
94 
95  // Save postprocessor previous values
96  for (const auto i : index_range(*transformed_pps))
97  (*transformed_pps_values)[i][0] = getPostprocessorValueByName((*transformed_pps)[i]);
98 }
99 
100 bool
102 {
103  // unrelaxed Picard is the default update for fixed point iterations
104  // old values are required for relaxation
105  const auto fixed_point_it = primary ? _fixed_point_it : _main_fixed_point_it;
106  return performingRelaxation(primary) && fixed_point_it > 0;
107 }
108 
109 void
111 {
112  Real relaxation_factor;
113  const std::vector<PostprocessorName> * transformed_pps;
114  std::vector<std::vector<PostprocessorValue>> * transformed_pps_values;
115  if (primary)
116  {
117  relaxation_factor = _relax_factor;
118  transformed_pps = &_transformed_pps;
119  transformed_pps_values = &_transformed_pps_values;
120  }
121  else
122  {
123  relaxation_factor = _secondary_relaxation_factor;
124  transformed_pps = &_secondary_transformed_pps;
125  transformed_pps_values = &_secondary_transformed_pps_values;
126  }
127 
128  // Relax the postprocessors
129  for (size_t i = 0; i < (*transformed_pps).size(); i++)
130  {
131  // Get new postprocessor value
132  const Real current_value = getPostprocessorValueByName((*transformed_pps)[i]);
133  const Real old_value = (*transformed_pps_values)[i][0];
134 
135  // Compute and set relaxed value
136  Real new_value = current_value;
137  new_value = relaxation_factor * current_value + (1 - relaxation_factor) * old_value;
138  _problem.setPostprocessorValueByName((*transformed_pps)[i], new_value);
139  }
140 }
141 
142 void
143 PicardSolve::transformVariables(const std::set<dof_id_type> & transformed_dofs, const bool primary)
144 {
145  Real relaxation_factor;
146  TagID old_tag_id;
147  if (primary)
148  {
149  relaxation_factor = _relax_factor;
150  old_tag_id = _old_tag_id;
151  }
152  else
153  {
154  relaxation_factor = _secondary_relaxation_factor;
155  old_tag_id = _secondary_old_tag_id;
156  }
157 
159  NumericVector<Number> & transformed_old = _solver_sys.getVector(old_tag_id);
160 
161  for (const auto & dof : transformed_dofs)
162  solution.set(dof,
163  (transformed_old(dof) * (1.0 - relaxation_factor)) +
164  (solution(dof) * relaxation_factor));
165 
166  solution.close();
168 }
169 
170 void
172  const std::vector<Real> & timestep_begin_norms,
173  const std::vector<Real> & timestep_end_norms) const
174 {
175  _console << "\n 0 Picard |R| = "
176  << Console::outputNorm(std::numeric_limits<Real>::max(), initial_norm) << '\n';
177 
178  Real max_norm_old = initial_norm;
179  for (unsigned int i = 0; i <= _fixed_point_it; ++i)
180  {
181  Real max_norm = std::max(timestep_begin_norms[i], timestep_end_norms[i]);
182  _console << std::setw(2) << i + 1
183  << " Picard |R| = " << Console::outputNorm(max_norm_old, max_norm) << '\n';
184  max_norm_old = max_norm;
185  }
186 
187  _console << std::endl;
188 }
std::vector< std::vector< PostprocessorValue > > _transformed_pps_values
Previous values of the relaxed postprocessors.
std::vector< std::vector< PostprocessorValue > > _secondary_transformed_pps_values
Previous values of the postprocessors relaxed outside of the fixed point iteration (used as a subapp)...
static InputParameters validParams()
Definition: PicardSolve.C:19
FEProblemBase & _problem
Reference to FEProblem.
Definition: SolveObject.h:47
virtual void savePostprocessorValues(const bool primary) override final
Saves the current values of the postprocessors, and update the old(er) vectors.
Definition: PicardSolve.C:77
virtual void transformPostprocessors(const bool primary) override final
Use the fixed point algorithm to transform the postprocessors.
Definition: PicardSolve.C:110
unsigned int TagID
Definition: MooseTypes.h:210
NumericVector< Number > & solution()
Definition: SystemBase.h:196
PARALLEL
void setPostprocessorValueByName(const PostprocessorName &name, const PostprocessorValue &value, std::size_t t_index=0)
Set the value of a PostprocessorValue.
virtual TagID addVectorTag(const TagName &tag_name, const Moose::VectorTagType type=Moose::VECTOR_TAG_RESIDUAL)
Create a Tag.
Definition: SubProblem.C:92
The main MOOSE class responsible for handling user-defined parameters in almost every MOOSE system...
const TagName PREVIOUS_FP_SOLUTION_TAG
Definition: MooseTypes.C:29
virtual void printFixedPointConvergenceHistory(Real initial_norm, const std::vector< Real > &timestep_begin_norms, const std::vector< Real > &timestep_end_norms) const override final
Print the convergence history of the coupling, at every fixed point iteration.
Definition: PicardSolve.C:171
std::vector< PostprocessorName > _secondary_transformed_pps
Postprocessors to be relaxed outside of fixed point iteration (used as a subapp)
auto max(const L &left, const R &right)
const std::vector< PostprocessorName > _transformed_pps
The postprocessors (transferred or not) that are going to be relaxed.
NumericVector< Number > & addVector(const std::string &vector_name, const bool project, const libMesh::ParallelType type)
Adds a solution length vector to the system.
virtual bool useFixedPointAlgorithmUpdateInsteadOfPicard(const bool primary) override final
Use the fixed point algorithm transform instead of simply using the Picard update.
Definition: PicardSolve.C:101
void update()
Update the system (doing libMesh magic)
Definition: SystemBase.C:1245
const Real _relax_factor
Relaxation factor for fixed point Iteration.
Executioners are objects that do the actual work of solving your problem.
Definition: Executioner.h:30
TagID _old_tag_id
Vector tag id for the previous solution variable, as a main app.
Definition: PicardSolve.h:88
Real _secondary_relaxation_factor
Relaxation factor outside of fixed point iteration (used as a subapp)
std::string stringify(const T &t)
conversion to string
Definition: Conversion.h:64
virtual void needSolutionState(const unsigned int state, Moose::SolutionIterationType iteration_type=Moose::SolutionIterationType::Time, libMesh::ParallelType parallel_type=GHOSTED)
Registers that the solution state state is needed.
Definition: SystemBase.C:1452
virtual void close()=0
virtual const PostprocessorValue & getPostprocessorValueByName(const PostprocessorName &name) const
Retrieve the value of the Postprocessor.
unsigned int _fixed_point_it
TagID _secondary_old_tag_id
Vector tag id for the previous solution variable, as a sub app.
Definition: PicardSolve.h:91
SystemBase & _solver_sys
Reference to a system for creating vectors as needed for the solve, etc.
Definition: SolveObject.h:55
static InputParameters validParams()
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
static std::string outputNorm(const Real &old_norm, const Real &norm, const unsigned int precision=6)
A helper function for outputting norms in color.
Definition: Console.C:623
const TagID INVALID_TAG_ID
Definition: MooseTypes.C:23
virtual void allocateStorage(const bool primary) override final
Allocate storage for the fixed point algorithm.
Definition: PicardSolve.C:28
virtual void set(const numeric_index_type i, const Number value)=0
const ConsoleStream _console
An instance of helper class to write streams to the Console objects.
bool performingRelaxation(const bool primary) const
Returns true if there is relaxation.
virtual void saveVariableValues(const bool primary) override final
Saves the current values of the variables, and update the old(er) vectors.
Definition: PicardSolve.C:60
PicardSolve(Executioner &ex)
Definition: PicardSolve.C:25
virtual void transformVariables(const std::set< dof_id_type > &transformed_dofs, const bool primary) override final
Use the fixed point algorithm to transform the variables.
Definition: PicardSolve.C:143
virtual NumericVector< Number > & getVector(const std::string &name)
Get a raw NumericVector by name.
Definition: SystemBase.C:916
auto index_range(const T &sizable)
unsigned int _main_fixed_point_it
fixed point iteration counter for the main app