petsc-3.7.3 2016-08-01
Report Typos and Errors

ISSortPermutation

 calculate the permutation of the indices into a nondecreasing order.

Synopsis

#include "petscis.h"  
#undef  __FUNCT__
#define __FUNCT__ "ISSortPermutation"
PetscErrorCode ISSortPermutation(IS f,PetscBool always,IS *h)
Not collective.

Input arguments

f - IS to sort
always - build the permutation even when f's indices are nondecreasin.

Output argument

h -permutation or NULL, if f is nondecreasing and always == PETSC_TRUE.

Note: Indices in f are unchanged. f[h[i]] is the i-th smallest f index. If always == PETSC_FALSE, an extra check is peformed to see whether the f indices are nondecreasing. h is built on PETSC_COMM_SELF, since the permutation has a local meaning only.

See Also

ISLocalToGlobalMapping, ISSort(), PetscIntSortWithPermutation()

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