===========================================================================
README

===========================================================================
SOFTWARE
--------

RELEASE 0.01 ALPHA:  4/2008
---------------------------

This release contains 3 packages.

1.  stargen.tar.gz
     - to unpack the tar file:
            % tar xvfz stargen.tar.gz
     - script frontend builds spatial multiresolution data
     - allows extraction of any attribute
     - input data is '3df' files
     - quick help:  
            % cd stargen
            % make
            % stargen -a rr -i sample_data
     - more help:
            % stargen --help

     - Sample Data:
        - contains 3 recorded files representing 181 simulation timesteps.
        - sample_data/data
        - contains original GGCM simulation data in compressed, 
          '3df' file format.

2.  stargui.tar.gz
     - to unpack the tar file:
            % tar xvfz stargui.tar.gz
     - GUI frontend to the multiresolution build tool 'makear'.
     - builds both spatial and temporal MR hierarchies
     - runs on binary data as input
     - quick USAGE:
            % cd stargui
            % make
            % java -jar STARgui.jar

     - Sample Data:
        - contains 3 recorded files representing 181 simulation timesteps.
        - sample_data/data
        - contains raw binary density input data (32-bit float)
        - suitable for use with 'makear' or STARgui.  
        - contains sample TSD.tsd metadata file describing data

3.  visit_plugins.tar.gz
     - to unpack the tar file:
            % tar xvfz star_visit_plugins.tar.gz
     - C++ plugins for use with the VisIT visualization environment
     - requires installation of VisIT environment on your system
     - plugins must be compiled

       (I)  'StarTsdPlugin'
             - database plugin to read in MR data created by
               either stargen or STARgui tools above.

       (II) 'MultiresControl'
             - operator plugin to control resolution dynamically
               while running VisIT.

===========================================================================