ISSortPermutation#

calculate the permutation of the indices into a nondecreasing order.

Synopsis#

#include "petscis.h"  
PetscErrorCode ISSortPermutation(IS f, PetscBool always, IS *h)

Not Collective

Input Parameters#

f - IS to sort
always - build the permutation even when f’s indices are nondecreasing.

Output Parameter#

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

Notes#

Indices in f are unchanged. f[h[i]] is the i-th smallest f index.

If always == PETSC_FALSE, an extra check is performed to see whether the f indices are nondecreasing. h is built on PETSC_COMM_SELF, since the permutation has a local meaning only.

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