ipperm.f
SUBROUTINE IPPERM (IX, N, IPERM, IER)
C***BEGIN PROLOGUE IPPERM
C***PURPOSE Rearrange a given array according to a prescribed
C permutation vector.
C***LIBRARY SLATEC
C***CATEGORY N8
C***TYPE INTEGER (SPPERM-S, DPPERM-D, IPPERM-I, HPPERM-H)
C***KEYWORDS APPLICATION OF PERMUTATION TO DATA VECTOR
C***AUTHOR McClain, M. A., (NIST)
C Rhoads, G. S., (NBS)
C***DESCRIPTION
C
C IPPERM rearranges the data vector IX according to the
C permutation IPERM: IX(I) <--- IX(IPERM(I)). IPERM could come
C from one of the sorting routines IPSORT, SPSORT, DPSORT or
C HPSORT.
C
C Description of Parameters
C IX - input/output -- integer array of values to be rearranged.
C N - input -- number of values in integer array IX.
C IPERM - input -- permutation vector.
C IER - output -- error indicator:
C = 0 if no error,
C = 1 if N is zero or negative,
C = 2 if IPERM is not a valid permutation.
C
C***REFERENCES (NONE)
C***ROUTINES CALLED XERMSG
C***REVISION HISTORY (YYMMDD)
C 900618 DATE WRITTEN
C 920507 Modified by M. McClain to revise prologue text.
C***END PROLOGUE IPPERM