ESM Dataset Selection Web-Service

Sample requests

Data can be obtained using any program supporting the HTTP-GET method, e.g. your favourite web browser:

Restricted Data (authenticated users only)

ESM Administrators and users with special authorizations can access data intended for internal use and/or embargoed.
Data can be obtained using any program supporting the HTTP-POST method, e.g. CURL:

curl -X POST -F "message=@path/to/token.txt" "https://esmdev.mi.ingv.it/esmws/dataset-selection/1/query?starttime=2012-01-10&endtime=2012-01-20&unprocessed=false&qc=false&qd=false"
curl -X POST -F "message=@path/to/token.txt" "https://esmdev.mi.ingv.it/esmws/dataset-selection/1/query?network=IV&minmag=5&maxdist=30"

Query options

HTTP-POST variables (required)

Option	Description	Default
message	The clearsign token obtained from the generate-signed-message authentication webservice or from EIDA authentication webpage.

URL format

Option	Description	Default
eventid	ESM event ID. Supported wildcard are or '*' (matches zero or more characters) or '?' (matches just one character).	'*'
starttime	Limit to events on or after the specified start time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM- DD'.	'1900-01-01T00:00:00'
endtime	Limit to events on or before the specified end time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM- DD'.	'2100-01-01T00:00:00'
minmag	Limit to events with a magnitude larger than the specified minimum.	0
maxdist	Limit to stations with epicentral distance smaller than the specified maximum.	3000
network	ESM network code (i.e. FDSN network code). Supported wildcard are or '*' or '?'.	'*'
station	ESM station code (SEED station code or data center defined code). Supported wildcard are or '*' or '?'.	'*'
instrument	Instrument code. Supported wildcard are or '*' or '?'.	'*'
unprocessed	{true,false} Include unprocessed data.	true
discarded	{true,false} Include manually discarded data.	true
automatic	{true,false} Include automatically processed data.	true
manual	{true,false} Include manually processed data.	true
standard	{true,false} Include data processed with default/standard ESM method (Paolucci et al. 2011 aka ITACA) as preferred, both manual and automatic modes.	true
ebasco	{true,false} Include data processed with eBASCO method (Schiappapietra et al. 2021) as preferred, both manual and automatic modes.	true
processing-filter-logic	{preferred,available} Specify a criterion for filter on processing scheme. Available types are: 'available' (the processing scheme specified by manual/automatic + standard/ebasco options is available for selected waveforms.), 'preferred' (the processing scheme specified by manual/automatic + standard/ebasco options is the preferred scheme for selected waveforms.).	preferred
best	{true,false} Include data classified as 'best quality'.	true
good	{true,false} Include data classified as 'good quality'.	true
bad	{true,false} Include data classified as 'bad quality'.	true
undef	{true,false} nclude data classified as 'undefined'.	true
quality-reason	Select 'all' or one or more quality reason codes (see table below for description). Multiple codes are comma-separated.	all
format	{json} Specify format of result, currently only 'json' is supported.	'json'
offset	Pagination offset. NOTE: setting offset=0 and limit=0 disables pagination.	0
limit	Pagination limit. NOTE: setting offset=0 and limit=0 disables pagination.	0
indent	{true,false} Prettifies output setting a 4 spaces indentation style. Valid only in combination with 'json' format.	false

Quality reason codes for option 'qr'

Code	Description	Quality class
1	High Signal to Noise Ratio	BEST
2	PGA > 2g	GOOD
3	one component more than twice the other (ACC)	GOOD
4	unreliable P-wave arrival	GOOD
5	more events detected	GOOD
6	restricted frequency passband	GOOD
7	too short duration for one or more components	BAD
8	one zero component	BAD
9	cannot_compute_zeroes_percent	BAD
10	one or more quasi zero component	BAD
11	auto trigger failed	BAD
12	auto PS phase picking failed	BAD
13	Low Signal to Noise Ratio	BAD
14	Anomalous Signal to Noise Ratio	BAD
15	very restricted frequency passband	BAD
16	missing one component	UNDEF
17	one empty component	UNDEF
18	Undefined Quality Index	UNDEF

Backend Python software used by this web service is developed and maintained by Russo E. and Felicetta C.