Tools

Tools included with the TauP package:

time

calculates travel times.

pierce

calculates pierce points at model discontinuities and specified depths.

path

calculates ray paths, depth versus epicentral distance.

find

calculates all possible phases in a model with number of interactions.

wavefront

calculates wavefronts in steps of time, depth versus epicentral distance.

curve

calculates travel time curves, time versus epicentral distance.

phase

textual description of the path the phase takes through the model.

table

outputs travel times for a range of depths and distances in an ASCII file

setms3

puts theoretical arrival times into extra headers.

setsac

puts theoretical arrival times into sac header variables.

velmerge

merges part of one velocity model into another.

velplot

output velocity model as a gmt script.

create

creates a .taup model from a velocity model.

spikes

create spike seismogram.

refltrans

plot reflection and transmission coefficients for a discontinuity.

web

http access to the tools

version

print the version.

help

display help information about the specified command.

Startup Script

Each tool is a subcommand of the overall taup Java application which is an wrapper to make execution easier: sh scripts for Unix and bat files for windows. The application are machine independent but the wrappers are OS specific. For example, to invoke TauP Time under Unix, you could type

java -classpath ... edu.sc.seis.TauP.TauP time -mod prem

or simply use the script that does the same thing,

taup time -mod prem

Each tool has a --help flag that will print a usage summary, as well as a --version flag that will print the version.

Tab Completion

New with version 3.0 is tab completion for bash and zsh. Sourcing the output of taup generate-completion will provide hints for the shell when hitting the tab key for bash or zsh. You can enable it with running this command:

source <(taup generate-completion)

Adding this to your .bash_profile or .zshrc will enable it for future logins.

Note, for bash 3.2, which the default verion on OSX, there is a bug that prevents this from working. The alterantive is to save it as a file like:

taup generate-completion > taup_completion

and then source the file:

source taup_completion

Once sourced, you will be able to get hints or completion for most arguments within TauP. For example typing:

taup time -

and then hitting the tab key will display all of the possible command line flags. Continuing to type

taup time --mod

and then hitting the tab key will display the models available for the --mod command line argument:

ak135       ak135favg   ak135fcont  iasp91      prem        qdt