1gout(1) Scotch user's manual gout(1)
2
6 gout - output graphics from matrices and graphs
7
9 gout [options] [gfile] [xfile] [mfile] [vfile]
10
13 The gout program creates graphics files of various types, representing
14 the Scotch graph and mapping data which is passed to it.
15 Source graph file gfile can only be a centralized graph file. File
17 xfile stores its associated geometry, whenever necessary. File mfile
18 represents label information attached to each of the graph vertices,
19 for instance the index of the part to which each vertex belongs in the
20 case of a mapping file. File vfile is the output graphics file, the
21 type of which may differ according to the input parameters. When file
22 names are not specified, data is read from standard input and written
23 to standard output. Standard streams can also be explicitly represented
24 by a dash '-'.
25 When the proper libraries have been included at compile time, gtst can
27 directly handle compressed graphs, both as input and output. A stream
28 is treated as compressed whenever its name is postfixed with a com‐
29 pressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The com‐
30 pression formats which can be supported are the bzip2 format ('.bz2'),
31 the gzip format ('.gz'), and the lzma format ('.lzma').
32
34 -h Display some help.
35 -ggeop Geometry parameters, which can be an arbitrary combination of
37 any of the following code letters:
38 n Do not read geometry data, when it is not available or
40 not required, such as when using the -om option.
41 p Permute Y and Z geometry dimensions.
43 r Rotate geometry by 90 degrees in the (X,Y) plane.
45 -h Display some help.
47 -mn Do not read mapping data, when it is not available or not re‐
49 quired.
50 -ooutp Select the output file type and allows to provide additional pa‐
52 rameters between braces and separated by commas:
53 i OpenInventor 3D mesh file, to be viewed by means of pro‐
55 grams such as ivview. Additional parameters for this out‐
56 put file type are:
57 c Color output.
59 g Gray level output.
61 r Remove cut edges.
63 v View cut edges.
65 m PostScript matrix pattern file. Additional parameters for
67 this output file type are:
68 e EPSF-type output.
70 f Full-page output.
72 p PostScript 2D mesh file. This output module was intended
74 for 2D meshes; as a fallback, the Z coordinate is pro‐
75 jected according to isometric perspective rules, but
76 drawings of full 3D objects are most likely to be unread‐
77 able. Additional parameters for this output file type
78 are:
79 c Color output.
81 g Gray level output.
83 e EPSF-type output.
85 f Full-page output.
87 s Short clipping (disks excluded).
89 l Large clipping (disks included).
91 a Avoid displaying disks.
93 d Display disks.
95 r Remove cut edges.
97 v View cut edges.
99 X=rat Maximum x clipping ratio (in [0.0;1.0]).
101 x=rat Minimum x clipping ratio.
103 Y=rat Maximum y clipping ratio.
105 y=rat Minimum y clipping ratio.
107 t Tulip 3D mesh file. Additional parameters for this output
109 file type are:
110 b Black and white output.
112 c Color output.
114 a Avoid displaying disks.
116 d Display disks.
118 r Remove cut edges.
120 v View cut edges.
122 -V Display program version and copyright.
124
126 Build an OpenInventor file of the mapping of graph brol.grf contained
127 in file brol.map. Vertices with no mapping information attached to them
128 will be rendered in white, while distinct colors will be used to repre‐
129 sent the different parts. Cut edges will be removed:
130 $ gout '-oi{r}' brol.grf brol.xyz brol.map brol.iv
132 $ ivview brol.iv
133 Build an OpenInventor file of graph brol.grf without any vertex infor‐
135 mation associated to it. Mapping data are not required and will not be
136 read, but a file name has to be provided, hence the ’-':
137 $ gout -oi -mn brol.grf brol.xyz - brol.iv
139 Output the pattern of matrix brol.grf on the form of a PostScript flat
141 drawing. Geometry and mapping data are not required and will not be
142 read, but file names have to be provided, hence the two '-'s:
143 $ gout -om -gn -mn brol.grf - - brol.ps
145 Output a PostScript 2D drawing of a rectangular portion graph brol.grf,
147 with disks representing mapping data:
148 $ 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
150
154 gmap(1), gout(1), gtst(1).
155 Scotch user's manual.
157
159 Francois Pellegrini <francois.pellegrini@labri.fr>
160 23 November 2019 gout(1)