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/).

copyright:

The ObsPy Development Team (devs@obspy.org)

license:

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

obspy.clients.iris.client.Client.traveltime()

obspy.taup

obspy.clients.iris.client.Client.distaz()

obspy.geodetics

obspy.clients.iris.client.Client.flinnengdahl()

obspy.geodetics.flinnengdahl.FlinnEngdahl

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

client.Client

EarthScope Web service request client.

Modules

client

EarthScope (former IRIS) Web service client for ObsPy.