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 Num
s 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