Provided by: rheolef_6.5-1build1_amd64 
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.
INPUT FILE SPECIFICATION
-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.
BRANCH FILE FORMAT
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)