This DATA output module generates a sequence of UCD data time steps
onto a (set of) file(s), which may then be read by the twin module,
RdUcdAnim.
For each time step, it can store node positions, node data, cell data,
model data or a subset of these.
It is fully compatible with the standard read ucd format, so the
first time step may be read by read ucd.

 It can use 3 different modes :

  One file mode :
    In this mode, node, cell and model data are stored at the end of
    the base file : all data for step 0, then all data for step 1,etc..
  Sequence number mode.
    In this mode, you first read the UCD .inp file, but no attempt is
    made to read nodal,cell or model data. This program then tries to
    locate time step data in files named xxx.00, xxx.01,
    where xxx is the name of the base file
  File list mode.
    In this mode, you can enter 2 file names : one is the base .inp file,
    except that again no nodal,cell or model data is read,
    and the other one is an ascii file, listing file names for every
    time step.

 It can generate 3 types of format : 

 Ascii :
    Standard UCD ascii format, with some information added at the
    end of the first line (this information does not disturb read ucd) 

 Binary3.0 
    Binary UCD format for AVS 3.0, with some information added at the
    end of the file.
    
 Binary3.5 
    Binary UCD format for AVS 3.5 or higher , with some information added
    at the end of the file.
    
BUG FIXES at V1.1.3:
    A lot of them (I wonder if and how previous versions might have worked at all).

BUG FIXES at V1.1:
    Incorrect cell type strings in ASCII mode.
    Max step parameter was not stored in ASCII mode.
    Moved interface to a separate window.

BUGS and PROBLEMS:
      -Min & max values are computed on the fly, so somebody ought
       to change the module so that the global min/max values are
       stored at the end of the animation.
      -You should never change the file name or output format when running.
       Instead, remove the module with the hammer and call a new one.
      -File select mode probably does not work if you do not have enough
       file names in the file list.

Input : 
        UCD

Ouput :
	none

Parameters :
	
   File name: string.
	The name of the base input file. This file will be used to write
        a standard UCD format, with 0 or more time steps at the end.
        In sequence number mode, this name will be used as a prefix to
        generate .00,.01,etc.. time step file names.

   File list: string.
	In file list mode, this browser allows you to enter the name of a file,
        which shoud contain one line with the filename for each time step data. 

   File format: choice.
	Allows you to select Ascii, 3.0 AVS binary, or 3.5 and higher binary
	format.

   StoreNodePos: boolean.
	Specifies whether or node to store node coordinates for each time step.		Default is OFF, so that NO move is recorded (only data changes are).

   StoreNodeData: boolean.
	Specifies whether or node to store node data for each time step.		Default is ON, if there is node data in the input UCD structure.


   StoreCellData: boolean.
	Specifies whether or node to store cell data for each time step.		Default is ON, if there is node data in the input UCD structure.

   StoreModelData: boolean.
	Specifies whether or node to store model data for each time step.
	Default is ON, if there is model data in the input UCD structure.

   File mode: choice.
	If One file, generates one big file with all time steps.
	If Sequence num. of File list, generate one UCD file, and then one
        file for each time step.If File list, get file names from another file.
	
   Sleep: boolean.
        Default is on.
	Triggers the animation.

   Single step: oneshot.
        Starts a single step.

   First step: integer.
        Default is 0.
	Specifies the first step to animate.
	NOT SUR THAT YOU CAN CHANGE THIS.

   Last step: integer.
	Specifies the last  step to animate.
	Auto-increments with new data flowing in the input port.
	NOT SUR THAT YOU CAN CHANGE THIS.

   Current step: integer.
	Auto-increments with new data flowing in the input port.
        Allows you to go to a single step.
	NOT SUR THAT YOU CAN CHANGE THIS.


D. LE CORRE
TETHYS S.A
Immeuble Le Cedre
91960 Les Ulis
France
E-mail : dlc@lanor.matups.fr