MPI_Comm management.
More...
Go to the source code of this file.
◆ p6est_comm_parallel_env_assign()
Assign an MPI communicator to p6est; retrieve parallel environment.
- Parameters
-
[in] | mpicomm | A valid MPI communicator. |
- Note
- The provided MPI communicator is not owned by p6est.
◆ p6est_comm_parallel_env_duplicate()
void p6est_comm_parallel_env_duplicate |
( |
p6est_t * |
p6est | ) |
|
Duplicate MPI communicator and replace the current one by the duplicate.
- Note
- The duplicated MPI communicator is owned by p6est.
◆ p6est_comm_parallel_env_is_null()
int p6est_comm_parallel_env_is_null |
( |
p6est_t * |
p6est | ) |
|
Check if the MPI communicator is valid.
- Returns
- True if communicator is not NULL communicator, false otherwise.
◆ p6est_comm_parallel_env_reduce()
int p6est_comm_parallel_env_reduce |
( |
p6est_t ** |
p6est_supercomm | ) |
|
Reduce MPI communicator to non-empty ranks (i.e., nonzero quadrant counts).
- Parameters
-
[in/out] | p6est_supercomm Object which communicator is reduced. points to NULL if this p6est does not exists. |
- Returns
- True if p6est exists on this MPI rank after reduction.
◆ p6est_comm_parallel_env_reduce_ext()
int p6est_comm_parallel_env_reduce_ext |
( |
p6est_t ** |
p6est_supercomm, |
|
|
sc_MPI_Group |
group_add, |
|
|
int |
add_to_beginning, |
|
|
int ** |
ranks_subcomm |
|
) |
| |
Reduce MPI communicator to non-empty ranks and add a group of ranks that will remain in the reduced communicator regardless whether they are empty or not.
- Parameters
-
| [in/out] | p6est_supercomm Object which communicator is reduced. Points to NULL if this p6est does not exists. |
[in] | group_add | Group of ranks that will remain in communicator. |
[in] | add_to_beginning | If true, ranks will be added to the beginning of the reduced communicator, otherwise to the end. |
[out] | ranks_subcomm | If not null, array of size 'subcommsize' with subcommrank->supercommrank map. |
- Returns
- True if p6est exists on this MPI rank after reduction.
◆ p6est_comm_parallel_env_replace()
Replace the current MPI communicator by the one provided as input.
- Parameters
-
[in] | mpicomm | A valid MPI communicator. |
- Note
- The provided MPI communicator is not owned by p6est.