Jive3D release 1.1 - README file

Copyright (C) J.W.D. Hobro 1997, 2000

Jive3D is a 3-D travel-time inversion package that will produce a
smooth best-fit velocity & interface model from a set of travel time
data and a given starting model.

PLEASE PLEASE PLEASE don't use Jive3D as a 'black box' modelling tool.
If you plan to use Jive3D successfully for modelling, it is important
to have at least an elementary understanding of how it works. I would
recommend reading the first sections of my Ph.D. Thesis (available from 
http://bullard.esc.cam.ac.uk/~hobro/thesis/ ). Chapters 1-4 deal with
the method used by Jive3D.

See the file INSTALL for installation instructions.

Instructions for use are contained in the Jive3D manual which is
available from http://bullard.esc.cam.ac.uk/~hobro/Jive3D/

To use the plotting scripts provided, the Generic Mapping Tools
(GMT) package must be installed on your system. In order to use the
uncertainty analysis utility 'calcerr', the LAPACK Fortran library must
also be installed on your system.

Please send any bug reports or comments to jive3d@esc.cam.ac.uk

Program descriptions:

jive3d:    Main inversion program
calcerr:   Uncertainty analysis

depsamp:     Samples the depth of an interface at a given point
gradgen:     Generates a starting model velocity layer with constant gradient
int2gmt:     Samples the depth of an interface over a given rectangular grid
intgen:      Generates a starting model interface with constant slope
linedepsamp: Samples the depth of an interface along a given line
modslice:    Used by plotslice script
modvsp:      Used by plotvsp script
posconwa:    Used by posplot script
rays2gmt2d:  Used by plotrays script
res2gmt:     Used by resplot script

plotslice: Script to plot model slices
plotvsp:   Script to plot a vertical profile through a model
plotrays:  Script to plot ray paths
posplot:   Script to plot ray emergence positions
resplot:   Script to plot travel-time residuals