LAST MODIFIED DATE:
Tue Oct 17 11:19:45 EDT 2000

To get Geotouch to run properly you MUST have the following:

0)  A UNIX operating system running X-windows (X11R6).
     this includes SUN5.7, LINUX, NEXT, others?

1)  A copy of the source code of Geotouch:
    Follow the directions for INSTALLATION

2) you will need the 'head.big'  postscript header
   to make postscript output run properly.
     

3) To run the program you need input data and an origin file descriptor.
   Generally these change from place to place and the user provides them.

   I provide some demonstration data in the DEMO.tar
   file.  if you ftp this file, untar it and follow
   directions. If geotouch was compiled properly,
   you should be able to run Geotouch immediately.

   Be sure to make sure the Geotouch executable
   is in a directory that is in the search path
   for commands in your PATH env variable.
    
    for example:
    set path=( /PATH_TO_Geotouch_DIRECTORY  $path )
 
   You may run Geotouch in the same dir that the files
   reside, but this is less convenient.

4) When starting the program, a version number and
   a date of compilation comes up.
   in comunicating bugs to me, be sure to include this information.
   many bugs get fixed but I don't have time to install
    the latest version out in the public directories.

5) Good luck, happy computing.


======================= For legal purposes:
Copyright (c) 1994-1997 by Jonathan M. Lees
=======================


For new features see the file: new.features


We Now have a SOURCE distribution which is ANSI-C and POSIX compliant.
See the Src sub-directory for details on porting and installing Geotouch.



---------------------------------------------------
ACKNOWLEDGEMENTS

If you use this code for data exploration or producing figures
please acknowledge my contribution.
Add a reference in one of the figure captions to this program
by citing the journal article where I describe this:

Lees, J. M. (1995): "Geotouch: A Free Program for Three-Dimensional GIS",
Seismological Research Letters, 66(4), 33-37.

-----------------------------
DOCUMENTATION
-------------
The latest Documentation can be viewed in the WEB at:

http://www.unc.edu/~leesj/XM_DOC

-----------
-----------
UTILITIES:
-------------------GMT-2-LEES---------------
There is a utility that converts GMT files
into lees_format maps.
It is a Perl Script in the 
pub/Geotouch/Utils directory
run:
gmt2lees.p < your_gmt  > your_lees_map

--------   Hypocenters: -----------------------
I have included a short perl script (fp2ac.p) for converting
fpfit output to UW A-cards.  This little routine can be
used as a template for converting other formats to UW:
just change the input read statements.  Fill in 0's for
those field you do not need or care about.
Geotouch only really needs the LAT-LON-Depth(km) of the hypocenter.

---
-----------
INTALLATION NOTES

The INSTALL dir has several things that should 
be looked over regarding environmental variables.

These env variables ought to be set, or the
program is not guaranteed to produce expected results:
setenv PSHEAD  head.big_directory
setenv XMA_SPE_SRC full_path_to_writable_file

the following env variables are helpful, but optional
(they allow one to run Geotouch with no command line arguments,
i.e. the provide defaults)
setenv XMA_STA_FILE full_path_to_stationfile 
setenv XMA_ORG_FILE  full_path_default_origin
setenv XMA_AC_FILE  full_path_to_default_hypocenters

I recommend putting the env settings in your .cshrc file (or equivalent)
-----------------------------


GEOTHERM JAP WORLD
each have a tar file that should be untarred and then can
be used as demos for the program.

the most general demo is in: GEOTHERM
after untarring it, try some of the macros
by typing one of:
xm.macro1
xm.macro2
xm.macro3
xm.macro4
each of these illustrates different uses of Geotouch.
There are instructions in each macro. 


Send email to:
leesj@email.unc.edu
if you have good suggestions or bug reports.
I will respond to reasonable requests
for program modifications.

There are some auxiliary software
programs for formating and translating data
from other formats to UW or "lees" format.
Try asking, but I will not write formatting programs
unless I am collaborating on particular projects.

Jonathan Lees


