Ginkgo  Generated from pipelines/2837190956 branch based on develop. Ginkgo version 2.0.0
A numerical linear algebra library targeting many-core architectures
row_gatherer.hpp
1 // SPDX-FileCopyrightText: 2017 - 2026 The Ginkgo authors
2 //
3 // SPDX-License-Identifier: BSD-3-Clause
4 
5 #ifndef GKO_PUBLIC_CORE_MATRIX_ROW_GATHERER_HPP_
6 #define GKO_PUBLIC_CORE_MATRIX_ROW_GATHERER_HPP_
7 
8 
9 #include <algorithm>
10 #include <memory>
11 #include <numeric>
12 #include <vector>
13 
14 #include <ginkgo/core/base/array.hpp>
15 #include <ginkgo/core/base/exception.hpp>
16 #include <ginkgo/core/base/exception_helpers.hpp>
17 #include <ginkgo/core/base/executor.hpp>
18 #include <ginkgo/core/base/lin_op.hpp>
19 #include <ginkgo/core/base/types.hpp>
20 #include <ginkgo/core/base/utils.hpp>
21 
22 
23 namespace gko {
24 namespace matrix {
25 
26 
40 template <typename IndexType = int32>
41 class RowGatherer : public LinOp,
42  public EnableCloneable<RowGatherer<IndexType>> {
43  friend class EnableCloneable<RowGatherer>;
44 
45 public:
46  using index_type = IndexType;
47 
53  index_type* get_row_idxs() noexcept { return row_idxs_.get_data(); }
54 
62  const index_type* get_const_row_idxs() const noexcept
63  {
64  return row_idxs_.get_const_data();
65  }
66 
75  static std::unique_ptr<RowGatherer> create(
76  std::shared_ptr<const Executor> exec, const dim<2>& size = {});
77 
92  static std::unique_ptr<RowGatherer> create(
93  std::shared_ptr<const Executor> exec, const dim<2>& size,
94  array<index_type> row_idxs);
95 
106  static std::unique_ptr<const RowGatherer> create_const(
107  std::shared_ptr<const Executor> exec, const dim<2>& size,
108  gko::detail::const_array_view<IndexType>&& row_idxs);
109 
110 protected:
111  RowGatherer(std::shared_ptr<const Executor> exec, const dim<2>& size = {});
112 
113  RowGatherer(std::shared_ptr<const Executor> exec, const dim<2>& size,
114  array<index_type> row_idxs);
115 
116  void apply_impl(const LinOp* in, LinOp* out) const override;
117 
118  void apply_impl(const LinOp* alpha, const LinOp* in, const LinOp* beta,
119  LinOp* out) const override;
120 
121 private:
122  gko::array<index_type> row_idxs_;
123 };
124 
125 
126 } // namespace matrix
127 } // namespace gko
128 
129 
130 #endif // GKO_PUBLIC_CORE_MATRIX_ROW_GATHERER_HPP_
gko::LinOp
Definition: lin_op.hpp:117
gko::matrix::RowGatherer
RowGatherer is a matrix "format" which stores the gather indices arrays which can be used to gather r...
Definition: row_gatherer.hpp:41
gko
The Ginkgo namespace.
Definition: abstract_factory.hpp:19
gko::array< index_type >
gko::dim< 2 >
gko::matrix::RowGatherer::create_const
static std::unique_ptr< const RowGatherer > create_const(std::shared_ptr< const Executor > exec, const dim< 2 > &size, gko::detail::const_array_view< IndexType > &&row_idxs)
Creates a constant (immutable) RowGatherer matrix from a constant array.
gko::array::get_data
value_type * get_data() noexcept
Returns a pointer to the block of memory used to store the elements of the array.
Definition: array.hpp:686
gko::matrix::RowGatherer::create
static std::unique_ptr< RowGatherer > create(std::shared_ptr< const Executor > exec, const dim< 2 > &size={})
Creates uninitialized RowGatherer arrays of the specified size.
gko::EnableCloneable
This mixin is used to enable a default Cloneable::clone() implementation and similar for objects that...
Definition: polymorphic_object.hpp:376
gko::array::get_const_data
const value_type * get_const_data() const noexcept
Returns a constant pointer to the block of memory used to store the elements of the array.
Definition: array.hpp:695
gko::matrix::RowGatherer::get_row_idxs
index_type * get_row_idxs() noexcept
Returns a pointer to the row index array for gathering.
Definition: row_gatherer.hpp:53
gko::matrix::RowGatherer::get_const_row_idxs
const index_type * get_const_row_idxs() const noexcept
Returns a pointer to the row index array for gathering.
Definition: row_gatherer.hpp:62
gko::LinOp::LinOp
LinOp(const LinOp &)=default
Copy-constructs a LinOp.