Communicator performing operations within groups defined by a GroupTopology with arbitrary-size data associated with each group. More...

#include <communication.hpp>

Collaboration diagram for mfem::GroupCommunicator:

[legend]

Classes
struct	OpData
	Data structure on which we define reduce operations. More...

Public Types
enum	Mode { byGroup, byNeighbor }
	Communication mode. More...

Public Member Functions
	GroupCommunicator (GroupTopology &gt, Mode m=byNeighbor)
	Construct a GroupCommunicator object. More...

void	Create (const Array< int > &ldof_group)
	Initialize the communicator from a local-dof to group map. Finalize() is called internally. More...

Table &	GroupLDofTable ()
	Fill-in the returned Table reference to initialize the GroupCommunicator then call Finalize(). More...

const Table &	GroupLDofTable () const
	Read-only access to group-ldof Table. More...

void	Finalize ()
	Allocate internal buffers after the GroupLDofTable is defined. More...

void	SetLTDofTable (const Array< int > &ldof_ltdof)
	Initialize the internal group_ltdof Table. More...

GroupTopology &	GetGroupTopology ()
	Get a reference to the associated GroupTopology object. More...

const GroupTopology &	GetGroupTopology () const
	Get a const reference to the associated GroupTopology object. More...

void	GetNeighborLTDofTable (Table &nbr_ltdof) const
	Dofs to be sent to communication neighbors. More...

void	GetNeighborLDofTable (Table &nbr_ldof) const
	Dofs to be received from communication neighbors. More...

template<class T >
T *	CopyGroupToBuffer (const T ldata, T buf, int group, int layout) const
	Copy the entries corresponding to the group group from the local array ldata to the buffer buf. More...

template<class T >
const T *	CopyGroupFromBuffer (const T buf, T ldata, int group, int layout) const
	Copy the entries corresponding to the group group from the buffer buf to the local array ldata. More...

template<class T >
const T *	ReduceGroupFromBuffer (const T buf, T ldata, int group, int layout, void(*Op)(OpData< T >)) const
	Perform the reduction operation Op to the entries of group group using the values from the buffer buf and the values from the local array ldata, saving the result in the latter. More...

template<class T >
void	BcastBegin (T *ldata, int layout) const
	Begin a broadcast within each group where the master is the root. More...

template<class T >
void	BcastEnd (T *ldata, int layout) const
	Finalize a broadcast started with BcastBegin(). More...

template<class T >
void	Bcast (T *ldata, int layout) const
	Broadcast within each group where the master is the root. More...

template<class T >
void	Bcast (T *ldata) const
	Broadcast within each group where the master is the root. More...

template<class T >
void	Bcast (Array< T > &ldata) const
	Broadcast within each group where the master is the root. More...

template<class T >
void	ReduceBegin (const T *ldata) const
	Begin reduction operation within each group where the master is the root. More...

template<class T >
void	ReduceEnd (T ldata, int layout, void(Op)(OpData< T >)) const
	Finalize reduction operation started with ReduceBegin(). More...

template<class T >
void	Reduce (T ldata, void(Op)(OpData< T >)) const
	Reduce within each group where the master is the root. More...

template<class T >
void	Reduce (Array< T > &ldata, void(*Op)(OpData< T >)) const
	Reduce within each group where the master is the root. More...

void	PrintInfo (std::ostream &out=mfem::out) const
	Print information about the GroupCommunicator from all MPI ranks. More...

	~GroupCommunicator ()
	Destroy a GroupCommunicator object, deallocating internal data structures and buffers. More...

Static Public Member Functions
template<class T >
static void	Sum (OpData< T >)
	Reduce operation Sum, instantiated for int and double. More...

template<class T >
static void	Min (OpData< T >)
	Reduce operation Min, instantiated for int and double. More...

template<class T >
static void	Max (OpData< T >)
	Reduce operation Max, instantiated for int and double. More...

template<class T >
static void	BitOR (OpData< T >)
	Reduce operation bitwise OR, instantiated for int only. More...

Protected Attributes
GroupTopology &	gtopo

Mode	mode

Table	group_ldof

Table	group_ltdof

int	group_buf_size

Array< char >	group_buf

MPI_Request *	requests

int	comm_lock

int	num_requests

int *	request_marker

int *	buf_offsets

Table	nbr_send_groups

Table	nbr_recv_groups

Detailed Description

Communicator performing operations within groups defined by a GroupTopology with arbitrary-size data associated with each group.

Definition at line 120 of file communication.hpp.

Member Enumeration Documentation

enum mfem::GroupCommunicator::Mode

Communication mode.

Enumerator
byGroup	Communications are performed one group at a time.
byNeighbor	Communications are performed one neighbor at a time, aggregating over groups.

Definition at line 124 of file communication.hpp.

Constructor & Destructor Documentation

mfem::GroupCommunicator::GroupCommunicator	(	GroupTopology &	gt,
		Mode	m = `byNeighbor`
	)

Construct a GroupCommunicator object.

The object must be initialized before it can be used to perform any operations. To initialize the object, either

call Create() or
initialize the Table reference returned by GroupLDofTable() and then call Finalize().

Definition at line 341 of file communication.cpp.

mfem::GroupCommunicator::~GroupCommunicator ( )

Destroy a GroupCommunicator object, deallocating internal data structures and buffers.

Definition at line 1278 of file communication.cpp.

Member Function Documentation

template<class T >

void mfem::GroupCommunicator::Bcast	(	T *	ldata,
		int	layout
	)		const

inline

Broadcast within each group where the master is the root.

The data layout can be either 0 or 1.

For a description of layout, see CopyGroupToBuffer().

Definition at line 249 of file communication.hpp.

template<class T >

void mfem::GroupCommunicator::Bcast ( T * ldata ) const

inline

Broadcast within each group where the master is the root.

Definition at line 256 of file communication.hpp.

template<class T >

void mfem::GroupCommunicator::Bcast ( Array< T > & ldata ) const

inline

Broadcast within each group where the master is the root.

Definition at line 258 of file communication.hpp.

template<class T >

void mfem::GroupCommunicator::BcastBegin	(	T *	ldata,
		int	layout
	)		const

Begin a broadcast within each group where the master is the root.

For a description of layout, see CopyGroupToBuffer().

Definition at line 697 of file communication.cpp.

template<class T >

void mfem::GroupCommunicator::BcastEnd	(	T *	ldata,
		int	layout
	)		const

Finalize a broadcast started with BcastBegin().

The output data layout can be:

0 - ldata is an array on all ldofs; the input layout should be either 0 or 2
1 - ldata is the same array as given to BcastBegin(); the input layout should be 1.

For more details about layout, see CopyGroupToBuffer().

Definition at line 834 of file communication.cpp.

template<class T >

template void mfem::GroupCommunicator::BitOR< int > ( OpData< T > )

static

Reduce operation bitwise OR, instantiated for int only.

Definition at line 1145 of file communication.cpp.

template<class T >

const T * mfem::GroupCommunicator::CopyGroupFromBuffer	(	const T *	buf,
		T *	ldata,
		int	group,
		int	layout
	)		const

Copy the entries corresponding to the group group from the buffer buf to the local array ldata.

For a description of layout, see CopyGroupToBuffer().

Returns: The pointer buf plus the number of elements in the group.

Definition at line 624 of file communication.cpp.

template<class T >

T * mfem::GroupCommunicator::CopyGroupToBuffer	(	const T *	ldata,
		T *	buf,
		int	group,
		int	layout
	)		const

Copy the entries corresponding to the group group from the local array ldata to the buffer buf.

The layout of the local array can be:

0 - ldata is an array on all ldofs: copied indices: { J[j] : I[group] <= j < I[group+1] } where I,J=group_ldof.{I,J}
1 - ldata is an array on the shared ldofs: copied indices: { j : I[group] <= j < I[group+1] } where I,J=group_ldof.{I,J}
2 - ldata is an array on the true ldofs, ltdofs: copied indices: { J[j] : I[group] <= j < I[group+1] } where I,J=group_ltdof.{I,J}.
Returns
The pointer buf plus the number of elements in the group.

Definition at line 589 of file communication.cpp.

void mfem::GroupCommunicator::Create ( const Array< int > & ldof_group )

Initialize the communicator from a local-dof to group map. Finalize() is called internally.

Definition at line 353 of file communication.cpp.

void mfem::GroupCommunicator::Finalize ( )

Allocate internal buffers after the GroupLDofTable is defined.

Definition at line 379 of file communication.cpp.

GroupTopology& mfem::GroupCommunicator::GetGroupTopology ( )

inline

Get a reference to the associated GroupTopology object.

Definition at line 177 of file communication.hpp.

const GroupTopology& mfem::GroupCommunicator::GetGroupTopology ( ) const

inline

Get a const reference to the associated GroupTopology object.

Definition at line 180 of file communication.hpp.

void mfem::GroupCommunicator::GetNeighborLDofTable ( Table & nbr_ldof ) const

Dofs to be received from communication neighbors.

Definition at line 552 of file communication.cpp.

void mfem::GroupCommunicator::GetNeighborLTDofTable ( Table & nbr_ltdof ) const

Dofs to be sent to communication neighbors.

Definition at line 516 of file communication.cpp.

Table& mfem::GroupCommunicator::GroupLDofTable ( )

inline

Fill-in the returned Table reference to initialize the GroupCommunicator then call Finalize().

Definition at line 163 of file communication.hpp.

const Table& mfem::GroupCommunicator::GroupLDofTable ( ) const

inline

Read-only access to group-ldof Table.

Definition at line 166 of file communication.hpp.

template<class T >

template void mfem::GroupCommunicator::Max< double > ( OpData< T > )

static

Reduce operation Max, instantiated for int and double.

Definition at line 1127 of file communication.cpp.

template<class T >

template void mfem::GroupCommunicator::Min< double > ( OpData< T > )

static

Reduce operation Min, instantiated for int and double.

Definition at line 1109 of file communication.cpp.

void mfem::GroupCommunicator::PrintInfo ( std::ostream & out = mfem::out ) const

Print information about the GroupCommunicator from all MPI ranks.

Definition at line 1158 of file communication.cpp.

template<class T >

void mfem::GroupCommunicator::Reduce	(	T *	ldata,
		void(*)(OpData< T >)	Op
	)		const

inline

Reduce within each group where the master is the root.

The reduce operation is given by the second argument (see below for list of the supported operations.)

Definition at line 290 of file communication.hpp.

template<class T >

void mfem::GroupCommunicator::Reduce	(	Array< T > &	ldata,
		void(*)(OpData< T >)	Op
	)		const

inline

Reduce within each group where the master is the root.

Definition at line 297 of file communication.hpp.

template<class T >

void mfem::GroupCommunicator::ReduceBegin ( const T * ldata ) const

Begin reduction operation within each group where the master is the root.

The input data layout is an array on all ldofs, i.e. layout 0, see CopyGroupToBuffer().

The reduce operation will be specified when calling ReduceEnd(). This method is instantiated for int and double.

Definition at line 896 of file communication.cpp.

template<class T >

void mfem::GroupCommunicator::ReduceEnd	(	T *	ldata,
		int	layout,
		void(*)(OpData< T >)	Op
	)		const

Finalize reduction operation started with ReduceBegin().

The output data layout can be either 0 or 2, see CopyGroupToBuffer().

The reduce operation is given by the third argument (see below for list of the supported operations.) This method is instantiated for int and double.

Note: If the output data layout is 2, then the data from the ldata array passed to this call is used in the reduction operation, instead of the data from the ldata array passed to ReduceBegin(). Therefore, the data for master-groups has to be identical in both arrays.

Definition at line 1015 of file communication.cpp.

template<class T >

const T * mfem::GroupCommunicator::ReduceGroupFromBuffer	(	const T *	buf,
		T *	ldata,
		int	group,
		int	layout,
		void(*)(OpData< T >)	Op
	)		const

Perform the reduction operation Op to the entries of group group using the values from the buffer buf and the values from the local array ldata, saving the result in the latter.

For a description of layout, see CopyGroupToBuffer().

Returns: The pointer buf plus the number of elements in the group.

Definition at line 658 of file communication.cpp.

void mfem::GroupCommunicator::SetLTDofTable ( const Array< int > & ldof_ltdof )

Initialize the internal group_ltdof Table.

This method must be called before performing operations that use local data layout 2, see CopyGroupToBuffer() for layout descriptions.

Definition at line 488 of file communication.cpp.

template<class T >

template void mfem::GroupCommunicator::Sum< double > ( OpData< T > )

static

Reduce operation Sum, instantiated for int and double.

Definition at line 1085 of file communication.cpp.

Member Data Documentation

int* mfem::GroupCommunicator::buf_offsets

protected

Definition at line 144 of file communication.hpp.

int mfem::GroupCommunicator::comm_lock

mutableprotected

Definition at line 141 of file communication.hpp.

Array<char> mfem::GroupCommunicator::group_buf

mutableprotected

Definition at line 137 of file communication.hpp.

int mfem::GroupCommunicator::group_buf_size

protected

Definition at line 136 of file communication.hpp.

Table mfem::GroupCommunicator::group_ldof

protected

Definition at line 134 of file communication.hpp.

Table mfem::GroupCommunicator::group_ltdof

protected

Definition at line 135 of file communication.hpp.

GroupTopology& mfem::GroupCommunicator::gtopo

protected

Definition at line 132 of file communication.hpp.

Mode mfem::GroupCommunicator::mode

protected

Definition at line 133 of file communication.hpp.

Table mfem::GroupCommunicator::nbr_recv_groups

protected

Definition at line 145 of file communication.hpp.

Table mfem::GroupCommunicator::nbr_send_groups

protected

Definition at line 145 of file communication.hpp.

int mfem::GroupCommunicator::num_requests

mutableprotected

Definition at line 142 of file communication.hpp.

int* mfem::GroupCommunicator::request_marker

protected

Definition at line 143 of file communication.hpp.

MPI_Request* mfem::GroupCommunicator::requests

protected

Definition at line 138 of file communication.hpp.

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

general/communication.hpp
general/communication.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation