Peano
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Static Public Member Functions | Private Attributes | Static Private Attributes
peano4::parallel::TreeEntry Struct Reference

#include <TreeEntry.h>

Public Types

enum  ObjectConstruction { NoData }
 

Public Member Functions

 TreeEntry ()
 
 TreeEntry (int __id, int __master)
 
int getId () const
 
void setId (int value)
 
int getMaster () const
 
void setMaster (int value)
 
 TreeEntry (const TreeEntry &copy)=default
 
int getSenderRank () const
 
 TreeEntry (ObjectConstruction)
 
std::string toString () const
 

Static Public Member Functions

static MPI_Datatype getForkDatatype ()
 Hands out MPI datatype if we work without the LLVM MPI extension.
 
static MPI_Datatype getJoinDatatype ()
 
static MPI_Datatype getBoundaryExchangeDatatype ()
 
static MPI_Datatype getMultiscaleDataExchangeDatatype ()
 
static MPI_Datatype getGlobalCommunciationDatatype ()
 
static void freeForkDatatype ()
 
static void freeJoinDatatype ()
 
static void freeBoundaryExchangeDatatype ()
 
static void freeMultiscaleDataExchangeDatatype ()
 
static void freeGlobalCommunciationDatatype ()
 
static void initDatatype ()
 Wrapper around getDatatype() to trigger lazy evaluation if we use the lazy initialisation.
 
static void shutdownDatatype ()
 Free the underlying MPI datatype.
 
static void send (const peano4::parallel::TreeEntry &buffer, int destination, int tag, MPI_Comm communicator)
 In DaStGen (the first version), I had a non-static version of the send as well as the receive.
 
static void receive (peano4::parallel::TreeEntry &buffer, int source, int tag, MPI_Comm communicator)
 
static void send (const peano4::parallel::TreeEntry &buffer, int destination, int tag, std::function< void()> startCommunicationFunctor, std::function< void()> waitFunctor, MPI_Comm communicator)
 Alternative to the other send() where I trigger a non-blocking send an then invoke the functor until the corresponding MPI_Test tells me that the message went through.
 
static void receive (peano4::parallel::TreeEntry &buffer, int source, int tag, std::function< void()> startCommunicationFunctor, std::function< void()> waitFunctor, MPI_Comm communicator)
 
static void sendAndPollDanglingMessages (const peano4::parallel::TreeEntry &message, int destination, int tag, MPI_Comm communicator=tarch::mpi::Rank::getInstance().getCommunicator())
 
static void receiveAndPollDanglingMessages (peano4::parallel::TreeEntry &message, int source, int tag, MPI_Comm communicator=tarch::mpi::Rank::getInstance().getCommunicator())
 

Private Attributes

int _id
 
int _master
 
int _senderDestinationRank
 

Static Private Attributes

static MPI_Datatype Datatype
 Whenever we use LLVM's MPI extension (DaStGe), we rely on lazy initialisation of the datatype.
 

Detailed Description

Definition at line 27 of file TreeEntry.h.

Member Enumeration Documentation

◆ ObjectConstruction

enum peano4::parallel::TreeEntry::ObjectConstruction
Enumerator
NoData 

Definition at line 114 of file TreeEntry.h.

Constructor & Destructor Documentation

◆ TreeEntry() [1/4]

peano4::parallel::TreeEntry::TreeEntry ( )

Definition at line 29 of file TreeEntry.h.

◆ TreeEntry() [2/4]

peano4::parallel::TreeEntry::TreeEntry ( int __id,
int __master )

◆ TreeEntry() [3/4]

peano4::parallel::TreeEntry::TreeEntry ( const TreeEntry & copy)
default

◆ TreeEntry() [4/4]

peano4::parallel::TreeEntry::TreeEntry ( ObjectConstruction )

Definition at line 118 of file TreeEntry.h.

Member Function Documentation

◆ freeBoundaryExchangeDatatype()

static void peano4::parallel::TreeEntry::freeBoundaryExchangeDatatype ( )
static

◆ freeForkDatatype()

static void peano4::parallel::TreeEntry::freeForkDatatype ( )
static

◆ freeGlobalCommunciationDatatype()

static void peano4::parallel::TreeEntry::freeGlobalCommunciationDatatype ( )
static

◆ freeJoinDatatype()

static void peano4::parallel::TreeEntry::freeJoinDatatype ( )
static

◆ freeMultiscaleDataExchangeDatatype()

static void peano4::parallel::TreeEntry::freeMultiscaleDataExchangeDatatype ( )
static

◆ getBoundaryExchangeDatatype()

static MPI_Datatype peano4::parallel::TreeEntry::getBoundaryExchangeDatatype ( )
static

◆ getForkDatatype()

static MPI_Datatype peano4::parallel::TreeEntry::getForkDatatype ( )
static

Hands out MPI datatype if we work without the LLVM MPI extension.

If we work with this additional feature, this is the routine where the lazy initialisation is done and the datatype is also cached.

◆ getGlobalCommunciationDatatype()

static MPI_Datatype peano4::parallel::TreeEntry::getGlobalCommunciationDatatype ( )
static

◆ getId()

int peano4::parallel::TreeEntry::getId ( ) const

◆ getJoinDatatype()

static MPI_Datatype peano4::parallel::TreeEntry::getJoinDatatype ( )
static

◆ getMaster()

int peano4::parallel::TreeEntry::getMaster ( ) const

◆ getMultiscaleDataExchangeDatatype()

static MPI_Datatype peano4::parallel::TreeEntry::getMultiscaleDataExchangeDatatype ( )
static

◆ getSenderRank()

int peano4::parallel::TreeEntry::getSenderRank ( ) const
Returns
The rank of the sender of an object. It only make ssense to call this routine after you've invoked receive with MPI_ANY_SOURCE.

◆ initDatatype()

static void peano4::parallel::TreeEntry::initDatatype ( )
static

Wrapper around getDatatype() to trigger lazy evaluation if we use the lazy initialisation.

◆ receive() [1/2]

static void peano4::parallel::TreeEntry::receive ( peano4::parallel::TreeEntry & buffer,
int source,
int tag,
MPI_Comm communicator )
static

◆ receive() [2/2]

static void peano4::parallel::TreeEntry::receive ( peano4::parallel::TreeEntry & buffer,
int source,
int tag,
std::function< void()> startCommunicationFunctor,
std::function< void()> waitFunctor,
MPI_Comm communicator )
static

◆ receiveAndPollDanglingMessages()

static void peano4::parallel::TreeEntry::receiveAndPollDanglingMessages ( peano4::parallel::TreeEntry & message,
int source,
int tag,
MPI_Comm communicator = tarch::mpi::Rank::getInstance().getCommunicator() )
static

◆ send() [1/2]

static void peano4::parallel::TreeEntry::send ( const peano4::parallel::TreeEntry & buffer,
int destination,
int tag,
MPI_Comm communicator )
static

In DaStGen (the first version), I had a non-static version of the send as well as the receive.

However, this did not work with newer C++11 versions, as a member function using this as pointer usually doesn't see the vtable while the init sees the object from outside, i.e. including a vtable. So this routine now is basically an alias for a blocking MPI_Send.

◆ send() [2/2]

static void peano4::parallel::TreeEntry::send ( const peano4::parallel::TreeEntry & buffer,
int destination,
int tag,
std::function< void()> startCommunicationFunctor,
std::function< void()> waitFunctor,
MPI_Comm communicator )
static

Alternative to the other send() where I trigger a non-blocking send an then invoke the functor until the corresponding MPI_Test tells me that the message went through.

In systems with heavy MPI usage, this can help to avoid deadlocks.

◆ sendAndPollDanglingMessages()

static void peano4::parallel::TreeEntry::sendAndPollDanglingMessages ( const peano4::parallel::TreeEntry & message,
int destination,
int tag,
MPI_Comm communicator = tarch::mpi::Rank::getInstance().getCommunicator() )
static

◆ setId()

void peano4::parallel::TreeEntry::setId ( int value)

◆ setMaster()

void peano4::parallel::TreeEntry::setMaster ( int value)

◆ shutdownDatatype()

static void peano4::parallel::TreeEntry::shutdownDatatype ( )
static

Free the underlying MPI datatype.

◆ toString()

std::string peano4::parallel::TreeEntry::toString ( ) const

Field Documentation

◆ _id

int peano4::parallel::TreeEntry::_id
private

Definition at line 130 of file TreeEntry.h.

◆ _master

int peano4::parallel::TreeEntry::_master
private

Definition at line 131 of file TreeEntry.h.

◆ _senderDestinationRank

int peano4::parallel::TreeEntry::_senderDestinationRank
private

Definition at line 135 of file TreeEntry.h.

◆ Datatype

MPI_Datatype peano4::parallel::TreeEntry::Datatype
staticprivate

Whenever we use LLVM's MPI extension (DaStGe), we rely on lazy initialisation of the datatype.

However, Peano calls init explicitly in most cases. Without the LLVM extension which caches the MPI datatype once constructed, this field stores the type.

Definition at line 144 of file TreeEntry.h.

The documentation for this struct was generated from the following file: