Description
The traveltime webservice calculates travel-times for seismic phases using a 1-D spherical earth model.
Below is a full list of service parameters and their usage.
Query Usage
There are three ways to specify distance:
/query? (distdeg=<degrees>) [evdepth=<km>] [model=<iasp91|prem|ak135>] [phases=<phaselist>] [format] [output-params] /query? (distkm=<km>) [evdepth=<km>] [model=<iasp91|prem|ak135>] [phases=<phaselist>] [format] [output-params] /query? (evtloc=<LatLonPair>) [evdepth=<km>] (staloc=<LatLonList>) [model=<iasp91|prem|ak135>] [phases=<phaselist>] [format] [output-params]
where
output-params :: [noheader=<true|false>] [traveltimeonly=<true|false>] [rayparamonly=<true|false>] [mintimeonly=<true|false>] LatLonPair :: [latitude,longitude] LatLonList :: LatLonPair1,LatLonPair2,...,LatLonPairN (..) required parameter [..] optional parameter
The square braces “[]” around the LatLonPair latitude and longitude are required.
All parameters must be separated by ampersands (”&”) as demonstrated in the samples below.
Sample Queries
- /irisws/traveltime/1/query?staloc=[34.946,-106.457]&evloc=[-36.122,-72.898]&evdepth=22.9
- /irisws/traveltime/1/query?evloc=[-36.122,-72.898]&staloc=[-33.45,-70.67],[47.61,-122.33],[47.37,8.55]&evdepth=22.9
- /irisws/traveltime/1/query?distdeg=10,50,100&evdepth=300&phases=S,pSKS,SKKKKKKS,sSKJKP,PPP670s
Detailed Descriptions of each Query Parameter
parameters | examples | discussion | default | |
---|---|---|---|---|
model | prem | Name of 1–D earth velocity model to be used. Available models include: iasp91 — by Int’l Assoc of Seismology and Physics of the Earth’s Interior prem — Preliminary Reference Earth Model ak135 — Kennett, 1997 |
iasp91 | |
phases | p,P,S,PKP,p410s | Comma separated list of phases1, defaulting to p,s,P,S,Pn,Sn,PcP,ScS,Pdiff,Sdiff,PKP,SKS,PKiKP,SKiKS,PKIKP,SKIKS See TauP documentation for more information |
see discussion | |
evdepth | 20.0 | The depth of the event, in kilometers. | 0.0 | |
Geographical Parameters — Required | ||||
distdeg | 57.4 | Great-circle distance from source to station, in decimal degrees. Specify multiple distances as a comma-separated list | ||
distkm | 100.0 | Distance between the source and station, in kilometers. Use commas to specify multiple distances | ||
evloc | [30.1,-120.0] | The Event location [lat,lon] using decimal degrees. Used in conjunction with staloc |
||
staloc | [42.0,-150] | Retrieve phases for this comma separated list of station locations Ex. [lat1,lon1],...,[latN,lonN] |
||
Format Two text-based and one image-based output formats are available. |
||||
format | text | Specify output format. Valid formats include text , json , and svg .If format=svg is specified, a PNG image file is returned showing the raypaths traveling through concentric circles, representing layers of the Earth. |
||
Output Parameters By default, values are returned in fixed width columns. more detail |
||||
noheader | true | Suppresses header from the resulting table | false | |
traveltimeonly | true | returns a space–separated list of travel times, in seconds. Note2 | false | |
rayparamonly | true | will return a space-separated list of ray parameters, in sec/deg. | false | |
mintimeonly | true | will only retrieve the first arrival of each phase for each distance | false |
notes
1 Valid arbitrary phases can be made up e.g. sSKJKP
, but invalid phases will be ignored.
2 Travel times are produced in ascending time order regardless of the order in which the phases are specified
WADL
Retrieve the WADL associated with this service:
Problems with this service?
Please send an email report of which service you were using, your URL query, and any error feedback to:
ws-issues AT iris.washington.edu
We will address your issue as soon as possible.