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