geo(1) 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;
-[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

-subdivide int
Subdivide each edge in k parts, where k is the prescribed argument. The new vertices are numbered so that they coincide with the Pk Lagrange nodes. It can be combined with the -geo option to get the subdivided mesh. In that case, default value is 1, i.e. no subdividing. It can also be combined with a graphic option, such that -gnuplot or paraview: When dealing with a curved high order geometry, k corresponds to the number of points per edge used to draw a curved element. In that case, this option is activated by default and value is the curved mesh order.
-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