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

eGSIM, through the GMPE-SMTK library, offers the ability to compare observed ground motions with the GMPE model predictions using the GMPE implementations found inside OpenQuake. This is a particularly powerful tool as it permits a hazard modeller to undertake the GMPE comparison using the exact same GMPE implementation found inside the seismic hazard software. All analyses undertaken will, by default, analyse the total residual, the inter-event residual and the intra-event residual, exposed to the user via Residuals plots.

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:

Selection expression

{% include "./selexpr_help.html" %}

Response

The number of generated Residuals plots will be the product of the requested Intensity measure types ({{ data.form.imt.name }}), the requested GMPEs ({{ data.form.gsim.name }}). Each Residual plot is futher subdivided into three subplots:

Plot type Residual plots per (GMPE, IMT) tuple Plot description Additional plot attributes
{{ data.form.plot_type.choices.0.1 }} Intra event
Inter event
Total		 Histogram of frequencies (y axis) vs residuals bins (x) Mean, standard deviation of the distribution
{{ data.form.plot_type.choices.1.1 }} Histogram of the frequencies (y) vs residuals likelihood bins (x) Median of the distribution
{{ data.form.plot_type.choices.2.1 }} Scatter plot of residuals (y) vs. magnitude (x) p-value and linear regression (slope, intercept)
{{ data.form.plot_type.choices.3.1 }} Same as above with distance as point's x
{{ data.form.plot_type.choices.4.1 }} Same as above with Vs30 as point's x
{{ data.form.plot_type.choices.5.1 }} Same as above with depth as point's x

JSON

Residuals plot data returned in JSON format will have the following structure: 

{
    "PGA": {
        "Intra event": {
            "AkkarEtAl2013": {
                "xvalues": [4, 4, 3.9, ...],
                "xlabel": "Magnitude",
                "yvalues": [-2.11, -2.27, -2.08, ...],
                "ylabel": "Z (PGA)",
                "slope": 0.269,      # see note 1
                "intercept": -1.998, # see note 1
                "pvalue": 6.6e-8,    # see note 1
                "median": null,      # see note 1
                "mean": null,        # see note 1
                "stddev": null       # see note 1
            },
            "CauzziEtAl2014": {
                # same Object type as above,
                # computed for a different GSIM
            },
            ...
        },
        "Inter event": {
            # same Object types as above,
            # computed for a different Residuals type
        },
        ...
    },
    "PGV": {
        # same Object types as above,
        # computed for a different IMT
    },
    ...
}
Notes:
  1. The parameters from slope, intercept, pvalue, median, stddev are provided (not null) depending on the value of {{ data.form.plot_type.name }}

CSV

Residuals plot data returned in CSV format will have the following structure (represented as csv table).
= x values (first cell is the x label), = y values (first cell is the y label)

imt type gsim mean stddev median slope intercept pvalue
PGA Intra event AkkarEtAl2013 0.269 -1.998 6.6e-8 Magnitude 4 4 3.9 …
Z (PGA) -2.11 -2.27 -2.08 …
PGA Intra event CauzziEtAl2014 0.28 -2.281 1.21e-8 Magnitude 4 4 3.9 …
Z (PGA) -1.116 -2.815 -2.11 …
PGA Inter event AkkarEtAl2013 0.103 -1.281 0.163 Magnitude 4 4 3.9 …
Z (PGA) -1.832 -1.913 -1.85 …
… … … … … … … … … … … … … …
PGV Intra event AkkarEtAl2013 0.171 -2.12 0.002 Magnitude 4 4 3.9 …
Z (PGV) -0.17 -1.11 -0.871 …
… … … … … … … … … … … … … …