Client.traveltime(model='iasp91', phases=['p', 's', 'P', 'S', 'Pn', 'Sn', 'PcP', 'ScS', 'Pdiff', 'Sdiff', 'PKP', 'SKS', 'PKiKP', 'SKiKS', 'PKIKP', 'SKIKS'], evdepth=0.0, distdeg=None, distkm=None, evloc=None, staloc=None, noheader=False, traveltimeonly=False, rayparamonly=False, mintimeonly=False, filename=None)[source]

Low-level interface for traveltime Web service of IRIS (http://service.iris.edu/irisws/traveltime/) - release 1.1.1 (2012-05-15).

This method will calculates travel-times for seismic phases using a 1-D spherical earth model.

  • model (str, optional) –

    Name of 1-D earth velocity model to be used. Available models include:

    • 'iasp91' (default) - by Int’l Assoc of Seismology and Physics of the Earth’s Interior

    • 'prem' - Preliminary Reference Earth Model

    • 'ak135'

  • phases (list[str], optional) –

    Comma separated list of phases. The default is as follows:


    Invalid phases will be ignored. Valid arbitrary phases can be made up e.g. sSKJKP. See TauP documentation for more information.

  • evdepth (float, optional) – The depth of the event, in kilometers. Default is 0 km.

Geographical Parameters - required

The travel time web service requires a great-circle distance between an event and station be specified. There are three methods of specifying this distance:

  • Specify a great-circle distance in degrees, using distdeg

  • Specify a great-circle distance in kilometers, using distkm

  • Specify an event location and one or more station locations, using evloc and staloc

  • evtlon – Great-circle distance from source to station, in decimal degrees. Multiple distances may be specified as a list.

  • distkm (float or list[float], optional) – Distance between the source and station, in kilometers. Multiple distances may be specified as a list.

  • evloc (tuple(float, float), optional) – The Event location (lat,lon) using decimal degrees.

  • staloc (tuple(float, float) or list[tuple(float, float)], optional) – Station locations for which the phases will be listed. The general format is (lat,lon). Specify multiple station locations with a list, e.g. [(lat1,lon1),(lat2,lon2),...,(latn,lonn)].

Output Parameters

  • noheader (bool, optional) – Specifying noheader will strip the header from the resulting table. Defaults to False.

  • traveltimeonly (bool, optional) –

    Returns a space-separated list of travel times, in seconds. Defaults to False.


    Travel times are produced in ascending order regardless of the order in which the phases are specified

  • rayparamonly (bool, optional) – Returns a space-separated list of ray parameters, in sec/deg.. Defaults to False.

  • mintimeonly (bool, optional) – Returns only the first arrival of each phase for each distance. Defaults to False.

  • filename (str, optional) – Name of a output file. If this parameter is given nothing will be returned. Default is None.

Return type:

str or None


ASCII travel time table if no filename is given.


>>> from obspy.clients.iris import Client
>>> client = Client()
>>> result = client.traveltime(evloc=(-36.122,-72.898),
...     staloc=[(-33.45,-70.67),(47.61,-122.33),(35.69,139.69)],
...     evdepth=22.9)
>>> print(result.decode())  
Model: iasp91
Distance   Depth   Phase   Travel    Ray Param  Takeoff  Incident ...
  (deg)     (km)   Name    Time (s)  p (s/deg)   (deg)    (deg)   ...
    3.24    22.9   P         49.39    13.750     53.77    45.82   ...
    3.24    22.9   Pn        49.40    13.754     53.80    45.84   ...