vtkMPICommunicator Class Reference

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

#include <vtkMPICommunicator.h>

Inheritance diagram for vtkMPICommunicator:

Collaboration diagram for vtkMPICommunicator:

List of all members.

Classes
class	Request
Public Types
typedef vtkCommunicator	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkMPICommunicator *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
int	Initialize (vtkProcessGroup *group)
int	SplitInitialize (vtkCommunicator *oldcomm, int color, int key)
int	WaitAll (const int count, Request requests[])
int	WaitAny (const int count, Request requests[], int &idx)
int	TestAll (const int count, Request requests[], int &flag)
int	TestAny (const int count, Request requests[], int &idx, int &flag)
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 unsigned 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 (unsigned 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)
int	WaitSome (const int count, Request requests[], int &NCompleted, int *completed)
int	TestSome (const int count, Request requests[], int &NCompleted, int *completed)
virtual void	SetUseSsend (int)
virtual int	GetUseSsend ()
virtual void	UseSsendOn ()
virtual void	UseSsendOff ()
Static Public Member Functions
static int	IsTypeOf (const char *type)
static vtkMPICommunicator *	SafeDownCast (vtkObjectBase *o)
static vtkMPICommunicator *	New ()
static vtkMPICommunicator *	GetWorldCommunicator ()
static char *	Allocate (size_t size)
static void	Free (char *ptr)
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
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 vtkMPICommunicator *	WorldCommunicator
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 51 of file vtkMPICommunicator.h.

---

Member Typedef Documentation

typedef vtkCommunicator vtkMPICommunicator::Superclass

Reimplemented from vtkCommunicator.

Definition at line 71 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

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

(

vtkObjectBase *

o

)

[static]

Reimplemented from vtkCommunicator.

virtual vtkObjectBase* vtkMPICommunicator::NewInstanceInternal

(

)

const [protected, virtual]

Reimplemented from vtkCommunicator.

vtkMPICommunicator* vtkMPICommunicator::NewInstance

(

)

const

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 unsigned 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	(	unsigned 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.

int vtkMPICommunicator::WaitAll	(	const int	count,
		Request	requests[]
	)

Given the request objects of a set of non-blocking operations (send and/or receive) this method blocks until all requests are complete.

int vtkMPICommunicator::WaitAny	(	const int	count,
		Request	requests[],
		int &	idx
	)

Blocks until one of the specified requests in the given request array completes. Upon return, the index in the array of the completed request object is returned through the argument list.

int vtkMPICommunicator::WaitSome	(	const int	count,
		Request	requests[],
		int &	NCompleted,
		int *	completed
	)

Blocks until one or more of the specified requests in the given request request array completes. Upon return, the list of handles that have completed is stored in the completed vtkIntArray.

int vtkMPICommunicator::TestAll	(	const int	count,
		Request	requests[],
		int &	flag
	)

Checks if the given communication request objects are complete. Upon return, flag evaluates to true iff all of the communication request objects are complete.

int vtkMPICommunicator::TestAny	(	const int	count,
		Request	requests[],
		int &	idx,
		int &	flag
	)

Check if at least one of the specified requests has completed.

int vtkMPICommunicator::TestSome	(	const int	count,
		Request	requests[],
		int &	NCompleted,
		int *	completed
	)

Checks the status of all the given request communication object handles. Upon return, NCompleted holds the count of requests that have completed and the indices of the completed requests, w.r.t. the requests array is given the by the pre-allocated completed array.

vtkMPICommunicatorOpaqueComm* vtkMPICommunicator::GetMPIComm

(

)

[inline]

Definition at line 241 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 239 of file vtkMPICommunicator.h.

---

Member Data Documentation

vtkMPICommunicator* vtkMPICommunicator::WorldCommunicator [static, protected]

Definition at line 286 of file vtkMPICommunicator.h.

vtkMPICommunicatorOpaqueComm* vtkMPICommunicator::MPIComm [protected]

Definition at line 311 of file vtkMPICommunicator.h.

int vtkMPICommunicator::Initialized [protected]

Definition at line 313 of file vtkMPICommunicator.h.

int vtkMPICommunicator::KeepHandle [protected]

Definition at line 314 of file vtkMPICommunicator.h.

int vtkMPICommunicator::LastSenderId [protected]

Definition at line 316 of file vtkMPICommunicator.h.

int vtkMPICommunicator::UseSsend [protected]

Definition at line 317 of file vtkMPICommunicator.h.

---

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

• dox/Parallel/MPI/vtkMPICommunicator.h