Scotch Brand 5.1.10 User Manual

Page 91

Advertising
background image

vertnbr

+ 1, and treetab is the array holding the structure of the separators

tree, of size vertnbr. See the above manual page of SCOTCH graphOrder, as
well as section 7.2.5, for an explanation of the semantics of all of these fields.

The SCOTCH graphOrderInit routine should be the first function to be called
upon a SCOTCH Ordering structure for ordering graphs. When the ordering
structure is no longer of use, the SCOTCH graphOrderExit function must be
called, in order to to free its internal structures.

Return values

SCOTCH graphOrderInit

returns 0 if the ordering structure has been success-

fully initialized, and 1 else.

7.7.3

SCOTCH graphOrderExit

Synopsis

void SCOTCH graphOrderExit (const SCOTCH Graph *

grafptr,

SCOTCH Ordering *

ordeptr)

scotchfgraphorderexit (doubleprecision (*)

grafdat,

doubleprecision (*)

ordedat)

Description

The SCOTCH graphOrderExit function frees the contents of a SCOTCH
Ordering

structure previously initialized by SCOTCH graphOrderInit. All

subsequent calls to SCOTCH graphOrder* routines other than SCOTCH graph
OrderInit

, using this structure as parameter, may yield unpredictable results.

7.7.4

SCOTCH graphOrderLoad

Synopsis

int SCOTCH graphOrderLoad (const SCOTCH Graph *

grafptr,

SCOTCH Ordering *

ordeptr,

FILE *

stream)

scotchfgraphorderload (doubleprecision (*)

grafdat,

doubleprecision (*)

ordedat,

integer

fildes,

integer

ierr)

Description

The SCOTCH graphOrderLoad routine fills the SCOTCH Ordering structure
pointed to by ordeptr with the ordering data available in the Scotch order-
ing format (see section 5.6) from stream stream.

Fortran users must use the PXFFILENO or FNUM functions to obtain the num-
ber of the Unix file descriptor fildes associated with the logical unit of the
ordering file.

91

Advertising