# create a directory where
#  Geotouch code will reside
#  move the source code archive into that directory 
mkdir Geotouch
mv geotouch-YOUR_VERSION.tar.gz  Geotouch
(YOUR_VERSION stands for the latest version of geotouch, 
downloaded from the internet site.  This will change as the code is updated.)
cd Geotouch
#  gunzip the code
gunzip  geotouch-YOUR_VERSION.tar.gz
#    untar the source code
tar xvf geotouch-YOUR_VERSION.tar
#
#  before you compile and load geotouch,
#   you must have a library that reads in netcdf files (libnetcdf.a)
#   this is a free software and can be retrieved over the net
#    or a copy compatable with SUNOS is available on this web site

# a version of this is distributed in DISTRIB directory
#       download this to the geotouch directory, gunzip it and untar it.
#   there are several goodies there, including netcdf library files


# install the netcdf libs in a place which is in the path
# set by ENV variable: LD_LIBRARY_PATH
#  for example, my libs are in /home/lees/lib
#  and
#  LD_LIBRARY_PATH=/usr/openwin/lib:/usr/dt/lib:/usr/openwin/lib:/opt/hpnp/lib:/usr/local/pgsql/lib:/home/lees/lib

#
#  in the Makefile, 
#   change the destination of the executable binary and other variables
#  in mine it reads:
# 
#  for example:
HOME=/home/lees
XHOME=/usr/X11R6
DEST=$(HOME)/bin



#  ON A SUN SYSTEM YOU must make the following change:

#  perl -pi.bak -e 's/GXnor/GXxor/'  `grep -l GXnor *.c`

#  make the software
make geotouch

#  now you are ready to run geotouch

#   ENV VARIABLES

# you must set some env variables to get the postscript output working properly
# put the file head.big in a directory where geotouch can find it.
#  here it is set to PWD but you can move it anywhere.

setenv PSHEAD           $PWD
setenv XMA_SPE_SRC      $HOME/special.src

# there are several other ENV variables that can be set,
#  these are discussed in the online documentation

example:

XMA_THEMAP=/data/whiskey/lees/k1/lees/Loc/Coso/CECI/themap
XMA_PALETTE_REV=0
XMA_PALETTE_IMAGE=1
XMA_AC_FILE=/data/whiskey/lees/k1/lees/Loc/Coso/CECI/allcoso_8.ac
XMA_ORG_FILE=/data/whiskey/lees/k1/lees/Loc/Coso/CECI/org.demo
XMA_SPE_SRC=/home/lees/special.src
XMA_SCALE_IMAGE=1
XMA_VEL_FILE=/data/whiskey/lees/j1/coso/NEWUW/whole.vel
XMA_STA_FILE=/data/whiskey/lees/k1/lees/Loc/Coso/CECI/sta.uw
XMA_SPE_PPS=/home/lees/special.points


see: DISTRIB/ENV.variables  for explanations