[This is preliminary documentation and is subject to change.]

Constructs a new intercommunicator that provides communication between two groups of processes, specified by intracommunicators. This is a collective operation involving all of the processes in the communicators passed via localComm.

Namespace:  MPI
Assembly:  MPI (in MPI.dll)
Version: 0.8.0.0 (0.8.0.0)

Syntax

C#
public Intercommunicator(
	Intracommunicator localComm,
	int localLeader,
	Intracommunicator bridgeComm,
	int remoteLeader,
	int tag
)
Visual Basic (Declaration)
Public Sub New ( _
	localComm As Intracommunicator, _
	localLeader As Integer, _
	bridgeComm As Intracommunicator, _
	remoteLeader As Integer, _
	tag As Integer _
)
Visual C++
public:
Intercommunicator(
	Intracommunicator^ localComm, 
	int localLeader, 
	Intracommunicator^ bridgeComm, 
	int remoteLeader, 
	int tag
)

Parameters

localComm
Type: MPI..::.Intracommunicator
Intracommunicator whose processes will form the local group in the resulting intercommunication. Since there are two groups in an intercommunicator (each of which is identified by an intracommunicator), each process will provide the communicator for its own "local" group. Note that a process cannot be in both groups.
localLeader
Type: System..::.Int32
The rank of the "leader" in the local group. Each of the processes must provide the same leader rank as all of the other processes within its group.
bridgeComm
Type: MPI..::.Intracommunicator
A communicator that permits communication between the leaders of the two groups. This communicator is used internally to construct the intercommunicator, so there must not be any pending communication that might interfere with point-to-pointer messages with tag tag. This parameter is only significant for the processes that are leaders of their group.
remoteLeader
Type: System..::.Int32
The rank of the remote group's leader within the communicator bridgeComm.
tag
Type: System..::.Int32
A tag value that indicates which intercommunicator is used to transmit setup messages across the communicator bridgeComm. Pick a tag value that will not interfere with other communicator on bridgeComm.

See Also