Data can be obtained using any program supporting the HTTP-GET method, e.g. your favourite web browser:
https://esm-db.eu/esmws/flatfile/1/query?eventid=INT-20220209_0000149&network=IT&station=NVL&channel=HG
https://esm-db.eu/esmws/flatfile/1/query?eventid=EMSC-20161030_0000029&max-epicentral-distance=30&include-fields=ESM_event_id,network_code,station_code
https://esm-db.eu/esmws/flatfile/1/query?eventid=EMSC-20200224_0000188&include-fields=ESM_event_id,network_code,station_code,st_latitude,st_longitude,preferred_vs30_m_s,rotD50_pga,rotD50_pgv&output-format=shapefile
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://esm-db.eu/esmws/flatfile/1/query?eventid=INT-20220829_0000132&network=NP&station=1581&channel=HN"
HTTP-POST variables (required)
Option | Description |
---|---|
message | The clearsign token obtained from the generate-signed-message authentication webservice. |
Option | Description | Default |
---|---|---|
spectra | {SA, SD} Specify the type of the response spectrum ('SA' = spectral acceleration ordinates; 'SD' = spectral displacement ordinates). | SA |
include-fields | Specify the fields to be included in the output table. A complete list of the available fields can be found here | * |
output-format | {csv, shapefile} Specify the output format. NOTE:output-format = shapefile format must include events and/or stations coordinates. | csv |
contains-string | {True, False} Specify the search mode ('contains' or 'exact') for some search options (eventid,event-name,event-region,event-province,event-municipality,station,station-name,station-country,station-region,station-province) | True |
EVENT METADATA | ||
eventid | Specify events by ESM-ID according to the ESM database. Multiple IDs are comma-separated. | * |
event-name | Specify the name of the event according to the ESM database. | * |
event-country | Specify ISO 3166-1 alpha-2 of the event country. Multiple countries are comma-separated. | * |
event-region | Specify the administrative region of the event. Multiple regions are comma-separated. | * |
event-province | Specify the administrative province of the event. | * |
event-municipality | Specify the municipality of the event. | * |
starttime | Limit to waveforms related to events on or after the specific start time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM-DD'. | * |
endtime | Limit to waveforms related to events on or before the specific end time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM-DD'. | * |
min-event-latitude | Minumum value of latitude for events selection. | n/a |
max-event-latitude | Maximum value of latitude for events selection. | n/a |
min-event-longitude | Minumum value of longitude for events selection. | n/a |
max-event-longitude | Maximum value of longitude for events selection. | n/a |
min-event-depth | Minumum value of hypocentral depth [km] for events selection. | n/a |
max-event-depth | Maximum value of hypocentral depth [km] for events selection. | n/a |
min-magnitude | Limit to events with a magnitude larger than the specified minimum value (Mw or Ml or Ms or Mb or Md or generic M). | n/a |
max-magnitude | Limit to events with a magnitude smaller than the specified minimum value (Mw or Ml or Ms or Mb or Md or generic M). | n/a |
style-of-faulting | {NF, TF, SS, U} Specify the style of faulting ('NF' = normal faulting; 'TF' = thrust faulting; 'SS' = strike-slip faulting; 'U' = unknown). Multiple style of faulting are comma-separated. | * |
STATION METADATA | ||
network | Specify one or more SEED network available in the ESM database. Multiple codes are comma-separated. | n/a |
station | Specify one or more SEED station code available in the ESM database. Multiple codes are comma-separated. | n/a |
max-sensor-depth | Specify maximum value of the depth of the sensor [m]. | n/a |
station-name | Specify the name of the station according the ESM database. | * |
station-country | Specify ISO 3166-1 alpha-2 of the station country. Multiple countries are comma-separated. | * |
station-region | Specify the administrative region of the station. Multiple regions are comma-separated. | * |
station-province | Specify the administrative province of the station. | * |
station-municipality | Specify the municipality of the station. | * |
min-sta-latitude | Minumum value of latitude for stations selection. | n/a |
max-sta-latitude | Maximum value of latitude for stations selection. | n/a |
min-sta-longitude | Minumum value of longitude for stations selection. | n/a |
max-sta-longitude | Maximum value of longitude for stations selection. | n/a |
min-vs30 | Minumum value of VS,30 [m/s] for stations selection. This option cannot be used in conjunction with the "soil-class" option. | n/a |
max-vs30 | Maximum value of VS,30 [m/s] for stations selection. This option cannot be used in conjunction with the "soil-class" option. | n/a |
soil-class | {A, B, C, D, E} Specify the soil class according to NTC18 or EC8 classification. Multiple classes are comma-separated. This option cannot be used in conjunction with the "min-vs30" or "max-vs30" options. | * |
estimation-method | {geophysical, geology, topography} Specify the method used to estimate the VS,30 values or NTC18/EC8 site classes. ('geophysical' = from geophysical survey; 'geology' = from surface geology; 'topography' = from topographic proxy). | ALL |
reference-site | {Y, N, ALL} Possibility to select only station classified as reference sites according to Lanzano et al. (2022) ('Y' = only reference sites; 'N' = not reference sites). | ALL |
WAVEFORM METADATA | ||
channel | {HN, HG, HL, EH, HH} Specify the channel code of the waveforms selection: EH/HH = velicimeter sensors; HN/HG/HL = accelerometric sensors. Multiple codes are comma-separated. | * |
instrument-type | {A, D, U, ALL} Specify the instrument type of the waveforms selection ('A' = analog; 'D' = digital; 'U' = unknown; 'ALL' = analog and digita. | ALL |
min-epicentral-distance | Limit to waveforms with epicentral distance greater than the specified minimum. | n/a |
max-epicentral-distance | Limit to waveforms with epicentral distance smaller than the specified maximum. | n/a |
min-joynerboore-distance | Limit to waveforms with Joyner-Boore distance greater than the specified minimum. | n/a |
max-joynerboore-distance | Limit to waveforms with Joyner-Boore distance smaller than the specified maximum. | n/a |
min-unprocessed-pga | Minumum value of unprocessed Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
max-unprocessed-pga | Maximum value of unprocessed Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
min-pga | Minumum value of horizontal Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
max-pga | Maximum value of horizontal Peak-Ground Acceleration [cm/s^2] for waveforms selection. | n/a |
min-pgv | Minumum value of horizontal Peak-Ground Velocity [cm/s] for waveforms selection. | n/a |
max-pgv | Maximum value of horizontal Peak-Ground Velocity [cm/s] for waveforms selection. | n/a |
min-pgd | Minumum value of horizontal Peak-Ground Displacement [cm] for waveforms selection. | n/a |
max-pgd | Maximum value of horizontal Peak-Ground Displacement [cm] for waveforms selection. | n/a |
min-arias-intensity | Minumum value of horizontal Arias Intensity [cm/s] for waveforms selection. | n/a |
max-arias-intensity | Maximum value of horizontal Arias Intensity [cm/s] for waveforms selection. | n/a |
min-housner-intensity | Minumum value of horizontal Housner Intensity [cm] for waveforms selection. | n/a |
max-housner-intensity | Maximum value of horizontal Housner Intensity [cm] for waveforms selection. | n/a |
min-t90 | Minumum value of horizontal T90 [cm] for waveforms selection. | n/a |
max-t90 | Maximum value of horizontal T90 [cm] for waveforms selection. | n/a |
late-triggered | {Y, N, ALL} Possibility to select only late-triggered wavefomrs ('Y' = only late-triggered waveforms; 'N' = not include late-triggered waveforms; 'ALL' = include also late-triggered waveforms). | ALL |
include-pulse-like | {0, 1, 3, 4, 9, ALL} 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. | ALL |
unprocessed | {Y, N} Possibility to include the unprocessed waveforms in the selection ('Y' = include; 'N' = not include) | N |
bad-quality | {Y, N} Possibility to include the bad-quality waveforms in the selection ('Y' = include; 'N' = not include) | N |
processing-type | {MP, AP, MB, AB, ALL} Specify the processing type for the waveforms selection ('MP' = manually processed using Paolucci et al. (2011); 'AP = automatically processed using Paolucci et al., 2011; 'MB' = manually processed with eBASCO procedure; 'AB' = automatically processed with eBASCO procedure | MP |
Backend Python software used by this web service is developed and maintained by Felicetta C. and Russo E.