Scotch Brand 5.1.10 - Manual (Page 40)

6.3.12 gout
Synopsis
gout [input graph file [input geometry file [input mapping file [output
visualization file ]]]] options
Description
The gout program is the graph, matrix, and mapping viewer program. It takes
on input a source graph, its geometry file, and optionally a mapping result file,
and produces a file suitable for display. At the time being, gout can gener-
ate plain and encapsulated PostScript files for the display of adjacency matrix
patterns and the display of planar graphs (although tridimensional objects can
be displayed by means of isometric projection, the display of tridimensional
mappings is not efficient), and Open Inventor files [40] for the interactive
visualization of tridimensional graphs.
In the case of mapping display, the number of mapping pairs contained in the
input mapping file may differ from the number of vertices of the input source
graph; only mapping pairs the source labels of which match labels of source
graph vertices will be taken into account for display. This feature allows the
user to show the result of the mapping of a subgraph drawn on the whole
graph, or else to outline the most important aspects of a mapping by restrict-
ing the display to a limited portion of the graph. For example, Figure 14.b
shows how the result of the mapping of a subgraph of the bidimensional mesh
M
2
(4, 4) onto the complete graph K(2) can be displayed on the whole M
2
(4, 4)
graph, and Figure 14.c shows how the display of the same mapping can be
restricted to a subgraph of the original graph.
Options
-gparameters
Geometry parameters.
n Do not read geometry data. This option can be used in conjunction
with option -om to avoid reading the geometry file when displaying
the pattern of the adjacency matrix associated with the source graph,
since geometry data are not needed in this case. If this option is set,
the geometry file is not read. However, if an output visualization file
name is given in the command line, dummy input geometry file and
input mapping file
names must be specified so that the file argument
count is correct. In this case, use the “-” parameter to take standard
input as a dummy geometry input stream. In practice, the -om and
-gn
options always imply the -mn option.
r For bidimensional geometry only, rotate geometry data by 90 de-
grees, counter-clockwise.
-h Display the program synopsis.
-mn Do not read mapping data, and display the graph without any mapping
information. If this option is set, the mapping file is not read. However, if
an output visualization file name is given in the command line, a dummy
input mapping file
name must be specified so that the file argument count
is correct. In this case, use the “-” parameter to take standard input as
a dummy mapping input stream.
40