HPL_perm man page

HPL_perm — Combine 2 index arrays — Generate the permutation.

Synopsis

#include "hpl.h"
 void HPL_perm( const int N, int * LINDXA, int * LINDXAU, int * IWORK );

Description

HPL_perm combines  two  index  arrays  and generate the corresponding permutation. First, this function computes the inverse of LINDXA, and then combine it with LINDXAU.  Second, in order to be able to perform the permutation in place,  LINDXAU  is overwritten by the sequence of permutation  producing  the  same result.  What we ultimately want to achieve is:  U[LINDXAU[i]] := U[LINDXA[i]] for i in [0..N). After the call to this function,  this in place permutation can be performed by for i in [0..N) swap U[i] with U[LINDXAU[i]].

Arguments

N       (global input)          const int

On entry,  N  specifies the length of the arrays  LINDXA  and LINDXAU. N should be at least zero.

LINDXA  (global input/output)   int *

On entry,  LINDXA  is an array of dimension N  containing the source indexes. On exit,  LINDXA  contains the combined index array.

LINDXAU (global input/output)   int *

On entry,  LINDXAU is an array of dimension N  containing the target indexes.  On exit,  LINDXAU  contains  the sequence of permutation,  that  should be applied  in increasing order to permute the underlying array U in place.

IWORK   (workspace)             int *

On entry, IWORK is a workarray of dimension N.

See Also

HPL_plindx1 (3), HPL_pdlaswp01N (3), HPL_pdlaswp01T (3).

Info

October 26, 2012 HPL 2.1 HPL Library Functions