Dune Core Modules (2.8.0)
A buffered communicator where the amount of data sent does not have to be known a priori. More...
#include <dune/common/parallel/variablesizecommunicator.hh>
Public Types | |
typedef std::map< int, std::pair< InterfaceInformation, InterfaceInformation >, std::less< int >, typename std::allocator_traits< Allocator >::template rebind_alloc< std::pair< const int, std::pair< InterfaceInformation, InterfaceInformation > > > > | InterfaceMap |
The type of the map from process number to InterfaceInformation for sending and receiving to and from it. | |
Public Member Functions | |
VariableSizeCommunicator (MPI_Comm comm, const InterfaceMap &inf) | |
Creates a communicator with the default maximum buffer size. More... | |
VariableSizeCommunicator (const Interface &inf) | |
Creates a communicator with the default maximum buffer size. More... | |
VariableSizeCommunicator (MPI_Comm comm, const InterfaceMap &inf, std::size_t max_buffer_size) | |
Creates a communicator with a specific maximum buffer size. More... | |
VariableSizeCommunicator (const Interface &inf, std::size_t max_buffer_size) | |
Creates a communicator with a specific maximum buffer size. More... | |
VariableSizeCommunicator (const VariableSizeCommunicator &other) | |
Copy-constructs a communicator. More... | |
VariableSizeCommunicator & | operator= (const VariableSizeCommunicator &other) |
Copy-assignes a communicator. More... | |
template<class DataHandle > | |
void | forward (DataHandle &handle) |
Communicate forward. More... | |
template<class DataHandle > | |
void | backward (DataHandle &handle) |
Communicate backwards. More... | |
Detailed Description
class Dune::VariableSizeCommunicator< Allocator >
A buffered communicator where the amount of data sent does not have to be known a priori.
In contrast to BufferedCommunicator the amount of data is determined by the container whose entries are sent and not known at the receiving side a priori.
Note that there is no global index-space, only local index-spaces on each rank. Note also that each rank has two index-spaces, one used for gathering/sending, and one used for scattering/receiving. These may be the identical, but they do not have to be.
For data send from rank A to rank B, the order that rank A inserts its indices into its send-interface for rank B has to be the same order that rank B inserts its matching indices into its receive interface for rank A. (This is because the VariableSizeCommunicator
has no concept of a global index-space, so the order used to insert the indices into the interfaces is the only clue it has to know which source index should be communicated to which target index.)
It is permissible for a rank to communicate with itself, i.e. it can define send- and receive-interfaces to itself. These interfaces do not need to contain the same indices, as the local send index-space can be different from the local receive index-space. This is useful for repartitioning or for aggregating in AMG.
Do not assume that gathering to an index happens before scattering to the same index in the same communication, as VariableSizeCommunicator
assumes they are from different index-spaces. This is a pitfall if you want do communicate a vector in-place, e.g. to sum up partial results from different ranks. Instead, have separate source and target vectors and copy the source vector to the target vector before communicating.
Constructor & Destructor Documentation
◆ VariableSizeCommunicator() [1/5]
|
inline |
Creates a communicator with the default maximum buffer size.
The default size ist either what the macro DUNE_MAX_COMMUNICATION_BUFFER_SIZE is set to or 32768 if is not set.
◆ VariableSizeCommunicator() [2/5]
|
inline |
Creates a communicator with the default maximum buffer size.
- Parameters
-
inf The communication interface.
References Dune::Interface::communicator().
◆ VariableSizeCommunicator() [3/5]
|
inline |
Creates a communicator with a specific maximum buffer size.
- Parameters
-
comm The MPI communicator to use. inf The communication interface. max_buffer_size The maximum buffer size allowed.
◆ VariableSizeCommunicator() [4/5]
|
inline |
Creates a communicator with a specific maximum buffer size.
- Parameters
-
inf The communication interface. max_buffer_size The maximum buffer size allowed.
References Dune::Interface::communicator().
◆ VariableSizeCommunicator() [5/5]
|
inline |
Copy-constructs a communicator.
- Parameters
-
other VariableSizeCommunicator that is copied.
Member Function Documentation
◆ backward()
|
inline |
Communicate backwards.
- Template Parameters
-
DataHandle The type of the handle describing the data. This type has to adhere to the following interface: // returns whether the number of data items per entry is fixedbool fixedsize();// get the number of data items for an entry with index istd::size_t size(std::size_t i);// gather the data at index itemplate<class MessageBuffer>void gather(MessageBuffer& buf, std::size_t i);// scatter the n data items to index itemplate<class MessageBuffer>void scatter(MessageBuffer& buf, std::size_t i, std::size_t n);
- Parameters
-
handle A handle responsible for describing the data, gathering, and scattering it.
◆ forward()
|
inline |
Communicate forward.
- Template Parameters
-
DataHandle The type of the handle describing the data. This type has to adhere to the following interface: // returns whether the number of data items per entry is fixedbool fixedsize();// get the number of data items for an entry with index istd::size_t size(std::size_t i);// gather the data at index itemplate<class MessageBuffer>void gather(MessageBuffer& buf, std::size_t i);// scatter the n data items to index itemplate<class MessageBuffer>void scatter(MessageBuffer& buf, std::size_t i, std::size_t n);
- Parameters
-
handle A handle responsible for describing the data, gathering, and scattering it.
◆ operator=()
|
inline |
Copy-assignes a communicator.
- Parameters
-
other VariableSizeCommunicator that is copied.
The documentation for this class was generated from the following file:
- dune/common/parallel/variablesizecommunicator.hh