Scotch Brand 5.1.10 - Manual (Page 93)

resulting mapping file can be used by the gout program (see Section 6.3.12)
to produce pictures showing the different separators and blocks.
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
mapping file.
Return values
SCOTCH graphOrderSaveMap returns 0 if the ordering structure has been suc-
cessfully written to stream, and 1 else.
7.7.7 SCOTCH graphOrderSaveTree
Synopsis
int SCOTCH graphOrderSaveTree (const SCOTCH Graph * grafptr,
const SCOTCH Ordering * ordeptr,
FILE * stream)
scotchfgraphordersavetree (doubleprecision (*) grafdat,
doubleprecision (*) ordedat,
integer fildes,
integer ierr)
Description
The SCOTCH graphOrderSaveTree routine saves the tree hierarchy informa-
tion associated with the SCOTCH Ordering structure pointed to by ordeptr
to stream stream.
The format of the tree output file resembles the one of a mapping or ordering
file: it is made up of as many lines as there are vertices in the ordering. Each
of these lines holds two integer numbers. The first one is the index or the
label of the vertex, and the second one is the index of its parent node in the
separators tree, or −1 if the vertex belongs to a root node.
Fortran users must use the PXFFILENO or FNUM functions to obtain the number
of the Unix file descriptor fildes associated with the logical unit of the tree
mapping file.
Return values
SCOTCH graphOrderSaveTree returns 0 if the separators tree structure has
been successfully written to stream, and 1 else.
7.7.8 SCOTCH graphOrderCheck
Synopsis
int SCOTCH graphOrderCheck (const SCOTCH Graph * grafptr,
const SCOTCH Ordering * ordeptr)
scotchfgraphordercheck (doubleprecision (*) grafdat,
doubleprecision (*) ordedat,
integer ierr)
93