Scotch Brand 5.1.10 User Manual

Page 88

Advertising
background image

7.6.7

SCOTCH graphMapCompute

Synopsis

int SCOTCH graphMapCompute (const SCOTCH Graph *

grafptr,

SCOTCH Mapping *

mappptr,

const SCOTCH Strat *

straptr)

scotchfgraphmapcompute (doubleprecision (*)

grafdat,

doubleprecision (*)

mappdat,

doubleprecision (*)

stradat,

integer

ierr)

Description

The SCOTCH graphMapCompute routine computes a mapping on the given
SCOTCH Mapping

structure pointed to by mappptr using the mapping strategy

pointed to by stratptr.

On return, every cell of the mapping array (see section 7.6.3) holds the number
of the target vertex to which the corresponding source vertex is mapped. The
numbering of target values is not based: target vertices are numbered from 0
to the number of target vertices, minus 1.

Return values

SCOTCH graphMapCompute

returns 0 if the mapping has been successfully com-

puted, and 1 else. In this latter case, the mapping array may however have
been partially or completely filled, but its content is not significant.

7.6.8

SCOTCH graphMapView

Synopsis

int SCOTCH graphMapView (const SCOTCH Graph *

grafptr,

const SCOTCH Mapping *

mappptr,

FILE *

stream)

scotchfgraphmapview (doubleprecision (*)

grafdat,

doubleprecision (*)

mappdat,

integer

fildes,

integer

ierr)

Description

The SCOTCH mapView routine summarizes statistical information on the map-
ping pointed to by mappptr (load of target processors, number of neighboring
domains, average dilation and expansion, edge cut size, distribution of edge
dilations), and prints these results to stream stream.

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 output
data file.

88

Advertising