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 of 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 of float, optional) Distance between the source and station, in kilometers. Multiple distances may be specified as a list.
  • evloc (tuple of two floats, optional) The Event location (lat,lon) using decimal degrees.
  • staloc (tuple of two floats or list of tuples, 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   ...