Data can be obtained using any program supporting the HTTP-GET method, e.g. your favourite web browser:
https://esmdev.mi.ingv.it/esmws/website-waveforms/1/query?esm-id=INT-20220209_0000149&network-code=IT&station-code=NVLhttps://esmdev.mi.ingv.it/esmws/website-waveforms/1/query?epicentral-distance-to=200&pga-from=5https://esmdev.mi.ingv.it/esmws/website-waveforms/1/query?magnitude-from=5&magnitude-to=6&station-code=AESM 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/website-waveforms/1/query?esm-id=INT-20220829_0000132&network-code=NP&station-code=1581&instrument-code=HN"HTTP-POST variables (required)
| Option | Description |
|---|---|
| message | The clearsign token obtained from the generate-signed-message authentication webservice. |
| Option | Description | Default |
|---|---|---|
| output-format | Specify format of result, currently only 'json' is supported | json |
| json-output-style | {compact,verbose} Specify a style for output | compact |
| indent-json | {True,False} Valid only in combination with 'json' format. Prettifies output setting a 4 spaces indentation style. | False |
| pagination-limit | Pagination limit. Dafault value '0' corresponds to no limit raws for the results. | 0 |
| pagination-offset | {True,False} Pagination offset. Dafault value '0' corresponds to no pgination. | False |
| orderby-field | Results are shown ordered by field-direction | date |
| orderby-direction | {'desc','asc'} Direction of the orderby-field parameter. | desc |
| WAVEFORM METADATA | ||
| epicentral-distance-from | Limit to waveforms with epicentral distance greater than the specified minimum. | n/a |
| epicentral-distance-to | Limit to waveforms with epicentral distance smaller than the specified maximum. | n/a |
| rjb-from | Limit to waveforms with Joyner-Boore distance greater than the specified minimum. | n/a |
| rjb-to | Limit to waveforms with Joyner-Boore distance smaller than the specified maximum. | n/a |
| unprocessed-pga-from | Minumum value of unprocessed Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
| unprocessed-pga-to | Maximum value of unprocessed Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
| pga-from | Minumum value of horizontal Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
| pga-to | Maximum value of horizontal Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
| pgv-from | Minumum value of horizontal Peak-Ground Velocity [cm/s] for waveforms selection. | n/a |
| pgv-to | Maximum value of horizontal Peak-Ground Velocity [cm/s] for waveforms selection. | n/a |
| pgd-from | Minumum value of horizontal Peak-Ground Displacement [cm] for waveforms selection. | n/a |
| pgd-to | Maximum value of horizontal Peak-Ground Displacement [cm] for waveforms selection. | n/a |
| arias-intensity-from | Minumum value of horizontal Arias Intensity [cm/s] for waveforms selection. | n/a |
| arias-intensity-to | Maximum value of horizontal Arias Intensity [cm/s] for waveforms selection. | n/a |
| housner-intensity-from | Minumum value of horizontal Housner Intensity [cm] for waveforms selection. | n/a |
| housner-intensity-to | Maximum value of horizontal Housner Intensity [cm] for waveforms selection. | n/a |
| t90-from | Minumum value of horizontal T90 [cm] for waveforms selection. | n/a |
| t90-to | Maximum value of horizontal T90 [cm] for waveforms selection. | n/a |
| trigger-type | {any,late,normal} Possibility to select only late-triggered wavefomrs ('late' = only late triggered data; 'normal' = not include late triggered data). | any |
| include-pulse-like | {0,1,3,4,9,any} Select waveforms with peculiarities in terms of pulse-like behaviour ('0' = non-pulse like behaviour; '1' = pulse-like behaviour; '2' = pulse-like behaviour most likely caused by site effects; '3' = pulse-like behaviour linked to near-source fling-step ground motion; '4' = pulse-like behaviour linked to directivity effects; '9' = not investigated. | any |
| instrument-code | Specify the channel code of the waveforms selection: EH/HH/DH = velicimeter sensors; HN/HG/HL/DH = accelerometric sensors. | n/a |
| instrument-type | {A,D,U,any} Specify the instrument type of the waveforms selection ('A' = analog; 'D' = digital; 'U' = unknown; 'any' = analog, digital, and unknown. | ALL |
| processing-scheme | {P,M,A,U,any} Specify processing scheme for data selection: 'P' = processed (any scheme); 'M' = manually processed (any scheme); 'A' = automatically procecessed (any scheme); 'U' = unprocessed. The processing procedure are Paolucci et al. (2011) and eBASCO. | any |
| show-discaded-data | {True,False} "True = Select also data with manually discarded processing. | False |
| quality-class | {1,2,3,4,any} Specify waveform quality ('1' = BEST; '2' = GOOD; '3' = BAD; '4' = UNDEF) | any |
| EVENT METADATA | ||
| esm-id | Select a specific event by ESM-ID according to the ESM database. Event ids containing the specified string will be selected. | n/a |
| event-name | Select a specific event by ID; Event names containing the specified string will be selected. | n/a |
| event-country | ISO code of country in which the event occurred. | any |
| event-latitude-from | Limit to events with a latitude larger than or equal to the specified minimum. | -90 |
| event-latitude-to | Limit to events with a latitude smaller than or equal to the specified maximum. | 90 |
| event-longitude-from | Limit to events with a longitude larger than or equal to the specified minimum. | -180 |
| event-longitude-to | Limit to events with a longitude smaller than or equal to the specified maximum. | 180 |
| hypocentral-depth-from | Limit to events with hypocentral depth (in km) greater than the specified minimum. | 0 |
| hypocentral-depth-to | Limit to events with hypocentral depth (in km) smaller than the specified minimum. | 100000 |
| date-time-from | 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 |
| date-time-to | 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' |
| magnitude-from | Limit to events with the preferred magnitude larger than the specified minimum. | 0 |
| magnitude-to | Limit to events with the preferred magnitude smaller than the specified minimum. | 10 |
| style-of-faulting | {NF,NS,O,SS,TF,TS,U,any} Specify the style of faulting ('NF' = normal faulting; 'TF' = thrust faulting; 'SS' = strike-slip faulting; 'U' = unknown). | any |
| STATION METADATA | ||
| network-code | Select one network code. | n/a |
| station-code | Specify one station code. | n/a |
| station-name | Specify the name of the station according the ESM database. | n/a |
| station-country | Specify ISO 3166-1 alpha-2 of the station country. | any |
| station-latitude-from | Limit to stations with a latitude larger than or equal to the specified minimum. | -90 |
| station-latitude-to | Limit to stations with a latitude smaller than or equal to the specified maximum. | 90 |
| station-longitude-from | Limit to stations with a longitude larger than or equal to the specified minimum. | -180 |
| station-longitude-to | Limit to stations with a longitude smaller than or equal to the specified maximum. | 180 |
| vs30-ec8-method | {0,1,2,any} Specify the method used to estimate the VS,30 values or NTC18/EC8 site classes. ('0' = from geophysical survey; '1' = from surface geology; '2' = from topographic proxy). | any |
| ec8-code | {A,B,C,D,E,any} Specify the soil class according to NTC18 or EC8 classification. This option cannot be used in conjunction with the "min-vs30" or "max-vs30" options. | n/a |
| vs30-from | Limit to stations with vs30 values (in m/s) greater than the specified minimum. | 0 |
| vs30-to | Limit to stations with vs30 value (in m/s) smaller than the specified minimum. | 100000 |
| reference-site | {0,1,2,any} 0=search for stations not classified as reference site; 1=search for stations classified as reference site; 2=search for stations not analyzed. | any |
Backend Python software used by this web service is developed and maintained by Felicetta C. and Russo E.