Scotch Brand 5.1.10 - Manual (Page 86)

7.6.3 SCOTCH graphMapInit
Synopsis
int SCOTCH graphMapInit (const SCOTCH Graph * grafptr,
SCOTCH Mapping * mappptr,
const SCOTCH Arch * archptr,
SCOTCH Num * parttab)
scotchfgraphmapinit (doubleprecision (*) grafdat,
doubleprecision (*) mappdat,
doubleprecision (*) archdat,
integer*num (*) parttab,
integer ierr)
Description
The SCOTCH graphMapInit routine fills the mapping structure pointed to by
mappptr
with all of the data that is passed to it. Thus, all subsequent calls
to ordering routines such as SCOTCH graphMapCompute, using this mapping
structure as parameter, will place mapping results in field parttab.
parttab is the pointer to an array of as many SCOTCH Nums as there are vertices
in the graph pointed to by grafptr, and which will receive the indices of the
vertices of the target architecture pointed to by archptr.
It should be the first function to be called upon a SCOTCH Mapping structure.
When the mapping structure is no longer of use, call function SCOTCH graph
MapExit
to free its internal structures.
Return values
SCOTCH graphMapInit returns 0 if the mapping structure has been success-
fully initialized, and 1 else.
7.6.4 SCOTCH graphMapExit
Synopsis
void SCOTCH graphMapExit (const SCOTCH Graph * grafptr,
SCOTCH Mapping * mappptr)
scotchfgraphmapexit (doubleprecision (*) grafdat,
doubleprecision (*) mappdat)
Description
The SCOTCH graphMapExit function frees the contents of a SCOTCH Mapping
structure previously initialized by SCOTCH graphMapInit. All subsequent calls
to SCOTCH graphMap* routines other than SCOTCH graphMapInit, using this
structure as parameter, may yield unpredictable results.
86