← Back to branch summary

~ubuntu-branches/ubuntu/trusty/scotch/trusty-proposed

« back to all changes in this revision

Viewing changes to man/man1/gmap.1

  • Committer: Bazaar Package Importer
  • Author(s): "Adam C. Powell, IV", Christophe Trophime, Adam C. Powell, IV
  • Date: 2010-12-29 13:07:19 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20101229130719-jwalolw5d6av6wqx
Tags: 5.1.11.dfsg-1
[Christophe Trophime]
* New upstream release
* Forward-ported patches to version 5.1.10b.
* Install scotch headers properly.
* Fix chrpath commands in debian/rules.
* Fix (pt)scotch library install paths.
* Fix lintian errors and warnings.

[Adam C. Powell, IV]
* Forward-ported patches to version 5.1.11.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/man1/gmap.1
1
1
." Text automatically generated by txt2man
2
 
.TH gmap 1 "September 08, 2008" "" "Scotch user's manual"
 
2
.TH gmap 1 "August 03, 2010" "" "Scotch user's manual"
3
3
.SH NAME
4
4
\fBgmap, gpart \fP- compute static mappings and partitions sequentially
5
5
\fB
31
31
When the proper libraries have been included at compile time, \fBgmap\fP
32
32
and \fBgpart\fP can directly handle compressed graphs, both as input and
33
33
output. A stream is treated as compressed whenever its name is
34
 
postfixed with a compressed file extension, such as in
35
 
'brol.grf.bz2' or '-.gz'. The compression formats which can be
 
34
postfixed with a compressed file extension, such as
 
35
in 'brol.grf.bz2' or '-.gz'. The compression formats which can be
36
36
supported are the bzip2 format ('.bz2'), the gzip format ('.gz'),
37
37
and the lzma format ('.lzma', on input only).
38
38
.SH OPTIONS
39
39
.TP
40
40
.B
 
41
\fB-c\fPopt
 
42
Choose default mapping strategy according to one or
 
43
several \fIoptions\fP among:
 
44
.RS
 
45
.TP
 
46
.B
 
47
b
 
48
enforce load balance as much as possible.
 
49
.TP
 
50
.B
 
51
q
 
52
privilege quality over speed (default).
 
53
.TP
 
54
.B
 
55
s
 
56
privilege speed over quality.
 
57
.TP
 
58
.B
 
59
t
 
60
enforce safety.
 
61
.RE
 
62
.TP
 
63
.B
41
64
\fB-h\fP
42
65
Display some help.
43
66
.TP
90
113
hypercube of dimension \fIdim\fP.
91
114
.TP
92
115
.B
93
 
leaf \fIhgt\fP \fIclu\fP \fIwgt\fP
 
116
leaf \fIhgt\fP \fIn0\fP \fIw0\fP \.\.\. \fInhgt-1\fP \fIwhgt-1\fP
94
117
tree-leaf graph of height \fIhgt\fP
95
 
with 2^\fIhgt\fP vertices, \fIclu\fP levels
96
 
before reaching the processing
97
 
elements, and an inter-cluster
98
 
link weight of \fIwgt\fP.
 
118
with (\fIn0\fP times \fIn1\fP times \.\.\. \fInhgt-1\fP)
 
119
vertices, with inter-cluster link
 
120
weights of \fIw0\fP, \fIw1\fP, \.\.\. \fIwhgt-1\fP.
99
121
.TP
100
122
.B
101
123
mesh2D \fIdimX\fP \fIdimY\fP
129
151
lines. In most cases, since full mappings are requested, the number
130
152
of lines is equal to the number of vertices in the source graph.
131
153
.SH EXAMPLES
132
 
Run \fBgpart\fP to compute a partition into 7 parts of graph brol.grf and
133
 
save the resulting ordering to file brol.map.
 
154
Run \fBgpart\fP to compute a partition into 7 parts of graph 'brol.grf' and
 
155
save the resulting ordering to file 'brol.map'.
134
156
.PP
135
157
.nf
136
158
.fam C
137
 
      $ gpart 7 brol.grf brol.map
 
159
    $ gpart 7 brol.grf brol.map
138
160
 
139
161
.fam T
140
162
.fi
141
163
Run \fBgmap\fP to compute a partition, into 3 parts of respective weights
142
 
1, 2 and 4, of graph brol.grf and save the resulting mapping to
143
 
file brol.map. The dash '-' standard file name is used so that the
 
164
1, 2 and 4, of graph 'brol.grf' and save the resulting mapping to
 
165
file 'brol.map'. The dash '-' standard file name is used so that the
144
166
target architecture description is read from the standard input,
145
167
through the pipe, as provided by the 'echo' shell command.
146
168
.PP
147
169
.nf
148
170
.fam C
149
 
     $ echo "cmpltw 3 1 2 4" | gmap brol.grf - brol.map
 
171
    $ echo "cmpltw 3 1 2 4" | gmap brol.grf - brol.map
150
172
 
151
173
.fam T
152
174
.fi