ISGlobalToLocalMappingApply

Takes a list of integers in global numbering and returns the local numbering.

Synopsis

int ISGlobalToLocalMappingApply(ISLocalToGlobalMapping mapping, ISGlobalToLocalMappingType type,
                                  int n, int *idx,int *nout,int *idxout)
Not collective

Input Parameters

mapping - mapping between local and global numbering
type - IS_GTOLM_MASK - replaces global indices with no local value with -1 IS_GTOLM_DROP - drops the indices with no local value from the output list
n - number of global indices to map
idx - global indices to map

Output Parameters

nout - number of indices in output array (if type == IS_GTOLM_MASK then nout = n)
idxout - local index of each global index, one must pass in an array long enough to hold all the indices. You can call ISGlobalToLocalMappingApply() with idxout == PETSC_NULL to determine the required length (returned in nout) and then allocate the required space and call ISGlobalToLocalMappingApply() a second time to set the values.

Notes

Either nout or idxout may be PETSC_NULL. idx and idxout may be identical.

Keywords

IS, global-to-local mapping, apply

See Also

ISLocalToGlobalMappingApply(), ISLocalToGlobalMappingCreate(),
ISLocalToGlobalMappingDestroy()

Examples

src/is/examples/tutorials/ex4.c

Location: src/is/utils/isltog.c
IS and DA Index
Table of Contents