42 #ifndef TPETRA_IMPORT_DECL_HPP
43 #define TPETRA_IMPORT_DECL_HPP
45 #include "Tpetra_Details_Transfer.hpp"
106 template<
class LocalOrdinal,
113 friend class Export<LocalOrdinal,GlobalOrdinal,Node>;
130 Import (
const Teuchos::RCP<const map_type>& source,
131 const Teuchos::RCP<const map_type>& target);
143 Import (
const Teuchos::RCP<const map_type>& source,
144 const Teuchos::RCP<const map_type>& target,
145 const Teuchos::RCP<Teuchos::FancyOStream>& out);
159 Import (
const Teuchos::RCP<const map_type>& source,
160 const Teuchos::RCP<const map_type>& target,
161 const Teuchos::RCP<Teuchos::ParameterList>& plist);
178 Import (
const Teuchos::RCP<const map_type>& source,
179 const Teuchos::RCP<const map_type>& target,
180 const Teuchos::RCP<Teuchos::FancyOStream>& out,
181 const Teuchos::RCP<Teuchos::ParameterList>& plist);
194 Import (
const Teuchos::RCP<const map_type>& source,
195 const Teuchos::RCP<const map_type>& target,
196 Teuchos::Array<int> & remotePIDs,
197 const Teuchos::RCP<Teuchos::ParameterList>& plist = Teuchos::rcp(
new Teuchos::ParameterList) );
244 const GlobalOrdinal targetMapRemoteOrPermuteGlobalIndices[],
245 const int targetMapRemoteOrPermuteProcessRanks[],
246 const LocalOrdinal numTargetMapRemoteOrPermuteGlobalIndices,
247 const bool mayReorderTargetMapIndicesLocally,
248 const Teuchos::RCP<Teuchos::ParameterList>& plist = Teuchos::null,
249 const Teuchos::RCP<Teuchos::FancyOStream>& out = Teuchos::null);
254 const Teuchos::ArrayView<int> & remotePIDs,
255 const Teuchos::ArrayView<const LocalOrdinal> & userExportLIDs,
256 const Teuchos::ArrayView<const int> & userExportPIDs,
257 const Teuchos::RCP<Teuchos::ParameterList>& plist = Teuchos::null,
258 const Teuchos::RCP<Teuchos::FancyOStream>& out = Teuchos::null);
281 Teuchos::Array<std::pair<int,GlobalOrdinal>>& remotePGIDs,
282 typename Teuchos::Array<GlobalOrdinal>::size_type& numSameGIDs,
283 typename Teuchos::Array<GlobalOrdinal>::size_type& numPermuteGIDs,
284 typename Teuchos::Array<GlobalOrdinal>::size_type& numRemoteGIDs,
285 const Teuchos::ArrayView<const GlobalOrdinal>& sameGIDs1,
286 const Teuchos::ArrayView<const GlobalOrdinal>& sameGIDs2,
287 Teuchos::Array<GlobalOrdinal>& permuteGIDs1,
288 Teuchos::Array<GlobalOrdinal>& permuteGIDs2,
289 Teuchos::Array<GlobalOrdinal>& remoteGIDs1,
290 Teuchos::Array<GlobalOrdinal>& remoteGIDs2,
291 Teuchos::Array<int>& remotePIDs1,
292 Teuchos::Array<int>& remotePIDs2)
const;
327 Teuchos::RCP<const Import<LocalOrdinal, GlobalOrdinal, Node> >
346 Teuchos::RCP<const Import<LocalOrdinal, GlobalOrdinal, Node> >
353 Teuchos::RCP<const Import<LocalOrdinal, GlobalOrdinal, Node> >
383 describe (Teuchos::FancyOStream& out,
384 const Teuchos::EVerbosityLevel verbLevel =
385 Teuchos::Describable::verbLevel_default)
const;
402 virtual void print (std::ostream& os)
const;
426 init (
const Teuchos::RCP<const map_type>& source,
427 const Teuchos::RCP<const map_type>& target,
429 Teuchos::Array<int> & remotePIDs,
430 const Teuchos::RCP<Teuchos::ParameterList>& plist);
463 void setupSamePermuteRemote (Teuchos::Array<GlobalOrdinal>& remoteGIDs);
494 setupExport (Teuchos::Array<GlobalOrdinal>& remoteGIDs,
495 bool useRemotePIDs, Teuchos::Array<int> & remotePIDs,
496 const Teuchos::RCP<Teuchos::ParameterList>& plist= Teuchos::null);
506 Import (
const Teuchos::RCP<const map_type>& source,
507 const Teuchos::RCP<const map_type>& target,
508 const size_t numSameID,
509 Teuchos::Array<LocalOrdinal>& permuteToLIDs,
510 Teuchos::Array<LocalOrdinal>& permuteFromLIDs,
511 Teuchos::Array<LocalOrdinal>& remoteLIDs,
512 Teuchos::Array<LocalOrdinal>& exportLIDs,
513 Teuchos::Array<int>& exportPIDs,
515 const Teuchos::RCP<Teuchos::FancyOStream>& out = Teuchos::null,
516 const Teuchos::RCP<Teuchos::ParameterList>& plist = Teuchos::null);
530 template<
class LocalOrdinal,
class GlobalOrdinal,
class Node>
531 Teuchos::RCP<const Import<LocalOrdinal, GlobalOrdinal, Node> >
536 return Teuchos::null;
538 #ifdef HAVE_TPETRA_DEBUG
539 TEUCHOS_TEST_FOR_EXCEPTION(
540 src == Teuchos::null || tgt == Teuchos::null, std::runtime_error,
541 "Tpetra::createImport: Neither source nor target Map may be null.");
542 #endif // HAVE_TPETRA_DEBUG
544 return Teuchos::rcp (
new import_type (src, tgt));
557 template<
class LocalOrdinal,
class GlobalOrdinal,
class Node>
558 Teuchos::RCP<const Import<LocalOrdinal, GlobalOrdinal, Node> >
561 const Teuchos::RCP<Teuchos::ParameterList>& plist)
564 return Teuchos::null;
566 #ifdef HAVE_TPETRA_DEBUG
567 TEUCHOS_TEST_FOR_EXCEPTION(
568 src == Teuchos::null || tgt == Teuchos::null, std::runtime_error,
569 "Tpetra::createImport(): neither source nor target map may be null:"
570 << std::endl <<
"source: " << src << std::endl <<
"target: " << tgt
572 #endif // HAVE_TPETRA_DEBUG
574 return Teuchos::rcp (
new import_type (src, tgt, plist));
579 #endif // TPETRA_IMPORT_DECL_HPP
Communication plan for data redistribution from a uniquely-owned to a (possibly) multiply-owned distr...
Common base class of Import and Export.
Import< LocalOrdinal, GlobalOrdinal, Node > & operator=(const Import< LocalOrdinal, GlobalOrdinal, Node > &Source)=default
Assignment operator.
Teuchos::RCP< const Import< LocalOrdinal, GlobalOrdinal, Node > > createRemoteOnlyImport(const Teuchos::RCP< const map_type > &remoteTarget) const
Returns an importer that contains only the remote entries of this.
virtual void describe(Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel=Teuchos::Describable::verbLevel_default) const
Describe this object in a human-readable way to the given output stream.
Teuchos::RCP< const Import< LocalOrdinal, GlobalOrdinal, Node > > setUnion() const
Return the union of this Import this->getSourceMap()
Forward declaration of Tpetra::Export.
Import(const Teuchos::RCP< const map_type > &source, const Teuchos::RCP< const map_type > &target)
Construct an Import from the source and target Maps.
Forward declaration of Tpetra::Import.
Communication plan for data redistribution from a (possibly) multiply-owned to a uniquely-owned distr...
Sets up and executes a communication plan for a Tpetra DistObject.
virtual ~Import()=default
Destructor.
Teuchos::RCP< const Import< LocalOrdinal, GlobalOrdinal, Node > > createImport(const Teuchos::RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > &src, const Teuchos::RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > &tgt)
Nonmember constructor for Import.
void findUnionTargetGIDs(Teuchos::Array< GlobalOrdinal > &unionTgtGIDs, Teuchos::Array< std::pair< int, GlobalOrdinal >> &remotePGIDs, typename Teuchos::Array< GlobalOrdinal >::size_type &numSameGIDs, typename Teuchos::Array< GlobalOrdinal >::size_type &numPermuteGIDs, typename Teuchos::Array< GlobalOrdinal >::size_type &numRemoteGIDs, const Teuchos::ArrayView< const GlobalOrdinal > &sameGIDs1, const Teuchos::ArrayView< const GlobalOrdinal > &sameGIDs2, Teuchos::Array< GlobalOrdinal > &permuteGIDs1, Teuchos::Array< GlobalOrdinal > &permuteGIDs2, Teuchos::Array< GlobalOrdinal > &remoteGIDs1, Teuchos::Array< GlobalOrdinal > &remoteGIDs2, Teuchos::Array< int > &remotePIDs1, Teuchos::Array< int > &remotePIDs2) const
Find the union of the target IDs from two Import objects.
A parallel distribution of indices over processes.
virtual void print(std::ostream &os) const
Print the Import's data to the given output stream.