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

Page 121

Advertising
background image

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

Advertising