ESM Plot Web-Service

Sample requests

Publicly Available Data

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" -o output.png "https://esm-db.eu/esmws/plot/1/query?eventid=INT-20220829_0000132&network=NP&station=1581&location=10&instrument=HN&uori=E&vori=N&wori=Z&ptype=MP&plot=PRE&rz=True"

HTTP-POST variables (required)

Option	Description
message	The clearsign token obtained from the generate-signed-message authentication webservice.

Query options

Option	Description	Default
eventid	Select one event ID.	n/a
network	Select one network code.	n/a
station	Select one station code.	n/a
location	Select one location identifier.	n/a
instrument	Select one instrument code.	n/a
uori	Select one orientation identifier for first horizontal component.	n/a
vori	Select one orientation identifier for second horizontal component.	n/a
wori	Select one orientation identifier for vertical component.	n/a
ptype	{MP,AP,MB} Specify processing type for data selection: 'MP' (manually processed using Paolucci et al., 2011), 'AP' (automatically processed using Paolucci et al., 2011), and 'MB' (manually processed using Schiappapietra et al., 2021).	MP
plot	{PRE,FFT,ACC,VEL,DIS,SA,SD,SNR,GMM}. Specify the type of plot for data selection: 'PRE' (preview of acceleration, in cm/s^2), 'FFT' (Fourter spectra, in cm*s/s^2), 'ACC' (acceleration, in cm/s^2), 'VEL' (velocity, in cm/s), 'DIS' (displacement, in cm), 'SA' (acceleration response spectra, in cm/s^2), 'SD' (displacement response spectra, in cm), 'SNR' (Signal to Noise Ratio), and 'GMM' (Ground Motion Model vs observed SA, in cm/s^2)	PRE
data	{true,false} Add actual data to Graphics Objects.	True
transparency	{true,false} Add Transparency to Graphics Objects.	false
psarrivals	{true,false} Add P- and S-waves arrivals to acceleration, velocity and displacement traces	false
psauto	{true,false} Add P- and S-waves computed from tarce by Obspy ar_pick algorithm to acceleration, velocity, and displacement taces	false
channels	{true,false} Add ground motion orientation to graphic objects.	false
annotations	{true,false} Add annotations to graphic objects.	false
axes	{true,false} Add axes to graphic objects.	false
xscale	{linear,log} Set frequency scale for FFT plots.	log
grid	{true,false} Add grid axes to graphic objects.	false
peakvalues	{true,false} AAdd ground motion peak values to graphic objects.	false
frequencies	{true,false} Add corner frequencies of the Fourier Spectra filter.	false
unprocessed	{true,false} Add only unprocessed wavefroms to graphic objects.	false
rz	{true,false} Plot waveforms from main 'recordingz' repository. NOTE: use temporary user directory (default) is useful in combination with the processing workflow services	false
tmpdir	Specify a subdirectory name to get data from (valid only in combination with 'rz=false'). NOTE: Only alphanumeric characters are allowed.	n/a
format	{PNG,base64} Specify format of result.	PNG

Backend Python software used by this web service is developed and maintained by Russo E., D'Amico M., and Felicetta C.