opm-simulators
GpuSeqILU0.hpp
1 /*
2  Copyright 2022-2023 SINTEF AS
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 #ifndef OPM_GPUSEQILU0_HPP
20 #define OPM_GPUSEQILU0_HPP
21 
22 #include <dune/istl/preconditioner.hh>
23 #include <opm/simulators/linalg/PreconditionerWithUpdate.hpp>
24 #include <opm/simulators/linalg/gpuistl/GpuSparseMatrixWrapper.hpp>
25 #include <opm/simulators/linalg/gpuistl/detail/CuMatrixDescription.hpp>
26 #include <opm/simulators/linalg/gpuistl/detail/CuSparseHandle.hpp>
27 #include <opm/simulators/linalg/gpuistl/detail/CuSparseResource.hpp>
28 #include <opm/simulators/linalg/gpuistl/detail/fix_zero_diagonal.hpp>
29 #include <opm/simulators/linalg/is_gpu_operator.hpp>
30 
31 
32 
33 namespace Opm::gpuistl
34 {
50 template <class M, class X, class Y, int l = 1>
52 {
53 public:
55  using matrix_type = typename std::remove_const<M>::type ;
57  using domain_type = X;
59  using range_type = Y;
61  using field_type = typename X::field_type;
62 
69  template <typename T = M, typename std::enable_if_t<is_gpu_matrix_v<T>, int> = 0>
70  GpuSeqILU0(const M& A, field_type w);
71 
72 
79  template <typename T = M, typename std::enable_if_t<!is_gpu_matrix_v<T>, int> = 0>
80  GpuSeqILU0(const M& A, field_type w);
81 
82 
85  virtual void pre(X& x, Y& b) override;
86 
88  virtual void apply(X& v, const Y& d) override;
89 
92  virtual void post(X& x) override;
93 
95  virtual Dune::SolverCategory::Category category() const override;
96 
98  virtual void update() override;
99 
100 
102  static constexpr bool shouldCallPre()
103  {
104  return false;
105  }
106 
108  static constexpr bool shouldCallPost()
109  {
110  return false;
111  }
112 
113  virtual bool hasPerfectUpdate() const override {
114  return true;
115  }
116 
117 
118 private:
120  const M& m_underlyingMatrix;
122  field_type m_w;
123 
129  GpuSparseMatrixWrapper<field_type, true> m_LU;
130 
131  GpuVector<field_type> m_temporaryStorage;
132 
133 
136  detail::CuSparseResource<bsrsv2Info_t> m_infoL;
137  detail::CuSparseResource<bsrsv2Info_t> m_infoU;
138  detail::CuSparseResource<bsrilu02Info_t> m_infoM;
139 
140  std::unique_ptr<GpuVector<field_type>> m_buffer;
141  detail::CuSparseHandle& m_cuSparseHandle;
142 
143  bool m_analysisDone = false;
144 
145  void analyzeMatrix();
146  size_t findBufferSize();
147 
148  void createILU();
149 
150  void updateILUConfiguration();
151 };
152 
153 
154 // Case where matrix is a CPU matrix as input
155 template <class M, class X, class Y, int l>
156 template <typename T, typename std::enable_if_t<!is_gpu_matrix_v<T>, int>>
158  : m_underlyingMatrix(A)
159  , m_w(w)
160  , m_LU(GpuSparseMatrixWrapper<field_type, true>::fromMatrix(detail::makeMatrixWithNonzeroDiagonal(A)))
161  , m_temporaryStorage(m_LU.N() * m_LU.blockSize())
162  , m_descriptionL(detail::createLowerDiagonalDescription())
163  , m_descriptionU(detail::createUpperDiagonalDescription())
164  , m_cuSparseHandle(detail::CuSparseHandle::getInstance())
165 {
166  // Some sanity check
167  OPM_ERROR_IF(A.N() != m_LU.N(),
168  fmt::format("CuSparse matrix not same size as DUNE matrix. {} vs {}.", m_LU.N(), A.N()));
169  OPM_ERROR_IF(
170  A[0][0].N() != m_LU.blockSize(),
171  fmt::format("CuSparse matrix not same blocksize as DUNE matrix. {} vs {}.", m_LU.blockSize(), A[0][0].N()));
172  OPM_ERROR_IF(
173  A.N() * A[0][0].N() != m_LU.dim(),
174  fmt::format("CuSparse matrix not same dimension as DUNE matrix. {} vs {}.", m_LU.dim(), A.N() * A[0][0].N()));
175  OPM_ERROR_IF(A.nonzeroes() != m_LU.nonzeroes(),
176  fmt::format("CuSparse matrix not same number of non zeroes as DUNE matrix. {} vs {}. ",
177  m_LU.nonzeroes(),
178  A.nonzeroes()));
179 
180 
181  updateILUConfiguration();
182 }
183 
184 // Case where matrix is a GPU matrix as input
185 template <class M, class X, class Y, int l>
186 template <typename T, typename std::enable_if_t<is_gpu_matrix_v<T>, int>>
187 GpuSeqILU0<M, X, Y, l>::GpuSeqILU0(const M& A, field_type w)
188  : m_underlyingMatrix(A)
189  , m_w(w)
190  , m_LU(A.getNonZeroValues().data(),
191  A.getRowIndices().data(),
192  A.getColumnIndices().data(),
193  A.nonzeroes(),
194  A.blockSize(),
195  A.N())
196  , m_temporaryStorage(m_LU.N() * m_LU.blockSize())
197  , m_descriptionL(detail::createLowerDiagonalDescription())
198  , m_descriptionU(detail::createUpperDiagonalDescription())
199  , m_cuSparseHandle(detail::CuSparseHandle::getInstance())
200 {
201  // Some sanity check
202  OPM_ERROR_IF(A.N() != m_LU.N(),
203  fmt::format("CuSparse matrix not same size as DUNE matrix. {} vs {}.", m_LU.N(), A.N()));
204  OPM_ERROR_IF(A.nonzeroes() != m_LU.nonzeroes(),
205  fmt::format("CuSparse matrix not same number of non zeroes as DUNE matrix. {} vs {}. ",
206  m_LU.nonzeroes(),
207  A.nonzeroes()));
208 
209 
210  updateILUConfiguration();
211 }
212 
213 } // end namespace Opm::gpuistl
214 
215 #endif
virtual Dune::SolverCategory::Category category() const override
Category of the preconditioner (see SolverCategory::Category)
Definition: GpuSeqILU0.cpp:123
The GpuSparseMatrixWrapper Checks CUDA/HIP version and dispatches a version either using the old or t...
Definition: gpu_type_detection.hpp:32
GpuSeqILU0(const M &A, field_type w)
Constructor.
Definition: GpuSeqILU0.hpp:157
std::size_t N() const
N returns the number of rows (which is equal to the number of columns)
Definition: GpuSparseMatrixWrapper.hpp:232
std::size_t nonzeroes() const
nonzeroes behaves as the Dune::BCRSMatrix::nonzeros() function and returns the number of non zero blo...
Definition: GpuSparseMatrixWrapper.hpp:241
virtual void update() override
Updates the matrix data.
Definition: GpuSeqILU0.cpp:130
typename X::field_type field_type
The field type of the preconditioner.
Definition: GpuSeqILU0.hpp:61
static constexpr bool shouldCallPre()
Definition: GpuSeqILU0.hpp:102
std::size_t dim() const
dim returns the dimension of the vector space on which this matrix acts
Definition: GpuSparseMatrixWrapper.hpp:312
Interface class adding the update() method to the preconditioner interface.
Definition: PreconditionerWithUpdate.hpp:33
virtual void apply(X &v, const Y &d) override
Apply the preconditoner.
Definition: GpuSeqILU0.cpp:60
X domain_type
The domain type of the preconditioner.
Definition: GpuSeqILU0.hpp:57
std::size_t blockSize() const
blockSize size of the blocks
Definition: GpuSparseMatrixWrapper.hpp:320
Sequential ILU0 preconditioner on the GPU through the CuSparse library.
Definition: GpuSeqILU0.hpp:51
std::shared_ptr< CuSparseResource< cusparseMatDescr_t > > GpuSparseMatrixDescriptionPtr
Pointer to GpuSparseMatrixDescription holder.
Definition: CuMatrixDescription.hpp:35
A small, fixed‑dimension MiniVector class backed by std::array that can be used in both host and CUD...
Definition: AmgxInterface.hpp:37
typename std::remove_const< M >::type matrix_type
The matrix type the preconditioner is for.
Definition: GpuSeqILU0.hpp:55
virtual void post(X &x) override
Post processing.
Definition: GpuSeqILU0.cpp:117
virtual void pre(X &x, Y &b) override
Prepare the preconditioner.
Definition: GpuSeqILU0.cpp:54
static constexpr bool shouldCallPost()
Definition: GpuSeqILU0.hpp:108
Y range_type
The range type of the preconditioner.
Definition: GpuSeqILU0.hpp:59