obspy.core.inventory.station.Station.select¶

Station.select(location=None, channel=None, time=None, starttime=None, endtime=None, sampling_rate=None, minlatitude=None, maxlatitude=None, minlongitude=None, maxlongitude=None, latitude=None, longitude=None, minradius=None, maxradius=None)[source]¶

Returns the Station object with only the Channels that match the given criteria (e.g. all channels with channel="EHZ").

Warning

The returned object is based on a shallow copy of the original object. That means that modifying any mutable child elements will also modify the original object (see https://docs.python.org/2/library/copy.html). Use copy() afterwards to make a new copy of the data in memory.

Example

>>> from obspy import read_inventory, UTCDateTime
>>> sta = read_inventory()[0][0]
>>> t = UTCDateTime(2008, 7, 1, 12)
>>> sta = sta.select(channel="[LB]HZ", time=t)
>>> print(sta)  
Station FUR (Fuerstenfeldbruck, Bavaria, GR-Net)
    Station Code: FUR
    Channel Count: None/None (Selected/Total)
    2006-12-16T00:00:00.000000Z -
    Access: None
    Latitude: 48.16, Longitude: 11.28, Elevation: 565.0 m
    Available Channels:
        FUR..BHZ, FUR..LHZ

The location and channel selection criteria may also contain UNIX style wildcards (e.g. *, ?, ...; see fnmatch()).

Parameters:

Parameters:	location (str) Potentially wildcarded location code. If not given, all location codes will be accepted. channel (str) Potentially wildcarded channel code. If not given, all channel codes will be accepted. time (`UTCDateTime`) Only include channels active at given point in time. starttime (`UTCDateTime`) Only include channels active at or after given point in time (i.e. channels ending before given time will not be shown). endtime (`UTCDateTime`) Only include channels active before or at given point in time (i.e. channels starting after given time will not be shown). sampling_rate (float) Only include channels whose sampling rate matches the given sampling rate, in Hz (within absolute tolerance of 1E-8 Hz and relative tolerance of 1E-5) minlatitude (float) Only include channels with a latitude larger than the specified minimum. maxlatitude (float) Only include channels with a latitude smaller than the specified maximum. minlongitude (float) Only include channels with a longitude larger than the specified minimum. maxlongitude (float) Only include channels with a longitude smaller than the specified maximum. latitude (float) Specify the latitude to be used for a radius selection. longitude (float) Specify the longitude to be used for a radius selection. minradius (float) Only include channels within the specified minimum number of degrees from the geographic point defined by the latitude and longitude parameters. maxradius (float) Only include channels within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters.

location (str) Potentially wildcarded location code. If not given, all location codes will be accepted.
channel (str) Potentially wildcarded channel code. If not given, all channel codes will be accepted.
time (UTCDateTime) Only include channels active at given point in time.
starttime (UTCDateTime) Only include channels active at or after given point in time (i.e. channels ending before given time will not be shown).
endtime (UTCDateTime) Only include channels active before or at given point in time (i.e. channels starting after given time will not be shown).
sampling_rate (float) Only include channels whose sampling rate matches the given sampling rate, in Hz (within absolute tolerance of 1E-8 Hz and relative tolerance of 1E-5)
minlatitude (float) Only include channels with a latitude larger than the specified minimum.
maxlatitude (float) Only include channels with a latitude smaller than the specified maximum.
minlongitude (float) Only include channels with a longitude larger than the specified minimum.
maxlongitude (float) Only include channels with a longitude smaller than the specified maximum.
latitude (float) Specify the latitude to be used for a radius selection.
longitude (float) Specify the longitude to be used for a radius selection.
minradius (float) Only include channels within the specified minimum number of degrees from the geographic point defined by the latitude and longitude parameters.
maxradius (float) Only include channels within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters.