13 miscellaneous routines, 14 metis compatibility library – Scotch Brand 5.1.10 User Manual
Page 121

The SCOTCH errorProg function is designed to be called at the beginning of a
program or of a portion of code to identify the place where subsequent errors
take place. This routine is not reentrant, as it is only a minor help function.
It is defined in libscotcherr.a and is used by the standalone programs of
the Scotch distribution.
7.13
Miscellaneous routines
7.13.1
SCOTCH randomReset
Synopsis
void SCOTCH randomReset (void)
scotchfrandomreset ()
Description
The SCOTCH randomReset routine resets the seed of the pseudo-random gen-
erator used by the graph partitioning routines of the libScotch library. Two
consecutive calls to the same libScotch partitioning routines, and separated
by a call to SCOTCH randomReset, will always yield the same results, as if the
equivalent standalone Scotch programs were used twice, independently, to
compute the results.
7.14
MeTiS compatibility library
The MeTiS compatibility library provides stubs which redirect some calls to MeTiS
routines to the corresponding Scotch counterparts. In order to use this feature,
the only thing to do is to re-link the existing software with the libscotchmetis
library, and eventually with the original MeTiS library if the software uses MeTiS
routines which do not need to have Scotch equivalents, such as graph transforma-
tion routines. In that latter case, the “-lscotchmetis” argument must be placed
before the “-lmetis” one (and of course before the “-lscotch” one too), so that
routines that are redefined by Scotch are chosen instead of their MeTiS counter-
part. When no other MeTiS routines than the ones redefined by Scotch are used,
the “-lmetis” argument can be omitted. See Section 9 for an example.
7.14.1
METIS EdgeND
Synopsis
void METIS EdgeND (const int * const
n,
const int * const
xadj,
const int * const
adjncy,
const int * const
numflag,
const int * const
options,
int * const
perm,
int * const
iperm)
121