Ginkgo  Generated from pipelines/1330831941 branch based on master. Ginkgo version 1.8.0
A numerical linear algebra library targeting many-core architectures
cb_gmres.hpp
1 // SPDX-FileCopyrightText: 2017 - 2024 The Ginkgo authors
2 //
3 // SPDX-License-Identifier: BSD-3-Clause
4 
5 #ifndef GKO_PUBLIC_CORE_SOLVER_CB_GMRES_HPP_
6 #define GKO_PUBLIC_CORE_SOLVER_CB_GMRES_HPP_
7 
8 
9 #include <memory>
10 #include <vector>
11 
12 
13 #include <ginkgo/core/base/array.hpp>
14 #include <ginkgo/core/base/exception_helpers.hpp>
15 #include <ginkgo/core/base/lin_op.hpp>
16 #include <ginkgo/core/base/math.hpp>
17 #include <ginkgo/core/base/types.hpp>
18 #include <ginkgo/core/config/config.hpp>
19 #include <ginkgo/core/config/registry.hpp>
20 #include <ginkgo/core/log/logger.hpp>
21 #include <ginkgo/core/matrix/dense.hpp>
22 #include <ginkgo/core/matrix/identity.hpp>
23 #include <ginkgo/core/solver/solver_base.hpp>
24 #include <ginkgo/core/stop/combined.hpp>
25 #include <ginkgo/core/stop/criterion.hpp>
26 
27 
28 namespace gko {
29 namespace solver {
30 
31 
32 namespace cb_gmres {
33 
34 
62 enum class storage_precision {
63  keep,
64  reduce1,
65  reduce2,
66  integer,
67  ireduce1,
68  ireduce2
69 };
70 
71 
72 } // namespace cb_gmres
73 
74 
96 template <typename ValueType = default_precision>
97 class CbGmres : public EnableLinOp<CbGmres<ValueType>>,
98  public EnablePreconditionedIterativeSolver<ValueType,
99  CbGmres<ValueType>> {
100  friend class EnableLinOp<CbGmres>;
101  friend class EnablePolymorphicObject<CbGmres, LinOp>;
102 
103 public:
104  using value_type = ValueType;
105 
111  size_type get_krylov_dim() const { return parameters_.krylov_dim; }
112 
118  void set_krylov_dim(size_type other) { parameters_.krylov_dim = other; }
119 
125  cb_gmres::storage_precision get_storage_precision() const
126  {
127  return parameters_.storage_precision;
128  }
129 
130  class Factory;
131 
134  parameters_type, Factory> {
138  cb_gmres::storage_precision GKO_FACTORY_PARAMETER_SCALAR(
139  storage_precision, cb_gmres::storage_precision::reduce1);
140 
145  };
146 
149 
163  static parameters_type parse(const config::pnode& config,
164  const config::registry& context,
165  const config::type_descriptor& td_for_child =
166  config::make_type_descriptor<ValueType>());
167 
168 protected:
169  void apply_impl(const LinOp* b, LinOp* x) const override;
170 
171  void apply_dense_impl(const matrix::Dense<ValueType>* b,
172  matrix::Dense<ValueType>* x) const;
173 
174  void apply_impl(const LinOp* alpha, const LinOp* b, const LinOp* beta,
175  LinOp* x) const override;
176 
177  explicit CbGmres(std::shared_ptr<const Executor> exec)
178  : EnableLinOp<CbGmres>(std::move(exec))
179  {}
180 
181  explicit CbGmres(const Factory* factory,
182  std::shared_ptr<const LinOp> system_matrix)
183  : EnableLinOp<CbGmres>(factory->get_executor(),
184  transpose(system_matrix->get_size())),
185  EnablePreconditionedIterativeSolver<ValueType, CbGmres<ValueType>>{
186  std::move(system_matrix), factory->get_parameters()},
187  parameters_{factory->get_parameters()}
188  {}
189 };
190 
191 
192 } // namespace solver
193 } // namespace gko
194 
195 
196 #endif // GKO_PUBLIC_CORE_SOLVER_CB_GMRES_HPP_
gko::config::pnode
pnode describes a tree of properties.
Definition: property_tree.hpp:28
gko::log::profile_event_category::solver
Solver events.
gko::LinOp
Definition: lin_op.hpp:118
gko::matrix::Dense
Dense is a matrix format which explicitly stores all values of the matrix.
Definition: dense_cache.hpp:20
gko::solver::CbGmres::get_storage_precision
cb_gmres::storage_precision get_storage_precision() const
Returns the storage precision used internally.
Definition: cb_gmres.hpp:125
gko::solver::CbGmres::get_krylov_dim
size_type get_krylov_dim() const
Returns the Krylov dimension.
Definition: cb_gmres.hpp:111
gko::solver::CbGmres::set_krylov_dim
void set_krylov_dim(size_type other)
Sets the Krylov dimension.
Definition: cb_gmres.hpp:118
gko::solver::CbGmres::Factory
Definition: cb_gmres.hpp:147
gko::size_type
std::size_t size_type
Integral type used for allocation quantities.
Definition: types.hpp:108
gko::solver::CbGmres::parameters_type::storage_precision
cb_gmres::storage_precision storage_precision
Determines which storage type is used.
Definition: cb_gmres.hpp:139
gko::solver::enable_preconditioned_iterative_solver_factory_parameters
Definition: solver_base.hpp:840
GKO_FACTORY_PARAMETER_SCALAR
#define GKO_FACTORY_PARAMETER_SCALAR(_name, _default)
Creates a scalar factory parameter in the factory parameters structure.
Definition: abstract_factory.hpp:445
gko::solver::CbGmres::parse
static parameters_type parse(const config::pnode &config, const config::registry &context, const config::type_descriptor &td_for_child=config::make_type_descriptor< ValueType >())
Create the parameters from the property_tree.
gko::config::type_descriptor
This class describes the value and index types to be used when building a Ginkgo type from a configur...
Definition: type_descriptor.hpp:37
gko
The Ginkgo namespace.
Definition: abstract_factory.hpp:20
GKO_ENABLE_LIN_OP_FACTORY
#define GKO_ENABLE_LIN_OP_FACTORY(_lin_op, _parameters_name, _factory_name)
This macro will generate a default implementation of a LinOpFactory for the LinOp subclass it is defi...
Definition: lin_op.hpp:1018
gko::solver::CbGmres::parameters_type
Definition: cb_gmres.hpp:132
gko::transpose
batch_dim< 2, DimensionType > transpose(const batch_dim< 2, DimensionType > &input)
Returns a batch_dim object with its dimensions swapped for batched operators.
Definition: batch_dim.hpp:120
gko::solver::CbGmres::parameters_type::krylov_dim
size_type krylov_dim
Krylov dimension factory.
Definition: cb_gmres.hpp:144
gko::solver::CbGmres
CB-GMRES or the compressed basis generalized minimal residual method is an iterative type Krylov subs...
Definition: cb_gmres.hpp:97
gko::config::registry
This class stores additional context for creating Ginkgo objects from configuration files.
Definition: registry.hpp:168
GKO_ENABLE_BUILD_METHOD
#define GKO_ENABLE_BUILD_METHOD(_factory_name)
Defines a build method for the factory, simplifying its construction by removing the repetitive typin...
Definition: abstract_factory.hpp:394
gko::PolymorphicObject::get_executor
std::shared_ptr< const Executor > get_executor() const noexcept
Returns the Executor of the object.
Definition: polymorphic_object.hpp:235
gko::LinOp::get_size
const dim< 2 > & get_size() const noexcept
Returns the size of the operator.
Definition: lin_op.hpp:211
gko::EnableLinOp
The EnableLinOp mixin can be used to provide sensible default implementations of the majority of the ...
Definition: lin_op.hpp:878
gko::solver::EnablePreconditionedIterativeSolver
A LinOp implementing this interface stores a system matrix and stopping criterion factory.
Definition: solver_base.hpp:785
gko::EnablePolymorphicObject
This mixin inherits from (a subclass of) PolymorphicObject and provides a base implementation of a ne...
Definition: polymorphic_object.hpp:662