g05ehf

g05ehf © Numerical Algorithms Group, 2002.

Purpose

G05EHF Pseudo-random permutation of an integer vector

Synopsis

[index,ifail] = g05ehf(index<,ifail>)

Description

 
 The routine permutes the elements of INDEX without inspecting 
 their values. Each of the n! possible permutations of the n 
 values may be regarded as being equiprobable.
 
 If n is 20 or more, it is theoretically impossible that all n! 
 permutations may occur, as n! exceeds the cycle length of G05CAF.
 For practical purposes this is irrelevant, as the time necessary 
 to generate all possible permutations is many millenia.

Parameters

g05ehf

Required Input Arguments:

index (:)                             integer

Optional Input Arguments:                       <Default>

ifail                                 integer  -1

Output Arguments:

index (:)                             integer
ifail                                 integer