ISLocalToGlobalMapping — PETSc 3.23.0 documentation

Skip to main content
`Ctrl`+`K`

# ISLocalToGlobalMapping

mappings from a local ordering (on individual MPI processes) of 0 to n-1 to a global PETSc ordering (across collections of MPI processes) used by a vector or matrix.

## Synopsis

    typedef struct _p_ISLocalToGlobalMapping *ISLocalToGlobalMapping;

## Note

Mapping from local to global is scalable; but global to local may not be if the range of global values represented locally is very large. `ISLocalToGlobalMappingType` provides alternative ways of efficiently applying `ISGlobalToLocalMappingApply()

## Developer Note

`ISLocalToGlobalMapping` is actually a private object; it is included here for the inline function `ISLocalToGlobalMappingApply()` to allow it to be inlined since it is used so often.

## See Also

`ISLocalToGlobalMappingCreate()`, `ISLocalToGlobalMappingApply()`, `ISLocalToGlobalMappingDestroy()`, `ISGlobalToLocalMappingApply()`

## Level

intermediate

## Location

include/petscistypes.h

## Examples

src/mat/tutorials/ex3.c
src/ksp/ksp/tutorials/ex59.c
src/ksp/ksp/tutorials/ex70.c
src/ksp/ksp/tutorials/ex85.c
src/ksp/ksp/tutorials/ex71.c
src/tao/bound/tutorials/plate2.c
src/ksp/ksp/tutorials/ex14f.F90
src/snes/tutorials/ex48.c
src/ksp/ksp/tutorials/ex49.c
src/ksp/ksp/tutorials/ex43.c

## Implementations

_p_ISLocalToGlobalMapping in include/petsc/private/isimpl.h
ISLocalToGlobalMapping_Basic in src/vec/is/utils/isltog.c
ISLocalToGlobalMapping_Hash in src/vec/is/utils/isltog.c

Index of all IS routines
Table of Contents for all manual pages
Index of all manual pages