Endpoint: {{ baseurl }}/{{ data.path }}

eGSIM, through the GMPE-SMTK library, offers the ability to test the GMPE model predictions using the GMPE implementations found inside OpenQuake with respect to observed ground motions, by means of one or more measures of fit.

Request

A request to the Residuals plot service requires a list of GMPEs and IMTs, a Ground Motion database (GMDB) and the desired plot type.

{% include "./request_template.html" with form=data.form %}
Notes:

Response

JSON

The reponse Object is an Object with keys representing the chosen measures of fit ({{ data.form.fit_measure.name }}), mapped to the chosen {{ data.form.imt.name }}s. Each IMT is in turn an Object of chosen {{ data.form.gsim.name }}s mapped to the resulting model-to-data value. Note that from a single {{ data.form.fit_measure.name }} in the request several ones might be returned in the response. E.g., choosing {{ data.form.fit_measure.choices.0.0 }} ({{ data.form.fit_measure.choices.0.1 }}) the {{ data.form.fit_measure.name }}s in the response will be six: Residuals Inter event Mean, Residuals Inter event Std Dev, Residuals Intra event Mean, Residuals Intra event Std Dev, Residuals Total Mean and Residuals Total Std Dev. The JSON structure is outlined below:

{
	"Measure of fit": {
		# The following properties represent the chosen measures of fit
		# (thus, some of them might be missing depending on the user's request)
		# and are mapped to Objects with these properties:
		"Residuals inter event mean": {
			"PGA": {
				"BindiEtAl2011": 0.01,
				"CauzziEtAl2014": 0.02,
				...
			},
			"PGV": {
				# same Object type as above,
				# computed for a different IMT
			},
			...
		},
		# same Objects types as above, computed for a different MOF:
		"Residuals inter event stddev": { ... },
		"Residuals intra event mean": { ... },
		"Residuals intra event stddev": { ... },
		"Residuals total mean": { ... },
		"Residuals total stddev": { ... },
		"Likelihood inter event median": { ... },  # see note 1
		"Likelihood intra event median": { ... },  # see note 1
		"Likelihood total median": { ... },        # see note 1
		"Likelihood inter event iqr": { ... },     # see note 1
		"Likelihood intra event iqr": { ... },     # see note 1
		"Likelihood total iqr": { ... },           # see note 1
		"Log-likelihood": { ... },
		"Multivariate log-likelihood": { ... }     # see note 1
		"Euclidean distance-based ranking mde norm": { ... }    # see note 2
		"Euclidean distance-based ranking sqrt kappa": { ... }  # see note 2
		"Euclidean distance-based ranking edr": { ... }         # see note 2
	},
	"Db records": {
		"BindiEtAl2011": 1023,
		"CauzziEtAl2014": 2012,
		...
	},
	"Gsim skipped":{
		"AbrahamsonEtAl2014NSHMPUpper": "No db record found",
		...
	}
}
Notes:
  1. {{ data.form.fit_measure.choices.2.0 }} ({{ data.form.fit_measure.choices.2.1 }}) and {{ data.form.fit_measure.choices.3.0 }} ({{ data.form.fit_measure.choices.3.1 }}) include also the value All for {{ data.form.imt.name }}
  2. {{ data.form.fit_measure.choices.4.0 }} ({{ data.form.fit_measure.choices.4.1 }}) are not associated with any {{ data.form.imt.name }}, thus their values will be an Object keyed by the empty string ""

CSV

measure of fit imt gsim value db records used
Residuals inter event mean PGA BindiEtAl2011
Residuals inter event mean PGA CauzziEtAl2014
Residuals intra event mean PGA BindiEtAl2011
Residuals Inter event Mean PGV BindiEtAl2011
Residuals Inter event Mean PGV CauzziEtAl2014
Notes: