Skip to content

ANISOtime

Kensuke Konishi edited this page Aug 2, 2020 · 41 revisions

version release gplicense Java8

ANISOtime is a utility package mainly to compute travel time in a laterally homogeneous, transversely isotropic (TI), spherically symmetric medium, is bundled in Kibrary.

INSTALLATION

If you already have Kibrary installed, you then have access to ANISOtime. If you do not have Kibrary, please see here.

In case you prefer an instant use,

For macOS or Linux users:

Please download this and run as below:

//When you want to download the file under /path/to 
$ anisotime=/path/to/anisotime
$ wget -q -O $anisotime https://bit.ly/2Xdq5QI || curl -qL -o $anisotime https://bit.ly/2Xdq5QI
$ chmod +x $anisotime
$ $anisotime (OPTIONS)

For Windows users:

Please check if you have Java Runtime Environment. Batch file for Windows can be downloaded here.

// You can easily get this path when you drag and drop the file on the prompt.
$ "/path/of/anisotime.bat" (options)

Velocity model

ANISOtime includes the following well-known velocity structures:
PREM(prem)
AK135(ak135)
Isotropic PREM(iprem)

Names in the parenthesis are to be used as a model name in CLI.

Hereinafter, /path/to/Kibrary/bin is assumed to be in PATH.

USAGE

GUI

If you want to use ANISOtime in its GUI mode, execute ANISOtime as below:

//GUI mode runs when you activate ANISOtime without any options.
anisotime

CLI

When you add arguments in the command of the above execution for the GUI mode, it works as CLI.

Arguments

  • -dec Number of decimal places for output.
  • -deg Epicentral distance Δ [deg].
  • -h Depth of source [km] (default:0)
  • -mod Structure (default:prem)
  • -help Prints the usage. This option has the highest priority.
  • -ph, --phase Seismic phases (default:P,PCP,PKiKP,S,ScS,SKiKS)
  • -p Ray parameter
  • -v, --version Shows information of the tool. This option has the 2nd highest priority.
  • -SH Computes travel time for SH (default:SH)
  • -SV Computes travel time for SV (default:SH)
  • -dD Parameter for a catalog creation (dΔ).
  • -dR Integral interval [km] (default:10.0)
  • -eps output path figure
  • -o Directory for a record section. It must not exist before the launch.
  • --delta show only epicentral distances
  • --rayp show only ray parameters
  • --time show only travel times
  • -rc, --read-catalog Path of a catalog for which travel times are computed.
  • -rs, --record-section start,end(,interval) [deg] Computes a table of a record section for the range.

For instance, if you want to see the usage, you can execute as below:

anisotime -help

Catalog creation

If you want to create a database of raypath set that shortens the time for travel time computation,

anisotime -mod prem

it creates a catalog and the catalog is used from the next use.
If you want to specify a catalog for the raypath computation:

anisotime -rc /path/to/catalog -deg 60 -ph S

Record section

If you want to create P and S wave record sections for an epicentral distance range start to end with interval interval and let the results in /path/to/out (must not exist before the launch),

anisotime -rs start,end,interval -ph P,S -mod prem -o /path/to/out

Without -o, it shows the result in the standard output.