-- plot a field
field options filename[.field[.gz]]
Read and output a finite element field from file.
field square.field -bw
- specifies the name of the file containing the input field.
- read field on standard input instead on a file.
- when the field comes from standard input, the file base
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
- -I dir
- Add dir to the rheolef file search path. This option
is usefull e.g. when the mesh .geo and the .field fikes are in different
directories. 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.
- -catchmark string
- Jump accross the file to the specifield string.
Label start at the begining of a line, preceded by a ` #' mark (see
- output field on standard output stream in Rheolef ascii
(field or geo) text file format.
- output field on standard output stream in gmsh text file
- output field on standard output stream in gmsh-pos text
file format, suitable for mesh adaptation purpose.
- output field on standard output stream in bamg-bb text file
format, suitable for mesh adaptation purpose.
- -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
- -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
- print the min (resp. max) value of the scalar field and
- use gnuplot tool. This is the default in one and two
- use mayavi tool. This is the default for
- use paraview tool. This is feature is under
- Use (color/gray scale/black and white) rendering. Color
rendering is the default.
- Show or hide title, color bar and various anotations.
Default is to show labels.
- For two dimensional field, represent values as elevation in
the third dimension. The default is no evelation.
- -scale float
- applies a multiplicative factor to the field. This is
useful e.g. in conjonction with the elevation option. The default
value is 1.
- Rendering mode suitable for red-blue anaglyph 3D
stereoscopic glasses. This option is only available with mayavi and
- isoline intervals are filled with color. This is the
- draw isolines by using lines.
- for 3D data, render values using a colored translucid
volume. This option requires the paraview code.
- Cut by a specified plane. The cutting plane is specified by
its origin point and normal vector. This option requires the
- -origin float [float
- set the origin of the cutting plane. Default is (0.5, 0.5,
- -normal float [float
- set the normal of the cutting plane. Default is (1, 0,
- -iso [float]
- do draw 3d isosurface. When the optional float is not
provided, a median value is used. This option requires the paraview
- do not draw isosurface.
- -n-iso int
- For 2D visualizations, the isovalue table contains
regularly spaced values from fmin to fmax, the bounds of the field.
- -proj approx
- Convert all selected fields to approximation approx
by using a L2 projection.
- Convert all selected fields to Pk-continuous approximation
by using a L2 projection.
- Force P1 approximation for L2 projection and use a lumped
mass matrix for it.
- -round [float]
- Round the input up to the specifiexd precision. This
option, combined with -field, leads to a round filter. Usefull for
non-regression test purpose, in order to compare numerical results between
files with a limited precision, since the full double precision is
- -n-iso-negative int
- The isovalue table is splitted into negatives and positives
values. Assume there is n_iso=15 isolines: if 4 is requested by this
option, then, there will be 4 negatives isolines, regularly spaced from
fmin to 0 and 11=15-4 positive isolines, regularly spaced from 0 to fmax.
This option is usefull when plotting e.g. vorticity or stream functions,
where the sign of the field is representative.
- -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.
- Render vector-valued fields as deformed mesh using
mayavi, paraview or gnuplot. This is the default
vector field representation.
- Render vector-valued fields as arrows using mayavi
- -comp int
- -comp string
- Extract the i-th component of a vector-valued field. For a
tensor-valued field, indexing components as "00",
"01", "11"... is supported.
- -domain name
- Reduce the visualization to the specified domain.
- print messages related to graphic files created and command
system calls (this is the default).
- does not print previous messages.
- clear temporary graphic files (this is the default).
- does not clear temporary graphic files.
- execute graphic command (this is the default).
- does not execute graphic command. Generates only graphic
files. This is usefull in conjuction with the -noclean
It contains a header and a list values at degrees of freedom. The header
contains the field
keyword followed by a line containing a format
version number (presently 1), the number of degrees of freedom (i.e. the
number of values listed), the mesh file name without the ` .geo'
extension the approximation (e.g. P1, P2, etc), and finaly the list of values:
A sample field file (compatible with the sample mesh example presented in
command manual; see geo(1)) writes:
field cube.field -cut -normal 0 1 0 -origin 0.5 0.5 0.5 -vtk
This command send to vtk
the cutted 2d plane of the 3d field.
field cube.field -cut -normal 0 1 0 -origin 0.5 0.5 0.5 -text > cube-cut.field
This command generates the cutted 2d field and its associated mesh.
field cube.field -iso 0.5
This command draws the isosurface.
field cube.field -iso 0.5 -text > isosurf.geo
This command generates the isosurface as a 3d surface mesh in ` .geo'
format. This is suitable for others treatments.