obspy.iris - IRIS Web service client for ObsPy

The obspy.iris package contains a client for the DMC Web services provided by IRIS (http://www.iris.edu/ws/).

copyright:The ObsPy Development Team (devs@obspy.org) license:GNU Lesser General Public License, Version 3 (http://www.gnu.org/copyleft/lesser.html)

Basic Usage

1. getWaveform(): The following example illustrates how to request and plot 60 minutes of the BHZ channel of station Albuquerque, New Mexico ("ANMO") of the Global Seismograph Network ("IU") for an seismic event around 2010-02-27 06:45 (UTC).

   >>> from obspy.iris import Client
   >>> from obspy.core import UTCDateTime
   >>> client = Client()
   >>> t = UTCDateTime("2010-02-27T06:45:00.000")
   >>> st = client.getWaveform("IU", "ANMO", "00", "BHZ", t, t + 60 * 60)
   >>> st.plot() 
   

   [hires.png, pdf]

   

2. saveWaveform(): Writes the requested waveform unmodified into your local file system. Here we request a Full SEED volume.

   >>> from obspy.iris import Client
   >>> from obspy.core import UTCDateTime
   >>> client = Client()
   >>> t1 = UTCDateTime("2010-02-27T06:30:00.000")
   >>> t2 = UTCDateTime("2010-02-27T07:30:00.000")
   >>> client.saveWaveform('IU.ANMO.00.BHZ.mseed', 'IU', 'ANMO',
   ...                     '00', 'BHZ', t1, t2) 
   

3. saveResponse(): Writes the response information into a file. You may choose one of the format 'RESP', 'StationXML' or 'SACPZ'.

   >>> from obspy.iris import Client
   >>> from obspy.core import UTCDateTime
   >>> client = Client()
   >>> t = UTCDateTime(2009, 1, 1)
   >>> client.saveResponse('resp.txt', 'IU', 'ANMO', '', '*',
   ...                     t, t + 1, format="RESP") 
   

Low-level Web service Interfaces

Each of the following methods directly wrap a single Web service provided by IRIS (http://www.iris.edu/ws/):

• availability() - returns information about what time series data is available at the IRIS-DMC
• bulkdataselect() - returns multiple channels of time series data for specified time ranges
• dataselect() - returns a single channel of time series data
• distaz() - calculate the distance and azimuth between two points on a sphere.
• evalresp() - evaluates instrument response information stored at the IRIS DMC and outputs ASCII data or Bode Plots.
• event() - returns event information in the QuakeML format. Events may be selected based on location, time, catalog, contributor and internal identifiers.
• flinnengdahl() - converts a latitude, longitude pair into either a Flinn-Engdahl seismic region code or region name.
• 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
• station() - provides access to station metadata in the IRIS DMC database

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

Classes & Functions

client.Client

IRIS Web service request client.

Modules

client

IRIS Web service client for ObsPy.