Ginkgo  Generated from pipelines/2837190956 branch based on develop. Ginkgo version 2.0.0
A numerical linear algebra library targeting many-core architectures
range_accessors.hpp
1 // SPDX-FileCopyrightText: 2017 - 2026 The Ginkgo authors
2 //
3 // SPDX-License-Identifier: BSD-3-Clause
4 
5 #ifndef GKO_PUBLIC_CORE_BASE_RANGE_ACCESSORS_HPP_
6 #define GKO_PUBLIC_CORE_BASE_RANGE_ACCESSORS_HPP_
7 
8 
9 #include <array>
10 
11 #include <ginkgo/core/base/range.hpp>
12 #include <ginkgo/core/base/types.hpp>
13 
14 
15 namespace gko {
20 namespace accessor {
21 
22 
38 template <typename ValueType, size_type Dimensionality>
39 class row_major {
40 public:
41  friend class range<row_major>;
42 
43  static_assert(Dimensionality == 2,
44  "This accessor is only implemented for matrices");
45 
49  using value_type = ValueType;
50 
55 
59  static constexpr size_type dimensionality = 2;
60 
61 protected:
72  constexpr GKO_ATTRIBUTES explicit row_major(data_type data,
73  size_type num_rows,
74  size_type num_cols,
76  : data{data}, lengths{num_rows, num_cols}, stride{stride}
77  {}
78 
79 public:
88  constexpr GKO_ATTRIBUTES value_type& operator()(size_type row,
89  size_type col) const
90  {
91  return GKO_ASSERT(row < lengths[0]), GKO_ASSERT(col < lengths[1]),
92  data[row * stride + col];
93  }
94 
103  constexpr GKO_ATTRIBUTES range<row_major> operator()(const span& rows,
104  const span& cols) const
105  {
106  return GKO_ASSERT(rows.is_valid()), GKO_ASSERT(cols.is_valid()),
107  GKO_ASSERT(rows <= span{lengths[0]}),
108  GKO_ASSERT(cols <= span{lengths[1]}),
109  range<row_major>(data + rows.begin * stride + cols.begin,
110  rows.end - rows.begin, cols.end - cols.begin,
111  stride);
112  }
113 
121  constexpr GKO_ATTRIBUTES size_type length(size_type dimension) const
122  {
123  return dimension < 2 ? lengths[dimension] : 1;
124  }
125 
138  template <typename OtherAccessor>
139  GKO_ATTRIBUTES void copy_from(const OtherAccessor& other) const
140  {
141  for (size_type i = 0; i < lengths[0]; ++i) {
142  for (size_type j = 0; j < lengths[1]; ++j) {
143  (*this)(i, j) = other(i, j);
144  }
145  }
146  }
147 
152 
156  const std::array<const size_type, dimensionality> lengths;
157 
162 };
163 
164 
165 } // namespace accessor
166 } // namespace gko
167 
168 
169 #endif // GKO_PUBLIC_CORE_BASE_RANGE_ACCESSORS_HPP_
gko::accessor::row_major::operator()
constexpr value_type & operator()(size_type row, size_type col) const
Returns the data element at position (row, col)
Definition: range_accessors.hpp:88
gko::span::end
const size_type end
End of the span.
Definition: range.hpp:89
gko::size_type
std::size_t size_type
Integral type used for allocation quantities.
Definition: types.hpp:101
gko::accessor::row_major::operator()
constexpr range< row_major > operator()(const span &rows, const span &cols) const
Returns the sub-range spanning the range (rows, cols)
Definition: range_accessors.hpp:103
gko::accessor::row_major
A row_major accessor is a bridge between a range and the row-major memory layout.
Definition: range_accessors.hpp:39
gko::span::is_valid
constexpr bool is_valid() const
Checks if a span is valid.
Definition: range.hpp:72
gko::span::begin
const size_type begin
Beginning of the span.
Definition: range.hpp:84
gko::accessor::row_major::data
const data_type data
Reference to the underlying data.
Definition: range_accessors.hpp:151
gko::accessor::row_major::lengths
const std::array< const size_type, dimensionality > lengths
An array of dimension sizes.
Definition: range_accessors.hpp:156
gko::range
A range is a multidimensional view of the memory.
Definition: range.hpp:302
gko
The Ginkgo namespace.
Definition: abstract_factory.hpp:19
gko::span
A span is a lightweight structure used to create sub-ranges from other ranges.
Definition: range.hpp:45
gko::accessor::row_major::stride
const size_type stride
Distance between consecutive rows.
Definition: range_accessors.hpp:161
gko::accessor::row_major::value_type
ValueType value_type
Type of values returned by the accessor.
Definition: range_accessors.hpp:49
gko::accessor::row_major::copy_from
void copy_from(const OtherAccessor &other) const
Copies data from another accessor.
Definition: range_accessors.hpp:139
gko::accessor::row_major::dimensionality
static constexpr size_type dimensionality
Number of dimensions of the accessor.
Definition: range_accessors.hpp:59
gko::accessor::row_major::length
constexpr size_type length(size_type dimension) const
Returns the length in dimension dimension.
Definition: range_accessors.hpp:121
gko::accessor::row_major::data_type
value_type * data_type
Type of underlying data storage.
Definition: range_accessors.hpp:54