Tpetra parallel linear algebra  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Tpetra_RowGraph_decl.hpp
1 // @HEADER
2 // *****************************************************************************
3 // Tpetra: Templated Linear Algebra Services Package
4 //
5 // Copyright 2008 NTESS and the Tpetra contributors.
6 // SPDX-License-Identifier: BSD-3-Clause
7 // *****************************************************************************
8 // @HEADER
9 
10 #ifndef TPETRA_ROWGRAPH_DECL_HPP
11 #define TPETRA_ROWGRAPH_DECL_HPP
12 
13 #include "Tpetra_RowGraph_fwd.hpp"
14 #include "Tpetra_Map.hpp"
15 #include "Tpetra_Import.hpp"
16 #include "Tpetra_Export.hpp"
17 #include "Tpetra_Packable.hpp"
18 #include "Teuchos_Describable.hpp"
19 
20 namespace Tpetra {
21 
34 template <class LocalOrdinal,
35  class GlobalOrdinal,
36  class Node>
37 class RowGraph : virtual public Teuchos::Describable,
38  public Packable<GlobalOrdinal, LocalOrdinal> {
39  public:
41 
42  typedef LocalOrdinal local_ordinal_type;
45  typedef GlobalOrdinal global_ordinal_type;
47  typedef Node node_type;
49 
50  typedef typename Kokkos::View<LocalOrdinal*, typename Node::device_type>::const_type
51  local_inds_device_view_type;
52  typedef typename local_inds_device_view_type::host_mirror_type::const_type
53  local_inds_host_view_type;
54  typedef typename local_inds_device_view_type::host_mirror_type
55  nonconst_local_inds_host_view_type;
56 
57  typedef typename Kokkos::View<GlobalOrdinal*, typename Node::device_type>::const_type
58  global_inds_device_view_type;
59  typedef typename global_inds_device_view_type::host_mirror_type::const_type
60  global_inds_host_view_type;
61  typedef typename global_inds_device_view_type::host_mirror_type
62  nonconst_global_inds_host_view_type;
63 
64  typedef typename Kokkos::View<const size_t*, typename Node::device_type>::const_type
65  row_ptrs_device_view_type;
66  typedef typename row_ptrs_device_view_type::host_mirror_type::const_type
67  row_ptrs_host_view_type;
68 
70  virtual ~RowGraph(){};
71 
73 
74 
76  virtual Teuchos::RCP<const Teuchos::Comm<int> >
77  getComm() const = 0;
78 
80  virtual Teuchos::RCP<const Map<LocalOrdinal, GlobalOrdinal, Node> >
81  getRowMap() const = 0;
82 
84  virtual Teuchos::RCP<const Map<LocalOrdinal, GlobalOrdinal, Node> >
85  getColMap() const = 0;
86 
88  virtual Teuchos::RCP<const Map<LocalOrdinal, GlobalOrdinal, Node> >
89  getDomainMap() const = 0;
90 
92  virtual Teuchos::RCP<const Map<LocalOrdinal, GlobalOrdinal, Node> >
93  getRangeMap() const = 0;
94 
96  virtual Teuchos::RCP<const Import<LocalOrdinal, GlobalOrdinal, Node> >
97  getImporter() const = 0;
98 
100  virtual Teuchos::RCP<const Export<LocalOrdinal, GlobalOrdinal, Node> >
101  getExporter() const = 0;
102 
104  virtual global_size_t getGlobalNumRows() const = 0;
105 
107  virtual global_size_t getGlobalNumCols() const = 0;
108 
110  virtual size_t getLocalNumRows() const = 0;
111 
113  virtual size_t getLocalNumCols() const = 0;
114 
116  virtual GlobalOrdinal getIndexBase() const = 0;
117 
119  virtual global_size_t getGlobalNumEntries() const = 0;
120 
122  virtual size_t getLocalNumEntries() const = 0;
123 
125 
126  virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const = 0;
127 
129 
130  virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const = 0;
131 
133  virtual size_t getGlobalMaxNumRowEntries() const = 0;
134 
136  virtual size_t getLocalMaxNumRowEntries() const = 0;
137 
139  virtual bool hasColMap() const = 0;
140 
142  virtual bool isLocallyIndexed() const = 0;
143 
145  virtual bool isGloballyIndexed() const = 0;
146 
148  virtual bool isFillComplete() const = 0;
149 
151 
153 
169 
170  virtual void
171  getGlobalRowCopy(const GlobalOrdinal gblRow,
172  nonconst_global_inds_host_view_type& gblColInds,
173  size_t& numColInds) const = 0;
174 
191  virtual void
192  getLocalRowCopy(const LocalOrdinal lclRow,
193  nonconst_local_inds_host_view_type& lclColInds,
194  size_t& numColInds) const = 0;
195 
202  virtual bool supportsRowViews() const {
203  return false;
204  }
205 
233  virtual void
234  getLocalRowView(const LocalOrdinal lclRow,
235  local_inds_host_view_type& lclColInds) const = 0;
236 
252  virtual void
253  getGlobalRowView(const GlobalOrdinal gblRow,
254  global_inds_host_view_type& gblColInds) const = 0;
255 
257 
259 
261  virtual void
262  pack(const Teuchos::ArrayView<const LocalOrdinal>& exportLIDs,
263  Teuchos::Array<GlobalOrdinal>& exports,
264  const Teuchos::ArrayView<size_t>& numPacketsPerLID,
265  size_t& constantNumPackets) const;
267 }; // class RowGraph
268 } // namespace Tpetra
269 
270 #endif // TPETRA_ROWGRAPH_DECL_HPP
virtual bool hasColMap() const =0
Whether the graph has a well-defined column Map.
virtual Teuchos::RCP< const Import< LocalOrdinal, GlobalOrdinal, Node > > getImporter() const =0
This graph&#39;s Import object.
virtual ~RowGraph()
Destructor (virtual for memory safety of derived classes).
virtual void pack(const Teuchos::ArrayView< const LocalOrdinal > &exportLIDs, Teuchos::Array< GlobalOrdinal > &exports, const Teuchos::ArrayView< size_t > &numPacketsPerLID, size_t &constantNumPackets) const
Pack this object&#39;s data for Import or Export.
virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const =0
Returns the current number of entries on this node in the specified local row.
An abstract interface for graphs accessed by rows.
virtual GlobalOrdinal getIndexBase() const =0
Returns the index base for global indices for this graph.
virtual Teuchos::RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > getRowMap() const =0
The Map that describes this graph&#39;s distribution of rows over processes.
GlobalOrdinal global_ordinal_type
The type of global indices in the graph.
virtual size_t getLocalNumCols() const =0
Returns the number of columns connected to the locally owned rows of this graph.
virtual size_t getLocalNumEntries() const =0
Returns the local number of entries in the graph.
virtual size_t getLocalMaxNumRowEntries() const =0
Returns the maximum number of entries across all rows/columns on this node.
virtual bool supportsRowViews() const
Whether this class implements getLocalRowView() and getGlobalRowView().
Forward declaration of Tpetra::RowGraph.
virtual bool isFillComplete() const =0
Whether fillComplete() has been called (without an intervening resumeFill()).
virtual Teuchos::RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > getRangeMap() const =0
The Map associated with the range of this graph.
size_t global_size_t
Global size_t object.
virtual global_size_t getGlobalNumRows() const =0
Returns the number of global rows in the graph.
virtual size_t getGlobalMaxNumRowEntries() const =0
Returns the maximum number of entries across all rows/columns on all nodes.
virtual global_size_t getGlobalNumCols() const =0
Returns the number of global columns in the graph.
virtual void getGlobalRowCopy(const GlobalOrdinal gblRow, nonconst_global_inds_host_view_type &gblColInds, size_t &numColInds) const =0
Get a copy of the global column indices in a given row of the graph.
virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const =0
Returns the current number of entries on this node in the specified global row.
virtual void getLocalRowCopy(const LocalOrdinal lclRow, nonconst_local_inds_host_view_type &lclColInds, size_t &numColInds) const =0
Get a copy of the local column indices in a given row of the graph.
virtual Teuchos::RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > getColMap() const =0
The Map that describes this graph&#39;s distribution of columns over processes.
virtual bool isGloballyIndexed() const =0
If graph indices are in the global range, this function returns true. Otherwise, this function return...
LocalOrdinal local_ordinal_type
The type of local indices in the graph.
virtual void getGlobalRowView(const GlobalOrdinal gblRow, global_inds_host_view_type &gblColInds) const =0
Get a const, non-persisting view of the given global row&#39;s global column indices, as a Teuchos::Array...
virtual Teuchos::RCP< const Export< LocalOrdinal, GlobalOrdinal, Node > > getExporter() const =0
This graph&#39;s Export object.
virtual void getLocalRowView(const LocalOrdinal lclRow, local_inds_host_view_type &lclColInds) const =0
Get a constant, nonpersisting, locally indexed view of the given row of the graph.
virtual Teuchos::RCP< const Teuchos::Comm< int > > getComm() const =0
The communicator over which this graph is distributed.
Node node_type
The Kokkos Node type.
virtual bool isLocallyIndexed() const =0
If graph indices are in the local range, this function returns true. Otherwise, this function returns...
virtual size_t getLocalNumRows() const =0
Returns the number of rows owned on the calling node.
virtual Teuchos::RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > getDomainMap() const =0
The Map associated with the domain of this graph.
Declaration of Tpetra::Packable.
Abstract base class for objects that can be the source of an Import or Export operation, and that also know how to pack their data to send to the target object.
virtual global_size_t getGlobalNumEntries() const =0
Returns the global number of entries in the graph.