Ginkgo  Generated from pipelines/1478841010 branch based on develop. Ginkgo version 1.9.0
A numerical linear algebra library targeting many-core architectures
cholesky.hpp
1 // SPDX-FileCopyrightText: 2017 - 2024 The Ginkgo authors
2 //
3 // SPDX-License-Identifier: BSD-3-Clause
4 
5 #include <memory>
6 
7 #include <ginkgo/core/base/composition.hpp>
8 #include <ginkgo/core/base/lin_op.hpp>
9 #include <ginkgo/core/base/polymorphic_object.hpp>
10 #include <ginkgo/core/config/config.hpp>
11 #include <ginkgo/core/config/registry.hpp>
12 #include <ginkgo/core/factorization/factorization.hpp>
13 #include <ginkgo/core/matrix/csr.hpp>
14 #include <ginkgo/core/matrix/sparsity_csr.hpp>
15 
16 
17 namespace gko {
18 namespace experimental {
19 namespace factorization {
20 
21 
32 template <typename ValueType, typename IndexType>
33 class Cholesky
34  : public EnablePolymorphicObject<Cholesky<ValueType, IndexType>,
35  LinOpFactory>,
36  public EnablePolymorphicAssignment<Cholesky<ValueType, IndexType>> {
37 public:
38  struct parameters_type;
41 
42  using value_type = ValueType;
43  using index_type = IndexType;
47 
49  : public enable_parameters_type<parameters_type, Cholesky> {
56  std::shared_ptr<const sparsity_pattern_type>
58 
70  };
71 
77  const parameters_type& get_parameters() { return parameters_; }
78 
82  const parameters_type& get_parameters() const { return parameters_; }
83 
91  std::unique_ptr<factorization_type> generate(
92  std::shared_ptr<const LinOp> system_matrix) const;
93 
95  static parameters_type build() { return {}; }
96 
110  static parameters_type parse(
111  const config::pnode& config, const config::registry& context,
112  const config::type_descriptor& td_for_child =
113  config::make_type_descriptor<ValueType, IndexType>());
114 
115 protected:
116  explicit Cholesky(std::shared_ptr<const Executor> exec,
117  const parameters_type& params = {});
118 
119  std::unique_ptr<LinOp> generate_impl(
120  std::shared_ptr<const LinOp> system_matrix) const override;
121 
122 private:
123  parameters_type parameters_;
124 };
125 
126 
127 } // namespace factorization
128 } // namespace experimental
129 } // namespace gko
gko::experimental::factorization::Cholesky::build
static parameters_type build()
Creates a new parameter_type to set up the factory.
Definition: cholesky.hpp:95
gko::experimental::factorization::Factorization
Represents a generic factorization consisting of two triangular factors (upper and lower) and an opti...
Definition: factorization.hpp:76
gko::matrix::Csr
CSR is a matrix format which stores only the nonzero coefficients by compressing each row of the matr...
Definition: matrix.hpp:27
gko::experimental::factorization::Cholesky::get_parameters
const parameters_type & get_parameters() const
Returns the parameters used to construct the factory.
Definition: cholesky.hpp:82
gko::config::pnode
pnode describes a tree of properties.
Definition: property_tree.hpp:28
gko::matrix::SparsityCsr
SparsityCsr is a matrix format which stores only the sparsity pattern of a sparse matrix by compressi...
Definition: csr.hpp:40
gko::experimental::factorization::Cholesky::parameters_type::skip_sorting
bool skip_sorting
The system_matrix, which will be given to this factory, must be sorted (first by row,...
Definition: cholesky.hpp:69
gko::experimental::factorization::Cholesky::parameters_type::symbolic_factorization
std::shared_ptr< const sparsity_pattern_type > symbolic_factorization
The combined sparsity pattern L + L^H of the factors L and L^H.
Definition: cholesky.hpp:57
gko::EnablePolymorphicAssignment
This mixin is used to enable a default PolymorphicObject::copy_from() implementation for objects that...
Definition: polymorphic_object.hpp:723
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::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:39
gko
The Ginkgo namespace.
Definition: abstract_factory.hpp:20
gko::experimental::factorization::Cholesky::generate
std::unique_ptr< factorization_type > generate(std::shared_ptr< const LinOp > system_matrix) const
gko::experimental::factorization::Cholesky::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, IndexType >())
Create the parameters from the property_tree.
gko::experimental::factorization::Cholesky::parameters_type
Definition: cholesky.hpp:48
gko::experimental::factorization::Cholesky
Computes a Cholesky factorization of a symmetric, positive-definite sparse matrix.
Definition: cholesky.hpp:33
gko::config::registry
This class stores additional context for creating Ginkgo objects from configuration files.
Definition: registry.hpp:167
gko::LinOpFactory
A LinOpFactory represents a higher order mapping which transforms one linear operator into another.
Definition: lin_op.hpp:384
gko::enable_parameters_type
The enable_parameters_type mixin is used to create a base implementation of the factory parameters st...
Definition: abstract_factory.hpp:211
gko::experimental::factorization::Cholesky::get_parameters
const parameters_type & get_parameters()
Returns the parameters used to construct the factory.
Definition: cholesky.hpp:77
gko::EnablePolymorphicObject
This mixin inherits from (a subclass of) PolymorphicObject and provides a base implementation of a ne...
Definition: polymorphic_object.hpp:661