TauP Table

TauP Table creates an ASCII table of arrival times for a range of depths and distances. Its main use is for generating travel time tables for earthquake location programs such as LOCSAT. The --generic flag generates a flat table with all arrivals at each depth and distance, one arrival per line. The --csv flag generates a comma separated value file, including a header while the --json flag will output the table data as JSON. The --locsat flag generates a LOCSAT style travel time table with only the first arrival of all the phases listed at each distance and depth. Thus, the program must be run several times in order to generate files for several phases. Also, all options write to standard out unless a file is given with the -o flag.

There is a default phase, distance and depth list, but this is easily customizable with the --header option. An example LOCSAT style file for use as a header can be generated with taup table -locsat -o example.locsat. The first three sections specify the phase list, distances and depths to use. After editing, a custom table can be created with taup table -header example.locsat.

Note that the taup.table.locsat.maxdiff property sets the cutoff beyond which Pdiff and Sdiff while not be output. This is to align the output with preexisting locsat style travel time files.

The usage is:

Usage: taup table [--debug] [--help] [--verbose] [--header=<headerFile>]
                  [-o=<outFile>] [--prop=<toolPropsFilename>] [--csv | --json |
                  --locsat | --text] [[--mod=<modelName>] [--stadepth=depth[,
                  depth...]]... [--scat=s s]...] [[-p=phase[,phase...]]...
                  [--phasefile=<phaseFiles>]...]
Create a table of travel times for a range of depths and distances.

Options:

      --debug              enable debugging output
      --header=<headerFile>
                           reads depth and distance spacing data from a LOCSAT
                             style file.
      --help               display this help message
  -o, --output=<outFile>   output to file, default is stdout.
      --prop=<toolPropsFilename>
                           load defaults from properties file
      --verbose            enable verbose output
Output Type:
      --csv                outputs as CSV
      --json               outputs as JSON
      --locsat             outputs as Locsat
      --text, --generic    outputs as Text
Model Args
      --mod, --model=<modelName>
                           use velocity model "modelName" for calculations.
                           Default is iasp91. Other builtin models include
                             prem, ak135, ak135fcont, and ak135favg.
      --scat, --scatter=s s
                           scattering depth and distance in degrees, which may
                             be negative. Only effects phases with 'o' or 'O'
                             in the phase name.
      --stadepth, --receiverdepth=depth[,depth...]
                           the receiver depth in km for stations not at the
                             surface
Phase Names
  -p, --ph, --phase=phase[,phase...]
                           seismic phase names
      --phasefile=<phaseFiles>
                           read list of phase names from file