SIOSEIS program(s) recommended installation
                                                     January 2019

The directory structure should follow normal Unix conventions, e.g.
bin - contains all the executables.
src - contains the source code.

Remember to add ~/bin to your search path.  e.g. in ~/.bashrc mine is:
export PATH=.:~/bin:/bin:$PATH:/usr/bin/usr:/local/bin

COMPILING 
---------
Make sure gcc and gfortran are as the sioseis makefile expects, download
hello.tar.bz2 and execute:
tar -xjf hello.tar.bz2
make -f make.hello
hello

Download the latest source tarball from the main sioseis web (page
and read README.

PLOTTING
--------
SIOSEIS plotting is rather limited since there are many excellent programs
available elsewhere.  A great program for final plots and for interpretation
is Kingdom Suite.  It has undergone some ownership changes so it's best to 
search for it on the web.  Should be free to .edu with some hoops though.

The easiest way of making screen plots is to use the plot parameter
SRPATH, which creates a Sun rasterfile.
# /bin/csh
sioseis << endsioseis
procs ...... end
.
.
plot
   .....
   srpath sunfil.ras end
end
end
endsioseis
display -rotate 90 sunfil.ras &

ImageMagick program display is a great free display program that runs
on any Unix platform.  Use     display -rotate 90 sunfil.ras

ImageMagick program CONVERT reformats Sun rasterfiles into most other
image formats (my favorite is PNG).

xloadimage is another convenient display program, but the version
on the sioseis site does not work on TrueColor (24 plane) screens
such as on the Mac.  Mac OSX program GraphicConverter is also 
convienient.  To open it on OSX in the sioseis script use:
open -a /Applications/GraphicConverter\ US/GraphicConverter,app sunfil.ras

Sioseis program SIO2SUN to convert SIOSEIS rasterfiles, which were produced
using plot parameter OPATH, to Sun rasterfiles.

TEST SCRIPT
---- ------
Use the following script to check the sioseis installation.  Make sure
the script has execute permission (chmod 777 script-name)
sioseis << eof
procs syn filter plot end
syn
   fno 1 lno 1 secs 4 tva .1 2000 1 ntrcs 10 end
end
filter
   pass 10 20 end
end
plot
  nibs 2859 
  srpath sunfil.ras
  nsecs 1 vscale 1.25 end
end
end
eof
display -rotate 90 sunfil.ras &


DOCUMENTATION
-------------
Non-web documentation:
doc/siodoc is a script to more the documention of each process.
Change the path of the doc directory in file siodoc and create an
alias such as:  alias sd '~henkart/doc/siodoc'

Then you can get a fast copy of a process' documentation by typing:
sd proc-name.    e.g.  sd agc

ADDITIONAL TEST SCRIPTS
---------- ---- -------
1)  Plot the same synthetic without the filter.
sioseis << eof
procs syn plot end
syn
   fno 1 lno 1 secs 4 tva .1 2000 1 ntrcs 10 end
end
filter
   pass 10 20 end
end
plot
  nibs 2859
  srpath sunfil.ras
  nsecs 1 vscale 1.25 end
end
end
eof
display -rotate 90 sunfil.ras &

    Notice that just removing FILTER from the PROCS list works;
the filter parameters are ignore.

2) Make other changes:
sioseis << eof
procs syn filter plot end
syn
   fno 1 lno 1 secs 5 tva .1 1500 1 1 1600 -1 ntrcs 100 end
end
filter
   pass 10 20 end
end
plot
  nibs 2859
  srpath sunfil.ras
  ann sh&tr taginc 10 trpin 50 def .05
  nsecs 0 vscale .5 end
end
end
eof
display -rotate 90 sunfil.ras &