Scotch Brand 5.1.10 User Manual

Page 72

Advertising
background image

string pointers, the scotchfarchname routine takes as second and third pa-
rameters a character() array to be filled with the name of the architecture,
and the integer size of the array, respectively. If the array is of sufficient
size, a trailing nul character is appended to the string to materialize the end
of the string (this is the C style of handling character strings).

Return values

SCOTCH archName

returns a non-null character pointer that points to a null-

terminated string describing the type of the architecture.

7.4.6

SCOTCH archSize

Synopsis

SCOTCH Num SCOTCH archSize (const SCOTCH Arch *

archptr)

scotchfarchsize (doubleprecision (*)

archdat,

integer*num

archnbr)

Description

The SCOTCH archSize function returns the number of nodes of the given tar-
get architecture. The Fortran routine has a second parameter, of integer type,
which is set on return with the number of nodes of the target architecture.

Return values

SCOTCH archSize

returns the number of nodes of the target architecture.

7.4.7

SCOTCH archBuild

Synopsis

int SCOTCH archBuild (SCOTCH Arch *

archptr,

const SCOTCH Graph *

grafptr,

const SCOTCH Num

listnbr,

const SCOTCH Num *

listtab,

const SCOTCH Strat *

straptr)

scotchfarchbuild (doubleprecision (*)

archdat,

doubleprecision (*)

grafdat,

integer*num

listnbr,

integer*num (*)

listtab,

doubleprecision (*)

stradat,

integer

ierr)

Description

The SCOTCH archBuild routine fills the architecture structure pointed to by
archptr

with the decomposition-defined target architecture computed by ap-

plying the graph bipartitioning strategy pointed to by straptr to the archi-
tecture graph pointed to by grafptr.

72

Advertising