This DATA input module animates a sequence of data applied to a UCD
structure. The base format is exactly the same as the standard UCD,
except that you can specify a 6-th value on the first line (if you
use ASCII format) , giving the maximum number of time steps to consider.
By default, allocation is provided for at most 256 time steps.

 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, and then try 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,
    the other one is the list of file names for steps 0,1,etc..

All these files can be ASCII or binary. You can either create them
manually or use the twin module WrUcdAnim.

For best performance, this module should be mongoed into ucd_multm, thus
sharing memory pointers rather than structure copies whit other ucd modules.
Ask larryg@avs.com how to do this.

BUGS and PROBLEMS:
      -Min & max values are computed on the fly, so if you want the 
       same colormap for every time step, you must either use the
       preload option or read all the steps once.
      -In one file mode, you can go to a random time step only with the
       preload option. Without preload, you can only reach
       time steps you already read in or the immediate next one.
      -Prefarably, you should use SEQUENCE NUM. mode ONLY.
       This is the most thorougly tested mode.
      -One file mode for sure does not work with binary files.
      -When I ported to Stardent 3000, I discovered that the Convex
       version of read_ucd.c (which I used as a starting base) uses 2
       utility functions called ucd_qsorti & ucd _bsearchi. These do
       not seem to be part of AVS (although there is ucd_qsort and 
       ucd_bsearch in libutil.a). So I simply replaced this by a program
       loop, which might result in a performance drop. If somebody knows
       what are the arguments to ucd_qsort & ucd _bsearch, please send
       me mail, or correct read_ascii.c and resubmit. For now, I just
       put a #ifdef CONVEX around the 2 calls.
      -In general, this is the first version of both RdUcdAnim and WrUcdAnim,
       and it is not fully guaranteed. It will work though, if you
       1- use sequence num. mode
       2- choose preload or not only BEFORE entering a file name
       However, as I'm changing company, I've
       rather submit it as is and work further on it later. Please contact
       laminie@lanor.matups.fr to know where I am if you want more information,
       bug reports, corrections,  etc.. for these modules.


Inputs : None

Ouput :
	UCD

Parameters :
	
   File name: string.
	The name of the base input file. This must be a valid .inp file,
        with optionally a 6-th value at the end of the first line giving
        the max number of time steps. This file will be used to read in
        node coordinates & IDs, cell IDs,coordinates,materials,types,and 
        node lists, the node components,labels and units, and the cell
        components, labels and units. 
	In one file mode, this file will also have node and data coordinates
        fore every time step.
        In sequence number mode, this name will be used as a prefix to
        generate .00,.01,etc.. 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. 

   Preload: boolean.
        Default is off.
	With this option set, all time steps between First step and Last step 
        are read in when a file is loaded.This option consumes more memory,
        but lessens Disk and Cpu consumption for subsequent operations.

   File mode: choice.
        If One file, read one big file with all time steps.
        If Sequence num. of File list, read one UCD file, and then one file
        for each time step.If File list, get file names from another file.

   AnimNodePos: boolean.
        Specifies whether or not to animate node coordinates for each time step.
        Default is ON, if node positions have been recorded.

   AnimNodeData: boolean.
        Specifies whether or node to animate node data for each time step.
        Default is ON, if cell data has been recorded.


   AnimeCellData: boolean.
        Specifies whether or node to animate cell data for each time step.
        Default is ON, if cell data has been recorded.

   AnimModelData: boolean.
        Specifies whether or node to animate model data for each time step.
        Default is ON, if model data has been recorded.


   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.

   Last step: integer.
        Default is 256.
	Specifies the last  step to animate.
        If there are not that much time steps, animation stops after the
        last available time step, updating the value of this dial.

   Current step: integer.
        Default is 0.
        Allows you to go to a specific step.


D. LE CORRE
CONVEX S.A
9,Ave Ampere
78180 Montigny-le-Bx
France
E-mail : dlc@lanor.matups.fr