VTK
Classes | Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Static Protected Attributes | Friends
vtkMPICommunicator Class Reference

Class for creating user defined MPI communicators. More...

#include <vtkMPICommunicator.h>

Inheritance diagram for vtkMPICommunicator:
Inheritance graph
[legend]
Collaboration diagram for vtkMPICommunicator:
Collaboration graph
[legend]

List of all members.

Classes

class  Request

Public Types

typedef vtkCommunicator Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
int Initialize (vtkProcessGroup *group)
int SplitInitialize (vtkCommunicator *oldcomm, int color, int key)
vtkMPICommunicatorOpaqueComm * GetMPIComm ()
int InitializeExternal (vtkMPICommunicatorOpaqueComm *comm)
virtual int SendVoidArray (const void *data, vtkIdType length, int type, int remoteProcessId, int tag)
virtual int ReceiveVoidArray (void *data, vtkIdType length, int type, int remoteProcessId, int tag)
int NoBlockSend (const int *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockSend (const unsigned long *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockSend (const char *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockSend (const float *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockSend (const double *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockReceive (int *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockReceive (unsigned long *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockReceive (char *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockReceive (float *data, int length, int remoteProcessId, int tag, Request &req)
int NoBlockReceive (double *data, int length, int remoteProcessId, int tag, Request &req)
virtual void Barrier ()
virtual int BroadcastVoidArray (void *data, vtkIdType length, int type, int srcProcessId)
virtual int GatherVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType length, int type, int destProcessId)
virtual int GatherVVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType sendLength, vtkIdType *recvLengths, vtkIdType *offsets, int type, int destProcessId)
virtual int ScatterVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType length, int type, int srcProcessId)
virtual int ScatterVVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType *sendLengths, vtkIdType *offsets, vtkIdType recvLength, int type, int srcProcessId)
virtual int AllGatherVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType length, int type)
virtual int AllGatherVVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType sendLength, vtkIdType *recvLengths, vtkIdType *offsets, int type)
virtual int ReduceVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType length, int type, int operation, int destProcessId)
virtual int ReduceVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType length, int type, Operation *operation, int destProcessId)
virtual int AllReduceVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType length, int type, int operation)
virtual int AllReduceVoidArray (const void *sendBuffer, void *recvBuffer, vtkIdType length, int type, Operation *operation)
int Iprobe (int source, int tag, int *flag, int *actualSource)
int Iprobe (int source, int tag, int *flag, int *actualSource, int *type, int *size)
int Iprobe (int source, int tag, int *flag, int *actualSource, unsigned long *type, int *size)
int Iprobe (int source, int tag, int *flag, int *actualSource, const char *type, int *size)
int Iprobe (int source, int tag, int *flag, int *actualSource, float *type, int *size)
int Iprobe (int source, int tag, int *flag, int *actualSource, double *type, int *size)
virtual void SetUseSsend (int)
virtual int GetUseSsend ()
virtual void UseSsendOn ()
virtual void UseSsendOff ()

Static Public Member Functions

static int IsTypeOf (const char *type)
static vtkMPICommunicatorSafeDownCast (vtkObject *o)
static vtkMPICommunicatorNew ()
static vtkMPICommunicatorGetWorldCommunicator ()
static char * Allocate (size_t size)
static void Free (char *ptr)

Protected Member Functions

int InitializeNumberOfProcesses ()
void InitializeCopy (vtkMPICommunicator *source)
void Duplicate (vtkMPICommunicator *source)
virtual void SetKeepHandle (int)
virtual void KeepHandleOn ()
virtual void KeepHandleOff ()
virtual int ReceiveDataInternal (char *data, int length, int sizeoftype, int remoteProcessId, int tag, vtkMPICommunicatorReceiveDataInfo *info, int useCopy, int &senderId)

Static Protected Member Functions

static int CheckForMPIError (int err)

Protected Attributes

vtkMPICommunicatorOpaqueComm * MPIComm
int Initialized
int KeepHandle
int LastSenderId
int UseSsend

Static Protected Attributes

static vtkMPICommunicatorWorldCommunicator

Friends

class vtkMPIController
void CopyFrom (vtkMPICommunicator *source)
 vtkMPICommunicator ()
 ~vtkMPICommunicator ()

Detailed Description

Class for creating user defined MPI communicators.

This class can be used to create user defined MPI communicators. The actual creation (with MPI_Comm_create) occurs in Initialize which takes as arguments a super-communicator and a group of process ids. The new communicator is created by including the processes contained in the group. The global communicator (equivalent to MPI_COMM_WORLD) can be obtained using the class method GetWorldCommunicator. It is important to note that this communicator should not be used on the processes not contained in the group. For example, if the group contains processes 0 and 1, controller->SetCommunicator(communicator) would cause an MPI error on any other process.

See also:
vtkMPIController vtkProcessGroup
Tests:
vtkMPICommunicator (Tests)

Definition at line 50 of file vtkMPICommunicator.h.


Member Typedef Documentation

Reimplemented from vtkCommunicator.

Definition at line 70 of file vtkMPICommunicator.h.


Constructor & Destructor Documentation

vtkMPICommunicator::vtkMPICommunicator ( ) [protected]

Copies all the attributes of source, deleting previously stored data. The MPI communicator handle is also copied. Normally, this should not be needed. It is used during the construction of a new communicator for copying the world communicator, keeping the same context.

vtkMPICommunicator::~vtkMPICommunicator ( ) [protected]

Copies all the attributes of source, deleting previously stored data. The MPI communicator handle is also copied. Normally, this should not be needed. It is used during the construction of a new communicator for copying the world communicator, keeping the same context.


Member Function Documentation

virtual const char* vtkMPICommunicator::GetClassName ( ) [virtual]

Reimplemented from vtkCommunicator.

static int vtkMPICommunicator::IsTypeOf ( const char *  name) [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::IsA ( const char *  name) [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkCommunicator.

static vtkMPICommunicator* vtkMPICommunicator::SafeDownCast ( vtkObject o) [static]

Reimplemented from vtkCommunicator.

void vtkMPICommunicator::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkCommunicator.

static vtkMPICommunicator* vtkMPICommunicator::New ( ) [static]

Creates an empty communicator.

Reimplemented from vtkObject.

static vtkMPICommunicator* vtkMPICommunicator::GetWorldCommunicator ( ) [static]

Returns the singleton which behaves as the global communicator (MPI_COMM_WORLD)

int vtkMPICommunicator::Initialize ( vtkProcessGroup group)

Used to initialize the communicator (i.e. create the underlying MPI_Comm). The group must be associated with a valid vtkMPICommunicator.

int vtkMPICommunicator::SplitInitialize ( vtkCommunicator oldcomm,
int  color,
int  key 
)

Used to initialize the communicator (i.e. create the underlying MPI_Comm) using MPI_Comm_split on the given communicator. Return values are 1 for success and 0 otherwise.

virtual int vtkMPICommunicator::SendVoidArray ( const void *  data,
vtkIdType  length,
int  type,
int  remoteProcessId,
int  tag 
) [virtual]

Performs the actual communication. You will usually use the convenience Send functions defined in the superclass. Return values are 1 for success and 0 otherwise.

Implements vtkCommunicator.

virtual int vtkMPICommunicator::ReceiveVoidArray ( void *  data,
vtkIdType  length,
int  type,
int  remoteProcessId,
int  tag 
) [virtual]

Performs the actual communication. You will usually use the convenience Send functions defined in the superclass. Return values are 1 for success and 0 otherwise.

Implements vtkCommunicator.

int vtkMPICommunicator::NoBlockSend ( const int data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method sends data to another process (non-blocking). Tag eliminates ambiguity when multiple sends or receives exist in the same process. The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockSend ( const unsigned long *  data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method sends data to another process (non-blocking). Tag eliminates ambiguity when multiple sends or receives exist in the same process. The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockSend ( const char *  data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method sends data to another process (non-blocking). Tag eliminates ambiguity when multiple sends or receives exist in the same process. The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockSend ( const float data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method sends data to another process (non-blocking). Tag eliminates ambiguity when multiple sends or receives exist in the same process. The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockSend ( const double data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method sends data to another process (non-blocking). Tag eliminates ambiguity when multiple sends or receives exist in the same process. The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockReceive ( int data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method receives data from a corresponding send (non-blocking). The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockReceive ( unsigned long *  data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method receives data from a corresponding send (non-blocking). The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockReceive ( char *  data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method receives data from a corresponding send (non-blocking). The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockReceive ( float data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method receives data from a corresponding send (non-blocking). The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

int vtkMPICommunicator::NoBlockReceive ( double data,
int  length,
int  remoteProcessId,
int  tag,
Request req 
)

This method receives data from a corresponding send (non-blocking). The last argument, vtkMPICommunicator::Request& req can later be used (with req.Test() ) to test the success of the message. Return values are 1 for success and 0 otherwise.

virtual void vtkMPICommunicator::Barrier ( ) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::BroadcastVoidArray ( void *  data,
vtkIdType  length,
int  type,
int  srcProcessId 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::GatherVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  length,
int  type,
int  destProcessId 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::GatherVVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  sendLength,
vtkIdType recvLengths,
vtkIdType offsets,
int  type,
int  destProcessId 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::ScatterVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  length,
int  type,
int  srcProcessId 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::ScatterVVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType sendLengths,
vtkIdType offsets,
vtkIdType  recvLength,
int  type,
int  srcProcessId 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::AllGatherVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  length,
int  type 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::AllGatherVVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  sendLength,
vtkIdType recvLengths,
vtkIdType offsets,
int  type 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::ReduceVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  length,
int  type,
int  operation,
int  destProcessId 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::ReduceVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  length,
int  type,
Operation operation,
int  destProcessId 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::AllReduceVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  length,
int  type,
int  operation 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

virtual int vtkMPICommunicator::AllReduceVoidArray ( const void *  sendBuffer,
void *  recvBuffer,
vtkIdType  length,
int  type,
Operation operation 
) [virtual]

More efficient implementations of collective operations that use the equivalent MPI commands. Return values are 1 for success and 0 otherwise.

Reimplemented from vtkCommunicator.

int vtkMPICommunicator::Iprobe ( int  source,
int  tag,
int flag,
int actualSource 
)

Nonblocking test for a message. Inputs are: source -- the source rank or ANY_SOURCE; tag -- the tag value. Outputs are: flag -- True if a message matches; actualSource -- the rank sending the message (useful if ANY_SOURCE is used) if flag is True and actualSource isn't NULL; size -- the length of the message in bytes if flag is true (only set if size isn't NULL). The return value is 1 for success and 0 otherwise.

int vtkMPICommunicator::Iprobe ( int  source,
int  tag,
int flag,
int actualSource,
int type,
int size 
)

Nonblocking test for a message. Inputs are: source -- the source rank or ANY_SOURCE; tag -- the tag value. Outputs are: flag -- True if a message matches; actualSource -- the rank sending the message (useful if ANY_SOURCE is used) if flag is True and actualSource isn't NULL; size -- the length of the message in bytes if flag is true (only set if size isn't NULL). The return value is 1 for success and 0 otherwise.

int vtkMPICommunicator::Iprobe ( int  source,
int  tag,
int flag,
int actualSource,
unsigned long *  type,
int size 
)

Nonblocking test for a message. Inputs are: source -- the source rank or ANY_SOURCE; tag -- the tag value. Outputs are: flag -- True if a message matches; actualSource -- the rank sending the message (useful if ANY_SOURCE is used) if flag is True and actualSource isn't NULL; size -- the length of the message in bytes if flag is true (only set if size isn't NULL). The return value is 1 for success and 0 otherwise.

int vtkMPICommunicator::Iprobe ( int  source,
int  tag,
int flag,
int actualSource,
const char *  type,
int size 
)

Nonblocking test for a message. Inputs are: source -- the source rank or ANY_SOURCE; tag -- the tag value. Outputs are: flag -- True if a message matches; actualSource -- the rank sending the message (useful if ANY_SOURCE is used) if flag is True and actualSource isn't NULL; size -- the length of the message in bytes if flag is true (only set if size isn't NULL). The return value is 1 for success and 0 otherwise.

int vtkMPICommunicator::Iprobe ( int  source,
int  tag,
int flag,
int actualSource,
float type,
int size 
)

Nonblocking test for a message. Inputs are: source -- the source rank or ANY_SOURCE; tag -- the tag value. Outputs are: flag -- True if a message matches; actualSource -- the rank sending the message (useful if ANY_SOURCE is used) if flag is True and actualSource isn't NULL; size -- the length of the message in bytes if flag is true (only set if size isn't NULL). The return value is 1 for success and 0 otherwise.

int vtkMPICommunicator::Iprobe ( int  source,
int  tag,
int flag,
int actualSource,
double type,
int size 
)

Nonblocking test for a message. Inputs are: source -- the source rank or ANY_SOURCE; tag -- the tag value. Outputs are: flag -- True if a message matches; actualSource -- the rank sending the message (useful if ANY_SOURCE is used) if flag is True and actualSource isn't NULL; size -- the length of the message in bytes if flag is true (only set if size isn't NULL). The return value is 1 for success and 0 otherwise.

vtkMPICommunicatorOpaqueComm* vtkMPICommunicator::GetMPIComm ( ) [inline]

Definition at line 203 of file vtkMPICommunicator.h.

int vtkMPICommunicator::InitializeExternal ( vtkMPICommunicatorOpaqueComm *  comm)
static char* vtkMPICommunicator::Allocate ( size_t  size) [static]
static void vtkMPICommunicator::Free ( char *  ptr) [static]
virtual void vtkMPICommunicator::SetUseSsend ( int  ) [virtual]

When set to 1, all MPI_Send calls are replaced by MPI_Ssend calls. Default is 0.

virtual int vtkMPICommunicator::GetUseSsend ( ) [virtual]

When set to 1, all MPI_Send calls are replaced by MPI_Ssend calls. Default is 0.

virtual void vtkMPICommunicator::UseSsendOn ( ) [virtual]

When set to 1, all MPI_Send calls are replaced by MPI_Ssend calls. Default is 0.

virtual void vtkMPICommunicator::UseSsendOff ( ) [virtual]

When set to 1, all MPI_Send calls are replaced by MPI_Ssend calls. Default is 0.

void vtkMPICommunicator::CopyFrom ( vtkMPICommunicator source)

Copies all the attributes of source, deleting previously stored data. The MPI communicator handle is also copied. Normally, this should not be needed. It is used during the construction of a new communicator for copying the world communicator, keeping the same context.

int vtkMPICommunicator::InitializeNumberOfProcesses ( ) [protected]
virtual void vtkMPICommunicator::SetKeepHandle ( int  ) [protected, virtual]

KeepHandle is normally off. This means that the MPI communicator handle will be freed at the destruction of the object. However, if the handle was copied from another object (via CopyFrom() not Duplicate()), this has to be turned on otherwise the handle will be freed multiple times causing MPI failure. The alternative to this is using reference counting but it is unnecessarily complicated for this case.

virtual void vtkMPICommunicator::KeepHandleOn ( ) [protected, virtual]

KeepHandle is normally off. This means that the MPI communicator handle will be freed at the destruction of the object. However, if the handle was copied from another object (via CopyFrom() not Duplicate()), this has to be turned on otherwise the handle will be freed multiple times causing MPI failure. The alternative to this is using reference counting but it is unnecessarily complicated for this case.

virtual void vtkMPICommunicator::KeepHandleOff ( ) [protected, virtual]

KeepHandle is normally off. This means that the MPI communicator handle will be freed at the destruction of the object. However, if the handle was copied from another object (via CopyFrom() not Duplicate()), this has to be turned on otherwise the handle will be freed multiple times causing MPI failure. The alternative to this is using reference counting but it is unnecessarily complicated for this case.

void vtkMPICommunicator::InitializeCopy ( vtkMPICommunicator source) [protected]
void vtkMPICommunicator::Duplicate ( vtkMPICommunicator source) [protected]

Copies all the attributes of source, deleting previously stored data EXCEPT the MPI communicator handle which is duplicated with MPI_Comm_dup(). Therefore, although the processes in the communicator remain the same, a new context is created. This prevents the two communicators from intefering with each other during message send/receives even if the tags are the same.

virtual int vtkMPICommunicator::ReceiveDataInternal ( char *  data,
int  length,
int  sizeoftype,
int  remoteProcessId,
int  tag,
vtkMPICommunicatorReceiveDataInfo *  info,
int  useCopy,
int senderId 
) [protected, virtual]

Implementation for receive data.

static int vtkMPICommunicator::CheckForMPIError ( int  err) [static, protected]

Friends And Related Function Documentation

friend class vtkMPIController [friend]

Definition at line 201 of file vtkMPICommunicator.h.


Member Data Documentation

Definition at line 248 of file vtkMPICommunicator.h.

vtkMPICommunicatorOpaqueComm* vtkMPICommunicator::MPIComm [protected]

Definition at line 273 of file vtkMPICommunicator.h.

Definition at line 275 of file vtkMPICommunicator.h.

Definition at line 276 of file vtkMPICommunicator.h.

Definition at line 278 of file vtkMPICommunicator.h.

Definition at line 279 of file vtkMPICommunicator.h.


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