ESM GMMresid 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" "https://esmdev.mi.ingv.it/esmws/gmm-resid/1/query?resid=var&gmm=ITA18&plot=true"

HTTP-POST variables (required)

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

Query options

Option	Description	Default
gmm	Select a specific Ground-Motion Model (GMM). Multiple GMMs are not allowed. Available GMMs are 'ITA18' for Itlay and 'KOT20' for Europe.	ITA18
dist_type	Allowed types of distance are 'rjb' (Joyner-Boore) and 'rrup' (rupture). 'ITA18' is defined for 'rjb' and 'rrup' distances, 'KOT20' for 'rjb'	rjb
resid	Select a ground motion residual component: 'dBe': between-event residual component (with standard errors and the number of records for each period) 'dS2S': site-to-site residual component (with standard errors, the number of records for each period, dS2S for Vs30=800 m/s, and event-corrected and site-corrected variability at single-site) 'dW0e': event-corrected and site-corrected residual component 'var': standard deviation components obtained from residual analysis (sigma, tau, phiS2S, phi0), the offset term of the residual analysis is also provided along with the periods vector	dBe
eventid	Select a specific event by ESM ID; Multiple codes are comma-separated. It must be a valid code or 'all'. Allowed wildcard: '' (matches zero or more characters) or '?' (matches a single character). NOTE*: event selection is not allowed when 'resid' is set to 'dS2S' and 'var'	all
siteid	Select one or more site ids (format = NETWORK.STATION.LOCATION, e.g. IT.AQV.00 or IV.ACER.). Multiple ids are comma-separated. It must be a valid code or 'all'. NOTE: site selection is not allowed when 'residual-component' is set to 'dBe' and 'var'. In 'post-event' modality, when 'all' is selected, the first 10 stations, sorted by distance, are provided.	all
post-event	Set 'True' if the selected eventid is not included in the library of the GMM residuals. If 'True' insert only one 'eventid'. NOTE: this option doesn't work with 'resid' option	False
periods	Select the preferred spectral periods. The possible values are: pga, pgv, 0.01, 0.025, 0.04, 0.05, 0.07, 0.1, 0.15, 0.2, 0.25, 0.3, 0.35, 0.4, 0.45, 0.5, 0.6, 0.7, 0.75, 0.8, 0.9, 1.0, 1.2, 1.4, 1.6, 1.8, 2.0, 2.5, 3.0, 3.5, 4.0, 4.5, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0. Default: 'pga, pgv, 0.3, 1.0, 3.0' NOTE: This option is valid only for plots in case 'post-event' is True.	'pga, pgv, 0.3, 1.0, 3.0'
buffer	Select the type of buffer to plot the dBe of the regional events for the post-event modality. 'circle' 'ZS16' 'BRN'	circle
plot	Also add png plots to results {True,False}. NOTE: 'True' values is not allowed when 'siteid=all' or 'eventid=all'	false

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