obspy.clients.iris - EarthScope (former IRIS) web service client for ObsPy

The obspy.clients.iris package contains a client for the DMC Web services provided by EarthScope (former IRIS) (https://service.iris.edu/irisws/).


The ObsPy Development Team (devs@obspy.org)


GNU Lesser General Public License, Version 3 (https://www.gnu.org/copyleft/lesser.html)

Local Alternatives

ObsPy contains local alternatives to some of the calculation tools offered by the EarthScope web services. Consider using them when working within ObsPy:

EarthScope Web Service

Equivalent ObsPy Function/Module







Web service Interfaces

Each of the following methods directly wrap a single Web service provided by EarthScope (https://service.iris.edu/irisws/):

Request Tools

  • evalresp() - evaluates instrument response information stored at the EarthScope DMC and outputs ASCII data or Bode Plots.

  • resp() - provides access to channel response information in the SEED RESP format (as used by evalresp)

  • sacpz() - provides access to instrument response information (per-channel) as poles and zeros in the ASCII format used by SAC and other programs

  • timeseries() - fetches segments of seismic data and returns data formatted in either MiniSEED, ASCII or SAC. It can optionally filter the data.

Calculation Tools

  • traveltime() - calculates travel-times for seismic phases using a 1-D spherical Earth model.

  • distaz() - calculate the distance and azimuth between two points on a sphere.

  • flinnengdahl() - converts a latitude, longitude pair into either a Flinn-Engdahl seismic region code or region name.

Please see the documentation for each method for further information and examples to retrieve various data from the EarthScope DMC.

Classes & Functions


EarthScope Web service request client.



EarthScope (former IRIS) Web service client for ObsPy.