saul.waveform.helpers

Contains helper functions for tasks related to waveform data gathering, availablity assessment, and plotting.

saul.waveform.helpers.get_availability(network, station, channel, starttime, endtime, location='*', print_timespans=True, plot=False)[source]

Obtain waveform availability timespans.

Uses the NSF SAGE availability web service: https://service.iris.edu/fdsnws/availability/1/

Parameters:

  • network (str) – SEED network code

  • station (str) – SEED station code

  • channel (str) – SEED channel code

  • starttime (tuple or UTCDateTime) – Start time for availability search; for tuple input the format is integers: (year, month, day[, hour[, minute[, second[, microsecond]]])

  • endtime (tuple or UTCDateTime) – End time for availability search (same format as starttime)

  • location (str) – SEED location code

  • print_timespans (bool) – Toggle pretty-printing availability timespans to the console

  • plot (bool) – Toggle plotting availability timespans

Returns:

Table of data availability information, with columns network, station, location, channel, earliest, and latest

Return type:

DataFrame