Geotouch is an all purpose, three-dimensional, GIS mapping and data exploration tool. An origin file is required at start-up, but station and earthquake files are optional, i.e. they can be entered as "null". Several ENV variables must be set properly for Postscript output to be created properly.
The program can read in several different 3D objects:
sources - earthquakes, points, whatever
stations
maps - geologic, gmt
wells - lines, 3D vectors, deviated boreholes with lithology and dip
points - labeled points with color and size information
wireframe objects - 3D structures
2D and 3D raster files
irregularly spaced data fields, which can be gridded and contoured
predetermined cross sections
Spin Module - Allows users to rotate objects in 3D (postscript available)
Time Module - Allows users to see events plotted in time sequences
COMMAND LINE OPTIONS
-G x y width height
-B 0=color 1=b/w
-D maximum depth for x-sects
-Z maximum depth for x-sects
-z minimum depth for x-sects
-w width for x-sects
-F filename of A-M cards for focal mechanisms (MANY)
-W filename of well lat-lon-depth (MANY)
-S filename of A-cards (MANY)
-R Receiver_filename Station (Receiver) (MANY)
-r Receiver_filename symbol Station (Receiver) (MANY)
-M filename of geologic map (MANY)
-J filename of geologic map in GMT format (MANY)
-m filename code of geologic map (MANY)
-Y Wire_Frame_file (MANY)
-E Ellipse_file (MANY)
-C Contour_file
-I Image_file
-p Points_file (MANY)
-T title
-X filename of cross sections
-force_source force all hypocenters to be included (no spatial selection)
ENV VARIABLES
Several ENV variable should be set to make full use of Geotouch. These are not required to run the program, however some features will not work without these settings. $PWD = means present working directory, (which should be changed to a permanent location). Once the location of Geotouch is established, it is recommended that these settings be inserted into the .cshrc file so they do not have to be set for each login session.
# postscript header file directory
setenv PSHEAD $PWD
# default origin file for maps
setenv XMA_ORG_FILE $PWD/org.jt1
# default hypocenter cards for maps (in UW acard format)
setenv XMA_AC_FILE $PWD/used.ac
# default station location file for maps
setenv XMA_STA_FILE $PWD/sta.uw
# default 1D velocity model
setenv XMA_VEL_FILE $PWD/nps1d.vel
# file for saving and retrieving events (must have READ/WRITE access)
setenv XMA_SPE_SRC $HOME/special.src
# directory where events and other stuff gets dumped
setenv DUMPING_GROUND $PWD
# file where default map lies
setenv XMA_THEMAP $PWD
#
# (gmt) latlon flag for map files. Set to 1 forces
# reading of gmt files as LON-LAT rather than LAT-LON
setenv XMA_LONLAT 0
setenv XAPPLRESDIR $PWD
---------------------------------
Example settings for lees on my computer:
---------------------------------
XMA_AC_FILE=/home/lees/inge/Hel/ring.ac
XMA_ORG_FILE=/home/lees/inge/Hel/org.ring
XMA_SPE_SRC=/home/lees/special.src
XMA_STA_FILE=/home/lees/inge/Hel/sta.uw
XMA_VEL_FILE=/home/lees/Loc/Joshua/JTdata/nps1d.vel
XMA_THEMAP=/home/lees/inge/Pug/ndal.lees
XMA_LONLAT=0
KEY ACCELERATORS
q - quit
w - toggles into 'photo mode' suitable for photographing the screen
p - gives info on the point where the cursor is located
o - gives info on the point where the cursor is located in X-sections
e - explode focal-mechanisms
r - plot focal mechanisms as strike and dip vectors
t - plot focal mechanisms as P-T axes
a - Animate the source sequence, leaving all events on.
z - animate the source sequence forcing disappearance of old events
f - select a focal mechanism for moving in explode mode
g - final position of selected focal mechanism
c - toggle the style of focal mechanism plotting
v - switch the focal and auxiliary planes of the selected focal mechanism
m - position start of label (this is the tail where the label resides)
n - final position of arrow for label (head of the arrow)
F1 - restore figure from a ZOOM
F3 - Descend into earth
F4 - Ascend up from depths
s - plot events stored in a file accessed via the environmental variable XMA_SPE_SRC
SEE ALSO