Ginkgo  Generated from pipelines/1554403166 branch based on develop. Ginkgo version 1.9.0
A numerical linear algebra library targeting many-core architectures
index_map.hpp
1 // SPDX-FileCopyrightText: 2017 - 2024 The Ginkgo authors
2 //
3 // SPDX-License-Identifier: BSD-3-Clause
4 
5 #ifndef GKO_PUBLIC_CORE_DISTRIBUTED_INDEX_MAP_HPP_
6 #define GKO_PUBLIC_CORE_DISTRIBUTED_INDEX_MAP_HPP_
7 
8 
9 #include <ginkgo/core/base/segmented_array.hpp>
10 #include <ginkgo/core/distributed/partition.hpp>
11 
12 
13 namespace gko {
14 namespace experimental {
15 namespace distributed {
16 
17 
23 enum class index_space {
24  local,
25  non_local,
26  combined
27 };
28 
29 
67 template <typename LocalIndexType, typename GlobalIndexType = int64>
68 struct index_map {
70 
82  index_space index_space_v) const;
83 
87  size_type get_global_size() const;
88 
92  size_type get_local_size() const;
93 
98 
111  index_map(std::shared_ptr<const Executor> exec,
112  std::shared_ptr<const partition_type> partition,
113  comm_index_type rank,
114  const array<GlobalIndexType>& recv_connections);
115 
119  index_map(std::shared_ptr<const Executor> exec);
120 
127 
143 
151 
155  std::shared_ptr<const Executor> get_executor() const;
156 
157  index_map(const index_map& other);
158 
159  index_map(index_map&& other) noexcept;
160 
161  index_map& operator=(const index_map& other);
162 
163  index_map& operator=(index_map&& other);
164 
165 private:
166  std::shared_ptr<const Executor> exec_;
167  std::shared_ptr<const partition_type> partition_;
168  comm_index_type rank_;
169 
170  array<comm_index_type> remote_target_ids_;
171  segmented_array<LocalIndexType> remote_local_idxs_;
172  segmented_array<GlobalIndexType> remote_global_idxs_;
173 };
174 
175 
176 } // namespace distributed
177 } // namespace experimental
178 } // namespace gko
179 
180 
181 #endif // GKO_PUBLIC_CORE_DISTRIBUTED_INDEX_MAP_HPP_
gko::experimental::distributed::index_space::combined
both local and non_local indices
gko::experimental::distributed::index_space::local
indices that are locally owned
gko::experimental::distributed::index_map::get_remote_local_idxs
const segmented_array< LocalIndexType > & get_remote_local_idxs() const
get the index set , but mapped to their respective local index space.
gko::experimental::distributed::index_map::get_remote_target_ids
const array< comm_index_type > & get_remote_target_ids() const
get the rank ids which contain indices accessed by this rank.
gko::size_type
std::size_t size_type
Integral type used for allocation quantities.
Definition: types.hpp:86
gko::experimental::distributed::index_map::index_map
index_map(std::shared_ptr< const Executor > exec, std::shared_ptr< const partition_type > partition, comm_index_type rank, const array< GlobalIndexType > &recv_connections)
Creates a new index map.
gko::experimental::distributed::index_map::get_local_size
size_type get_local_size() const
get size of index_space::local
gko
The Ginkgo namespace.
Definition: abstract_factory.hpp:20
gko::array< LocalIndexType >
gko::experimental::distributed::index_map
This class defines mappings between global and local indices.
Definition: index_map.hpp:68
gko::experimental::distributed::index_map::get_remote_global_idxs
const segmented_array< GlobalIndexType > & get_remote_global_idxs() const
get the index set for this rank.
gko::experimental::distributed::index_map::map_to_local
array< LocalIndexType > map_to_local(const array< GlobalIndexType > &global_ids, index_space index_space_v) const
Maps global indices to local indices.
gko::segmented_array< GlobalIndexType >
gko::experimental::distributed::Partition
Represents a partition of a range of indices [0, size) into a disjoint set of parts.
Definition: matrix.hpp:137
gko::experimental::distributed::index_space::non_local
indices that are owned by other processes
gko::experimental::distributed::index_map::get_non_local_size
size_type get_non_local_size() const
get size of index_space::non_local
gko::experimental::distributed::index_space
index_space
Index space classification for the locally stored indices.
Definition: index_map.hpp:23
gko::experimental::distributed::index_map::get_global_size
size_type get_global_size() const
get size of index_space::local
gko::experimental::distributed::index_map::get_executor
std::shared_ptr< const Executor > get_executor() const
get the associated executor.
gko::experimental::distributed::comm_index_type
int comm_index_type
Index type for enumerating processes in a distributed application.
Definition: types.hpp:838