find_events

find_events gathers events matching the criteria given in the following options.

Options

Format Meaning Default
-v/--version Print SOD's version and exit
-r/--recipe Print the created recipe to stdout instead of running it
-h/--help Print a brief help message and exit
-p/--props <props> Add an additional props file to specify a different nameserver, database or other internal SOD options
--allow-duplicates By default, find_events filters out very similar events. Adding this flag allows all events through
-S/--server <server> Set the event server for this search earthquake.usgs.gov
-R/--box-area <box> Limit the events to those in a box region. It's specified as west/east/south/north where west and east are longitudes from -180 to 180 and north and south are latitudes from -90 to 90
-d/--donut <donut> Limits the events to those in a donut region. It's specified as centerLat/centerLon/minRadiusDegrees/maxRadiusDegrees. As with --box-area, latitude goes from -90 to 90 and longitude goes from -180 to 180
-b/--begin <begin> The earliest time for an accepted event. Relative times can be given like -1d for one day ago, similar for (hour), (m)onth and (y)year. Actual time must be in 'YYYY[[[[[-MM]-DD]-hh]-mm]-ss]' format or 'network' to specify the earliest start time for a channel found by the network arm. Each unspecified field in 'YYYY[[[[[-MM]-DD]-hh]-mm]-ss]' format is assumed to be the earliest possible value for that field. the previous day
-e/--end <end> The latest time for an accepted event. Must be in 'YYYY[[[[[-MM]-DD]-hh]-mm]-ss]' format, 'now' for the current time or 'network' for the latest end time for a channel found by the network arm. Each unspecified field in 'YYYY[[[[[-MM]-DD]-hh]-mm]-ss]' format is assumed to be the latest possible value for that field. now
-m/--magnitude <magnitude> The range of acceptable magnitudes in the form min[-max]. If max is unspecified, a max of 10 is assumed. 0-10
-t/--types t1,t2,...,tN The types of magnitudes to retrieve. If unspecified, all magnitude types will be retrieved. These can be any type supported by the event server such as Mb or Mw
-D/--depth <depth> The range of acceptable depths in kilometers 0-10000
-o/--output <output> The format for output. Can be none, xy, yx or a Velocity template as described in the printlineEventProcess ingredient xy
-c/--catalogs c1,c2,...,cN A comma separated list of catalogs to search. If unspecified, PREF will be searched
--seis-regions s1,s2,...,sN A comma separated list of numeric seismic Flinn-Engdahl regions. An event must be in one of these regions to pass. If unspecified, all regions will be acceptable
--geo-regions g1,g2,...,gN A comma separated list of numeric geographic Flinn-Engdahl regions. An event must be in one of these regions to pass. If unspecified, all regions will be acceptable