petsc-master 2014-11-21
Report Typos and Errors

ISLocalToGlobalMappingCreate

Creates a mapping between a local (0 to n) ordering and a global parallel ordering.

Synopsis

#include "petscis.h"  
PetscErrorCode  ISLocalToGlobalMappingCreate(MPI_Comm cm,PetscInt bs,PetscInt n,const PetscInt indices[],PetscCopyMode mode,ISLocalToGlobalMapping *mapping)
Not Collective, but communicator may have more than one process

Input Parameters

comm - MPI communicator
bs - the block size
n - the number of local elements divided by the block size, or equivalently the number of block indices
indices - the global index for each local element, these do not need to be in increasing order (sorted), these values should not be scaled (i.e. multiplied) by the blocksize bs
mode - see PetscCopyMode

Output Parameter

mapping -new mapping data structure

Notes: There is one integer value in indices per block and it represents the actual indices bs*idx + j, where j=0,..,bs-1

See Also

ISLocalToGlobalMappingDestroy(), ISLocalToGlobalMappingCreateIS()

Level:advanced
Location:
src/vec/is/utils/isltog.c
Index of all IS routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/vec/vec/examples/tutorials/ex8.c.html
src/vec/is/is/examples/tutorials/ex4.c.html
src/vec/is/is/examples/tutorials/ex5.c.html
src/ts/examples/tutorials/ex30.cxx.html