Geotouch

Copyright © 1996 Jonathan M. Lees


NAME


Geotouch - general 3D GIS software for geophysical/geological
applications

SYNOPSIS


Geotouch origin_file station_file event_file [ -options ]

DESCRIPTION

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

Geotouch

xm_color

xm_hypo

xm_focal

xm_map

xm_menu

xm_origin

xm_points

xm_raster

xm_station

xm_well

xm_wire

xm_xsec

xm_ellipse


SEE ALSO

REFERENCES

MORE CONTACT INFORMATION