petsc-3.7.1 2016-05-15
Report Typos and Errors

DMDAGetProcessorSubset

Returns a communicator consisting only of the processors in a DMDA that own a particular global x, y, or z grid point (corresponding to a logical plane in a 3D grid or a line in a 2D grid).

Synopsis

#include "petscdmda.h"   
PetscErrorCode  DMDAGetProcessorSubset(DM da,DMDADirection dir,PetscInt gp,MPI_Comm *comm)
Collective on DMDA Many br

Input Parameters

da - the distributed array Many br
dir - Cartesian direction, either DMDA_X, DMDA_Y, or DMDA_Z Many br
gp - global grid point number in this direction Many br

Output Parameters

comm -new communicator Many br

Many br

Notes

All processors that share the DMDA must call this with the same gp value Many br

This routine is particularly useful to compute boundary conditions Many bror other application-specific calculations that require manipulating Many brsets of data throughout a logical plane of grid points. Many br

Keywords

distributed array, get, processor subset

Level:advanced
Location:
src/dm/impls/da/dasub.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages