Tpetra parallel linear algebra Version of the Day
Loading...
Searching...
No Matches
Tpetra_FECrsGraph_decl.hpp
Go to the documentation of this file.
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_FECRSGRAPH_DECL_HPP
11#define TPETRA_FECRSGRAPH_DECL_HPP
12
15
16#include "Tpetra_ConfigDefs.hpp"
17#include "Tpetra_FECrsGraph_fwd.hpp"
18#include "Tpetra_CrsGraph_decl.hpp"
19
20namespace Tpetra {
88
89 template <class LocalOrdinal,
90 class GlobalOrdinal,
91 class Node>
92 class FECrsGraph :
93 public CrsGraph<LocalOrdinal, GlobalOrdinal, Node>
94 {
96 typedef DistObject<GlobalOrdinal, LocalOrdinal, GlobalOrdinal, Node> dist_object_type;
97
98 template <class S, class LO, class GO, class N>
99 friend class FECrsMatrix;
100 public:
102 typedef CrsGraph<LocalOrdinal, GlobalOrdinal, Node> crs_graph_type;
103
105 typedef LocalOrdinal local_ordinal_type;
107 typedef GlobalOrdinal global_ordinal_type;
109 typedef Node node_type;
110
112 typedef typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::device_type device_type;
114 typedef typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::execution_space execution_space;
115
117 typedef typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::local_graph_device_type local_graph_device_type;
118
120 using map_type = ::Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node>;
122 using import_type = ::Tpetra::Import<LocalOrdinal, GlobalOrdinal, Node>;
124 using export_type = ::Tpetra::Export<LocalOrdinal, GlobalOrdinal, Node>;
125
127
128
152 FECrsGraph(const Teuchos::RCP<const map_type> & ownedRowMap,
153 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
154 const size_t maxNumEntriesPerRow,
155 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
156 const Teuchos::RCP<const map_type> & domainMap = Teuchos::null,
157 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
158 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
159
186 FECrsGraph (const Teuchos::RCP<const map_type> & ownedRowMap,
187 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
188 const size_t maxNumEntriesPerRow,
189 const Teuchos::RCP<const map_type> & ownedPlusSharedDomainMap,
190 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
191 const Teuchos::RCP<const map_type> & ownedDomainMap = Teuchos::null,
192 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
193 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
194
218 FECrsGraph (const Teuchos::RCP<const map_type> & ownedRowMap,
219 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
220 const Kokkos::DualView<const size_t*, device_type>& numEntPerRow,
221 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
222 const Teuchos::RCP<const map_type> & domainMap = Teuchos::null,
223 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
224 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
225
252 FECrsGraph (const Teuchos::RCP<const map_type> & ownedRowMap,
253 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
254 const Kokkos::DualView<const size_t*, device_type>& numEntPerRow,
255 const Teuchos::RCP<const map_type> & ownedPlusSharedDomainMap,
256 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
257 const Teuchos::RCP<const map_type> & ownedDomainMap = Teuchos::null,
258 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
259 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
260
261
287 FECrsGraph(const Teuchos::RCP<const map_type> & ownedRowMap,
288 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
289 const Teuchos::RCP<const map_type> & ownedPlusSharedColMap,
290 const size_t maxNumEntriesPerRow,
291 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
292 const Teuchos::RCP<const map_type> & domainMap = Teuchos::null,
293 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
294 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
295
323 FECrsGraph(const Teuchos::RCP<const map_type> & ownedRowMap,
324 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
325 const Teuchos::RCP<const map_type> & ownedPlusSharedColMap,
326 const size_t maxNumEntriesPerRow,
327 const Teuchos::RCP<const map_type> & ownedPlusSharedDomainMap,
328 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
329 const Teuchos::RCP<const map_type> & ownedDomainMap = Teuchos::null,
330 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
331 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
332
333
357 FECrsGraph (const Teuchos::RCP<const map_type> & ownedRowMap,
358 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
359 const Teuchos::RCP<const map_type> & ownedPlusSharedColMap,
360 const Kokkos::DualView<const size_t*, device_type>& numEntPerRow,
361 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
362 const Teuchos::RCP<const map_type> & domainMap = Teuchos::null,
363 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
364 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
365
390 FECrsGraph (const Teuchos::RCP<const map_type> & ownedRowMap,
391 const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,
392 const Teuchos::RCP<const map_type> & ownedPlusSharedColMap,
393 const Kokkos::DualView<const size_t*, device_type>& numEntPerRow,
394 const Teuchos::RCP<const map_type> & ownedPlusSharedDomainMap,
395 const Teuchos::RCP<const import_type> & ownedPlusSharedToOwnedimporter = Teuchos::null,
396 const Teuchos::RCP<const map_type> & ownedDomainMap = Teuchos::null,
397 const Teuchos::RCP<const map_type> & ownedRangeMap = Teuchos::null,
398 const Teuchos::RCP<Teuchos::ParameterList>& params = Teuchos::null);
399
401 FECrsGraph (const FECrsGraph<LocalOrdinal, GlobalOrdinal, Node>&) = delete;
402
404 FECrsGraph (FECrsGraph<LocalOrdinal, GlobalOrdinal, Node>&&) = delete;
405
407 FECrsGraph&
408 operator= (const FECrsGraph<LocalOrdinal, GlobalOrdinal, Node>&) = delete;
409
411 FECrsGraph&
412 operator= (FECrsGraph<LocalOrdinal, GlobalOrdinal, Node>&&) = delete;
413
423 virtual ~FECrsGraph () = default;
424
426
428
429 Teuchos::RCP<const Teuchos::ParameterList>
430 getValidParameters () const override;
431
433
435
437 void endAssembly();
438 void endAssembly(const Teuchos::RCP<const map_type>& domainMap, const Teuchos::RCP<const map_type>& rangeMap);
439
441 void beginAssembly();
442
480 void
481 fillComplete (const Teuchos::RCP<const map_type>& ownedDomainMap,
482 const Teuchos::RCP<const map_type>& ownedRangeMap,
483 const Teuchos::RCP<Teuchos::ParameterList>& /* params */ = Teuchos::null) {
484 ownedDomainMap_ = ownedDomainMap;
485 ownedRangeMap_ = ownedRangeMap;
486 endFill();
487 }
488
516 void
517 fillComplete (const Teuchos::RCP<Teuchos::ParameterList>& /* params */ = Teuchos::null) {endFill();}
518
519
520 private:
521
523 void endFill();
524 void endFill(const Teuchos::RCP<const map_type>& domainMap, const Teuchos::RCP<const map_type>& rangeMap);
525
527 void beginFill();
528
532 void doOwnedPlusSharedToOwned(const CombineMode CM=Tpetra::ADD);
533
536 void doOwnedToOwnedPlusShared(const CombineMode CM=Tpetra::ADD);
537
538 public:
540 void switchActiveCrsGraph();
542
543 private:
544
545 // Common core guts of the constructor (the colMap argument is Teuchos::null if we're globally-indexed)
546 void setup(const Teuchos::RCP<const map_type> & ownedRowMap, const Teuchos::RCP<const map_type> & ownedPlusSharedRowMap,const Teuchos::RCP<const map_type> & ownedPlusSharedColMap, const Teuchos::RCP<Teuchos::ParameterList>& params);
547
548 // Template to avoid long type names...lazy.
549 // template<typename ViewType>
550 // Teuchos::RCP<const map_type> makeOwnedColMap (ViewType ownedGraphIndices);
551
552 Teuchos::RCP<FE::FillState> fillState_;
553
554 // This is whichever graph isn't currently active
555 Teuchos::RCP<CrsGraph<LocalOrdinal, GlobalOrdinal, Node> > inactiveCrsGraph_;
556
557 // This is in RCP to make shallow copies of the FECrsGraph work correctly
558 Teuchos::RCP<FE::WhichActive> activeCrsGraph_;
559
560 // The importer between the rowmaps of the two graphs
561 Teuchos::RCP<const import_type> ownedRowsImporter_;
562
563 // The domainMap to use in endFill() for the owned graph
564 Teuchos::RCP<const map_type> ownedDomainMap_;
565
566 // The rangeMap to use in endFill() for the owned graph
567 Teuchos::RCP<const map_type> ownedRangeMap_;
568
569 protected:
579 size_t
580 insertGlobalIndicesImpl (const local_ordinal_type lclRow,
581 const global_ordinal_type inputGblColInds[],
582 const size_t numInputInds);
583
593 size_t
594 insertGlobalIndicesImpl (const RowInfo& rowInfo,
595 const global_ordinal_type inputGblColInds[],
596 const size_t numInputInds,
597 std::function<void(const size_t, const size_t, const size_t)> fun =
598 std::function<void(const size_t, const size_t, const size_t)>());
599
600 void
601 insertLocalIndicesImpl (const local_ordinal_type lclRow,
602 const Teuchos::ArrayView<const local_ordinal_type>& gblColInds,
603 std::function<void(const size_t, const size_t, const size_t)> fun =
604 std::function<void(const size_t, const size_t, const size_t)>());
605
606 }; // class FECrsGraph
607
608
609} // namespace Tpetra
610
611#endif // TPETRA_FECRSGRAPH_DECL_HPP
Tpetra_CrsGraph_decl.hpp
Declaration of the Tpetra::CrsGraph class.
Tpetra_FECrsGraph_fwd.hpp
Forward declaration of Tpetra::FECrsGraph.
Tpetra::CrsGraph
A distributed graph accessed by rows (adjacency lists) and stored sparsely.
Definition Tpetra_CrsGraph_decl.hpp:196
Tpetra::CrsGraph::device_type
typename Node::device_type device_type
This class' Kokkos device type.
Definition Tpetra_CrsGraph_decl.hpp:213
Tpetra::CrsGraph::execution_space
typename device_type::execution_space execution_space
This class' Kokkos execution space.
Definition Tpetra_CrsGraph_decl.hpp:215
Tpetra::CrsGraph::local_graph_device_type
Kokkos::StaticCrsGraph< local_ordinal_type, Kokkos::LayoutLeft, device_type, void, size_t > local_graph_device_type
The type of the part of the sparse graph on each MPI process.
Definition Tpetra_CrsGraph_decl.hpp:226
Tpetra::CrsMatrixStruct
Struct that holds views of the contents of a CrsMatrix.
Definition TpetraExt_MMHelpers_decl.hpp:36
Tpetra::Export
Communication plan for data redistribution from a (possibly) multiply-owned to a uniquely-owned distr...
Definition Tpetra_Export_decl.hpp:87
Tpetra::FECrsGraph
A distributed graph accessed by rows (adjacency lists) and stored sparsely.
Definition Tpetra_FECrsGraph_decl.hpp:94
Tpetra::FECrsGraph::device_type
CrsGraph< LocalOrdinal, GlobalOrdinal, Node >::device_type device_type
The Kokkos device type.
Definition Tpetra_FECrsGraph_decl.hpp:112
Tpetra::FECrsGraph::endAssembly
void endAssembly()
Migrates data to the owned mode.
Definition Tpetra_FECrsGraph_def.hpp:385
Tpetra::FECrsGraph::crs_graph_type
CrsGraph< LocalOrdinal, GlobalOrdinal, Node > crs_graph_type
Parent class.
Definition Tpetra_FECrsGraph_decl.hpp:102
Tpetra::FECrsGraph::getValidParameters
Teuchos::RCP< const Teuchos::ParameterList > getValidParameters() const override
Default parameter list suitable for validation.
Definition Tpetra_FECrsGraph_def.hpp:413
Tpetra::FECrsGraph::FECrsGraph
FECrsGraph(const FECrsGraph< LocalOrdinal, GlobalOrdinal, Node > &)=delete
Copy constructor (forbidden).
Tpetra::FECrsGraph::beginAssembly
void beginAssembly()
Activates the owned+shared mode for assembly.
Definition Tpetra_FECrsGraph_def.hpp:373
Tpetra::FECrsGraph::operator=
FECrsGraph & operator=(const FECrsGraph< LocalOrdinal, GlobalOrdinal, Node > &)=delete
Copy assignment (forbidden).
Tpetra::FECrsGraph::switchActiveCrsGraph
void switchActiveCrsGraph()
Switches which CrsGraph is active (without migrating data)
Definition Tpetra_FECrsGraph_def.hpp:298
Tpetra::FECrsGraph::fillComplete
void fillComplete(const Teuchos::RCP< Teuchos::ParameterList > &=Teuchos::null)
Tell the graph that you are done changing its structure; set default domain and range Maps.
Definition Tpetra_FECrsGraph_decl.hpp:517
Tpetra::FECrsGraph::local_ordinal_type
LocalOrdinal local_ordinal_type
This class' first template parameter; the type of local indices.
Definition Tpetra_FECrsGraph_decl.hpp:105
Tpetra::FECrsGraph::insertGlobalIndicesImpl
size_t insertGlobalIndicesImpl(const local_ordinal_type lclRow, const global_ordinal_type inputGblColInds[], const size_t numInputInds)
Insert global indices, using an input local row index.
Definition Tpetra_FECrsGraph_def.hpp:424
Tpetra::FECrsGraph::local_graph_device_type
CrsGraph< LocalOrdinal, GlobalOrdinal, Node >::local_graph_device_type local_graph_device_type
The type of the part of the sparse graph on each MPI process.
Definition Tpetra_FECrsGraph_decl.hpp:117
Tpetra::FECrsGraph::FECrsGraph
FECrsGraph(FECrsGraph< LocalOrdinal, GlobalOrdinal, Node > &&)=delete
Move constructor (forbidden).
Tpetra::FECrsGraph::fillComplete
void fillComplete(const Teuchos::RCP< const map_type > &ownedDomainMap, const Teuchos::RCP< const map_type > &ownedRangeMap, const Teuchos::RCP< Teuchos::ParameterList > &=Teuchos::null)
Tell the graph that you are done changing its structure.
Definition Tpetra_FECrsGraph_decl.hpp:481
Tpetra::FECrsGraph::~FECrsGraph
virtual ~FECrsGraph()=default
Destructor (virtual for memory safety of derived classes).
Tpetra::FECrsGraph::node_type
Node node_type
This class' Kokkos Node type.
Definition Tpetra_FECrsGraph_decl.hpp:109
Tpetra::FECrsGraph::execution_space
CrsGraph< LocalOrdinal, GlobalOrdinal, Node >::execution_space execution_space
The Kokkos execution space.
Definition Tpetra_FECrsGraph_decl.hpp:114
Tpetra::FECrsGraph::global_ordinal_type
GlobalOrdinal global_ordinal_type
This class' second template parameter; the type of global indices.
Definition Tpetra_FECrsGraph_decl.hpp:107
Tpetra::FECrsMatrix
Sparse matrix that presents a row-oriented interface that lets users read or modify entries.
Definition Tpetra_FECrsMatrix_decl.hpp:34
Tpetra::Import
Communication plan for data redistribution from a uniquely-owned to a (possibly) multiply-owned distr...
Definition Tpetra_Import_decl.hpp:79
Tpetra::Map
A parallel distribution of indices over processes.
Definition Tpetra_Map_decl.hpp:198
Tpetra
Namespace Tpetra contains the class and methods constituting the Tpetra library.
Tpetra::CombineMode
CombineMode
Rule for combining data in an Import or Export.
Definition Tpetra_CombineMode.hpp:65
Tpetra::ADD
@ ADD
Sum new values.
Definition Tpetra_CombineMode.hpp:66
Tpetra::RowInfo
Allocation information for a locally owned row in a CrsGraph or CrsMatrix.
Definition Tpetra_CrsGraph_decl.hpp:77
Generated on Sat Nov 8 2025 09:00:37 for Tpetra parallel linear algebra by doxygen 1.9.8