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 |