obspy.clients.seedlink.basic_client.Client.get_info

Client.get_info(network=None, station=None, location=None, channel=None, level='station', cache=True, warn_on_excluded_stations=False)[source]

Request available stations information from the seedlink server.

Supports fnmatch wildcards, e.g. * and ?, in network, station, location and channel.

>>> client = Client('rtserver.ipgp.fr')
>>> info = client.get_info(station="FDFM")
>>> print(info)
[('G', 'FDFM')]
>>> info = client.get_info(
...     station="FD?M", channel='*Z', level='channel')
>>> print(info)  
[('G', 'FDFM', '00', 'BHZ'), ('G', 'FDFM', '00', 'HHZ'),
 ('G', 'FDFM', '00', 'HNZ'), ('G', 'FDFM', '00', 'LHZ'),
 ('G', 'FDFM', '10', 'BHZ'), ('G', 'FDFM', '10', 'HHZ'),
 ('G', 'FDFM', '10', 'LHZ')]

Available station information is cached after the first request to the server, so use cache=False on subsequent requests if there is a need to force fetching new information from the server (should only concern programs running in background for a very long time).

Note

Stations/channels are excluded from the results for which the server indicates it is serving them in general but it also states no data are in ring buffer currently. If interested in these “no data” stations/channels, either set warn_on_excluded_stations=True which will show a warning message with excluded stations or use debug=True when initializing the client which will print the raw server seedlink INFO xml response which will show these stations listed with begin_seq and end_seq both with value '000000'.

Parameters:

network (str) – Network code. Supports fnmatch wildcards, e.g. * and ?.
station (str) – Station code. Supports fnmatch wildcards, e.g. * and ?.
location (str) – Location code. Supports fnmatch wildcards, e.g. * and ?.
channel (str) – Channel code. Supports fnmatch wildcards, e.g. * and ?.
cache (bool) – Subsequent function calls are cached, use cache=False to force fetching station metadata again from the server.
warn_on_excluded_stations (bool) – Whether to show a warning for stations that are excluded from the results because the server indicates there is no data currently available.

Return type:

list

Returns:

list of 2-tuples (or 4-tuples with level='channel') with network/station (network/station/location/channel, respectively) code combinations for which data is served by the server.