:orphan: # ISLocalToGlobalMappingGetInfo Gets the neighbor information for each processor and each index shared by more than one processor ## Synopsis ``` #include "petscis.h" PetscErrorCode ISLocalToGlobalMappingGetInfo(ISLocalToGlobalMapping mapping, PetscInt *nproc, PetscInt *procs[], PetscInt *numprocs[], PetscInt **indices[]) ``` Collective ## Input Parameter - ***mapping -*** the mapping from local to global indexing ## Output Parameters - ***nproc -*** number of processors that are connected to this one - ***proc -*** neighboring processors - ***numproc -*** number of indices for each subdomain (processor) - ***indices -*** indices of nodes (in local numbering) shared with neighbors (sorted by global numbering) ## Note The user needs to call `ISLocalToGlobalMappingRestoreInfo()` when the data is no longer needed. ## Fortran Usage ```none PetscInt indices[nproc][numprocmax],ierr) ISLocalToGlobalMpngGetInfoSize(ISLocalToGlobalMapping,PetscInt nproc,PetscInt numprocmax,ierr) followed by ISLocalToGlobalMappingGetInfo(ISLocalToGlobalMapping,PetscInt nproc, PetscInt procs[nproc],PetscInt numprocs[nproc], ``` ## Fortran Note There is no `ISLocalToGlobalMappingRestoreInfo()` in Fortran. You must make sure that `procs`[], `numprocs`[] and `indices`[][] are large enough arrays, either by allocating them dynamically or defining static ones large enough. ## See Also [](sec_scatter), `ISLocalToGlobalMappingDestroy()`, `ISLocalToGlobalMappingCreateIS()`, `ISLocalToGlobalMappingCreate()`, `ISLocalToGlobalMappingRestoreInfo()` ## Level advanced ## Location src/vec/is/utils/isltog.c --- [Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/vec/is/utils/isltog.c) [Index of all IS routines](index.md) [Table of Contents for all manual pages](/manualpages/index.md) [Index of all manual pages](/manualpages/singleindex.md)