Xpetra  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
Xpetra_TpetraCrsGraph_decl.hpp
Go to the documentation of this file.
1 // @HEADER
2 // *****************************************************************************
3 // Xpetra: A linear algebra interface package
4 //
5 // Copyright 2012 NTESS and the Xpetra contributors.
6 // SPDX-License-Identifier: BSD-3-Clause
7 // *****************************************************************************
8 // @HEADER
9 
10 #ifndef XPETRA_TPETRACRSGRAPH_DECL_HPP
11 #define XPETRA_TPETRACRSGRAPH_DECL_HPP
12 
13 /* this file is automatically generated - do not edit (see script/tpetra.py) */
14 
16 #include "Xpetra_Exceptions.hpp"
17 
18 #include "Tpetra_CrsGraph.hpp"
19 
20 #include "Xpetra_CrsGraph.hpp"
24 #include "Xpetra_Utils.hpp"
25 
26 namespace Xpetra {
27 
28 template <class LocalOrdinal,
29  class GlobalOrdinal,
30  class Node = Tpetra::KokkosClassic::DefaultNode::DefaultNodeType>
32  : public CrsGraph<LocalOrdinal, GlobalOrdinal, Node> {
33 #undef XPETRA_TPETRACRSGRAPH_SHORT
35  // The following typedef is used by the XPETRA_DYNAMIC_CAST() macro.
39  typedef Map map_type;
40 
42 
43  public:
45 
46 
48  TpetraCrsGraph(const RCP<const Map>& rowMap, size_t maxNumEntriesPerRow, const RCP<ParameterList>& params = null);
49 
51  TpetraCrsGraph(const RCP<const Map>& rowMap, const ArrayRCP<const size_t>& NumEntriesPerRowToAlloc, const RCP<ParameterList>& params = null);
52 
54  TpetraCrsGraph(const RCP<const Map>& rowMap, const RCP<const Map>& colMap, size_t maxNumEntriesPerRow, const RCP<ParameterList>& params = null);
55 
57  TpetraCrsGraph(const RCP<const Map>& rowMap, const RCP<const Map>& colMap, const ArrayRCP<const size_t>& NumEntriesPerRowToAlloc, const RCP<ParameterList>& params = null);
58 
59  // Constructor for fused import
60  TpetraCrsGraph(const RCP<const CrsGraph>& sourceGraph,
61  const Import& importer,
62  const RCP<const Map>& domainMap = Teuchos::null,
63  const RCP<const Map>& rangeMap = Teuchos::null,
64  const RCP<Teuchos::ParameterList>& params = Teuchos::null);
65 
85  TpetraCrsGraph(const Teuchos::RCP<const Map>& rowMap,
86  const Teuchos::RCP<const Map>& colMap,
87  const typename local_graph_type::row_map_type& rowPointers,
88  const typename local_graph_type::entries_type::non_const_type& columnIndices,
89  const Teuchos::RCP<Teuchos::ParameterList>& plist = Teuchos::null);
90 
115  TpetraCrsGraph(const local_graph_type& lclGraph,
116  const Teuchos::RCP<const map_type>& rowMap,
117  const Teuchos::RCP<const map_type>& colMap,
118  const Teuchos::RCP<const map_type>& domainMap = Teuchos::null,
119  const Teuchos::RCP<const map_type>& rangeMap = Teuchos::null,
120  const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
121 
140  TpetraCrsGraph(const Teuchos::RCP<const Map>& rowMap,
141  const Teuchos::RCP<const Map>& colMap,
142  const local_graph_type& lclGraph,
143  const Teuchos::RCP<Teuchos::ParameterList>& params);
144 
145  TpetraCrsGraph(const Teuchos::RCP<const Map>& rowMap,
146  const Teuchos::RCP<const Map>& colMap,
147  const Teuchos::ArrayRCP<size_t>& rowPointers,
148  const Teuchos::ArrayRCP<LocalOrdinal>& columnIndices,
149  const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
150 
152  virtual ~TpetraCrsGraph();
153 
155 
156 
158  void insertGlobalIndices(GlobalOrdinal globalRow, const ArrayView<const GlobalOrdinal>& indices);
159 
161  void insertLocalIndices(const LocalOrdinal localRow, const ArrayView<const LocalOrdinal>& indices);
162 
164  void removeLocalIndices(LocalOrdinal localRow);
165 
167  void allocateAllIndices(size_t numNonZeros, ArrayRCP<size_t>& rowptr, ArrayRCP<LocalOrdinal>& colind);
168 
170  void setAllIndices(const ArrayRCP<size_t>& rowptr, const ArrayRCP<LocalOrdinal>& colind);
171 
173  void getAllIndices(ArrayRCP<const size_t>& rowptr, ArrayRCP<const LocalOrdinal>& colind) const;
174 
176 
178 
179 
181  void fillComplete(const RCP<const Map>& domainMap, const RCP<const Map>& rangeMap, const RCP<ParameterList>& params = null);
182 
184  void fillComplete(const RCP<ParameterList>& params = null);
185 
187  void
188  expertStaticFillComplete(const Teuchos::RCP<const map_type>& domainMap,
189  const Teuchos::RCP<const map_type>& rangeMap,
190  const Teuchos::RCP<const Import>& importer =
191  Teuchos::null,
192  const Teuchos::RCP<const Export>& exporter =
193  Teuchos::null,
194  const Teuchos::RCP<Teuchos::ParameterList>& params =
195  Teuchos::null);
197 
199 
201 
202 
204  RCP<const Comm<int> > getComm() const;
205 
207  RCP<const Map> getRowMap() const;
208 
210  RCP<const Map> getColMap() const;
211 
213  RCP<const Map> getDomainMap() const;
214 
216  RCP<const Map> getRangeMap() const;
217 
219  RCP<const Import> getImporter() const;
220 
222  RCP<const Export> getExporter() const;
223 
226 
229 
231  size_t getLocalNumRows() const;
232 
234  size_t getLocalNumCols() const;
235 
237  GlobalOrdinal getIndexBase() const;
238 
241 
243  size_t getLocalNumEntries() const;
244 
246  size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const;
247 
249  size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const;
250 
252  size_t getNumAllocatedEntriesInGlobalRow(GlobalOrdinal globalRow) const;
253 
255  size_t getNumAllocatedEntriesInLocalRow(LocalOrdinal localRow) const;
256 
258  size_t getGlobalMaxNumRowEntries() const;
259 
261  size_t getLocalMaxNumRowEntries() const;
262 
264  bool hasColMap() const;
265 
267  bool isLocallyIndexed() const;
268 
270  bool isGloballyIndexed() const;
271 
273  bool isFillComplete() const;
274 
276  bool isStorageOptimized() const;
277 
279  void getGlobalRowView(GlobalOrdinal GlobalRow, ArrayView<const GlobalOrdinal>& Indices) const;
280 
282  void getLocalRowView(LocalOrdinal LocalRow, ArrayView<const LocalOrdinal>& indices) const;
283 
285  typename local_graph_type::HostMirror getLocalGraphHost() const;
286 
289 
291  void getLocalDiagOffsets(const Kokkos::View<size_t*, typename Node::device_type, Kokkos::MemoryUnmanaged>& offsets) const;
292 
294  void computeGlobalConstants();
295 
297 
299 
300 
302  std::string description() const;
303 
305  void describe(Teuchos::FancyOStream& out, const Teuchos::EVerbosityLevel verbLevel = Teuchos::Describable::verbLevel_default) const;
306 
308 
310 
311 
313  ArrayRCP<const size_t> getNodeRowPtrs() const;
314 
316 
318  //{@
319 
321  Teuchos::RCP<const Map> getMap() const;
322 
325  const Import& importer, CombineMode CM);
326 
329  const Import& importer, CombineMode CM);
330 
333  const Export& exporter, CombineMode CM);
334 
337  const Export& exporter, CombineMode CM);
338 
339  // @}
340 
342 
343 
345  TpetraCrsGraph(const Teuchos::RCP<Tpetra::CrsGraph<LocalOrdinal, GlobalOrdinal, Node> >& graph);
346 
348  RCP<const Tpetra::CrsGraph<LocalOrdinal, GlobalOrdinal, Node> > getTpetra_CrsGraph() const;
349 
351 
352  private:
353  RCP<Tpetra::CrsGraph<LocalOrdinal, GlobalOrdinal, Node> > graph_;
354 }; // TpetraCrsGraph class
355 
356 // TODO: move that elsewhere
357 template <class LocalOrdinal, class GlobalOrdinal, class Node>
358 RCP<const CrsGraph<LocalOrdinal, GlobalOrdinal, Node> >
359 toXpetra(RCP<const Tpetra::CrsGraph<LocalOrdinal, GlobalOrdinal, Node> > graph) { // TODO: return TpetraCrsGraph instead of CrsGraph
360  // typedef TpetraCrsGraph<LocalOrdinal, GlobalOrdinal, Node> TpetraCrsGraphClass;
361  // XPETRA_RCP_DYNAMIC_CAST(const TpetraCrsGraphClass, graph, tGraph, "toTpetra");
362  if (graph.is_null()) {
363  return Teuchos::null;
364  }
365  RCP<Tpetra::CrsGraph<LocalOrdinal, GlobalOrdinal, Node> > tGraph =
366  Teuchos::rcp_const_cast<Tpetra::CrsGraph<LocalOrdinal, GlobalOrdinal, Node> >(graph);
368 }
369 
370 template <class LocalOrdinal, class GlobalOrdinal, class Node>
371 RCP<const Tpetra::CrsGraph<LocalOrdinal, GlobalOrdinal, Node> >
373  typedef TpetraCrsGraph<LocalOrdinal, GlobalOrdinal, Node> TpetraCrsGraphClass;
374  XPETRA_RCP_DYNAMIC_CAST(const TpetraCrsGraphClass, graph, tpetraCrsGraph, "toTpetra");
375  return tpetraCrsGraph->getTpetra_CrsGraph();
376 }
377 
378 } // namespace Xpetra
379 
380 #endif // XPETRA_TPETRACRSGRAPH_DECL_HPP
void insertLocalIndices(const LocalOrdinal localRow, const ArrayView< const LocalOrdinal > &indices)
Insert local indices into the graph.
TpetraExport< LocalOrdinal, GlobalOrdinal, Node > TpetraExportClass
bool isGloballyIndexed() const
Whether column indices are stored using global indices on the calling process.
TpetraImport< LocalOrdinal, GlobalOrdinal, Node > TpetraImportClass
void doExport(const DistObject< GlobalOrdinal, LocalOrdinal, GlobalOrdinal, Node > &dest, const Import &importer, CombineMode CM)
Export.
Kokkos::StaticCrsGraph< LocalOrdinal, Kokkos::LayoutLeft, device_type, void, size_t > local_graph_type
size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const
Returns the current number of entries on this node in the specified global row.
local_graph_type::HostMirror getLocalGraphHost() const
Access the local KokkosSparse::StaticCrsGraph data for host use.
RCP< const Map > getDomainMap() const
Returns the Map associated with the domain of this graph.
RCP< Tpetra::CrsGraph< LocalOrdinal, GlobalOrdinal, Node > > graph_
void expertStaticFillComplete(const Teuchos::RCP< const map_type > &domainMap, const Teuchos::RCP< const map_type > &rangeMap, const Teuchos::RCP< const Import > &importer=Teuchos::null, const Teuchos::RCP< const Export > &exporter=Teuchos::null, const Teuchos::RCP< Teuchos::ParameterList > &params=Teuchos::null)
Expert version of fillComplete.
RCP< const Map > getColMap() const
Returns the Map that describes the column distribution in this graph.
void computeGlobalConstants()
Force the computation of global constants if we don&#39;t have them.
size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const
Returns the current number of entries on this node in the specified local row.
RCP< const Tpetra::CrsGraph< LocalOrdinal, GlobalOrdinal, Node > > getTpetra_CrsGraph() const
Get the underlying Tpetra graph.
TpetraCrsGraph< LocalOrdinal, GlobalOrdinal, Node > TpetraCrsGraphClass
GlobalOrdinal getIndexBase() const
Returns the index base for global indices for this graph.
RCP< const Import > getImporter() const
Returns the importer associated with this graph.
void insertGlobalIndices(GlobalOrdinal globalRow, const ArrayView< const GlobalOrdinal > &indices)
Insert global indices into the graph.
bool isStorageOptimized() const
Returns true if storage has been optimized.
size_t getNumAllocatedEntriesInLocalRow(LocalOrdinal localRow) const
Returns the current number of allocated entries on this node in the specified local row...
RCP< const Comm< int > > getComm() const
Returns the communicator.
TpetraCrsGraph(const RCP< const Map > &rowMap, size_t maxNumEntriesPerRow, const RCP< ParameterList > &params=null)
Constructor specifying fixed number of entries for each row.
RCP< const Export > getExporter() const
Returns the exporter associated with this graph.
bool isFillComplete() const
Whether fillComplete() has been called and the graph is in compute mode.
void getLocalRowView(LocalOrdinal LocalRow, ArrayView< const LocalOrdinal > &indices) const
Return a const, nonpersisting view of local indices in the given row.
global_size_t getGlobalNumRows() const
Returns the number of global rows in the graph.
void doImport(const DistObject< GlobalOrdinal, LocalOrdinal, GlobalOrdinal, Node > &source, const Import &importer, CombineMode CM)
Import.
size_t getNumAllocatedEntriesInGlobalRow(GlobalOrdinal globalRow) const
Returns the current number of allocated entries for this node in the specified global row ...
RCP< const Tpetra::CrsGraph< LocalOrdinal, GlobalOrdinal, Node > > toTpetra(const RCP< const CrsGraph< LocalOrdinal, GlobalOrdinal, Node > > &graph)
Teuchos::RCP< const Map > getMap() const
Implements DistObject interface.
void allocateAllIndices(size_t numNonZeros, ArrayRCP< size_t > &rowptr, ArrayRCP< LocalOrdinal > &colind)
Allocates the 1D pointer arrays of the graph.
void getAllIndices(ArrayRCP< const size_t > &rowptr, ArrayRCP< const LocalOrdinal > &colind) const
Gets the 1D pointer arrays of the graph.
local_graph_type getLocalGraphDevice() const
Access the local KokkosSparse::StaticCrsGraph data for device use.
size_t getLocalNumEntries() const
Returns the local number of entries in the graph.
virtual ~TpetraCrsGraph()
Destructor.
size_t global_size_t
Global size_t object.
void getGlobalRowView(GlobalOrdinal GlobalRow, ArrayView< const GlobalOrdinal > &Indices) const
Return a const, nonpersisting view of global indices in the given row.
global_size_t getGlobalNumEntries() const
Returns the global number of entries in the graph.
#define XPETRA_RCP_DYNAMIC_CAST(type, obj, newObj, exceptionMsg)
size_t getGlobalMaxNumRowEntries() const
Maximum number of entries in all rows over all processes.
size_t getLocalMaxNumRowEntries() const
Maximum number of entries in all rows owned by the calling process.
void getLocalDiagOffsets(const Kokkos::View< size_t *, typename Node::device_type, Kokkos::MemoryUnmanaged > &offsets) const
Get offsets of the diagonal entries in the matrix.
bool hasColMap() const
Whether the graph has a column Map.
bool isLocallyIndexed() const
Whether column indices are stored using local indices on the calling process.
void fillComplete(const RCP< const Map > &domainMap, const RCP< const Map > &rangeMap, const RCP< ParameterList > &params=null)
Signal that data entry is complete, specifying domain and range maps.
global_size_t getGlobalNumCols() const
Returns the number of global columns in the graph.
Xpetra::CrsGraph< LocalOrdinal, GlobalOrdinal, Node >::local_graph_type local_graph_type
void removeLocalIndices(LocalOrdinal localRow)
Remove all graph indices from the specified local row.
CombineMode
Xpetra::Combine Mode enumerable type.
std::string description() const
Return a simple one-line description of this object.
void describe(Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel=Teuchos::Describable::verbLevel_default) const
Print the object with some verbosity level to an FancyOStream object.
void setAllIndices(const ArrayRCP< size_t > &rowptr, const ArrayRCP< LocalOrdinal > &colind)
Sets the 1D pointer arrays of the graph.
RCP< const Map > getRowMap() const
Returns the Map that describes the row distribution in this graph.
RCP< const Map > getRangeMap() const
Returns the Map associated with the domain of this graph.
size_t getLocalNumCols() const
Returns the number of columns connected to the locally owned rows of this graph.
ArrayRCP< const size_t > getNodeRowPtrs() const
Get an ArrayRCP of the row-offsets.
RCP< const CrsGraph< int, GlobalOrdinal, Node > > toXpetra(const Epetra_CrsGraph &g)
size_t getLocalNumRows() const
Returns the number of graph rows owned on the calling node.