### 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 |