obspy.geodetics.base.inside_geobounds
- inside_geobounds(obj, minlatitude=None, maxlatitude=None, minlongitude=None, maxlongitude=None, latitude=None, longitude=None, minradius=None, maxradius=None)[source]
Check whether an object is within a given latitude and/or longitude range, or within a given distance range from a reference geographic point.
The object must have
latitude
andlongitude
attributes, expressed in degrees.- Parameters:
obj (object) – An object with latitude and longitude attributes.
minlatitude (float) – Minimum latitude in degrees.
maxlatitude (float) – Maximum latitude in degrees. If this value is smaller than
minlatitude
, then 360 degrees are added to this value (i.e., wrapping around latitude of +/- 180 degrees)minlongitude (float) – Minimum longitude in degrees.
maxlongitude (float) – Minimum longitude in degrees.
latitude (float) – Latitude of the reference point, in degrees, for distance range selection.
longitude (float) – Longitude of the reference point, in degrees, for distance range selection.
minradius (float) – Minimum distance, in degrees, from the reference geographic point defined by the latitude and longitude parameters.
maxradius (float) – Maximum distance, in degrees, from the reference geographic point defined by the latitude and longitude parameters.
- Returns:
True
if the object is within the given range,False
otherwise.
Example
>>> from obspy.geodetics import inside_geobounds >>> from obspy import read_events >>> ev = read_events()[0] >>> orig = ev.origins[0] >>> inside_geobounds(orig, minlatitude=40, maxlatitude=42) True >>> inside_geobounds(orig, minlatitude=40, maxlatitude=42, ... minlongitude=78, maxlongitude=79) False >>> inside_geobounds(orig, latitude=40, longitude=80, ... minradius=1, maxradius=10) True