branch(1rheolef)						    rheolef-6.1 						  branch(1rheolef)

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 asso-
	      ciated to the Float type.

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)

rheolef-6.1							    rheolef-6.1 						  branch(1rheolef)