(3M) Calculator User Manual

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 val ues
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