5#ifndef GKO_PUBLIC_CORE_MATRIX_COO_HPP_
6#define GKO_PUBLIC_CORE_MATRIX_COO_HPP_
9#include <ginkgo/core/base/array.hpp>
10#include <ginkgo/core/base/lin_op.hpp>
22template <
typename ValueType,
typename IndexType>
25template <
typename ValueType>
28template <
typename ValueType,
typename IndexType>
31template <
typename ValueType,
typename IndexType>
49template <
typename ValueType = default_precision,
typename IndexType =
int32>
51 public ConvertibleTo<Coo<next_precision<ValueType>, IndexType>>,
58 remove_complex<Coo<ValueType, IndexType>>> {
60 friend class Csr<ValueType, IndexType>;
61 friend class Dense<ValueType>;
64 friend class Hybrid<ValueType, IndexType>;
77 using value_type = ValueType;
78 using index_type = IndexType;
223 static std::unique_ptr<Coo>
create(std::shared_ptr<const Executor> exec,
247 static std::unique_ptr<Coo>
create(std::shared_ptr<const Executor> exec,
257 template <
typename InputValueType,
typename InputColumnIndexType,
258 typename InputRowIndexType>
260 "explicitly construct the gko::array argument instead of passing "
263 std::shared_ptr<const
Executor> exec, const
dim<2>& size,
264 std::initializer_list<InputValueType> values,
265 std::initializer_list<InputColumnIndexType> col_idxs,
266 std::initializer_list<InputRowIndexType> row_idxs)
287 std::shared_ptr<const Executor> exec,
const dim<2>& size,
288 gko::detail::const_array_view<ValueType>&& values,
289 gko::detail::const_array_view<IndexType>&& col_idxs,
290 gko::detail::const_array_view<IndexType>&& row_idxs);
293 Coo(std::shared_ptr<const Executor> exec,
const dim<2>& size =
dim<2>{},
296 Coo(std::shared_ptr<const Executor> exec,
const dim<2>& size,
309 void apply_impl(
const LinOp* b,
LinOp* x)
const override;
312 LinOp* x)
const override;
314 void apply2_impl(
const LinOp* b,
LinOp* x)
const;
ConvertibleTo interface is used to mark that the implementer can be converted to the object of Result...
Definition polymorphic_object.hpp:471
The EnableAbsoluteComputation mixin provides the default implementations of compute_absolute_linop an...
Definition lin_op.hpp:795
The EnableLinOp mixin can be used to provide sensible default implementations of the majority of the ...
Definition lin_op.hpp:880
This mixin inherits from (a subclass of) PolymorphicObject and provides a base implementation of a ne...
Definition polymorphic_object.hpp:663
The first step in using the Ginkgo library consists of creating an executor.
Definition executor.hpp:616
Definition lin_op.hpp:118
A LinOp implementing this interface can read its data from a matrix_data structure.
Definition lin_op.hpp:606
A LinOp implementing this interface can write its data to a matrix_data structure.
Definition lin_op.hpp:661
An array is a container which encapsulates fixed-sized arrays, stored on the Executor tied to the arr...
Definition logger.hpp:25
value_type * get_data() noexcept
Returns a pointer to the block of memory used to store the elements of the array.
Definition array.hpp:674
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:683
size_type get_size() const noexcept
Returns the number of elements in the array.
Definition array.hpp:657
This type is a device-side equivalent to matrix_data.
Definition device_matrix_data.hpp:36
COO stores a matrix in the coordinate matrix format.
Definition ell.hpp:21
index_type * get_col_idxs() noexcept
Returns the column indexes of the matrix.
Definition coo.hpp:136
const index_type * get_const_col_idxs() const noexcept
Returns the column indexes of the matrix.
Definition coo.hpp:145
void read(const device_mat_data &data) override
Reads a matrix from a device_matrix_data structure.
static std::unique_ptr< const Coo > create_const(std::shared_ptr< const Executor > exec, const dim< 2 > &size, gko::detail::const_array_view< ValueType > &&values, gko::detail::const_array_view< IndexType > &&col_idxs, gko::detail::const_array_view< IndexType > &&row_idxs)
Creates a constant (immutable) Coo matrix from a set of constant arrays.
void read(device_mat_data &&data) override
Reads a matrix from a device_matrix_data structure.
const LinOp * apply2(ptr_param< const LinOp > alpha, ptr_param< const LinOp > b, ptr_param< LinOp > x) const
LinOp * apply2(ptr_param< const LinOp > b, ptr_param< LinOp > x)
Applies Coo matrix axpy to a vector (or a sequence of vectors).
LinOp * apply2(ptr_param< const LinOp > alpha, ptr_param< const LinOp > b, ptr_param< LinOp > x)
Performs the operation x = alpha * Coo * b + x.
void compute_absolute_inplace() override
Compute absolute inplace on each element.
const value_type * get_const_values() const noexcept
Returns the values of the matrix.
Definition coo.hpp:126
void read(const mat_data &data) override
Reads a matrix from a matrix_data structure.
const index_type * get_const_row_idxs() const noexcept
Definition coo.hpp:164
const LinOp * apply2(ptr_param< const LinOp > b, ptr_param< LinOp > x) const
std::unique_ptr< absolute_type > compute_absolute() const override
Gets the AbsoluteLinOp.
static std::unique_ptr< Coo > create(std::shared_ptr< const Executor > exec, const dim< 2 > &size=dim< 2 >{}, size_type num_nonzeros={})
Creates an uninitialized COO matrix of the specified size.
void write(mat_data &data) const override
Writes a matrix to a matrix_data structure.
size_type get_num_stored_elements() const noexcept
Returns the number of elements explicitly stored in the matrix.
Definition coo.hpp:174
std::unique_ptr< Diagonal< ValueType > > extract_diagonal() const override
Extracts the diagonal entries of the matrix into a vector.
index_type * get_row_idxs() noexcept
Returns the row indexes of the matrix.
Definition coo.hpp:155
static std::unique_ptr< Coo > create(std::shared_ptr< const Executor > exec, const dim< 2 > &size, array< value_type > values, array< index_type > col_idxs, array< index_type > row_idxs)
Creates a COO matrix from already allocated (and initialized) row index, column index and value array...
value_type * get_values() noexcept
Returns the values of the matrix.
Definition coo.hpp:117
CSR is a matrix format which stores only the nonzero coefficients by compressing each row of the matr...
Definition sparsity_csr.hpp:22
Dense is a matrix format which explicitly stores all values of the matrix.
Definition sparsity_csr.hpp:26
HYBRID is a matrix format which splits the matrix into ELLPACK and COO format.
Definition hybrid.hpp:52
This class is used for function parameters in the place of raw pointers.
Definition utils_helper.hpp:43
The Ginkgo namespace.
Definition abstract_factory.hpp:20
typename detail::remove_complex_s< T >::type remove_complex
Obtain the type which removed the complex of complex/scalar type or the template parameter of class b...
Definition math.hpp:326
typename detail::next_precision_impl< T >::type next_precision
Obtains the next type in the singly-linked precision list.
Definition math.hpp:462
typename detail::to_complex_s< T >::type to_complex
Obtain the type which adds the complex of complex/scalar type or the template parameter of class by a...
Definition math.hpp:345
std::size_t size_type
Integral type used for allocation quantities.
Definition types.hpp:86
A type representing the dimensions of a multidimensional object.
Definition dim.hpp:27
This structure is used as an intermediate data type to store a sparse matrix.
Definition matrix_data.hpp:127