Scotch Brand 5.1.10 - Manual (Page 108)

Description
The SCOTCH meshOrderCompute routine computes a block ordering of the
mesh structure pointed to by grafptr, using the mapping strategy pointed
to by stratptr, and stores its result in the ordering structure pointed to by
ordeptr
.
On return, the ordering structure holds a block ordering of the given mesh
(see section 7.9.2 for a description of the ordering fields).
Return values
SCOTCH meshOrderCompute returns 0 if the ordering has been successfully
computed, and 1 else. In this latter case, the ordering arrays may however
have been partially or completely filled, but their contents are not significant.
7.10 Strategy handling routines
7.10.1 SCOTCH stratInit
Synopsis
int SCOTCH stratInit (SCOTCH Strat * straptr)
scotchfstratinit (doubleprecision (*) stradat,
integer ierr)
Description
The SCOTCH stratInit function initializes a SCOTCH Strat structure so as to
make it suitable for future operations. It should be the first function to be
called upon a SCOTCH Strat structure. When the strategy data is no longer
of use, call function SCOTCH stratExit to free its internal structures.
Return values
SCOTCH stratInit returns 0 if the strategy structure has been successfully
initialized, and 1 else.
7.10.2 SCOTCH stratExit
Synopsis
void SCOTCH stratExit (SCOTCH Strat * archptr)
scotchfstratexit (doubleprecision (*) stradat)
Description
The SCOTCH stratExit function frees the contents of a SCOTCH Strat struc-
ture previously initialized by SCOTCH stratInit. All subsequent calls to
SCOTCH strat
routines other than SCOTCH stratInit, using this structure
as parameter, may yield unpredictable results.
108