3.3.0
DUNE for Multi-{Phase, Component, Scale, Physics, ...} flow and transport in porous media
porousmediumflow/richards/newtonsolver.hh
Go to the documentation of this file.
1// -*- mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
2// vi: set et ts=4 sw=4 sts=4:
3/*****************************************************************************
4 * See the file COPYING for full copying permissions. *
5 * *
6 * This program is free software: you can redistribute it and/or modify *
7 * it under the terms of the GNU General Public License as published by *
8 * the Free Software Foundation, either version 3 of the License, or *
9 * (at your option) any later version. *
10 * *
11 * This program is distributed in the hope that it will be useful, *
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
14 * GNU General Public License for more details. *
15 * *
16 * You should have received a copy of the GNU General Public License *
17 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
18 *****************************************************************************/
25#ifndef DUMUX_RICHARDS_NEWTON_SOLVER_HH
26#define DUMUX_RICHARDS_NEWTON_SOLVER_HH
27
28#include <algorithm>
33
34namespace Dumux {
43template <class Assembler, class LinearSolver>
44class RichardsNewtonSolver : public NewtonSolver<Assembler, LinearSolver>
45{
46 using Scalar = typename Assembler::Scalar;
48 using SolutionVector = typename Assembler::ResidualType;
49 using Indices = typename Assembler::GridVariables::VolumeVariables::Indices;
50 enum { pressureIdx = Indices::pressureIdx };
51
52public:
53 using ParentType::ParentType;
54
55private:
56
65 void choppedUpdate_(SolutionVector &uCurrentIter,
66 const SolutionVector &uLastIter,
67 const SolutionVector &deltaU) final
68 {
69 uCurrentIter = uLastIter;
70 uCurrentIter -= deltaU;
71
72 // do not clamp anything after 5 iterations
73 if (this->numSteps_ <= 4)
74 {
75 // clamp saturation change to at most 20% per iteration
76 const auto& gridGeometry = this->assembler().gridGeometry();
77 for (const auto& element : elements(gridGeometry.gridView()))
78 {
79 auto fvGeometry = localView(gridGeometry);
80 fvGeometry.bindElement(element);
81
82 for (auto&& scv : scvs(fvGeometry))
83 {
84 auto dofIdxGlobal = scv.dofIndex();
85
86 // calculate the old wetting phase saturation
87 const auto& spatialParams = this->assembler().problem().spatialParams();
88 const auto elemSol = elementSolution(element, uCurrentIter, gridGeometry);
89
90 // old material law interface is deprecated: Replace this by
91 // const auto& fluidMatrixInteraction = spatialParams.fluidMatrixInteraction(element, scv, elemSol);
92 // after the release of 3.1, when the deprecated interface is no longer supported
93 const auto fluidMatrixInteraction = Deprecated::makePcKrSw(Scalar{}, spatialParams, element, scv, elemSol);
94
95 const Scalar pcMin = fluidMatrixInteraction.pc(1.0);
96 const Scalar pw = uLastIter[dofIdxGlobal][pressureIdx];
97 using std::max;
98 const Scalar pn = max(this->assembler().problem().nonwettingReferencePressure(), pw + pcMin);
99 const Scalar pcOld = pn - pw;
100 const Scalar SwOld = max(0.0, fluidMatrixInteraction.sw(pcOld));
101
102 // convert into minimum and maximum wetting phase pressures
103 const Scalar pwMin = pn - fluidMatrixInteraction.pc(SwOld - 0.2);
104 const Scalar pwMax = pn - fluidMatrixInteraction.pc(SwOld + 0.2);
105
106 // clamp the result
107 using std::clamp;
108 uCurrentIter[dofIdxGlobal][pressureIdx] = clamp(uCurrentIter[dofIdxGlobal][pressureIdx], pwMin, pwMax);
109 }
110 }
111 }
112
113 // update the grid variables
114 this->solutionChanged_(uCurrentIter);
115
116 if (this->enableResidualCriterion())
117 this->computeResidualReduction_(uCurrentIter);
118 }
119};
120
121} // end namespace Dumux
122
123#endif
Helpers for deprecation.
Element solution classes and factory functions.
GridCache::LocalView localView(const GridCache &gridCache)
Free function to get the local view of a grid cache object.
Definition: localview.hh:38
auto elementSolution(const Element &element, const SolutionVector &sol, const GridGeometry &gg) -> std::enable_if_t< GridGeometry::discMethod==DiscretizationMethod::box, BoxElementSolution< typename GridGeometry::LocalView, std::decay_t< decltype(std::declval< SolutionVector >()[0])> > >
Make an element solution for box schemes.
Definition: box/elementsolution.hh:115
Definition: adapt.hh:29
A high-level interface for a PDESolver.
Definition: common/pdesolver.hh:55
const Assembler & assembler() const
Access the assembler.
Definition: common/pdesolver.hh:92
An implementation of a Newton solver.
Definition: nonlinear/newtonsolver.hh:177
virtual void solutionChanged_(const SolutionVector &uCurrentIter)
Update solution-depended quantities like grid variables after the solution has changed.
Definition: nonlinear/newtonsolver.hh:790
int numSteps_
actual number of steps done so far
Definition: nonlinear/newtonsolver.hh:871
bool enableResidualCriterion() const
Definition: nonlinear/newtonsolver.hh:809
void computeResidualReduction_(const SolutionVector &uCurrentIter)
Definition: nonlinear/newtonsolver.hh:795
A Richards model specific Newton solver.
Definition: porousmediumflow/richards/newtonsolver.hh:45
Declares all properties used in Dumux.
Reference implementation of a Newton solver.