Web services: Arrivals
Output a list of arrivals associated to events in the ISC Bulletin, as either QuakeML, a CSV file or in IMS1.0 format. Arrivals may be selected by station (individual names or defined region), phase name, event time, event region, event magnitude, event depth. Returned data comprise of:
- Phase data (station, phase, distance, back-azimuth, arrival-time, travel-time residual, etc.);
- Prime hypocentre origin (time, lat, lon, depth);
An overview of the available web services guides can be found on the web services page.
Event arrivals: URL construction
USAGE:
http://m.gxjydl.com/cgi-bin/web-db-run?<output-format><request-type><arrival-limits><station-region><event-region><event-time-range>[<event-depth-limits>][<event-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 arrivals from station WRA for phases P and Pg, where the arrival-time was time-defining. Search arrivals for all earthquakes in the ISC Bulletin between 2009-02-22 15:00:00 and 2009-04-22 15:00:00 where GCMT have computed a magnitude >= 5.5
QuakeML format:
http://m.gxjydl.com/cgi-bin/web-db-run?out_format=QuakeML&request=STNARRIVALS&stnsearch=STN&sta_list=WRA
&tdef=on&phaselist=P,PcP&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=CSV&request=STNARRIVALS&stnsearch=STN&sta_list=WRA&tdef=on&phaselist=P,PcP&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 arrivals from stations within a 10 degrees radius of Lat: 62 N; Lon: 114 W; for all S phases that are time-defining, from events 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 and are within 80 degrees radius of Lat: 62 N; Lon: 114 W.
QuakeML format:
http://m.gxjydl.com/cgi-bin/web-db-run?out_format=CSV&request=STNARRIVALS&stnsearch=CIRC&stn_ctr_lat=62&stn_ctr_lon=-114
&max_stndist_units=deg&stnradius=10&tdef=on&phaselist=S&searchshape=CIRC&ctr_lat=62&ctr_lon=-114&max_dist_units=deg&radius=80&start_year=2009
&start_month=2&start_day=22&start_time=15:00:00&end_year=2009
&end_month=4&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=CSV&request=STNARRIVALS&stnsearch=CIRC&stn_ctr_lat=62&stn_ctr_lon=-114
&max_stndist_units=deg&stnradius=10&tdef=on&phaselist=S&searchshape=CIRC&ctr_lat=62&ctr_lon=-114&max_dist_units=deg&radius=80&start_year=2009
&start_month=2&start_day=22&start_time=15:00:00&end_year=2009
&end_month=4&end_day=22&end_time=15:00:00&min_mag=5.5&req_mag_agcy=prime&req_mag_type=MB
Description of query options:
<output-format> |
|||
|---|---|---|---|
| Parameter name | Possible values | Description | |
out_format= |
<QuakeML>|<CSV>|<IMS1.0> |
|
|
<station-region> |
|||
|---|---|---|---|
| Parameter name | Possible values | Description | |
stnsearch= |
<STN>|<GLOBAL>|<RECT>|<CIRC>|<FE>|<POLY> |
|
|
Dependent parameters if: stnsearch=STN |
|||
sta_list= |
<CODE> | A valid station code. To search for available station codes, please check the station book in the International Registry of Seismograph Stations. | |
Dependent parameters if: stnsearch=RECT |
|||
stn_bot_lat= |
-90 to 90 | Bottom latitude of rectangular region | |
stn_top_lat= |
-90 to 90 | Top latitude of rectangular region | |
stn_left_lon= |
-180 to 180 | Left longitude of rectangular region | |
stn_right_lon= |
-180 to 180 | Right longitude of rectangular region | |
Dependent parameters if: stnsearch=CIRC |
|||
stn_ctr_lat= |
-90 to 90 | Central latitude of circular region | |
stn_ctr_lon= |
-180 to 180 | Central longitude of rectangular region | |
max_stn_dist_units= |
<deg>|<km> | Units of distance for a circular search: degrees or kilometres | |
stn_radius= |
any float or integer |
Radius for circular search region
|
|
Dependent parameters if: stnsearch=FE |
|||
stn_srn= |
1 to 50 | Seismic region number for a Flinn-Engdahl region search | |
stn_grn= |
1 to 757 | Geographic region number for a Flinn-Engdahl region search | |
Dependent parameters if: stnsearch=POLY |
|||
stn_coordvals= |
lat1,lon1,lat2,lon2,lat3,lon3,lat4,lon4,lat1,lon1 | Comma seperated list of coordinates for a desired polygon. Latitude needs to be before longitude. Coordinates in the western and southern hemispheres should be negative. | |
<event-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:
|
|
