bulk::coarray
Defined in header <bulk/coarray.hpp>.
template <typename T>
class coarray;
Distributed array with easy element access, loosely based on the behaviour of Coarray Fortran.
Usage
Coarrays provide a convenient way to share data across processors. Instead of manually sending and receiving data elements, coarrays model distributed data as a 2-dimensional array, where the first dimension is over the processors, and the second dimension is over local 1-dimensional array indices.
Template parameters
T- the type of the value stored in the local image of the coarray.
Member types
value_type: the type of the image values (i.e.T).
Nested classes
image |
representation of coarray image |
writer |
allows for modification for remote coarray image |
slice |
slices of coarrays |
slice_writer |
modify slices of coarrays |
Member functions
| (constructor) | constructs the coarray |
| (deconstructor) | deconstructs the coarray |
| Value access | |
operator() |
obtain an image of the coarray |
operator[] |
access the local elements of the coarray |
| World access | |
world |
returns the world to which the coarray belongs |
Example
auto xs = bulk::coarray<int>(world, 10);
// set the 5th element on the 1st processor to 4
xs(1)[5] = 4;
// set the 3rd element on the local processor to 2
xs[3] = 2;
// set a slice
xs(1)[{2, 5}] = {1, 2, 3};
// get a slice
auto values = xs(2)[{2, 5}].get();