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

Trellis plots provide an understanding of the manner in which each GMPE characterizes the ground motion scaling with respect to the properties of the seismic source, and the attenuation of the motion with respect to distance. By means of the underlying GMPE-SMTK library, eGSIM can generate different plot types:

IMT vs Magnitude plots show how the ground motion intensity value scales with respect to the magnitude of the rupture.
IMT vs Distance plots allow to compare how the GMPEs describe the attenuation of strong motion with distance for a given magnitude.
Magnitude-Distance spectra let the user understand how a GMPE will scale the response spectrum with magnitude and distance.

In addition to viewing the scaling of the expected ground motion from the GMPE, it is also possible to view the scaling of the standard deviation, for a total of six choosable plot types.

Request

A request to the Trellis plot service requires a list of GMPEs and IMTs, the desired plot type and the parameters configuring the scenario (rupture), most of which are optional. As discussed, parameters can be given in the endpoint URL (GET method) or as separate text data in JSON or YAML format (POST method) and are:

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

Notes:

SA in {{ data.form.imt.name }} must be provided with the given period in parentheses, e.g. ["SA(0.1)", "SA(0.2)"] (from the Web GUI, select SA and provide the periods in the field {{ data.form.sa_period.label }} separated by spaces or commas, e.g. 0.1 0.2). In any case, if {{ data.form.plot_type.name }} is {{ data.form.plot_type.choices.2.0 }} ({{ data.form.plot_type.choices.2.1 }}), then {{ data.form.imt.name }} can be omitted and will default to a list of pre-defined SA periods. Users can always provide their own list of SA with periods, but any other IMT will raise an error, if provided
{{ data.form.gsim.name }} and {{ data.form.imt.name }} can also be input with wildcards: eGSIM will then select all matching items (wildcards are not implemented in the Web GUI)

Response

The number of generated Trellis plots depends on the requested Intensity measure types (parameter {{ data.form.imt.name }}) and the parameters {{ data.form.magnitude.name }}, {{ data.form.distance.name }} and {{ data.form.vs30.name }} (which can be given as numeric scalr or array):

Plot type	Parameter setting the x values (should be numeric array):	The number of generated plots is the product of all supplied values of:
{{ data.form.plot_type.choices.0.1 }}	{{ data.form.distance.name }}	{{ data.form.imt.name }}, {{ data.form.magnitude.name }}, {{ data.form.vs30.name }}
{{ data.form.plot_type.choices.1.1 }}	{{ data.form.magnitude.name }}	{{ data.form.imt.name }}, {{ data.form.distance.name }}, {{ data.form.vs30.name }}
{{ data.form.plot_type.choices.2.1 }}	None: a set of pre-defined periods will be used	{{ data.form.magnitude.name }}, {{ data.form.distance.name }}, {{ data.form.vs30.name }}

JSON

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

{
    "xvalues": [2.905, 3.771, ... ],  # see note 1
    "xlabel": "Rupture Dist. (km)",
    "imts": ["PGA", "PGV"],
    "PGA": [
        {
            "yvalues": {
                "AkkarEtAl2013": [0.3811, 0.3812, ...],
                "CauzziEtAl2014": [0.283, 0.283, ...],
                ...
            },
            "ylabel": "Median PGA (g)",
            "magnitude": 5,    # see note 2
            "distance": null,  # see note 2
            "vs30": 760,
            "stdvalues": {},  # see note 3
            "stdlabel": ""    # see note 3
        },
        {
           # same Object as above, computed for
           # a different magnitude/distance/vs30
        },
        ...
    ],
    "PGV": [
        # same Array type as above,
        # computed for the PGV
    ],
    ...
}

Notes:

All plots share the same x axis and x values, thus for performance reasons those variables are not repeated inside each nested object.
magnitude and distance might be null when they represent the array of x values.
stdvalues is an empty object if the user did not choose to compute standard deviations: Otherwise, it is an Object equal to yvalues but mapping each GSIM to the list of standard deviations. If stdvalues is empty, then stdlabel is the empty string

CSV

Trellis plot data returned in CSV format will have the following structure.
= x values (first cell is the x label), = y values (first cell is the y label)

imt	gsim	magnitude	distance	vs30
					Rupture Dist. (km)	2.905	3.771	…
PGA	AkkarEtAl2013	5		760	Median PGA (g)	0.3811	0.3812	…
PGA	CauzziEtAl2014	5.5		760	Median PGA (g)	0.283	0.283	…
…	…	…	…	…	…	…	…	…
PGV	AkkarEtAl2013	5		760	Median PGV (g)	0.21	0.291	…