gout(1) | Scotch user's manual | gout(1) |
gout - output graphics from matrices and graphs
gout [options] [gfile] [xfile] [mfile] [vfile]
The gout program creates graphics files of various types, representing the Scotch graph and mapping data which is passed to it.
Source graph file gfile can only be a centralized graph file. File xfile stores its associated geometry, whenever necessary. File mfile represents label information attached to each of the graph vertices, for instance the index of the part to which each vertex belongs in the case of a mapping file. File vfile is the output graphics file, the type of which may differ according to the input parameters. When file names are not specified, data is read from standard input and written to standard output. Standard streams can also be explicitly represented by a dash '-'.
When the proper libraries have been included at compile time, gtst can directly handle compressed graphs, both as input and output. A stream is treated as compressed whenever its name is postfixed with a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The compression formats which can be supported are the bzip2 format ('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on input only).
Build an OpenInventor file of the mapping of graph brol.grf contained in file brol.map. Vertices with no mapping information attached to them will be rendered in white, while distinct colors will be used to represent the different parts. Cut edges will be removed:
Build an OpenInventor file of graph brol.grf without any vertex information associated to it. Mapping data are not required and will not be read, but a file name has to be provided, hence the '-':
$ gout '-oi{r}' brol.grf brol.xyz brol.map brol.iv
$ ivview brol.iv
Output the pattern of matrix brol.grf on the form of a PostScript flat drawing. Geometry and mapping data are not required and will not be read, but file names have to be provided, hence the two '-'s:
$ gout -oi -mn brol.grf brol.xyz - brol.iv
Output a PostScript 2D drawing of a rectangular portion graph brol.grf, with disks representing mapping data:
$ gout -om -gn -mn brol.grf - - brol.ps
$ gout '-op{c,e,d,x=0.3,X=0.6,y=0.2,Y=0.5}' brol.grf brol.xyz brol.map brol.ps
Scotch user's manual.
Francois Pellegrini <francois.pellegrini@labri.fr>
August 3, 2010 |