obspy.fdsn.client.Client.get_stations

Client.get_stations(starttime=None, endtime=None, startbefore=None, startafter=None, endbefore=None, endafter=None, network=None, station=None, location=None, channel=None, minlatitude=None, maxlatitude=None, minlongitude=None, maxlongitude=None, latitude=None, longitude=None, minradius=None, maxradius=None, level=None, includerestricted=None, includeavailability=None, updatedafter=None, filename=None, **kwargs)[source]

Query the station service of the client.

>>> client = Client("IRIS")
>>> inventory = client.get_stations(latitude=-56.1, longitude=-26.7,
...                                 maxradius=15)
>>> print inventory  
Inventory created at ...
    Created by: IRIS WEB SERVICE: fdsnws-station | version: ...
            http://service.iris.edu/fdsnws/station/1/query?lat...
    Sending institution: IRIS-DMC (IRIS-DMC)
    Contains:
        Networks (3):
            AI
            II
            SY
        Stations (4):
            AI.ORCD (ORCADAS, SOUTH ORKNEY ISLANDS)
            II.HOPE (Hope Point, South Georgia Island)
            SY.HOPE (HOPE synthetic)
            SY.ORCD (ORCD synthetic)
        Channels (0):
>>> inventory = client.get_stations(
...     starttime=UTCDateTime("2013-01-01"), network="IU",
...     sta="ANMO", level="channel")
>>> print inventory  
Inventory created at ...
    Created by: IRIS WEB SERVICE: fdsnws-station | version: ...
            http://service.iris.edu/fdsnws/station/1/query?station=...
    Sending institution: IRIS-DMC (IRIS-DMC)
    Contains:
        Networks (1):
            IU
        Stations (1):
            IU.ANMO (Albuquerque, New Mexico, USA)
        Channels (57):
            IU.ANMO.00.BH1, IU.ANMO.00.BH2, IU.ANMO.00.BHZ,
            IU.ANMO.00.LH1, IU.ANMO.00.LH2, IU.ANMO.00.LHZ,
            IU.ANMO.00.VH1, IU.ANMO.00.VH2, IU.ANMO.00.VHZ,
            IU.ANMO.00.VM1, IU.ANMO.00.VM2, IU.ANMO.00.VMZ,
            IU.ANMO.10.BH1, IU.ANMO.10.BH2, IU.ANMO.10.BHZ,
            IU.ANMO.10.EH1, IU.ANMO.10.EH2, IU.ANMO.10.EHZ,
            IU.ANMO.10.HH1, IU.ANMO.10.HH2, IU.ANMO.10.HHZ,
            IU.ANMO.10.LH1, IU.ANMO.10.LH2, IU.ANMO.10.LHZ,
            IU.ANMO.10.VH1, IU.ANMO.10.VH2, IU.ANMO.10.VHZ,
            IU.ANMO.10.VM1, IU.ANMO.10.VM2, IU.ANMO.10.VMZ,
            IU.ANMO.20.EN1, IU.ANMO.20.EN2, IU.ANMO.20.ENZ,
            IU.ANMO.20.HN1, IU.ANMO.20.HN1, IU.ANMO.20.HN2,
            IU.ANMO.20.HN2, IU.ANMO.20.HNZ, IU.ANMO.20.HNZ,
            IU.ANMO.20.LN1, IU.ANMO.20.LN1, IU.ANMO.20.LN2,
            IU.ANMO.20.LN2, IU.ANMO.20.LNZ, IU.ANMO.20.LNZ,
            IU.ANMO.30.LDO, IU.ANMO.31.LDO, IU.ANMO.35.LDO,
            IU.ANMO.40.LFZ, IU.ANMO.50.LDO, IU.ANMO.50.LIO,
            IU.ANMO.50.LKO, IU.ANMO.50.LRH, IU.ANMO.50.LRI,
            IU.ANMO.50.LWD, IU.ANMO.50.LWS, IU.ANMO.60.HDF
Parameters:
  • starttime (UTCDateTime) Limit to metadata epochs starting on or after the specified start time.
  • endtime (UTCDateTime) Limit to metadata epochs ending on or before the specified end time.
  • startbefore (UTCDateTime) Limit to metadata epochs starting before specified time.
  • startafter (UTCDateTime) Limit to metadata epochs starting after specified time.
  • endbefore (UTCDateTime) Limit to metadata epochs ending before specified time.
  • endafter (UTCDateTime) Limit to metadata epochs ending after specified time.
  • network (str) Select one or more network codes. Can be SEED network codes or data center defined codes. Multiple codes are comma-separated.
  • station (str) Select one or more SEED station codes. Multiple codes are comma-separated.
  • location (str) Select one or more SEED location identifiers. Multiple identifiers are comma-separated. As a special case ““ (two dashes) will be translated to a string of two space characters to match blank location IDs.
  • channel (str) Select one or more SEED channel codes. Multiple codes are comma-separated.
  • minlatitude (float) Limit to stations with a latitude larger than the specified minimum.
  • maxlatitude (float) Limit to stations with a latitude smaller than the specified maximum.
  • minlongitude (float) Limit to stations with a longitude larger than the specified minimum.
  • maxlongitude (float) Limit to stations with a longitude smaller than the specified maximum.
  • latitude (float) Specify the latitude to be used for a radius search.
  • longitude (float) Specify the longitude to the used for a radius search.
  • minradius (float)

    Limit results to stations within the specified minimum number of degrees from the geographic point defined by the

    latitude and longitude parameters.
  • maxradius (float) Limit results to stations within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters.
  • level (str) Specify the level of detail for the results (“network”,
“station”, “channel”, “response”), e.g. specify “response” to get full
information including instrument response for each channel.
Parameters:
  • includerestricted (bool) Specify if results should include information for restricted stations.
  • includeavailability (bool) Specify if results should include information about time series data availability.
  • updatedafter (UTCDateTime) Limit to metadata updated after specified date; updates are data center specific.
  • filename (str or open file-like object) If given, the downloaded data will be saved there instead of being parse to an ObsPy object. Thus it will contain the raw data from the webservices.
Return type:

Inventory

Returns:

Inventory with requested station information.

Any additional keyword arguments will be passed to the webservice as additional arguments. If you pass one of the default parameters and the webservice does not support it, a warning will be issued. Passing any non-default parameters that the webservice does not support will raise an error.

This Page