Web services: Event catalogue
Output a catalogue of events in either QuakeML or as a CSV file from the ISC Bulletin. The output is limited to the prime (preferred) hypocentre and the magnitude values for each event, providing a condensed list of events. Events may be selected by region, time, magnitude, and depth. Returned data comprise of:
- prime (preferred) hypocentre origins;
- magnitude - all magnitudes or those fitting your selection (specify author, type, and/or value);
An overview of the available web services guides can be found on the web services page.
Event catalogue: URL construction
USAGE:
http://m.gxjydl.com/cgi-bin/web-db-run?<output-format><database-choice><geographic-region><time-range>[<depth-limits>][<magnitude-limits>]
Each <query-option> is comprised of one or more parameters, which are described in detail
below. Each parameter needs to be separated by an ampersand (&) as shown in the
examples.
Queries or parameters in square brackets ([...]) are optional.
Example query 1:
Output a catalogue of events (prime hypocentres and magnitudes) in the ISC Bulletin between 2009-02-22 15:00:00 and 2009-04-22 15:00:00 where the magnitude computed by GCMT >= 5.5
QuakeML format:
http://m.gxjydl.com/cgi-bin/web-db-run?out_format=CATQuakeML&request=COMPREHENSIVE&searchshape=GLOBAL&start_year=2009
&start_month=02&start_day=22&start_time=15:00:00&end_year=2009&end_month=04&end_day=22&end_time=15:00:00
&min_mag=5.5&req_mag_agcy=GCMT&req_mag_type=Any
CSV file:
http://m.gxjydl.com/cgi-bin/web-db-run?out_format=CATCSV&request=COMPREHENSIVE&searchshape=GLOBAL&start_year=2009
&start_month=02&start_day=22&start_time=15:00:00&end_year=2009&end_month=04&end_day=22&end_time=15:00:00
&min_mag=5.5&req_mag_agcy=GCMT&req_mag_type=Any
Example query 2:
Output a catalogue of events (prime hypocentres and magnitudes), in the Reviewed ISC Bulletin between 2009-02-22 15:00:00 and 2009-04-22 15:00:00 where the body-wave magnitude (mb) associated to the prime hypocentre >= 5.5. Limit events to within 30 degrees of Lat: 25 N; Lon: 36 E
QuakeML format:
http://m.gxjydl.com/cgi-bin/web-db-run?out_format=QuakeML&request=REVIEWED&searchshape=CIRC&ctr_lat=25&ctr_lon=36&radius=30&max_dist_units=deg
&start_year=2009&start_month=02&start_day=22&start_time=15:00:00&end_year=2009&end_month=04&end_day=22
&end_time=15:00:00
&min_mag=5.5&req_mag_agcy=prime&req_mag_type=MB
CSV file:
http://m.gxjydl.com/cgi-bin/web-db-run?out_format=CATCSV&request=REVIEWED&searchshape=CIRC&ctr_lat=25&ctr_lon=36&radius=30&max_dist_units=deg
&start_year=2009&start_month=02&start_day=22&start_time=15:00:00&end_year=2009&end_month=04&end_day=22
&end_time=15:00:00
&min_mag=5.5&req_mag_agcy=prime&req_mag_type=MB
Description of query options:
<database-choice> |
|||
|---|---|---|---|
| Parameter name | Possible values | Description | |
request= |
<COMPREHENSIVE>|<REVIEWED> |
|
|
<magnitude-limits>
(Optional)
|
|||
|---|---|---|---|
| Parameter name | Possible values | Description | |
min_mag= |
any float or integer | Minimum magnitude of events | |
max_mag= |
any float or integer | Maximum magnitude of events. | |
null_mag= |
[<on>] |
If set to 'on', events with no known magnitude values will still be output if a min_mag
or max_mag is specified.
|
|
req_mag_type= |
<Any>|<MB>|<MS>|<MW>|<ML>|<MD> |
Limit events to specific magnitude types. Please note: the selected magnitude type will
search for all possible magnitudes in that category: E.g. MB will search for mb, mB, Mb, mb1mx, etc |
|
req_mag_agcy= |
<Any>|<prime>|<CODE> |
Limit events to magnitudes computed by the selected agency:
|
|
