tiebenn.tools.retrieve_data module

tiebenn.tools.retrieve_data.make_station_list(client_list, ev_lon, ev_lat, start_time, end_time, channel_list=[], filter_network=[], filter_station=[])[source]

Uses fdsn to find available stations in a specific geographical location and time period.

Parameters:

  • client_list (list) – List of client names e.g. [‘IRIS’, ‘SCEDC’, ‘USGGS’] from where to extract stations

  • ev_lon (float) – Longitude of the located event

  • ev_lat (float) – Latitude of the located event

  • start_time (str) – Start datetime for the beginning of the period. Format: yyyy-mm-dd hh:mm:ss.ss

  • end_time (str) – End datetime for the beginning of the period. Format: yyyy-mm-dd hh:mm:ss.ss

  • channel_list (list, default=[]) – A list containing the desired channel codes. Downloads will be limited to these channels based on priority. Defaults to [] –> all channels

  • filter_network (list, default=[]) – A list containing the network codes that need to be avoided

  • filter_station (list, default=[]) – A list containing the station names that need to be avoided

Returns:

A dictionary containing relevant information for the available stations, such as geographical coordinates, elevation, available channels

Return type:

stations_list

tiebenn.tools.retrieve_data.process_client(cl, ev_lon, ev_lat, start_time, end_time, channel_list=[], filter_network=[], filter_station=[])[source]

Process a single client: fetch station inventory and filter based on criteria. Returns a dictionary of station info.

Parameters:

  • cl (str) – Client name e.g. [‘IRIS’, ‘SCEDC’, ‘USGGS’] from where to extract stations

  • ev_lon (float) – Longitude of the located event

  • ev_lat (float) – Latitude of the located event

  • start_time (str) – Start datetime for the beginning of the period. Format: yyyy-mm-dd hh:mm:ss.ss

  • end_time (str) – End datetime for the beginning of the period. Format: yyyy-mm-dd hh:mm:ss.ss

  • channel_list (list, default=[]) – A list containing the desired channel codes. Downloads will be limited to these channels based on priority. Defaults to [] –> all channels

  • filter_network (list, default=[]) – A list containing the network codes that need to be avoided

  • filter_station (list, default=[]) – A list containing the station names that need to be avoided

Returns:

A dictionary of the stations, if necessary

Return type:

client_station_list