NAME

       gout - output graphics from matrices and graphs

SYNOPSIS

       gout [options] [gfile] [xfile] [mfile] [vfile]

DESCRIPTION

       The  gout program creates graphics files of various types, representing the Scotch graph and mapping data
       which is passed to it.

       Source graph file gfile can only be a centralized graph file. File xfile stores its associated  geometry,
       whenever  necessary.  File mfile 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 vfile  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 '-'.

       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).

OPTIONS

       -h     Display some help.

       -ggeop Geometry parameters, which can be an arbitrary combination of any of the following code letters:

              n      Do not read geometry data, when it is not available or not required, such as when using the
                     -om option.

              p      Permute Y and Z geometry dimensions.

              r      Rotate geometry by 90 degrees in the (X,Y) plane.

       -h     Display some help.

       -mn    Do not read mapping data, when it is not available or not required.

       -ooutp Select the output file type and  allows  to  provide  additional  parameters  between  braces  and
              separated by commas:

              i      OpenInventor  3D  mesh  file,  to be viewed by means of programs such as ivview. Additional
                     parameters for this output file type are:

                     c      Color output.

                     g      Gray level output.

                     r      Remove cut edges.

                     v      View cut edges.

              m      PostScript matrix pattern file. Additional parameters for this output file type are:

                     e      EPSF-type output.

                     f      Full-page output.

              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:

                     c      Color output.

                     g      Gray level output.

                     e      EPSF-type output.

                     f      Full-page output.

                     s      Short clipping (disks excluded).

                     l      Large clipping (disks included).

                     a      Avoid displaying disks.

                     d      Display disks.

                     r      Remove cut edges.

                     v      View cut edges.

                     X=rat  Maximum x clipping ratio (in [0.0;1.0]).

                     x=rat  Minimum x clipping ratio.

                     Y=rat  Maximum y clipping ratio.

                     y=rat  Minimum y clipping ratio.

              t      Tulip 3D mesh file. Additional parameters for this output file type are:

                     b      Black and white output.

                     c      Color output.

                     a      Avoid displaying disks.

                     d      Display disks.

                     r      Remove cut edges.

                     v      View cut edges.

       -V     Display program version and copyright.

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:

           $ gout '-oi{r}' brol.grf brol.xyz brol.map brol.iv
           $ ivview brol.iv

       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 '-':

           $ gout -oi -mn brol.grf brol.xyz - brol.iv

       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:

           $ gout -om -gn -mn brol.grf - - brol.ps

       Output  a  PostScript 2D drawing of a rectangular portion graph brol.grf, with disks representing mapping
       data:

           $ 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

SEE ALSO

       gmap(1), gout(1), gtst(1).

       Scotch user's manual.

AUTHOR

       Francois Pellegrini <francois.pellegrini@labri.fr>

                                                 August 03, 2010                                         gout(1)