1. To use SS, please get SS, TSplot and EMTF. 

If you have an SVN client, the following commands will create
the directories SS, TSplot and EMTF and download the software:

svn checkout http://mt.coas.oregonstate.edu/svn/SS/trunk SS
svn checkout http://mt.coas.oregonstate.edu/svn/TSplot/trunk TSplot
svn checkout http://mt.coas.oregonstate.edu/svn/EMTF/trunk EMTF

2. Set up a data processing directory on your system, if it doesn't
   already exist. That is,
   a) create an empty directory for your survey, e.g. 'survey'
   b) create a subdirectory survey/original
   c) cp -r EMTF/CF survey/

Your raw NIMS data should go to the survey/original directory.
Feel free to structure this directory in any way you feel suitable;
for example, you could have a separate subdirectory for each run,
or a directory for each week of data, etc. The programs will only 
assume that the path for your raw data starts with survey/original.

3. Compile EMTF by running 'make' in D, T and MMT.
   Please make sure the executables are in your system path.

4. If you don't already use a startup file in Matlab, create an
empty startup.m file in a directory that is in your MATLABPATH. 

Add the following lines to your startup.m:

addpath('/your/path/to/SS/system_tools');
addpathsvn('/your/path/to/SS','RECURSIVE');
addpathsvn('/your/path/to/TSplot','RECURSIVE');
addpathsvn('/your/path/to/EMTF/matlab','RECURSIVE');

setenv('MTdata', '/home/mt/earthscope/surveys');

Here, please replace '/your/path/to/' with your path to the
corresponding software. Environment variable MTdata defines
the location on your system where the data processing will occur.
This directory must already exist. If unsure, leave this line out;
you will get a chance to set it later.

5. Two tools are provided:

   SS  - read a raw NIMS output binary file; correct the meta data;
         plot, process and save the data in a MAT file.

   SSM - loads a MAT file that was created by running SS. Allows
         a second look at the data without reading the binary file
	 again. Otherwise, identical to SS.
	 
   Both tools save the corrected meta data in an XML file. This file
   is required for archiving the data with IRIS and for multiple
   station processing with ArrayManager. It can be also be viewed
   in any internet browser, such as Mozilla Firefox, Netscape or
   Internet Explorer.
   
   The software may be updated by running 'svn update' from inside
   each of the SS, TSplot and EMTF software directories.
   
(c) 2007-2008  Anna Kelbert  <anya AT coas.oregonstate.edu>