waveform_collection.server module

waveform_collection.server.gather_waveforms(source, network, station, location, channel, starttime, endtime, time_buffer=0, merge_fill_value=0, trim_fill_value=0, remove_response=False, return_failed_stations=False, watc_url=None, watc_username=None, watc_password=None, verbose=True)[source]

Gather seismic/infrasound waveforms from IRIS or WATC FDSN, or AVO Winston, and output a Stream with station/element coordinates attached. Optionally remove the sensitivity.

NOTE

Usual RTM usage is to specify a starttime/endtime that brackets the estimated source origin time. Then time_buffer is used to download enough extra data to account for the time required for an infrasound signal to propagate to the farthest station.

Parameters:
  • source (str) –

    Which source to gather waveforms from. Options are:

    • ’IRIS’ – IRIS FDSN
    • ’WATC’ – WATC FDSN (requires watc_url, watc_username, and watc_password)
    • ’AVO’ – AVO Winston
  • network (str) – SEED network code [wildcards (*, ?) accepted]
  • station (str) – SEED station code [wildcards (*, ?) accepted]
  • location (str) – SEED location code [wildcards (*, ?) accepted]
  • channel (str) – SEED channel code [wildcards (*, ?) accepted]
  • starttime (UTCDateTime) – Start time for data request
  • endtime (UTCDateTime) – End time for data request
  • time_buffer (int or float) – Extra amount of data to download after endtime [s]
  • merge_fill_value (bool, int, float, str, or None) – Controls merging of Trace objects with identical IDs. If False, no merging is performed. Otherwise, a merge is performed with the fill_value provided to this parameter. For details, see the docstring of obspy.core.stream.Stream.trim()
  • trim_fill_value (bool, int, float, or None) – Controls trimming of the output Stream, useful if precisely uniform start and end times are desired. If False, no trimming is performed. Otherwise, a trim is performed with the fill_value provided to this parameter. For details, see the docstring of obspy.core.stream.Stream.merge()
  • remove_response (bool or str) – Response removal via full frequency deconvolution (‘full’) or single frequency sensitivity (‘sens’) / a simple scalar multiplication. Default is False to return stream in counts.
  • return_failed_stations (bool) – If True, returns a list of station codes that were requested but not downloaded. This disables the standard failed station warning message
  • watc_url (str) – URL for WATC FDSN server (http://10.30.6.3:8080, or http://10.30.5.10:8080 if using VPN)
  • watc_username (str) – Username for WATC FDSN server
  • watc_password (str) – Password for WATC FDSN server
  • verbose (bool) – If False, all print statements will be blocked. Default is True.
Returns:

Stream containing gathered waveforms. If return_failed_stations is True, additionally returns a list containing station codes that were requested but not downloaded
waveform_collection.server.gather_waveforms_bulk(lon_0, lat_0, max_radius, starttime, endtime, channel, network='*', station='*', location='*', time_buffer=0, merge_fill_value=0, trim_fill_value=0, remove_response=False, watc_url=None, watc_username=None, watc_password=None, iris_only=True, verbose=True)[source]

Bulk gather infrasound waveforms within a specified maximum radius of a specified location. Waveforms are gathered from IRIS (and optionally WATC) FDSN, and AVO Winston. Outputs a Stream with station/element coordinates attached. Optionally removes the sensitivity. (Output Stream has the same properties as output Stream from gather_waveforms().)

NOTE 1

WATC database will NOT be used for station search NOR data download unless BOTH watc_username and watc_password are set.

NOTE 2

Usual RTM usage is to specify a starttime/endtime that brackets the estimated source origin time. Then time_buffer is used to download enough extra data to account for the time required for an infrasound signal to propagate to the farthest station.

Parameters:
  • lon_0 (int or float) – Longitude of search center [deg.]
  • lat_0 (int or float) – Latitude of search center [deg.]
  • max_radius (int or float) – Maximum radius to search for stations within [km]
  • starttime (UTCDateTime) – Start time for data request
  • endtime (UTCDateTime) – End time for data request
  • channel (str) – SEED channel code [wildcards (*, ?) accepted] (REQUIRED PARAMETER!)
  • network (str) – SEED network code [wildcards (*, ?) accepted]
  • station (str) – SEED station code [wildcards (*, ?) accepted]
  • location (str) – SEED location code [wildcards (*, ?) accepted]
  • time_buffer (int or float) – Extra amount of data to download after endtime [s]
  • merge_fill_value (bool, int, float, str, or None) – Controls merging of Trace objects with identical IDs. If False, no merging is performed. Otherwise, a merge is performed with the fill_value provided to this parameter. For details, see the docstring of obspy.core.stream.Stream.trim()
  • trim_fill_value (bool, int, float, or None) – Controls trimming of the output Stream, useful if precisely uniform start and end times are desired. If False, no trimming is performed. Otherwise, a trim is performed with the fill_value provided to this parameter. For details, see the docstring of obspy.core.stream.Stream.merge()
  • remove_response (bool) – Toggle response removal via remove_sensitivity() or a simple scalar multiplication
  • watc_url (str) – URL for WATC FDSN server
  • watc_username (str) – Username for WATC FDSN server
  • watc_password (str) – Password for WATC FDSN server
  • iris_only (bool) – If True, only the IRIS FDSN source is used
  • verbose (bool) – If False, all print statements will be blocked. Default is True.
Returns:

Stream containing bulk gathered waveforms