NAME

       geo - plot a finite element mesh

SYNOPSIS

               geo options mesh[.geo[.gz]]

DESCRIPTION

       Plot or upgrade a finite element mesh.

EXAMPLES

       Plot a mesh:

               geo square.geo
               geo box.geo
               geo box.geo -full

       Plot a mesh into a file:

               geo square.geo -image-format png

       Convert from a old geo file format to the new one:

               geo -upgrade - < square-old.geo > square.geo

       See  below  for the geo file format scpecification.  The old file format does not contains
       edges and faces connectivity in 3d geometries, or edges  connectivity  in  2d  geometries.
       The  converter  add  it  automatically into the upgraded file format.  Conversely, the old
       file format is usefull when combined with a translator from another file  format  that  do
       not provides edges and faces connectivity.

INPUT FILE SPECIFICATION

       filename
              specifies  the  name  of  the  file  containing  the input mesh.  The ".geo" suffix
              extension is assumed.

       -      read mesh on standard input instead on a file.

       -name  when mesh comes from standard input, the mesh name is  not  known  and  is  set  to
              "output"  by  default.   This  option  allows  to change this default.  Useful when
              dealing with output formats (graphic, format conversion)  that  creates  auxilliary
              files, based on this name.

       -Idir

       -I dir Add  dir to the rheolef file search path.  This mechanism initializes a search path
              given  by  the  environment  variable  `RHEOPATH'.   If  the  environment  variable
              `RHEOPATH' is not set, the default value is the current directory.

       -check Check that element orientation is positive.

INPUT FORMAT OPTIONS

       -if format

       -input-format format
              load  mesh in format file format, instead of plotting it.  Supported output formats
              are: geo, bamg, vtk.  When loading from a file, the corresponding suffix  extension
              is assumed.

RENDER SPECIFICATION

       -gnuplot
              use gnuplot tool.  This is the default.

       -mayavi
              use mayavi tool.

       -paraview
              use paraview tool.

RENDER OPTIONS

       -[no]lattice
              When  using a high order geometry, the lattice inside any element appears.  Default
              is on;

       -subdivide int
              When using a high order geometry, the number of points per  edge  used  to  draw  a
              curved element. Default value is the mesh order.

       -[no]full
              All internal edges appears, for 3d meshes.  Default is off;

       -[no]fill
              Fill mesh faces using light effects, when available.

       -[no]stereo
              Rendering mode suitable for red-blue anaglyph 3D stereoscopic glasses.  Option only
              available with mayavi or paraview.

       -[no]shrink
              shrink elements (with paraview only).

       -[no]cut
              cut by plane and clip (with mayavi or paraview only).

       -[no]label
              Show or hide labels, boundary domains and various annotations.  By default, domains
              are showed with a specific color.

OUTPUT FILE FORMAT OPTIONS

       -geo   output  mesh on standard output stream in geo text file format, instead of plotting
              it.

       -upgrade
              Convert from a old geo file format to the new one.

       -gmsh  output mesh on standard output stream in gmsh text file format, instead of plotting
              it.

       -image-format string
              The argument is any valid image format, such as bitmap png, jpg, gif, tif, ppm, bmp
              or vectorial pdf, eps, ps, svg image file formats.  this option can  be  used  with
              the  paraview  and  the gnuplot renders.  The output file is e.g. basename.png when
              basename is the name of the mesh, or can be set with the -name option.

       -resolution int int
              The argument is a couple of sizes, for the image resolution.  This  option  can  be
              used  together  with  the  -image-format for any of the bitmap image formats.  This
              option requires the paraview render.

OTHERS OPTIONS

       -add-boundary
              check for a domain named "boundary"; If this domain does not  exists,  extract  the
              boundary of the geometry and append it to the domain list.  This command is usefull
              for mesh converted from generators, as bamg, that cannot have more than one  domain
              specification per boundary edge.

       -rz

       -zr    Specifies the coordinate system. Usefull when converting from bamg or gmsh format,.

       -verbose
              print  messages  related to graphic files created and command system calls (this is
              the default).

       -noverbose
              does not print previous messages.

       -clean clear temporary graphic files (this is the default).

       -noclean
              does not clear temporary graphic files.

       -execute
              execute graphic command (this is the default).

       -noexecute
              does not execute graphic command. Generates only graphic files. This is usefull  in
              conjuction with the "-noclean" command.

       -check

       -dump  used for debug purpose.

INQUIRE OPTIONS

       -size

       -n-vertex
              print the mesh size, i.e. the number of elements (resp. of vertices) and then exit.

       -hmin

       -hmax  print the smallest (resp. largest) edge length and then exit.

       -min-element-measure

       -max-element-measure
              print the smallest (resp. largest) element measure and then exit.

GEO FILE FORMAT

       TODO