EGS Catalog Search Documentation
Data are available April 22, 2003 through June 30, 2016.
Select earthquake parameters
The earthquake catalogs may be filtered using several different parameters including time, location (latitude and longitude), magnitude, and depth. Additional criteria are available.
The EGS catalog spans 2003/04/22-2016/06/30. All time in the earthquake catalog is referenced to UTC. Date and time parameters can be specified in one of several formats:
- yyyy = year (1900-present)
- doy = day-of-year (1-366)
- mm = month (1-12)
- dd = day-of-month(1-31)
- HH = hour (0-23)
- MM = minute (0-59)
- SS = second (0-59.9999)
The date must be fully specified. The time is optional, and defaults to midnight if not specified. There cannot be any blanks between the date and time, or within the date,time string. The year MUST completely specified, eg 1999, not 99.
Latitude and Longitude parameters
Latitude and Longitude values can be specified in one of two formats:
- decimal degrees, such as 39.50 for 39 and one-half degrees.
- degrees and minutes, such as 39:30 for 39 degrees and 30 minutes.
Latitude values can range from -90 to 90, and longitude values can range from -180 to 180. Please remember that:
- Longitude for California is WEST, and therefore should be specified as NEGATIVE (eg -121.5 for 121.5 degrees West).
- Since longitude is signed, a search between longitudes of -117 and -121 should be specified with a Min longitude = -121 and a Max longitude = -117.
The USGS GNIS Mapping Query Form can be used to find the latitude and longitude of a specific town or geographic feature.
Additional search parameters
Additional search parameters for selecting earthquakes may be specified by entering the appropriate keyword=value strings in the "Additional Search Parameters" box. Most search parameters are min/max parameters which allow you to provide minimum and/or maximum values for specific fields in the event catalogs. However, you may also select earthquakes within a specified annulus (or ring) around a location with the delta parameter, or specify a polygonal region to confine your earthquake search to a more complex region than a simple latitude/longitude box.
Search parameters that have min and max values can be specified by the strings
where the strings min and max preceed the keyword. If you only specify one end of the range (either the min or the max value), the other end of the range will be determined appropriately. For example, to specify the that you want events where the closest station is between 1 and 20 km, you would specify:
- minclose=1 maxclose=20
and to specify you want events where the closest station is <= 25 km from the epicenter, you would specify>
There should be NO blanks in the parameter=value string. Multiple parameters may be entered on the same line if they are separated by one or more blanks.
The following keywords can be used in min and max values parameter strings:
- sta - number of stations used for solution (range: 0 to ...).
- close - distance of closest station to epicenter (range: 0 to ...).
- rms - root-mean-squared residual of solution (range: 0. to 1.).
- gap - azimuthal gap (range: 0 to 360).
You may search for all earthquakes that are within an annulus (ie between a minimum and maximum distance) from a location with the delta parameter.
where lat,lon specify the latitude and longitude of the center of the circle, and mindist,maxdist specify the minimum distance and maximum distance in kilometers (km) of earthquakes from the specified location. Only earthquakes that are between mindist and maxdist kilometers from the specified location will be selected. There should be NO blanks in the delta=value string.
specifies a circle (annulus with inner diameter of 0) of 50 km around the location (38,5,-118.5). The program will select only earthquakes that are located within this circle.
specifies an annulus (ring) of 20 to 50 km around the location (38,5,-118.5). The program will select only earthquakes that are located within this annulus.
WARNING: The delta function will break if the circle centered at lat,lon with diameter of maxdist kilometers contains either of the earth's poles.
You may specify a polygonal search area with the polygon parameter.
where lat_i,lon_i specify the latitude and longitude of the i-th vertex of the polygon. You should ensure that the last point is identical to the first point in order to define a closed polygon. There should be NO blanks in the polygon=value string.
defines a polygon that encloses that Bay Area Peninsula.
Select output mechanism
By default, the output from the search will be returned to your browser in another document. If you think that the search may generate more data than your brower can safely display, you can specify that the output should be sent to a file, available to download via http, at the NCEDC. The file will be automatically deleted within several days.
It is very easy to generate a lot of unwanted output by inadventently mis-typing any of the search parameters. For example, entering a minimum magnitude of 0.5 instead of 5.0 can signicantly alter the number of matches from a catalog search, and can easily generate megabytes of output from a phase retrieval request.
In order to protect yourself (and the NCEDC) from runaway searches, you should limit the number of lines that the search will generate before it is aborted. If you set this limit to a reasonable value on your desired request, it can help to prevent runaway searches that can result from mis-typed values.
You can disable the output line limit by deleting the value in the line limit field, or by entering a value of 0. Please use this setting with extreme caution.