Low-level interface for availability Web service of IRIS (http://www.iris.edu/ws/availability/) - release 1.2.1 (2012-04-06).
This method returns information about what time series data is available at the IRIS DMC. Users can query for station metadata by network, station, channel, location, time and other search criteria. Results are may be formated in two formats: 'bulk' or 'xml'.
The ‘bulk’ formatted information can be passed directly to the bulkdataselect() method.
The XML format contains station locations as well as channel time range for availability().
Parameters: |
|
---|---|
Return type: | str or None |
Returns: | String that lists available channels, either as plaintext bulkdataselect format (output="bulkdataselect") or in XML format (output="xml") if no filename is given. |
Note
For restricting data by geographical coordinates either:
Example
>>> from obspy.iris import Client
>>> from obspy import UTCDateTime
>>> client = Client()
>>> t1 = UTCDateTime("2010-02-27T06:30:00")
>>> t2 = UTCDateTime("2010-02-27T06:40:00")
>>> result = client.availability("IU", "B*", "*", "BH*", t1, t2)
>>> print(result)
IU BBSR 00 BH1 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BBSR 00 BH2 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BBSR 00 BHZ 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BBSR 10 BHE 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BBSR 10 BHN 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BBSR 10 BHZ 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BILL 00 BHE 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BILL 00 BHN 2010-02-27T06:30:00 2010-02-27T06:40:00
IU BILL 00 BHZ 2010-02-27T06:30:00 2010-02-27T06:40:00
>>> st = client.bulkdataselect(result)
>>> print(st)
9 Trace(s) in Stream:
IU.BBSR.00.BH1 | 2010-02-27T06:30:00... | 40.0 Hz, 24000 samples
IU.BBSR.00.BH2 | 2010-02-27T06:30:00... | 40.0 Hz, 24000 samples
IU.BBSR.00.BHZ | 2010-02-27T06:30:00... | 40.0 Hz, 24000 samples
IU.BBSR.10.BHE | 2010-02-27T06:30:00... | 40.0 Hz, 24000 samples
IU.BBSR.10.BHN | 2010-02-27T06:30:00... | 40.0 Hz, 24000 samples
IU.BBSR.10.BHZ | 2010-02-27T06:30:00... | 40.0 Hz, 24000 samples
IU.BILL.00.BHE | 2010-02-27T06:30:00... | 20.0 Hz, 12000 samples
IU.BILL.00.BHN | 2010-02-27T06:30:00... | 20.0 Hz, 12000 samples
IU.BILL.00.BHZ | 2010-02-27T06:30:00... | 20.0 Hz, 12000 samples