Running the TIDE level-zero software standalone:

The latest version of the software is tide_lz_v5.8.1.  v5.8.1.tar contains the
standalone software.  There are two programs that make up the software: lz_parm
creates the parameter file and tide_lz processes the data.  The parameter file
indicates what processing is to be done and contains all information associated
with that request.  tide_lz prompts the user for the name of the parameter file
and the name of the list file.  

The program are created using the make files provided.  To create lz_parm, use
'make -f Mparm' and to create tide_lz simply type make.


The list file contains the start and stop times for the run plus the name and
location of the TIDE level-zero file(s), POLAR orbit and attitude file(s), the
mask file, the spacecraft potential file, the peaks location file, and/or the
mfe magnetic field data file.  Note: Only those files needed for processing 
should be included in the list file.  Include the fully qualified pathname of
each file.  The first line contains the start time.  The second line contains 
the stop time.  Times are in UT on a 24-hour clock.  The format of each line can
be any of the following:

    mm/dd/yy hh:mm:ss
    mm/dd/yy hh:mm:ss UT
    mm-dd-yy hh:mm:ss
    mm-dd-yy hh:mm:ss UT

Each filename line has a number in the first column indicating the type of file:
1 - level-zero, 2 - orbit, 3 - attitude, 4 - mask, 5 - spacecraft potential,
6 - peaks location file, 7 - mfe magnetic field file, 9 mask file correction
factor, used to override the value in the parameter file.  

sample input file:

03/03/05 12:30:00
03/03/05 12:50:00
1 /archive/po_tid_lz_0503/data/po/tid/lz/05030301.dat
2 /archive/po_tid_lz_0503/data/po/pre/or/05030303.cdf
3 /archive/po_tid_lz_0503/data/po/pre/at/05030304.cdf
4 /datafiles/mask/t050301_v2.mask
5 /datafiles/scpot/200503xx.dat
 


The output created by tide_lz will vary depending on the processing done.  The
format for the filename is either 

      tyymmddh1m1_h2m2.ext
   or tyymmddh1m1_h2m2_mm.ext

where yymmdd is the start date, h1m1 is the start time, and h2m2 is the stop
time.  If the file contains data for a single mass, mm is the mass to charge
ratio of the ion or it is 00 for Singles or sp for Stops.  The extention is a
brief indication of the content of the file.  See file.extensions for a list
of file extensions.

Once tide_lz has completed, you can use one the IDL command files to plot the
data.  Each command file needs as input the name of the file containing a list
of the TIDE output files to be processed.  That way the results of more than 
one file can be processed.  The command files are:

  chr_multi_24bit   plots 24-bit chromograms
  chr_multi_8bit    plots 8-bit chromograms
  htr_multi         plots the high time resolution spectrograms
  mom_multi         plots moments data
  psd_multi         plots any of the velocity distrbution plots
  spect_multi       plots the two variable spectrograms other than esse plots

esse_sp and esse_sm are command files used to plot esse files but they plot only
one file at a time.

They are executed from IDL using the @ command.