1gout(1)                      Scotch user's manual                      gout(1)
2
3
4

NAME

6       gout - output graphics from matrices and graphs
7

SYNOPSIS

9       gout [options] [gfile] [xfile] [mfile] [vfile]
10
11

DESCRIPTION

13       The  gout program creates graphics files of various types, representing
14       the Scotch graph and mapping data which is passed to it.
15
16       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
26       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

OPTIONS

34       -h     Display some help.
35
36       -ggeop Geometry  parameters,  which  can be an arbitrary combination of
37              any of the following code letters:
38
39              n      Do not read geometry data, when it is  not  available  or
40                     not required, such as when using the -om option.
41
42              p      Permute Y and Z geometry dimensions.
43
44              r      Rotate geometry by 90 degrees in the (X,Y) plane.
45
46       -h     Display some help.
47
48       -mn    Do  not  read  mapping data, when it is not available or not re‐
49              quired.
50
51       -ooutp Select the output file type and allows to provide additional pa‐
52              rameters between braces and separated by commas:
53
54              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
58                     c      Color output.
59
60                     g      Gray level output.
61
62                     r      Remove cut edges.
63
64                     v      View cut edges.
65
66              m      PostScript matrix pattern file. Additional parameters for
67                     this output file type are:
68
69                     e      EPSF-type output.
70
71                     f      Full-page output.
72
73              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
80                     c      Color output.
81
82                     g      Gray level output.
83
84                     e      EPSF-type output.
85
86                     f      Full-page output.
87
88                     s      Short clipping (disks excluded).
89
90                     l      Large clipping (disks included).
91
92                     a      Avoid displaying disks.
93
94                     d      Display disks.
95
96                     r      Remove cut edges.
97
98                     v      View cut edges.
99
100                     X=rat  Maximum x clipping ratio (in [0.0;1.0]).
101
102                     x=rat  Minimum x clipping ratio.
103
104                     Y=rat  Maximum y clipping ratio.
105
106                     y=rat  Minimum y clipping ratio.
107
108              t      Tulip 3D mesh file. Additional parameters for this output
109                     file type are:
110
111                     b      Black and white output.
112
113                     c      Color output.
114
115                     a      Avoid displaying disks.
116
117                     d      Display disks.
118
119                     r      Remove cut edges.
120
121                     v      View cut edges.
122
123       -V     Display program version and copyright.
124

EXAMPLES

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
131           $ gout '-oi{r}' brol.grf brol.xyz brol.map brol.iv
132           $ ivview brol.iv
133
134       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
138           $ gout -oi -mn brol.grf brol.xyz - brol.iv
139
140       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
144           $ gout -om -gn -mn brol.grf - - brol.ps
145
146       Output a PostScript 2D drawing of a rectangular portion graph brol.grf,
147       with disks representing mapping data:
148
149           $ 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
151
152

SEE ALSO

154       gmap(1), gout(1), gtst(1).
155
156       Scotch user's manual.
157

AUTHOR

159       Francois Pellegrini <francois.pellegrini@labri.fr>
160
161
162
163                               23 November 2019                        gout(1)
Impressum