Files
ThirdParty-6/scotch_6.0.3/man/man1/gord.1
Henry Weller 1cce60aa78 scotch_6.0.3: Added to the source tree to simplify building OpenFOAM
Recent versions of scotch are rarely available in packaged form for
ready installation on GNU/Linux distributions and so the sources are
generally required.
2016-05-30 21:17:14 +01:00

113 lines
2.8 KiB
Groff
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

." Text automatically generated by txt2man
.TH gord 1 "August 03, 2010" "" "Scotch user's manual"
.SH NAME
\fBgord \fP- compute sparse matrix orderings of graphs
\fB
.SH SYNOPSIS
.nf
.fam C
\fBgord\fP [\fIoptions\fP] [\fIgfile\fP] [\fIofile\fP] [\fIlfile\fP]
.fam T
.fi
.SH DESCRIPTION
The \fBgord\fP program computes, in a sequential way, an ordering of a
Scotch source graph representing the pattern of some symmetric
sparse matrix.
.PP
Source graph file \fIgfile\fP can only be a centralized graph file. The
resulting ordering is stored in file \fIofile\fP. Eventual logging
information (such as the one produced by option \fB-v\fP) is sent to file
\fIlfile\fP. When file names are not specified, data is read from standard
input and written to standard output. Standard streams can also be
explicitely represented by a dash '-'.
.PP
When the proper libraries have been included at compile time, \fBgord\fP
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-c\fPopt
Choose default ordering strategy according to one or
several \fIoptions\fP among:
.RS
.TP
.B
b
enforce load balance as much as possible.
.TP
.B
q
privilege quality over speed (default).
.TP
.B
s
privilege speed over quality.
.TP
.B
t
enforce safety.
.RE
.TP
.B
\fB-h\fP
Display some help.
.TP
.B
\fB-m\fP\fImfile\fP
Save column block mapping data to file \fImfile\fP. Mapping
data specifies, for each vertex, the index of the column
block to which this vertex belongs.
.TP
.B
\fB-o\fP\fIstrat\fP
Use sequential graph ordering strategy \fIstrat\fP (see
Scotch user's manual for more information).
.TP
.B
\fB-t\fP\fItfile\fP
Save partitioning tree data to file \fItfile\fP. Partitioning
tree data specifies, for each vertex, the index of the
first vertex of the parent block of the block to which
the vertex belongs. Altogether with the mapping data
provided in file \fImfile\fP, it allows one to rebuild the
separator tree of the nested dissection process.
.TP
.B
\fB-V\fP
Display program version and copyright.
.TP
.B
\fB-v\fP\fIverb\fP
Set verbose mode to \fIverb\fP. It is a set of one of more
characters which can be:
.RS
.TP
.B
s
strategy information.
.TP
.B
t
timing information.
.SH EXAMPLE
Reorder matrix graph brol.grf and save the resulting ordering to
file brol.ord using the default sequential graph ordering strategy:
.PP
.nf
.fam C
$ gord brol.grf brol.ord
.fam T
.fi
.SH SEE ALSO
\fBdgord\fP(1), \fBgmk_hy\fP(1), \fBgtst\fP(1).
.PP
Scotch user's manual.
.SH AUTHOR
Francois Pellegrini <francois.pellegrini@labri.fr>