File: gout.1

package info (click to toggle)
scotch 6.0.6-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 17,316 kB
  • sloc: ansic: 77,340; makefile: 3,667; yacc: 622; lex: 264; sh: 119; fortran: 90
file content (267 lines) | stat: -rw-r--r-- 4,928 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
." Text automatically generated by txt2man
.TH gout 1 "August 03, 2010" "" "Scotch user's manual"
.SH NAME
\fBgout \fP- output graphics from matrices and graphs
\fB
.SH SYNOPSIS
.nf
.fam C
\fBgout\fP [\fIoptions\fP] [\fIgfile\fP] [\fIxfile\fP] [\fImfile\fP] [\fIvfile\fP]
.fam T
.fi
.SH DESCRIPTION
The \fBgout\fP program creates graphics files of various types,
representing the Scotch graph and mapping data which is passed to it.
.PP
Source graph file \fIgfile\fP can only be a centralized graph file. File
\fIxfile\fP stores its associated geometry, whenever necessary. File
\fImfile\fP 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 \fIvfile\fP 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 '-'.
.PP
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).
.SH OPTIONS
.TP
.B
\fB-h\fP
Display some help.
.TP
.B
\fB-g\fP\fIgeop\fP
Geometry parameters, which can be an arbitrary
combination of any of the following code letters:
.RS
.TP
.B
n
Do not read geometry data, when it is not
available or not required, such as when using
the \fB-om\fP option.
.TP
.B
p
Permute Y and Z geometry dimensions.
.TP
.B
r
Rotate geometry by 90 degrees in the (X,Y) plane.
.RE
.TP
.B
\fB-h\fP
Display some help.
.TP
.B
\fB-mn\fP
Do not read mapping data, when it is not available or
not required.
.TP
.B
\fB-o\fP\fIoutp\fP
Select the output file type and allows to provide
additional parameters between braces and separated
by commas:
.RS
.TP
.B
i
OpenInventor 3D mesh file, to be viewed by means of
programs such as \fBivview\fP. Additional parameters for
this output file type are:
.RS
.TP
.B
c
Color output.
.TP
.B
g
Gray level output.
.TP
.B
r
Remove cut edges.
.TP
.B
v
View cut edges.
.RE
.TP
.B
m
PostScript matrix pattern file. Additional parameters
for this output file type are:
.RS
.TP
.B
e
EPSF-type output.
.TP
.B
f
Full-page output.
.RE
.TP
.B
p
PostScript 2D mesh file. This output module was
intended for 2D meshes; as a fallback, the Z
coordinate is projected according to isometric
perspective rules, but drawings of full 3D objects
are most likely to be unreadable. Additional parameters
for this output file type are:
.RS
.TP
.B
c
Color output.
.TP
.B
g
Gray level output.
.TP
.B
e
EPSF-type output.
.TP
.B
f
Full-page output.
.TP
.B
s
Short clipping (disks excluded).
.TP
.B
l
Large clipping (disks included).
.TP
.B
a
Avoid displaying disks.
.TP
.B
d
Display disks.
.TP
.B
r
Remove cut edges.
.TP
.B
v
View cut edges.
.TP
.B
X=\fIrat\fP
Maximum x clipping ratio (in [0.0;1.0]).
.TP
.B
x=\fIrat\fP
Minimum x clipping ratio.
.TP
.B
Y=\fIrat\fP
Maximum y clipping ratio.
.TP
.B
y=\fIrat\fP
Minimum y clipping ratio.
.RE
.TP
.B
t
Tulip 3D mesh file. Additional parameters
for this output file type are:
.RS
.TP
.B
b
Black and white output.
.TP
.B
c
Color output.
.TP
.B
a
Avoid displaying disks.
.TP
.B
d
Display disks.
.TP
.B
r
Remove cut edges.
.TP
.B
v
View cut edges.
.RE
.RE
.TP
.B
\fB-V\fP
Display program version and copyright.
.SH EXAMPLES
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:
.PP
.nf
.fam C
    $ gout '-oi{r}' brol.grf brol.xyz brol.map brol.iv
    $ ivview brol.iv

.fam T
.fi
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 '-':
.PP
.nf
.fam C
    $ gout -oi -mn brol.grf brol.xyz - brol.iv

.fam T
.fi
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:
.PP
.nf
.fam C
    $ gout -om -gn -mn brol.grf - - brol.ps

.fam T
.fi
Output a PostScript 2D drawing of a rectangular portion graph
brol.grf, with disks representing mapping data:
.PP
.nf
.fam C
    $ 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


.fam T
.fi
.SH SEE ALSO
\fBgmap\fP(1), \fBgout\fP(1), \fBgtst\fP(1).
.PP
Scotch user's manual.
.SH AUTHOR
Francois Pellegrini <francois.pellegrini@labri.fr>