NAME¶
branch -- handle a family of fields
SYNOPSIS¶
branch [ options] filename
EXAMPLE¶
Generates vtk file colection for visualization with paraview:
branch output.branch -paraview
DESCRIPTION¶
Read and output a branch of finite element fields from file, in field text file
format.
- -Idir
- add dir to the RHEOPATH search path. See also geo(2) for RHEOPATH
mechanism.
- filename
- specifies the name of the file containing the input field.
- -
- read field on standard input instead on a file.
- -ndigit int
- Number of digits used to print floating point values when using the `
-geo' option. Default depends upon the machine precision associated
to the Float type.
INQUIRE¶
- -toc
- print the table of contents (toc) to standard output and exit.
OUTPUT AND RENDER SPECIFICATION¶
- -extract int
- Extract the i-th record in the file. The output is a field or multi-field
file format.
- -branch
- Output on stdout in `.branch' format. This is the default.
- -paraview
- Generate a collection of vtk files for using paraview.
- -vtk
- Generate a single vtk file with numbered fields.
- -gnuplot
- Run 1d animation using gnuplot.
- -plotmtv
- This driver is unsupported for animations.
OTHER OPTIONS¶
- -umin float
- -umax float
- set the solution range for the gnuplot driver. By default this
range is computed from the first field of the branch, and this could be
problematic when this field is initialy zero.
- -topography filename[.field[.gz]]
- performs a tridimensionnal elevation view based on the topographic data.
- -proj
- performs a P1 projection on the fly. This option is useful when
rendering P0 data while vtk render requieres P1
description.
- -elevation
- For two dimensional field, represent values as elevation in the third
dimension. This is the default.
- -noelevation
- Prevent from the elevation representation.
- -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.
- -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.
The `
.branch' file format bases on the `
.field' one:
EXAMPLE GENERAL FORM
#!branch #!branch
branch branch
1 1 11 <version> <nfield=1> <nvalue=N>
time u <key> <field name>
#time 3.14 #<key> <key value 1>
#u #<field name>
field <field 1>
..... ....
..... ....
#time 6.28 #<key> <key value N>
#u #<field name>
field <field N>
..... ....
The key name is here
time, but could be any string (without spaces). The
previous example contains one
field at each time step. Labels appears
all along the file to facilitate direct jumps and field and step skips.
The format supports several fields, such as (t,u(t),p(t)), where u could be a
multi-component (e.g. a vector) field:
#!branch
branch
1 2 11
time u p
#time 3.14
#u
mfield
1 2
#u0
field
...
#u1
field
...
#p
#time 6.28
...
SEE ALSO¶
geo(2)