petsc-3.12.5 2020-03-29
Report Typos and Errors

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 on ISLocalToGlobalMapping

Input Parameters

mapping -the mapping from local to global indexing

Output Parameter

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)

Notes: The user needs to call ISLocalToGlobalMappingRestoreInfo when the data is no longer needed.

Fortran Usage

       ISLocalToGlobalMpngGetInfoSize(ISLocalToGlobalMapping,PetscInt nproc,PetscInt numprocmax,ierr) followed by
       ISLocalToGlobalMappingGetInfo(ISLocalToGlobalMapping,PetscInt nproc, PetscInt procs[nproc],PetscInt numprocs[nproc],
PetscInt indices[nproc][numprocmax],ierr) 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

ISLocalToGlobalMappingDestroy(), ISLocalToGlobalMappingCreateIS(), ISLocalToGlobalMappingCreate(),
ISLocalToGlobalMappingRestoreInfo()

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