Here is a quick start description of the SPLAT software. For more details read
splat_manual.doc which can be found in the splat/Doc directory.

1. Edit splat.sh
----------------

The splat.sh is a c-sell script that sets environment variables for all
software and data paths. The user has to ensure that all paths defined in this
file are valid.

The file resides in the splat/splat_user directory. The various links, found in
the file, can be updated to reflect your own setup. If the default setup is
kept, only three lines need to be edited. They are marked with
"# <-- edit#.

The first line indicates where is the directory that splat was unzipped in. The
default is the unix top ($HOME) directory.

Next, the data paths have to be updated. These data paths point to each
spacecraft's CDFs directory. It is assumed that under the CDFs directory there
exists a per year directory structure.

2. Execute splat.sh
------------------

In each unix window (unix command line section) this shell should be executed
only once. Go to the spla/splat_user directory and execute the command:

source splat.sh

(The usage of tcsh or csh is assumed)

3. Using SPLAT
--------------

Go to the splat/splat_user directory. Run the various crib-sheets.

Available crib sheets are:
- pla_en_spec_crib
- pla_en_spec_line_crib
- pla_def_spec_crib
- pla_pos_spec_crib
- pla_obmom_crib
- pla_mon_crib
- pla_mon_full_crib
- pla_dig_hk_crib
- pla_hk_crib
- pla_sc_hk_crib

A description of these crib sheets is included in splat_manual.doc

In order to run a particular crib-sheet start IDL and at the IDL command line
enter (in this case the pla_en_spec_crib crib-sheet)

@pla_en_spec_crib

4. TPLOT functionality
----------------------

Open the following crib-sheet with a text editor.

_example_crib

This is an example crib sheet that will demonstrate some of the basic tplot
functionality. Run each line by copying and pasting (or typing) to the IDL
command line.

For a full list of available tplot functions use the web browser to open the
splat/Doc/splat_tplot.html file.

If you are using the MAC OSX unix you have to start X11 first.
