PreconditionerWithUpdate.hpp
Go to the documentation of this file.
1/*
2 Copyright 2019 SINTEF Digital, Mathematics and Cybernetics.
3
4 This file is part of the Open Porous Media project (OPM).
5
6 OPM 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 OPM 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 OPM. If not, see <http://www.gnu.org/licenses/>.
18*/
19
20#ifndef OPM_PRECONDITIONERWITHUPDATE_HEADER_INCLUDED
21#define OPM_PRECONDITIONERWITHUPDATE_HEADER_INCLUDED
22
23#include <dune/istl/preconditioner.hh>
24#include <memory>
25
26namespace Dune
27{
28
30template <class X, class Y>
31class PreconditionerWithUpdate : public Preconditioner<X, Y>
32{
33public:
34 virtual void update() = 0;
35
36 // Force derived classes to define if preconditioner has perfect update
37 virtual bool hasPerfectUpdate() const = 0;
38};
39
40template <class OriginalPreconditioner>
41class DummyUpdatePreconditioner : public PreconditionerWithUpdate<typename OriginalPreconditioner::domain_type,
42 typename OriginalPreconditioner::range_type>
43{
44public:
45 template <class... Args>
47 : orig_precond_(std::forward<Args>(args)...)
48 {
49 }
50
51 using X = typename OriginalPreconditioner::domain_type;
52 using Y = typename OriginalPreconditioner::range_type;
53
54 virtual void pre(X& x, Y& b) override
55 {
56 orig_precond_.pre(x, b);
57 }
58
59 virtual void apply(X& v, const Y& d) override
60 {
61 orig_precond_.apply(v, d);
62 }
63
64 virtual void post(X& x) override
65 {
66 orig_precond_.post(x);
67 }
68
69 virtual SolverCategory::Category category() const override
70 {
71 return orig_precond_.category();
72 }
73
74 // The update() function does nothing for a wrapped preconditioner.
75 virtual void update() override
76 {
77 }
78
79 virtual bool hasPerfectUpdate() const override {
80 return true;
81 }
82
83private:
84 OriginalPreconditioner orig_precond_;
85};
86
87template <class OriginalPreconditioner, class... Args>
88std::shared_ptr<DummyUpdatePreconditioner<OriginalPreconditioner>>
89getDummyUpdateWrapper(Args&&... args)
90{
91 return std::make_shared<DummyUpdatePreconditioner<OriginalPreconditioner>>(std::forward<Args>(args)...);
92}
93
96template <class OriginalPreconditioner>
98 virtual std::unique_ptr<
99 Preconditioner<typename OriginalPreconditioner::domain_type, typename OriginalPreconditioner::range_type>>
100 make() = 0;
101 virtual ~GeneralPreconditionerMaker() = default;
102};
103
108template <class OriginalPreconditioner, class... Args>
109struct PreconditionerMaker : public GeneralPreconditionerMaker<OriginalPreconditioner> {
110 using GenericPreconditioner = Preconditioner<typename OriginalPreconditioner::domain_type, typename OriginalPreconditioner::range_type>;
111
112 PreconditionerMaker(Args&&... args)
113 : args_(args...)
114 {
115 }
116 std::unique_ptr<GenericPreconditioner>
117 make() override
118 {
119 // return std::unique_ptr<GenericPreconditioner> {new auto(std::make_from_tuple<OriginalPreconditioner>(args_))};
120 return std::apply(
121 [](auto&&... args) {
122 return std::make_unique<OriginalPreconditioner>(std::forward<Args>(args)...);
123 }, args_);
124 }
126 std::tuple<Args...> args_;
127};
128
131template <class OriginalPreconditioner>
132class RebuildOnUpdatePreconditioner : public PreconditionerWithUpdate<typename OriginalPreconditioner::domain_type,
133 typename OriginalPreconditioner::range_type>
134{
135public:
136 template<class... Args>
138 : preconditioner_maker_(std::make_unique<PreconditionerMaker<OriginalPreconditioner, Args...>>(std::forward<Args>(args)...))
139 {
140 update();
141 }
142
143 using X = typename OriginalPreconditioner::domain_type;
144 using Y = typename OriginalPreconditioner::range_type;
145
146 virtual void pre(X& x, Y& b) override
147 {
148 orig_precond_->pre(x, b);
149 }
150
151 virtual void apply(X& v, const Y& d) override
152 {
153 orig_precond_->apply(v, d);
154 }
155
156 virtual void post(X& x) override
157 {
158 orig_precond_->post(x);
159 }
160
161 virtual SolverCategory::Category category() const override
162 {
163 return orig_precond_->category();
164 }
165
166 // Rebuild the preconditioner on update
167 void update() override
168 {
169 orig_precond_ = preconditioner_maker_->make();
170 }
171
172 virtual bool hasPerfectUpdate() const override {
173 return true;
174 }
175
176private:
178 using GenericPreconditioner = Preconditioner<typename OriginalPreconditioner::domain_type, typename OriginalPreconditioner::range_type>;
179
180 std::unique_ptr<AbstractMakerType> preconditioner_maker_;
181 std::unique_ptr<GenericPreconditioner> orig_precond_;
182};
183
189template <class OriginalPreconditioner, class... Args>
190auto
192{
193 return std::make_shared<RebuildOnUpdatePreconditioner<OriginalPreconditioner>>(
194 std::forward<Args>(args)...);
195}
196
197} // namespace Dune
198
199#endif // OPM_PRECONDITIONERWITHUPDATE_HEADER_INCLUDED
Definition: PreconditionerWithUpdate.hpp:43
virtual void post(X &x) override
Definition: PreconditionerWithUpdate.hpp:64
DummyUpdatePreconditioner(Args &&... args)
Definition: PreconditionerWithUpdate.hpp:46
typename OriginalPreconditioner::range_type Y
Definition: PreconditionerWithUpdate.hpp:52
virtual void pre(X &x, Y &b) override
Definition: PreconditionerWithUpdate.hpp:54
virtual void apply(X &v, const Y &d) override
Definition: PreconditionerWithUpdate.hpp:59
virtual void update() override
Definition: PreconditionerWithUpdate.hpp:75
virtual bool hasPerfectUpdate() const override
Definition: PreconditionerWithUpdate.hpp:79
virtual SolverCategory::Category category() const override
Definition: PreconditionerWithUpdate.hpp:69
typename OriginalPreconditioner::domain_type X
Definition: PreconditionerWithUpdate.hpp:51
Interface class adding the update() method to the preconditioner interface.
Definition: PreconditionerWithUpdate.hpp:32
virtual bool hasPerfectUpdate() const =0
Wrapper class of preconditioners that should be reconstructed on update.
Definition: PreconditionerWithUpdate.hpp:134
typename OriginalPreconditioner::range_type Y
Definition: PreconditionerWithUpdate.hpp:144
void update() override
Definition: PreconditionerWithUpdate.hpp:167
virtual SolverCategory::Category category() const override
Definition: PreconditionerWithUpdate.hpp:161
RebuildOnUpdatePreconditioner(Args... args)
Definition: PreconditionerWithUpdate.hpp:137
virtual void apply(X &v, const Y &d) override
Definition: PreconditionerWithUpdate.hpp:151
virtual bool hasPerfectUpdate() const override
Definition: PreconditionerWithUpdate.hpp:172
typename OriginalPreconditioner::domain_type X
Definition: PreconditionerWithUpdate.hpp:143
virtual void pre(X &x, Y &b) override
Definition: PreconditionerWithUpdate.hpp:146
virtual void post(X &x) override
Definition: PreconditionerWithUpdate.hpp:156
Definition: fvbaseprimaryvariables.hh:141
auto getRebuildOnUpdateWrapper(Args... args)
Wrapper function creating and return a shared pointer to a preconditioner which is reconstructed on u...
Definition: PreconditionerWithUpdate.hpp:191
std::shared_ptr< DummyUpdatePreconditioner< OriginalPreconditioner > > getDummyUpdateWrapper(Args &&... args)
Definition: PreconditionerWithUpdate.hpp:89
Interface class ensuring make function is overriden.
Definition: PreconditionerWithUpdate.hpp:97
virtual ~GeneralPreconditionerMaker()=default
virtual std::unique_ptr< Preconditioner< typename OriginalPreconditioner::domain_type, typename OriginalPreconditioner::range_type > > make()=0
Struct implementing a make function which creates a preconditioner Can create arbitrary preconditione...
Definition: PreconditionerWithUpdate.hpp:109
PreconditionerMaker(Args &&... args)
Definition: PreconditionerWithUpdate.hpp:112
Preconditioner< typename OriginalPreconditioner::domain_type, typename OriginalPreconditioner::range_type > GenericPreconditioner
Definition: PreconditionerWithUpdate.hpp:110
std::tuple< Args... > args_
Definition: PreconditionerWithUpdate.hpp:126
~PreconditionerMaker()
Definition: PreconditionerWithUpdate.hpp:125
std::unique_ptr< GenericPreconditioner > make() override
Definition: PreconditionerWithUpdate.hpp:117