GpuSeqILU0.hpp
Go to the documentation of this file.
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>
30
31
32
33namespace Opm::gpuistl
34{
50template <class M, class X, class Y, int l = 1>
52{
53public:
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
118private:
120 const M& m_underlyingMatrix;
122 field_type m_w;
123
130
131 GpuVector<field_type> m_temporaryStorage;
132
133
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
155template <class M, class X, class Y, int l>
156template <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
185template <class M, class X, class Y, int l>
186template <typename T, typename std::enable_if_t<is_gpu_matrix_v<T>, int>>
187GpuSeqILU0<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
Interface class adding the update() method to the preconditioner interface.
Definition: PreconditionerWithUpdate.hpp:32
Sequential ILU0 preconditioner on the GPU through the CuSparse library.
Definition: GpuSeqILU0.hpp:52
virtual void pre(X &x, Y &b) override
Prepare the preconditioner.
typename std::remove_const< M >::type matrix_type
The matrix type the preconditioner is for.
Definition: GpuSeqILU0.hpp:55
virtual void update() override
Updates the matrix data.
Y range_type
The range type of the preconditioner.
Definition: GpuSeqILU0.hpp:59
typename X::field_type field_type
The field type of the preconditioner.
Definition: GpuSeqILU0.hpp:61
virtual void post(X &x) override
Post processing.
virtual void apply(X &v, const Y &d) override
Apply the preconditoner.
X domain_type
The domain type of the preconditioner.
Definition: GpuSeqILU0.hpp:57
static constexpr bool shouldCallPost()
Definition: GpuSeqILU0.hpp:108
virtual Dune::SolverCategory::Category category() const override
Category of the preconditioner (see SolverCategory::Category)
virtual bool hasPerfectUpdate() const override
Definition: GpuSeqILU0.hpp:113
static constexpr bool shouldCallPre()
Definition: GpuSeqILU0.hpp:102
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 dim() const
dim returns the dimension of the vector space on which this matrix acts
Definition: GpuSparseMatrixWrapper.hpp:312
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
std::size_t blockSize() const
blockSize size of the blocks
Definition: GpuSparseMatrixWrapper.hpp:320
The CuSparseHandle class provides a singleton for the simulator universal cuSparseHandle.
Definition: CuSparseHandle.hpp:41
GpuSparseMatrixDescriptionPtr createLowerDiagonalDescription()
createLowerDiagonalDescription creates a lower diagonal matrix description
Definition: CuMatrixDescription.hpp:60
GpuSparseMatrixDescriptionPtr createUpperDiagonalDescription()
createUpperDiagonalDescription creates an upper diagonal matrix description
Definition: CuMatrixDescription.hpp:75
std::shared_ptr< CuSparseResource< cusparseMatDescr_t > > GpuSparseMatrixDescriptionPtr
Definition: CuMatrixDescription.hpp:35
const Matrix makeMatrixWithNonzeroDiagonal(const Matrix &matrix, const typename Matrix::field_type replacementValue=std::numeric_limits< typename Matrix::field_type >::epsilon())
makeMatrixWithNonzeroDiagonal creates a new matrix with the zero diagonal elements (when viewed as a ...
Definition: fix_zero_diagonal.hpp:40
A small, fixed‑dimension MiniVector class backed by std::array that can be used in both host and CUDA...
Definition: AmgxInterface.hpp:38