openquake.hazardlib.gsim package

Ground-shaking intensity models

abrahamson_2014

Module exports AbrahamsonEtAl2014

AbrahamsonEtAl2014RegCHN AbrahamsonEtAl2014RegJPN AbrahamsonEtAl2014RegTWN

class openquake.hazardlib.gsim.abrahamson_2014.AbrahamsonEtAl2014(**kwargs)

Bases: GMPE

Implements GMPE by Abrahamson, Silva and Kamai developed within the the PEER West 2 Project. This GMPE is described in a paper published in 2014 on Earthquake Spectra, Volume 30, Number 3 and titled ‘Summary of the ASK14 Ground Motion Relation for Active Crustal Regions’.

COEFFS = <CoeffsTable m1 vlin b c c4 a1 a2 a3 a4 a5 a6 a7 a8 a10 a11 a12 a13 a14 a15 a17 a43 a44 a45 a46 a25 a28 a29 a31 a36 a37 a38 a39 a40 a41 a42 s1e s2e s3 s4 s1m s2m s5 s6>

Coefficient tables as per annex B of Abrahamson et al. (2014)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent average horizontal RotD50, see page 1025.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see tables 4 pages 1036

DEFINED_FOR_REFERENCE_VELOCITY = 1180

Reference rock conditions as defined at page

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see paragraph “Equations for standard deviations”, page 1046.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see title!

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx', 'ry0'})

Required distance measures are Rrup, Rjb, Ry0 and Rx (see Table 2, page 1031).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'width', 'ztor'})

Required rupture parameters are magnitude, rake, dip, ztor, and width (see table 2, page 1031)

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'vs30measured', 'z1pt0'})

Required site parameters are Vs30 and Z1.0, see table 2, page 1031 Unit of measure for Z1.0 is [m]

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.abrahamson_2014.CONSTS = {'h1': 0.25, 'h2': 1.5, 'h3': -0.75, 'm2': 5.0, 'n': 1.5}

equation constants (that are IMT independent)

openquake.hazardlib.gsim.abrahamson_2014.get_epistemic_sigma(ctx)

This function gives the epistemic sigma computed following USGS-2014 approach. Also, note that the events are counted in each magnitude and distance bins. However, the epistemic sigma is based on NZ SMDB v1.0

abrahamson_2015

Module exports AbrahamsonEtAl2015

AbrahamsonEtAl2015SInter AbrahamsonEtAl2015SInterHigh AbrahamsonEtAl2015SInterLow AbrahamsonEtAl2015SSlab AbrahamsonEtAl2015SSlabHigh AbrahamsonEtAl2015SSlabLow

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SInter(**kwargs)

Bases: GMPE

Implements the Subduction GMPE developed by Norman Abrahamson, Nicholas Gregor and Kofi Addo, otherwise known as the “BC Hydro” Model, published as “BC Hydro Ground Motion Prediction Equations For Subduction Earthquakes (2015, Earthquake Spectra, in press), for subduction interface events.

From observations of very large events it was found that the magnitude scaling term can be adjusted as part of the epistemic uncertainty model. The adjustment comes in the form of the parameter DeltaC1, which is period dependent for interface events. To capture the epistemic uncertainty in DeltaC1, three models are proposed: a ‘central’, ‘upper’ and ‘lower’ model. The current class implements the ‘central’ model, whilst additional classes will implement the ‘upper’ and ‘lower’ alternatives.

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

COEFFS_MAG_SCALE = <CoeffsTable dc1>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 1000

Reference soil conditions (bottom of page 29)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see table 3, pages 12 - 13

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

FABA_ALL_MODELS = {'Gaussian': <class 'openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperGaussian'>, 'Linear': <class 'openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperLinear'>, 'SFunc': <class 'openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperSFunc'>, 'Sigmoid': <class 'openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperSigmoid'>, 'Step': <class 'openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperStep'>}

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'backarc', 'vs30'})

Site amplification is dependent upon Vs30 For the Abrahamson et al (2013) GMPE a new term is introduced to determine whether a site is on the forearc with respect to the subduction interface, or on the backarc. This boolean is a vector containing True for a backarc site or False for a forearc or unknown site.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

delta_c1 = None

kind = 'base'

trt = 'Subduction Interface'

Supported tectonic region type is subduction interface

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SInterHigh(**kwargs)

Bases: AbrahamsonEtAl2015SInter

Defines the Abrahamson et al. (2013) scaling relation assuming the upper values of the magnitude scaling for large slab earthquakes, as defined in table 4

COEFFS_MAG_SCALE = <CoeffsTable dc1>

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SInterLow(**kwargs)

Bases: AbrahamsonEtAl2015SInter

Defines the Abrahamson et al. (2013) scaling relation assuming the lower values of the magnitude scaling for large slab earthquakes, as defined in table 4

COEFFS_MAG_SCALE = <CoeffsTable dc1>

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SInter_scaled(**kwargs)

Bases: AbrahamsonEtAl2015SInter

Implements the Subduction GMPE developed by Norman Abrahamson, Nicholas Gregor and Kofi Addo, otherwise known as the “BC Hydro” Model, published as “BC Hydro Ground Motion Prediction Equations For Subduction Earthquakes (2015, Earthquake Spectra, in press), for subduction interface events.

Application of a scaling factor that converts the prediction of AbrahamsonEtAl2015SInter to the corresponding prediction for the Maximum value.

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SSlab(**kwargs)

Bases: AbrahamsonEtAl2015SInter

Implements the Subduction GMPE developed by Norman Abrahamson, Nicholas Gregor and Kofi Addo, otherwise known as the “BC Hydro” Model, published as “BC Hydro Ground Motion Prediction Equations For Subduction Earthquakes (2013, Earthquake Spectra, in press). This implements only the inslab GMPE. For inslab events the source is considered to be a point source located at the hypocentre. Therefore the hypocentral distance metric is used in place of the rupture distance, and the hypocentral depth is used to scale the ground motion by depth

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral for in-slab events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

In-slab events require constraint of hypocentral depth and magnitude

delta_c1 = -0.3

trt = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SSlabHigh(**kwargs)

Bases: AbrahamsonEtAl2015SSlab

Defines the Abrahamson et al. (2013) scaling relation assuming the upper values of the magnitude scaling for large slab earthquakes, as defined in table 8

delta_c1 = -0.1

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SSlabLow(**kwargs)

Bases: AbrahamsonEtAl2015SSlab

Defines the Abrahamson et al. (2013) scaling relation assuming the lower values of the magnitude scaling for large slab earthquakes, as defined in table 8

delta_c1 = -0.5

class openquake.hazardlib.gsim.abrahamson_2015.AbrahamsonEtAl2015SSlab_scaled(**kwargs)

Bases: AbrahamsonEtAl2015SInter_scaled

Implements the Subduction GMPE developed by Norman Abrahamson, Nicholas Gregor and Kofi Addo, otherwise known as the “BC Hydro” Model, published as “BC Hydro Ground Motion Prediction Equations For Subduction Earthquakes (2013, Earthquake Spectra, in press). This implements only the inslab GMPE. For inslab events the source is considered to be a point source located at the hypocentre. Therefore the hypocentral distance metric is used in place of the rupture distance, and the hypocentral depth is used to scale the ground motion by depth

Application of a scaling factor that converts the prediction of AbrahamsonEtAl2015SSlab to the corresponding prediction for the Maximum value.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral for in-slab events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

In-slab events require constraint of hypocentral depth and magnitude

delta_c1 = -0.3

trt = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

openquake.hazardlib.gsim.abrahamson_2015.get_stress_factor(imt, slab)

Returns the stress adjustment factor for the BC Hydro GMPE according to Abrahamson et al. (2018)

abrahamson_2018

Module exports AbrahamsonEtAl2018SInter

AbrahamsonEtAl2018SInterHigh AbrahamsonEtAl2018SInterLow AbrahamsonEtAl2018SSlab AbrahamsonEtAl2018SSlabHigh AbrahamsonEtAl2018SSlabLow

class openquake.hazardlib.gsim.abrahamson_2018.AbrahamsonEtAl2018SInter(**kwargs)

Bases: GMPE

Implements the 2018 updated Abrahamson et al. (2018) “BC Hydro” GMPE for application to subduction earthquakes, for the case of subduction interface events.

Abrahamson, N. A., Keuhn, N., Gulerce, Z., Gregor, N., Bozognia, Y., Parker, G., Stewart, J., Chiou, B., Idriss, I. M., Campbell, K. and Youngs, R. (2018) “Update of the BC Hydro Subduction Ground-Motion Model using the NGA-Subduction Dataset”, Pacific Earthquake Engineering Research Center (PEER) Technical Report, PEER 2018/02

Whilst the original model provides coefficients for different regional variations, these are incomplete for the purpose of a working implementation. As the authors indicate in the source, the coefficients and adjustment factors are intended only for application to the Cascadia region; hence this is the only version implemented here. Furthermore, scalar adjustments are intended to be applied in order to define an “upper”, “central” and “lower” branch to cover the epistemic uncertainty of the core model.

CASCADIA_ADJUSTMENT = 'adj_int'

Adjustment variable to match Cascadia to global average

COEFFS = <CoeffsTable C1inter vlin b a1 a2 a4 a6 a11 a12 a13 a14 adj_int adj_slab phi0 tau0 rho_w rho_b SINTER_LOW SINTER_HIGH SSLAB_LOW SSLAB_HIGH>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see section 4.5

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

EPISTEMIC_ADJUSTMENT = None

A “low” and “high” epistemic adjustment factor will be applied to subclasses of this model

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Site amplification is dependent only upon Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.abrahamson_2018.AbrahamsonEtAl2018SInterHigh(**kwargs)

Bases: AbrahamsonEtAl2018SInter

Abrahamson et al (2018) subduction interface GMPE with the positive epistemic adjustment factor applied

EPISTEMIC_ADJUSTMENT = 'SINTER_HIGH'

A “low” and “high” epistemic adjustment factor will be applied to subclasses of this model

class openquake.hazardlib.gsim.abrahamson_2018.AbrahamsonEtAl2018SInterLow(**kwargs)

Bases: AbrahamsonEtAl2018SInter

Abrahamson et al (2018) subduction interface GMPE with the negative epistemic adjustment factor applied

EPISTEMIC_ADJUSTMENT = 'SINTER_LOW'

A “low” and “high” epistemic adjustment factor will be applied to subclasses of this model

class openquake.hazardlib.gsim.abrahamson_2018.AbrahamsonEtAl2018SSlab(**kwargs)

Bases: AbrahamsonEtAl2018SInter

Abrahamson et al. (2018) updated “BC Hydro” subduction GMPE for application to subduction in-slab earthquakes.

CASCADIA_ADJUSTMENT = 'adj_slab'

Cascadia adjustment factor

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Required rupture parameters are only magnitude for the interface model

class openquake.hazardlib.gsim.abrahamson_2018.AbrahamsonEtAl2018SSlabHigh(**kwargs)

Bases: AbrahamsonEtAl2018SSlab

Abrahamson et al (2018) subduction in-slab GMPE with the positive epistemic adjustment factor applied

EPISTEMIC_ADJUSTMENT = 'SSLAB_HIGH'

A “low” and “high” epistemic adjustment factor will be applied to subclasses of this model

class openquake.hazardlib.gsim.abrahamson_2018.AbrahamsonEtAl2018SSlabLow(**kwargs)

Bases: AbrahamsonEtAl2018SSlab

Abrahamson et al (2018) subduction in-slab GMPE with the negative epistemic adjustment factor applied

EPISTEMIC_ADJUSTMENT = 'SSLAB_LOW'

A “low” and “high” epistemic adjustment factor will be applied to subclasses of this model

openquake.hazardlib.gsim.abrahamson_2018.compute_base_term(slab, C)

Returns the base coefficient of the GMPE, which for interface events is just the coefficient a1 (adjusted regionally)

openquake.hazardlib.gsim.abrahamson_2018.compute_depth_term(slab, C, ctx)

No top of rupture depth term for interface events

openquake.hazardlib.gsim.abrahamson_2018.compute_distance_term(slab, C, rrup, mag)

Returns the distance attenuation

openquake.hazardlib.gsim.abrahamson_2018.compute_magnitude_term(slab, C, mag)

Returns the magnitude scaling term

openquake.hazardlib.gsim.abrahamson_2018.compute_site_term(C, vs30, pga1000)

Returns the site amplification

openquake.hazardlib.gsim.abrahamson_2018.get_inter_event_stddev(C, C_PGA, dln)

Returns the between event aleatory uncertainty, tau

openquake.hazardlib.gsim.abrahamson_2018.get_stddevs(C, C_PGA, pga1000, vs30)

Returns the standard deviations

openquake.hazardlib.gsim.abrahamson_2018.get_within_event_stddev(C, C_PGA, dln)

Returns the within-event aleatory uncertainty, phi

abrahamson_gulerce_2020

Module exports AbrahamsonGulerce2020SInter,

AbrahamsonGulerce2020SSlab

class openquake.hazardlib.gsim.abrahamson_gulerce_2020.AbrahamsonGulerce2020SInter(**kwargs)

Bases: GMPE

Implements the 2020 Subduction ground motion model of Abrahamson & Gulerce (2020):

Abrahamson N. and Gulurce Z. (2020) “Regionalized Ground-Motion Models for Subduction Earthquakes based on the NGA-SUB Database”, Pacific Earthquake Engineering Research Center (PEER) Technical Report, PEER 2020/25

The model is regionalised, defining specific adjustment factors for (invoking region term in parenthesis):

• Global (“GLO” - for application to any subduction region for which no region-specific adjustment is defined)

• Alaska (“USA-AK”)

• Cascadia (“CAS”)

• Central America & Mexico (“CAM”)

• Japan (“JPN”)

• New Zealand (“NZL”)

• South America (“SAM”)

• Taiwan (“TWN”)

The region-specific adjustments primarily affect the constant term, the anelastic attenuation term and the linear Vs30 scaling term. In addition, however, further period-specific adjustment factors can be applied for the Alaska and Cascadia regions using the boolean input apply_adjustment. These adjustments scale the resulting ground motion values to appropriate levels accounting for limited data and the Alaska and Cascadia region, based on analysis undertaken by the authors.

A general epistemic uncertainty median adjustment factor is also defined based on the standard deviation of the median ground motion from five regions with estimated regional terms. This term should be applied only to the global model (though this is not strictly enforced), and it is controlled via the use of sigma_mu_epsilon, the number of standard deviations by which the adjustment will be multiplied (default = 0)

A non-ergodic aleatory uncertainty model can be returned by setting ergodic=False.

The code implementation and test tables have been verified using Fortran code supplied by Professor N. Abrahamson, and cross-checked against an independent implementation from Feng Li, Jason Motha and James Paterson from University of Canterbury (New Zealand).

Attributes:

region (str): Choice of region among the supported regions (“GLO”,

“USA-AK”, “CAS”, “CAM”, “JPN”, “NZL”, “SAM”, “TWN”)

ergodic (bool): Return the ergodic aleatory variability model (True)

or non-ergodic form (False)

apply_usa_adjustment (bool): Apply the modeller designated Alaska or

Cascadia adjustments (available only for the regions “USA-AK” or “CAS”)

sigma_mu_epsilon (float): Number of standard deviations to multiply

sigma mu (the standard deviation of the median) for the epistemic uncertainty model

COEFFS = <CoeffsTable c1i vlin b a1 a2 a6 a7 a8 a10 a11 a12 a13 a14 a16 a17 a18 a19 a20 a21 a22 a23 a24 a25 a26 a27 a28 a29 a30 a31 a32 a33 a34 a35 a36 a37 a39 a41 USA-AK_Adj CAS_Adj d1 d2 rhoW rhoB phi_s2s_g1 phi_s2s_g2 phi_s2s_g3 e1 e2 e3>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 1000.0

Defined for a reference velocity of 1000 m/s

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see section 4.5

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Site amplification is dependent only upon Vs30 for the majority of cases but Z2.5 is added for the JPN and CAS regions

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.abrahamson_gulerce_2020.AbrahamsonGulerce2020SSlab(**kwargs)

Bases: AbrahamsonGulerce2020SInter

Implements the 2020 Subduction ground motion model of Abrahamson & Gulerce (2020) for subduction in-slab earthquakes

Abrahamson N. and Gulurce Z. (2020) “Regionalized Ground-Motion Models for Subduction Earthquakes based on the NGA-SUB Database”, Pacific Earthquake Engineering Research Center (PEER) Technical Report, PEER 2020/25

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction inslab

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Required rupture parameters are magnitude and top-of-rupture depth

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_acceleration_on_reference_rock(C, trt, region, ctx, apply_adjustment)

Returns acceleration on reference rock - intended for use primarily with PGA. Overrides the Vs30 values and removes any basin depth terms

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_anelastic_attenuation_term(C, region, rrup)

Returns the regionally-adjusted anelastic attenuation term

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_base_term(C, region, apply_adjust)

Returns the region-specific base term (a1 - Equation 3.1)

Parameters:

• C – Coefficient dictionary for the specfic IMT

• region (str) – Region identifier

• apply_adjust (bool) – For Alaska and Cascadia apply the modeller-defined adjustment factors to the base term (True) or else leave regionalised but unadjusted (False)

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_basin_depth_scaling(C, region, vs30, z25)

Returns the basin depth scaling term, applicable only for the Cascadia and Japan regions, defined in equations 3.9 - 3.11 and corrected in the Erratum

Parameters:

z25 (numpy.ndarray) – Depth to 2.5 m/s shearwave velocity layer (km)

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_epistemic_adjustment(C, rrup)

Returns the distance-dependent epistemic adjustment factor defined in equation 6.1. In theory, this should only be applied to the global model, but we do not enforce this constraint here.

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_geometric_spreading_term(C, region, mag, rrup)

Returns the geometric spreading term defined in equation 3.1

Parameters:

rrup (numpy.ndarray) – Rupture distances (km)

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_inslab_scaling_term(C, trt, region, mag, rrup)

For inslab events, returns the inslab scaling term defined in equation 3.5 and corrected in the Erratum

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_magnitude_scaling_term(C, trt, region, mag)

Returns the magnitude scaling term (defined in Eq 3.3) and regional constant

Parameters:

• trt (str) – Tectonic region type

• mag (np.ndarray) – Earthquake magnitude

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_mean_acceleration(C, trt, region, ctx, pga1000, apply_adjustment)

Returns the mean acceleration on soil

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_partial_derivative_site_pga(C, vs30, pga1000)

Defines the partial derivative of the site term with respect to the PGA on reference rock, described in equation 5.9 (corrected in Erratum)

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_phi_lin_model(C, C_PGA, region, period, rrup)

Returns the distance-dependent linear phi term for both PGA and the required spectral period. The term is regionally dependent with additional factors added on for Central America, Japan and South America

Several equations are used here, described fully in section 5.3

Parameters:

period (float) – Spectral period of ground motion

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_reference_basin_depth(region, vs30)

For the Cascadia and Japan regions a reference basin depth, dependent on the Vs30, is returned according to equations 2.1 and 2.2

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_rupture_depth_scaling_term(C, trt, ctx)

Returns the rupture depth scaling described in Equation 3.6, which takes the value 0 for interface events

Parameters:

ztor (numpy.ndarray) – Top of rupture depths (km)

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_site_amplification_term(C, region, vs30, pga1000)

Returns the shallow site amplification term as descrbied in Equation 3.7, and corrected in the Erratum

Parameters:

• vs30 (numpy.ndarray) – 30-m averaged shearwave velocity (m/s)

• pga1000 (numpy.ndarray) – Peak Ground Acceleration (PGA), g, on a reference bedrock of 1000 m/s

openquake.hazardlib.gsim.abrahamson_gulerce_2020.get_tau_phi(C, C_PGA, region, period, rrup, vs30, pga1000, ergodic)

Get the heteroskedastic within-event and between-event standard deviation

abrahamson_silva_1997

Module exports AbrahamsonSilva1997

class:AbrahamsonSilva1997Vertical.

class openquake.hazardlib.gsim.abrahamson_silva_1997.AbrahamsonSilva1997(**kwargs)

Bases: GMPE

Implements GMPE developed by N. A. Abrahamson and W. J. Silva and published as “Empirical Response Spectral Attenuation Relations for Shallow Crustal Earthquakes”, Seismological Research Letters, v.68, no. 1, p. 94-127, 1997.

The GMPE distinguishes between rock (vs30 >= 600) and deep soil (vs30 < 600). The rake angle is also taken into account to distinguish between ‘reverse’ (45 <= rake < 135) and ‘other’. If an earthquake rupture is classified as ‘reverse’, then the hanging-wall term is included in the mean calculation.

COEFFS = <CoeffsTable c4 a1 a2 a3 a4 a5 a6 a9 a10 a11 a12 a13 c1 c5 n>

Coefficient table (table 3, page 108)

COEFFS_STD = <CoeffsTable b5 b6>

Coefficient table for standard deviation calculation (table 4, page 109)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components (see paragraph ‘Regression Model’, page 105)

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are PGA and SA. PGA is assumed to have same coefficients as SA(0.01)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is Total (see equations 13 pp. 106 and table 4, page 109).

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ (see Introduction, page 94)

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is RRup (eq. 3, page 105).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake (eq. 3, page 105). Rake is used to distinguish between ‘reverse’ (45 <= rake <= 135) and ‘other’ (i.e. strike-slip and normal). If an earthquake is classified as ‘reverse’ than the hanging-wall term is taken into account.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

The only site parameter is vs30 used to distinguish between rock (vs30 > 600 m/s) and deep soil (see table 2, page 95)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.abrahamson_silva_1997.AbrahamsonSilva1997Vertical(**kwargs)

Bases: AbrahamsonSilva1997

COEFFS = <CoeffsTable c4 a1 a2 a3 a4 a5 a6 a9 a10 a11 a12 a13 c1 c5 n>

Coefficient table (table 5, page 116)

COEFFS_STD = <CoeffsTable b5 b6>

Coefficient table for standard deviation calculation (table 6, page 117)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical'

Supported intensity measure component is vertical

abrahamson_silva_2008

Module exports AbrahamsonSilva2008.

class openquake.hazardlib.gsim.abrahamson_silva_2008.AbrahamsonSilva2008(**kwargs)

Bases: GMPE

Implements GMPE developed by Norman Abrahamson and Walter Silva and published as “Summary of the Abrahamson & Silva NGA Ground-Motion Relations” (2008, Earthquakes Spectra, Volume 24, Number 1, pages 67-97). This class implements only the equations for mainshock/foreshocks/swarms type events, that is the aftershock term (4th term in equation 1, page 74) is set to zero. The constant displacement model (page 80) is also not implemented (that is equation 1, page 74 is used for all periods and no correction is applied for periods greater than the constant displacement period). This class implements also the corrections (for standard deviation and hanging wall term calculation) as described in: http://peer.berkeley.edu/products/abrahamson-silva_nga_report_files/ AS08_NGA_errata.pdf

COEFFS = <CoeffsTable VLIN b a1 a2 a8 a10 a12 a13 a14 a15 a16 a18 s1est s2est s1mea s2mea s3 s4 rho>

Coefficient tables obtained by joining table 5a page 84, and table 5b page 85.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (GMRotI50)'

Supported intensity measure component is orientation-independent average horizontal GMRotI50, see abstract, page 67.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see tables 5a and 5b pages 84, 85, respectively.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see paragraph “Equations for standard deviations”, page 81.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see paragraph ‘Data Set Selection’, see page 68.

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

Required distance measures are Rrup, Rjb and Rx (see Table 2, page 75).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'width', 'ztor'})

Required rupture parameters are magnitude, rake, dip, ztor, and width (see table 2, page 75)

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'vs30measured', 'z1pt0'})

Required site parameters are Vs30, Vs30 type (measured or inferred), and Z1.0, see paragraph ‘Soil Depth Model’, page 79, and table 6, page 86.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.abrahamson_silva_2008.CONSTS = {'a3': 0.265, 'a4': -0.231, 'a5': -0.398, 'c': 1.88, 'c1': 6.75, 'c2': 50, 'c4': 4.5, 'n': 1.18, 'sigma_amp': 0.3}

equation constants (that are IMT independent) coefficients in table 4, page 84

afshari_stewart_2016

Module exports AfshariStewart2016,

AfshariStewart2016Japan

class openquake.hazardlib.gsim.afshari_stewart_2016.AfshariStewart2016(**kwargs)

Bases: GMPE

Implements the GMPE of Afshari & Stewart (2016) for relative significant duration for 5 - 75 %, 5 - 95 % and 20 - 80 % Arias Intensity.

Afshari, K. and Stewart, J. P. (2016) “Physically Parameterized Prediction Equations for Signficant Duration in Active Crustal Regions”, Earthquake Spectra, 32(4), 2057 - 2081

COEFFS = <CoeffsTable m1 m2 b0N b0R b0SS b0U b1N b1R b1SS b1U b2 b3 c1 c2 c3 c4 c5 vref tau1 tau2 phi1 phi2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function RSD595>, <function RSD575>, <function RSD2080>})

Supported intensity measure types are 5 - 95 % Arias and 5 - 75 % Arias significant duration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is only total, see table 7, page 35

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and top of rupture depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Requires vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

region = 'CAL'

class openquake.hazardlib.gsim.afshari_stewart_2016.AfshariStewart2016Japan(**kwargs)

Bases: AfshariStewart2016

Adaption of the Afshari & Stewart (2016) GMPE for relative significant duration for the case when the Japan basin model is preferred

region = 'JPN'

openquake.hazardlib.gsim.afshari_stewart_2016.get_distance_term(C, rrup)

Returns the distance scaling term in equation 7

openquake.hazardlib.gsim.afshari_stewart_2016.get_magnitude_term(C, ctx)

Returns the magnitude scaling term in equation 3

openquake.hazardlib.gsim.afshari_stewart_2016.get_site_amplification(region, C, ctx)

Returns the site amplification term

openquake.hazardlib.gsim.afshari_stewart_2016.get_stddevs(C, mag)

Returns the standard deviations

akkar_2013

Module exports AkkarEtAl2013.

class openquake.hazardlib.gsim.akkar_2013.AkkarEtAl2013(**kwargs)

Bases: AkkarEtAlRjb2014

To ensure backwards compatibility with existing seismic hazard models, the call AkkarEtAl2013 is retained as legacy. The AkkarEtAl2013 GMPE is now implemented as AkkarEtAlRjb2014

superseded_by

alias of AkkarEtAlRjb2014

akkar_2014

Module exports AkkarEtAlRjb2014

AkkarEtAlRepi2014 AkkarEtAlRhypo2014.

class openquake.hazardlib.gsim.akkar_2014.AkkarEtAlRepi2014(**kwargs)

Bases: AkkarEtAlRjb2014

Implements GMPE developed by S. Akkar, M. A. Sandikkaya, and J. J. Bommer as published in “Empirical Ground-Motion Models for Point- and Extended- Source Crustal Earthquake Scenarios in Europe and the Middle East”, Bullettin of Earthquake Engineering (2014).

The class implements the equations for epicentral distance and based on manuscript provided by the original authors.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 c1 Vcon Vref c n b1 b2 sigma tau>

Coefficient table (from Table 3 and 4a, page 22) Table 4.a: Period-dependent regression coefficients of the RJB ground-motion model sigma is the ‘intra-event’ standard deviation, while tau is the ‘inter-event’ standard deviation

REQUIRES_DISTANCES = frozenset({'repi'})

The required distance parameter is ‘Joyner-Boore’ distance, because coefficients in table 4.a, pages 22-23, are used.

class openquake.hazardlib.gsim.akkar_2014.AkkarEtAlRhyp2014(**kwargs)

Bases: AkkarEtAlRjb2014

Implements GMPE developed by S. Akkar, M. A. Sandikkaya, and J. J. Bommer as published in “Empirical Ground-Motion Models for Point- and Extended- Source Crustal Earthquake Scenarios in Europe and the Middle East”, Bullettin of Earthquake Engineering (2014).

The class implements the equations for hypocentral distance and based on manuscript provided by the original authors.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 c1 Vcon Vref c n b1 b2 sigma tau>

Coefficient table (from Table 3 and 4a, page 22) Table 4.a: Period-dependent regression coefficients of the RJB ground-motion model sigma is the ‘intra-event’ standard deviation, while tau is the ‘inter-event’ standard deviation

REQUIRES_DISTANCES = frozenset({'rhypo'})

The required distance parameter is ‘Joyner-Boore’ distance, because coefficients in table 4.a, pages 22-23, are used.

class openquake.hazardlib.gsim.akkar_2014.AkkarEtAlRjb2014(**kwargs)

Bases: GMPE

Implements GMPE developed by S. Akkar, M. A. Sandikkaya, and J. J. Bommer as published in “Empirical Ground-Motion Models for Point- and Extended- Source Crustal Earthquake Scenarios in Europe and the Middle East”, Bulletin of Earthquake Engineering (2014), 12(1): 359 - 387 The class implements the equations for Joyner-Boore distance and based on manuscript provided by the original authors.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 c1 Vcon Vref c n b1 b2 sigma tau>

Coefficient table (from Table 3 and 4a, page 22) Table 4.a: Period-dependent regression coefficients of the RJB ground-motion model sigma is the ‘intra-event’ standard deviation, while tau is the ‘inter-event’ standard deviation

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

The supported intensity measure component is ‘average horizontal’, see section ‘A New Generation of European Ground-Motion Models’, page 8

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

The supported intensity measure types are PGA, PGV, and SA, see table 4.a, pages 22-23

DEFINED_FOR_REFERENCE_VELOCITY = 800

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

The supported standard deviations are total, inter and intra event, see table 4.a, pages 22-23

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

The supported tectonic region type is active shallow crust because the equations have been developed for “all seismically- active regions bordering the Mediterranean Sea and extending to the Middle East”, see section ‘A New Generation of European Ground-Motion Models’, page 4.

REQUIRES_DISTANCES = frozenset({'rjb'})

The required distance parameter is ‘Joyner-Boore’ distance, because coefficients in table 4.a, pages 22-23, are used.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

The required rupture parameters are rake and magnitude, see equation 1, page 20.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

The required site parameter is vs30, see equation 1, page 20.

c1 = 6.75

c1 is the reference magnitude, fixed to 6.75Mw (which happens to be the same value used in Boore and Atkinson, 2008) see paragraph ‘Functional Form of Predictive Equations and Regressions’, page 21

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

Implement equation 1, page 20.

akkar_bommer_2010

Module exports AkkarBommer2010, class:AkkarBommer2010SWISS01, class:AkkarBommer2010SWISS04, class:AkkarBommer2010SWISS08,

class openquake.hazardlib.gsim.akkar_bommer_2010.AkkarBommer2010(**kwargs)

Bases: GMPE

Implements GMPE developed by Sinan Akkar and Julian J. Bommer and published as “Empirical Equations for the Prediction of PGA, PGV, and Spectral Accelerations in Europe, the Mediterranean Region, and the Middle East”, Seismological Research Letters, 81(2), 195-206. SA at 4 s (not supported by the original equations) has been added in the context of the SHARE project and assumed to be equal to SA at 3 s but scaled with proper factor. Equation coefficients for PGA and SA periods up to 0.05 seconds have been taken from updated model as described in ‘Extending ground-motion prediction equations for spectral accelerations to higher response frequencies’,Julian J. Bommer, Sinan Akkar, Stephane Drouet, Bull. Earthquake Eng. (2012) volume 10, pages 379 - 399. Coefficients for PGV and SA above 0.05 seconds are taken from the original 2010 publication.

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 b7 b8 b9 b10 Sigma1 tau SigmaTot>

For PGA and SA up to 0.05 seconds, coefficients are taken from table 5, page 385 of ‘Extending ground-motion prediction equations for spectral accelerations to higher response frequencies’, while for PGV and SA with periods greater than 0.05 coefficients are taken from table 1, pages 200-201 of ‘Empirical Equations for the Prediction of PGA, PGV, and Spectral Accelerations in Europe, the Mediterranean Region, and the Middle East’

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN, see page 196.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Reference Vs30. See page 2983 (top or right column)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, page 199.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is RRup (eq. 1, page 199).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1, page 199).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock and stiff and soft soil).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.akkar_bommer_2010.AkkarBommer2010SWISS01(**kwargs)

Bases: AkkarBommer2010

This class extends AkkarBommer2010 adjusted to be used for the Swiss Hazard Model [2014]. This GMPE is valid for a fixed value of vs30=600m/s

# kappa value K-adjustments corresponding to model 01 - as prepared by Ben Edwards K-value for PGA were not provided but infered from SA[0.01s] the model considers a fixed value of vs30=600 to match the reference vs30=1100m/s

# small-magnitude correction

# single station sigma - inter-event magnitude/distance adjustment

Disclaimer: these equations are modified to be used for the Swiss Seismic Hazard Model [2014]. The use of these models is the soly responsability of the hazard modeler.

Model implemented by laurentiu.danciu@gmail.com

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_REFERENCE_VELOCITY = 1105.0

Vs30 value representing typical rock conditions in Switzerland. confirmed by the Swiss GMPE group

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, page 199.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.akkar_bommer_2010.AkkarBommer2010SWISS04(**kwargs)

Bases: AkkarBommer2010SWISS01

This class extends AkkarBommer2010 following same strategy as for AkkarBommer2010SWISS01

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, page 199.

class openquake.hazardlib.gsim.akkar_bommer_2010.AkkarBommer2010SWISS08(**kwargs)

Bases: AkkarBommer2010SWISS01

This class extends AkkarBommer2010 following same strategy as for AkkarBommer2010SWISS01 to be used for the Swiss Hazard Model [2014].

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, page 199.

akkar_bommer_2010_swiss_coeffs

akkar_cagnan_2010

Module exports AkkarCagnan2010.

class openquake.hazardlib.gsim.akkar_cagnan_2010.AkkarCagnan2010(**kwargs)

Bases: GMPE

Implements GMPE developed by Sinnan Akkar and Zehra Cagnan and published as “A Local Ground-Motion Predictive Model for Turkey, and Its Comparison with Other Regional and Global Ground-Motion Models” (2010, Bulletin of the Seismological Society of America, Volume 100, No. 6, pages 2978-2995). It uses the same site response function used in Boore and Atkinson 2008.

COEFFS_AC10 = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 sigma tau>

Coefficient table (from Table 3, p. 2985) sigma is the ‘intra-event’ standard deviation, while tau is the ‘inter-event’ standard deviation

COEFFS_SOIL_RESPONSE = <CoeffsTable blin b1 b2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components : attr:~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN, see paragraph ‘Functional Form’, p. 2981.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see Table 3, p. 2985.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust (the equations being developed for Turkey, see paragraph ‘Strong Motion Databank’, p. 2981)

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb. See paragraph ‘Functional Form’, p. 2981.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake. See paragraph ‘Functional Form’, p. 2981.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30. See paragraph ‘Functionl Form’, p. 2981.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

allen_2012

Module exports Allen2012, :class:’Allen2012_SS14’

class openquake.hazardlib.gsim.allen_2012.Allen2012(**kwargs)

Bases: GMPE

Implements GMPE developed by T. Allen and published as “Stochastic ground- motion prediction equations for southeastern Australian earthquakes using updated source and attenuation parameters”, 2012, Geoscience Australia Record 2012/69. Document available at: https://www.ga.gov.au/products/servlet/controller?event=GEOCAT_DETAILS&catno=74133

COEFFS_DEEP = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 sigma>

Coefficients for deep events taken from Excel file produced by Trevor Allen and provided by Geoscience Australia (20120821.GMPE_coeffs.xls) (coefficients in the original report are not correct)

COEFFS_SHALLOW = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 sigma>

Coefficients for shallow events taken from Excel file produced by Trevor Allen and provided by Geoscience Australia (20120821.GMPE_coeffs.xls) (coefficients in the original report are not correct)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Median horizontal'

Supported intensity measure component is the median horizontal component see table 7, page 35

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types is spectral acceleration, see table 7, page 35, and PGA (coefficients assumed to be the same of SA(0.01))

DEFINED_FOR_REFERENCE_VELOCITY = 820.0

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total, see table 7, page 35

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, see paragraph ‘Regression of Model Coefficients’, page 32

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and hypocentral depth, see paragraph ‘Regression of Model Coefficients’, page 32 and tables 7 and 8, pages 35, 36

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters are needed, the GMPE is calibrated for average South East Australia site conditions (assumed consistent to Vs30 = 820 m/s) see paragraph ‘Executive Summary’, page VII. (provisionally set to 800 for compatibility with SiteTerm class)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.allen_2012.Allen2012_SS14(**kwargs)

Bases: Allen2012

Allen2012 Model updated to apply the linear and non-linear amplification factors of Sayhan & Stewart (2014) as applied in the Boore et al (2014) NGE-West 2 GMM

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

allen_2012_ipe

Module exports :class:’AllenEtAl2012’,

‘AllenEtAl2012Rhypo’

class openquake.hazardlib.gsim.allen_2012_ipe.AllenEtAl2012(**kwargs)

Bases: GMPE

Implements the Intensity Prediction Equation of Allen, Wald and Worden (2012) for Modified Mercalli Intensity in Active Crustal Regions Allen, T. I., Wald, D. J. and Worden, C. B. (2012) Intensity attenuation in active crustal regions, J. Seismology, 16: 409 - 433

This class implements the version using rupture distance, neglecting site amplification

COEFFS = <CoeffsTable c0 c1 c2 c3 s1 s2 s3>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is not considered for IPEs, so we assume equivalent to ‘average horizontal’

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function MMI>})

Supported intensity measure types are peak ground acceleration and peak ground velocity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

The GMPE is derived from induced earthquakes

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rupture distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude (ML is used)

REQUIRES_SITES_PARAMETERS = frozenset({})

No required site parameters (in the present version)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.allen_2012_ipe.AllenEtAl2012Rhypo(**kwargs)

Bases: AllenEtAl2012

Version of the Allen, Wald and Worden (2012) GSIM for hypocentral distance

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 m1 m2 s1 s2 s3>

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance

allen_2022

Module exports Allen2022

class openquake.hazardlib.gsim.allen_2022.Allen2022(**kwargs)

Bases: GMPE

Implements GMPE developed by Allen and published as “Allen, T. I. (2022). A farfield groundmotion model for the North Australian Craton from platemargin earthquakes, Bull. Seismol. Soc. Am., doi: 10.1785/0120210191.

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 d0 d1 d2 d3 n0 s0 s1 tau phi sigma>

Coefficient table (see table 1 page 1047.)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Median horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 1, pages 227 and 228.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types is total, see equations 9-10 page 1051.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction interface.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance, see equation 10 page 226.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude, and focal depth, see equation 10 page 226.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

ameri_2017

Module exports Ameri2014Rjb,

AmeriEtAl2017Rjb, AmeriEtAl2017Repi, AmeriEtAl2017RjbStressDrop, AmeriEtAl2017RepiStressDrop

class openquake.hazardlib.gsim.ameri_2017.Ameri2014Rjb(**kwargs)

Bases: AmeriEtAl2017Rjb

Implementation of Ameri (2014), an early version of the Ameri et al. (2017) GMM published in:

Ameri (2014) “Empirical Ground Motion Model Adapted to the French Context”, Seismic Ground Motion Assessment (SIGMA) Deliverable SIGMA-2014-D2-131

However, the model is adopted in favour of the Ameri et al. (2017) model within the 2020 seismic hazard model of France published by Drouet et al. (2020):

Drouet S, Ameri G, Le Dortz, K, Sevanell R, Senfaute G. (2020) “A probabilistic seismic hazard map for the metropolitan France”, Bulletin of Earthquake Engineering, 18: 1865 - 1898

Adopts a homoscedastic standard deviation model.

COEFFS = <CoeffsTable a c1 c2 h b1 b2 b3 e1 e2 e3 e4 f1 f2 f3>

Coefficients from xls file “coeff_AMERI2014_Rjb_generic.xls”:

COEFFS_SIGMA = <CoeffsTable sigmaB sigmaW sigmaT>

kind = 'homoscedastic'

class openquake.hazardlib.gsim.ameri_2017.AmeriEtAl2017Repi(**kwargs)

Bases: AmeriEtAl2017Rjb

Implements the Ameri et al (2017) GMPE for the case where epicentral distance is used. Standard deviation uses the heteroscedastic formulation given in eqn. 11. (for periods T<=1 s.)

Reference: Ameri, G., Drouet, S., Traversa, P., Bindi, D., Cotton, F., (2017), Toward an empirical ground motion prediction equation for France: accounting for regional differences in the source stress parameter, Bull. Earthquake Eng., 15: 4681-4717.

COEFFS = <CoeffsTable a c1 c2 h b1 b2 b3 e1 e2 e3 e4 f1 f2 f3>

Coefficients from Table “10518_2017_171_MOESM1_ESM.xlsx” in electronic supplementary material:

COEFFS_SIGMA = <CoeffsTable tau tau1 tau2 phi>

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance measure is Repi (eq. 1).

kind = 'repi'

class openquake.hazardlib.gsim.ameri_2017.AmeriEtAl2017RepiStressDrop(**kwargs)

Bases: AmeriEtAl2017Repi

Implements the Ameri et al (2017) GMPE for the case where epicentral distance is used, and the stress parameter is specified in the Ground-motion logic-tree. Example specification of the normalized stress parameter:

<uncertaintyModel>
    [AmeriEtAl2017RepiStressDrop]
    norm_stress_drop = 0.3
</uncertaintyModel>

The stress parameter is normalized according to STRESS_DROP/REF_STRESS_DROP, where REF_STRESS_DROP varies regionally. The authors used the following values for reference regional stress estimates: 1 bar for the Swtzerland (Swiss Alps+ Foreland), 10 bars for the French Alps + Rhine Graben, and 100 bars for the Pyrenees events. In this case, the standard deviation implements a homoscedastic formulation

Reference: Ameri, G., Drouet, S., Traversa, P., Bindi, D., Cotton, F., (2017), Toward an empirical ground motion prediction equation for France: accounting for regional differences in the source stress parameter, Bull. Earthquake Eng., 15: 4681-4717.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

kind = 'repi_stress'

class openquake.hazardlib.gsim.ameri_2017.AmeriEtAl2017Rjb(**kwargs)

Bases: GMPE

Implements the Ameri et al (2017) GMPE for the case where Joyner-Boore distance is used. Standard deviation uses the heteroscedastic formulation given in eqn. 11. (for periods T<=1 s.)

Reference: Ameri, G., Drouet, S., Traversa, P., Bindi, D., Cotton, F., (2017), Toward an empirical ground motion prediction equation for France: accounting for regional differences in the source stress parameter, Bull. Earthquake Eng., 15: 4681-4717.

COEFFS = <CoeffsTable a c1 c2 h b1 b2 b3 e1 e2 e3 e4 f1 f2 f3>

Coefficients from Table “10518_2017_171_MOESM2_ESM.xlsx” in electronic supplementary material:

COEFFS_SIGMA = <CoeffsTable tau tau1 tau2 phi>

COEFFS_STRESS = <CoeffsTable s0 s1 s2 s3 s4 s5 s6 s7 s8 s9>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'rjb'

class openquake.hazardlib.gsim.ameri_2017.AmeriEtAl2017RjbStressDrop(**kwargs)

Bases: AmeriEtAl2017Rjb

Implements the Ameri et al (2017) GMPE for the case where Joyner-Boore distance is used, and the stress parameter is specified in the Ground-motion logic-tree. Example specification of the normalizaed stress parameter:

<uncertaintyModel>
    [AmeriEtAl2017RjbStressDrop]
    norm_stress_drop = 0.3
</uncertaintyModel>

The stress parameter is normalized according to STRESS_DROP/REF_STRESS_DROP, where REF_STRESS_DROP varies regionally. The authors used the following values for reference regional stress estimates: 1 bar for the Swtzerland (Swiss Alps +Foreland), 10 bars for the French Alps + Rhine Graben, and 100 bars for the Pyrenees events. In this case, the standard deviation implements a homoscedastic formulation.

Reference: Ameri, G., Drouet, S., Traversa, P., Bindi, D., Cotton, F., (2017), Toward an empirical ground motion prediction equation for France: accounting for regional differences in the source stress parameter, Bull. Earthquake Eng., 15: 4681-4717.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

kind = 'rjb_stress'

armenia_2016

Armenian modification to selected active shallow crustal GMPEs Module exports AkkarEtAlRjb2014Armenia, BindiEtAl2014RjbArmenia, BooreEtAl2014LowQArmenia, CauzziEtAl2014Armenia, KaleEtAl2015Armenia, KothaEtAl2016Armenia, ChiouYoungs2014Armenia

class openquake.hazardlib.gsim.armenia_2016.AkkarEtAlRjb2014Armenia(**kwargs)

Bases: AkkarEtAlRjb2014

Adjustment of Akkar et al based on Armenian data

COEFFS_ADJUST = <CoeffsTable a b tau_adj sig_adj>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

class openquake.hazardlib.gsim.armenia_2016.BindiEtAl2014RjbArmenia(**kwargs)

Bases: BindiEtAl2014Rjb

Adjustment of Bindi et al based on Armenian data

COEFFS_ADJUST = <CoeffsTable a b tau_adj sig_adj>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

class openquake.hazardlib.gsim.armenia_2016.BooreEtAl2014LowQArmenia(**kwargs)

Bases: BooreEtAl2014LowQ

Adjustment of Boore et al for Low Q regions - adjusted for Armenian data

COEFFS_ADJUST = <CoeffsTable a b tau_adj sig_adj>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

class openquake.hazardlib.gsim.armenia_2016.CauzziEtAl2014Armenia(**kwargs)

Bases: CauzziEtAl2014

Adjustment of Cauzzi et al. (2014) for Armenia

COEFFS_ADJUST = <CoeffsTable a b tau_adj sig_adj>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

class openquake.hazardlib.gsim.armenia_2016.ChiouYoungs2014Armenia(**kwargs)

Bases: ChiouYoungs2014

Adaptation of Chiou & Youngs (2014) for use in Armenia

COEFFS_ADJUST = <CoeffsTable a b tau_adj sig_adj>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

class openquake.hazardlib.gsim.armenia_2016.KaleEtAl2015Armenia(**kwargs)

Bases: KaleEtAl2015Turkey

Adjustment of Kale et al (2015) - Turkish version, for use in Armenia

COEFFS_ADJUST = <CoeffsTable a b tau_adj sig_adj>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

class openquake.hazardlib.gsim.armenia_2016.KothaEtAl2016Armenia(**kwargs)

Bases: KothaEtAl2016Turkey

Adaptation of Kotha et al. (2016) - Turkey Regionalisation - for use in Armenia

COEFFS_ADJUST = <CoeffsTable a b tau_adj sig_adj>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

openquake.hazardlib.gsim.armenia_2016.compute(self, ctx: recarray, imts, mean, sig, tau, phi)

Adjustments for Armenia

arroyo_2010

Module exports :class:’ArroyoEtAl2010SInter’

class openquake.hazardlib.gsim.arroyo_2010.ArroyoEtAl2010SInter(**kwargs)

Bases: GMPE

Implements GMPE developed by Arroyo et al. (2010) for Mexican subduction interface events and published as:

Arroyo D., García D., Ordaz M., Mora M. A., and Singh S. K. (2010) “Strong ground-motion relations for Mexican interplate earhquakes”, J. Seismol., 14:769-785.

The original formulation predict peak ground acceleration (PGA), in cm/s**2, and 5% damped pseudo-acceleration response spectra (PSA) in cm/s**2 for the geometric average of the maximum component of the two horizontal component of ground motion.

The GMPE predicted values for Mexican interplate events at rock sites (NEHRP B site condition) in the forearc region.

COEFFS = <CoeffsTable c1 c2 c3 c4 g_e bias s_t s_e s_r>

Equation coefficients for geometric average of the maximum of the two horizontal components, as described in Table 2 on page 776.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration. See Table 2 in page 776.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total. See Table 2, page 776.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface, given that the equations have been derived using Mexican interface events.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup (closest distance to fault surface)

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is the magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

arteta_2021

Module exports ArtetaEtAl2021Inter

ArtetaEtAl2021Slab ArtetaEtAl2021Inter_Vs30 ArtetaEtAl2021Slab_Vs30

class openquake.hazardlib.gsim.arteta_2021.ArtetaEtAl2021Inter(**kwargs)

Bases: ArtetaEtAl2021InterVs30

Implements the model of Arteta et al (2021) as described in “Ground-motion model for subduction earthquakes in northern South America” by Arteta et al. (2021) - Earthquake Spectra, https://doi.org/10.1177/87552930211027585

Soil term depends of natural perod and pick value of HVRSR spectra

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'PHV', 'THV'})

Amplification is dependent on the period and amplitude of HVRSR spectra

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.arteta_2021.ArtetaEtAl2021InterVs30(**kwargs)

Bases: GMPE

Implements the model of Arteta et al (2021) as described in “Ground-motion model for subduction earthquakes in northern South America” by Arteta et al. (2021) - Earthquake Spectra, https://doi.org/10.1177/87552930211027585

Soil term is associated with Vs30 using the simplification given in terms of natural period of HVRSR and mean value of P*

COEFFS = <CoeffsTable Teta1 Teta2 Teta3 Teta4 Teta5 MC1 Tau Phi1 Phi2 Sigma1 Sigma2 Phis2s Phiss Sigmass>

COEFFS_SITE = <CoeffsTable s2 s3 s4 s5>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Site amplification is dependent only upon Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.arteta_2021.ArtetaEtAl2021Slab(**kwargs)

Bases: ArtetaEtAl2021SlabVs30

Implements the model of Arteta et al (2021) as described in “Ground-motion model for subduction earthquakes in northern South America” by Arteta et al. (2021) - Earthquake Spectra, https://doi.org/10.1177/87552930211027585

Soil term depends of natural perod and pick value of HVRSR spectra

REQUIRES_SITES_PARAMETERS = frozenset({'PHV', 'THV', 'backarc'})

Site amplification is dependent on the period and amplitude of HVRSR spectra

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.arteta_2021.ArtetaEtAl2021SlabVs30(**kwargs)

Bases: ArtetaEtAl2021InterVs30

Implements the model of Arteta et al (2021) as described in “Ground-motion model for subduction earthquakes in northern South America” by Arteta et al. (2021) - Earthquake Spectra, https://doi.org/10.1177/87552930211027585

Soil term is associated with Vs30 using the simplification given in terms of natural period of HVRSR and mean value of P*

COEFFS = <CoeffsTable Teta1 Teta2 Teta3 Teta4 Teta5 Teta6 Tau Phi1 Phi2 Sigma1 Sigma2 Phis2s Phiss Sigmass>

COEFFS_SITE = <CoeffsTable s2 s3 s4 s5>

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral for in-slab events

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

arteta_2023

Module exports ArtetaEtAl2023_Vs30

ArtetaEtAl2023

class openquake.hazardlib.gsim.arteta_2023.ArtetaEtAl2023(**kwargs)

Bases: ArtetaEtAl2023_Vs30

Implements the model of Arteta et al (2021) as described in “Ground‐Motion Model (GMM) for Crustal Earthquakes in Northern South America (NoSAm Crustal GMM)” published on the Bulletin of the Seismological Society of America 2023 ( doi: https://doi.org/10.1785/0120220168) by Carlos A. Arteta, Cesar A. Pajaro, Vicente Mercado, Julián Montejo, Mónica Arcila, Norman A. Abrahamson; Soil term depends of natural perod and peak value of HVRSR spectra

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rhypo', 'rvolc'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'PHV', 'THV'})

Site amplification is dependent on the period and amplitude of HVRSR spectra

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.arteta_2023.ArtetaEtAl2023_Vs30(**kwargs)

Bases: GMPE

Implements the model of Arteta et al (2021) as described in “Ground‐Motion Model (GMM) for Crustal Earthquakes in Northern South America (NoSAm Crustal GMM)” published on the Bulletin of the Seismological Society of America 2023 ( doi: https://doi.org/10.1785/0120220168) by Carlos A. Arteta, Cesar A. Pajaro, Vicente Mercado, Julián Montejo, Mónica Arcila, Norman A. Abrahamson; Soil term is associated with Vs30 using the simplification given in terms of natural period of HVRSR and mean value of P*

COEFFS = <CoeffsTable Tetha1 Tetha2 Tetha3 Tetha4 Tetha5 Tetha6 Tetha7 M1 Tau Phi Sigma>

COEFFS_SITE = <CoeffsTable s2 s3 s4 s5>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rhypo', 'rvolc'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Site amplification is dependent only upon Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

atkinson_2015

Module exports :class:’Atkinson2015’

Atkinson2015AltDistSat

class openquake.hazardlib.gsim.atkinson_2015.Atkinson2015(**kwargs)

Bases: GMPE

Implements the Induced Seismicity GMPE of Atkinson (2015) Atkinson, G. A. (2015) Ground-Motion Prediction Equation for Small-to- Moderate Events at Short Hypocentral Distances, with Application to Induced-Seismicity Hazards. Bulletin of the Seismological Society of America. 105(2).

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 phi tau sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the larger of two components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Induced'

The GMPE is derived from induced earthquakes

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

No required site parameters, the GMPE is derived for B/C site amplification factors

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

rsat = 'default'

class openquake.hazardlib.gsim.atkinson_2015.Atkinson2015AltDistSat(**kwargs)

Bases: Atkinson2015

This class implements the alternative effective depth term provided on page 986 of Atkinson (2015) for the use of stronger distance-saturation effects than implemented within the default model.

It should be noted that this class uses the coefficients obtained using the Yenier and Atkinson (2014) effective depth term i.e. those used within the base gsim class too, with modification only to the effective depth term

rsat = 'alternative'

atkinson_boore_1995

Module exports AtkinsonBoore1995GSCBest, AtkinsonBoore1995GSCLowerLimit, AtkinsonBoore1995GSCUpperLimit

class openquake.hazardlib.gsim.atkinson_boore_1995.AtkinsonBoore1995GSCBest(**kwargs)

Bases: GMPE

Implement equation used by the Geological Survey of Canada (GSC) for the 2010 Eastern Canada National Seismic Hazard Model. The equation fits the table values defined by Gail M. Atkinson and David M. Boore in “Ground-Motion Relations for Eastern North America”, Bullettin of the Seismological Society of America, Vol. 85, No. 1, pp. 17-30, February 1995. Table of coefficients were provided by GSC and are associated to the ‘Best’ case (that is mean value unaffected).

The class assumes magnitude to be in Mblg scale. The Atkinson 1993 conversion equation is used to obtain Mw values.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8>

coefficient table provided by GSC

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Random horizontal'

Supported intensity measure component is random horizontal RANDOM_HORIZONTAL, see page 22 in Atkinson and Boore’s manuscript

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental, given that the equations have been derived for Eastern North America

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance see page 18 in Atkinson and Boore’s manuscript

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

site params are not required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.atkinson_boore_1995.AtkinsonBoore1995GSCLowerLimit(**kwargs)

Bases: AtkinsonBoore1995GSCBest

Implement equation used by the Geological Survey of Canada (GSC) for the 2010 Eastern Canada National Seismic Hazard Model. The equation fits the table values defined by Gail M. Atkinson and David M. Boore in “Ground-Motion Relations for Eastern North America”, Bullettin of the Seismological Society of America, Vol. 85, No. 1, pp. 17-30, February 1995. Table of coefficients were provided by GSC and are associated to the ‘Lower Limit’ case (that is mean value decreased).

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8>

coefficient table provided by GSC

class openquake.hazardlib.gsim.atkinson_boore_1995.AtkinsonBoore1995GSCUpperLimit(**kwargs)

Bases: AtkinsonBoore1995GSCBest

Implement equation used by the Geological Survey of Canada (GSC) for the 2010 Eastern Canada National Seismic Hazard Model. The equation fits the table values defined by Gail M. Atkinson and David M. Boore in “Ground-Motion Relations for Eastern North America”, Bullettin of the Seismological Society of America, Vol. 85, No. 1, pp. 17-30, February 1995. Table of coefficients were provided by GSC and are associated to the ‘Upper Limit’ case (that is mean value increased).

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8>

coefficient table provided by GSC

atkinson_boore_2003

Module exports AtkinsonBoore2003SInter, AtkinsonBoore2003SSlab, AtkinsonBoore2003SInterNSHMP2008, AtkinsonBoore2003SSlabNSHMP2008, AtkinsonBoore2003SSlabCascadia, AtkinsonBoore2003SSlabCascadiaNSHMP2008, AtkinsonBoore2003SSlabJapan AtkinsonBoore2003SSlabJapanNSHMP2008

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SInter(**kwargs)

Bases: GMPE

Implements GMPE developed by G. M Atkinson and D. Boore and published as “Empirical Ground-Motion Relations for Subduction-Zone Earthquakes and Their Application to Cascadia and Other Regions” (Bulletin of the Seismological Society of America, Volume 93, Number 4, pages 1703-1929, 2003) and includes correction for subduction interface equations as described in “Erratum to ‘Empirical Ground Motion Relations for Subduction-Zone Earthquakes and their application to Cascadia and other regions’”, Gail M. Atkinson and David M. Boore, Volume 98, Number 5, pp.2567-2569, 2008. The class implements the global model but not the corrections for Japan/Cascadia. SA values at 4 s (not supported by the original equations) are obtained from mean value at 3 s divided by a factor equal to 0.550 (scaling factor computed in the context of the SHARE project and obtained as average ratio between median values at 4 and 3 seconds as predicted by SHARE subduction GMPEs). The class implements the equations for ‘Subduction Interface’ (that’s why the class name ends with ‘SInter’).

COEFFS_SINTER = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma s1 s2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Random horizontal'

Supported intensity measure component is the random horizontal component: attr:~openquake.hazardlib.const.IMC.RANDOM_HORIZONTAL, see paragraph ‘Functional : Form’, page 1706

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 1, page 1715

DEFINED_FOR_REFERENCE_VELOCITY = 800

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see table 1, page 1715

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, see equation 1, page 1706

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and focal depth, see equation 1, page 1706

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30, used to distinguish between NEHRP soil classes, see paragraph ‘Functional Form’, page 1706

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'SInter'

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SInterNSHMP2008(**kwargs)

Bases: AtkinsonBoore2003SInter

Extend AtkinsonBoore2003SInter and introduces site amplification for B/C site condition and fixed rupture hypocentral depth (20 km) as defined by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 US hazard model

Site amplification for B/C is triggered when vs30 > 760 and it is computed as site amplification for C soil scaled by a factor equal to 0.5

The class implements the equation as coded in subroutine getABsub in hazSUBXnga.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

kind = 'SInter2008'

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SSlab(**kwargs)

Bases: AtkinsonBoore2003SInter

Implements GMPE developed by G. M Atkinson and D. Boore and published as “Empirical Ground-Motion Relations for Subduction-Zone Earthquakes and Their Application to Cascadia and Other Regions” (Bulletin of the Seismological Society of America, Volume 93, Number 4, pages 1703-1929, 2003). The class implements the global model but not the corrections for Japan/Cascadia. SA values at 4 s (not supported by the original equations) are obtained from mean value at 3 s divided by a factor equal to 0.550 (scaling factor computed in the context of the SHARE project and obtained as average ratio between median values at 4 and 3 seconds as predicted by SHARE subduction GMPEs). The class implements the equations for ‘Subduction IntraSlab’ (that’s why the class name ends with ‘SSlab’).

COEFFS_SSLAB = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma s1 s2>

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction interface

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SSlabCascadia(**kwargs)

Bases: AtkinsonBoore2003SSlab

Extends AtkinsonBoore2003SSlab but uses coefficients for Cascadia region

The class replicates the equation as coded in subroutine getABsub in hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

COEFFS_SSLAB = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma s1 s2>

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SSlabCascadiaNSHMP2008(**kwargs)

Bases: AtkinsonBoore2003SSlabNSHMP2008

Combines AtkinsonBoore2003SSlabNSHMP2008 for NSHMP site amplification with AtkinsonBoore2003SSlabCascadia for Cascadia.

COEFFS_SSLAB = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma s1 s2>

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SSlabJapan(**kwargs)

Bases: AtkinsonBoore2003SSlab

Extends AtkinsonBoore2003SSlab but substitutes values for c1 from Table 3 which incorporate correction factors for Japan.

COEFFS_SSLAB = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma s1 s2>

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SSlabJapanNSHMP2008(**kwargs)

Bases: AtkinsonBoore2003SSlabNSHMP2008

Combines AtkinsonBoore2003SSlabNSHMP2008 for NSHMP site amplification with AtkinsonBoore2003SSlabJapan for Japan.

Validation test vector was generated by applying increments in columns 1 and 2 of Table 3 to test vector for AtkinsonBoore2003SSlabCascadiaNSHMP2008.

COEFFS_SSLAB = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma s1 s2>

class openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SSlabNSHMP2008(**kwargs)

Bases: AtkinsonBoore2003SSlab

Extend AtkinsonBoore2003SSlab and introduces site amplification for B/C site condition as defined by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 US hazard model.

Site amplification for B/C is triggered when vs30 > 760 and it is computed as site amplification for C soil scaled by a factor equal to 0.5

The class replicates the equation as coded in subroutine getABsub in hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

kind = 'SSlab2008'

atkinson_boore_2006

Module exports BooreAtkinson2008, AtkinsonBoore2006, AtkinsonBoore2006Modified2011. AtkinsonBoore2006SGS.

class openquake.hazardlib.gsim.atkinson_boore_2006.AtkinsonBoore2006(**kwargs)

Bases: GMPE

Implements GMPE developed by Gail M. Atkinson and David M. Boore and published as “Earthquake Ground-Motion Prediction Equations for Eastern North America” (2006, Bulletin of the Seismological Society of America, Volume 96, No. 6, pages 2181-2205). This class implements only the equations for stress parameter of 140 bars. The correction described in ‘Adjustment of Equations to Consider Alternative Stress Parameters’, p. 2198, is not implemented. This class uses the same soil amplification function as the BooreAtkinson2008. Note that in the paper, the reported soil amplification function is the one used in a preliminary version of the Boore and Atkinson 2008 GMPE, while the one that should be used is the one described in the final paper. See comment in: http://www.daveboore.com/pubs_online/ab06_gmpes_programs_and_tables.pdf

COEFFS_BC = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10>

Coefficients for NEHRP BC boundary (Vs30 = 760 m/s), table 9, pag 2202 coefficient values taken from Fortran implementation of Dave Boore (higher precision than in the paper)

COEFFS_HARD_ROCK = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10>

Hard rock coefficents, table 6, pag 2192, coefficient values taken from Fortran implementation of Dave Boore (higher precision than in the paper)

COEFFS_SOIL_RESPONSE = <CoeffsTable blin b1 b2>

Table 3, pag. 110. + coefficient values for additional frequencies extracted from Fortran code implementing soil response function developed by the original author (ab06_fmrvs_evaluate_gmpes.for available at http://www.daveboore.com/pubs_online.html - see code available for Atkinson, G. M. and D. M. Boore (2006). Earthquake ground -motion prediction equations for eastern North America)

COEFFS_STRESS = <CoeffsTable delta M1 Mh>

CUTOFF_RRUP = 0.0

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is horizontal GEOMETRIC_MEAN, personal communication with Gail Atkinson

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see paragraph ‘Methodology and Model Parameters’, p. 2182

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total, see table 6 and 9, p. 2192 and 2202, respectively.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental, given that the equations have been derived for Eastern North America

REQUIRES_ATTRIBUTES = frozenset({'mag_eq', 'scale_fac'})

Set of required GSIM attributes

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup. See paragraph ‘Methodology and Model Parameters’, p. 2182

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude (see paragraph ‘Methodology and Model Parameters’, p. 2182)

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30. See paragraph ‘Equations for soil sites’, p. 2200

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = '2006'

class openquake.hazardlib.gsim.atkinson_boore_2006.AtkinsonBoore2006Modified2011(**kwargs)

Bases: AtkinsonBoore2006

This GMPE modifies the original implementation of :class: AtkinsonBoore2006 with the magnitude dependent stress-drop scaling factor proposed in Atkinson & Boore (2011) Atkinson, G. A. and Boore D. M. (2011) Modifications to Existing Ground-Motion Prediciton Equations in Light of New Data. Bulletin of the Seismological Society of America, 101(3), 1121 - 1135

class openquake.hazardlib.gsim.atkinson_boore_2006.AtkinsonBoore2006SGS(**kwargs)

Bases: AtkinsonBoore2006

This class extends the original base class openquake.hazardlib.gsim.atkinson_boore_2006.AtkinsonBoore2006 by introducing a distance filter for the near field, as implemented by SGS for the national PSHA model for Saudi Arabia.

CUTOFF_RRUP = 5.0

openquake.hazardlib.gsim.atkinson_boore_2006.set_sig(kind, C, sig, tau, phi)

Set standard deviations as defined in table 8, pag 121.

atkinson_macias_2009

Module exports :class:’AtkinsonMacias2009’

class openquake.hazardlib.gsim.atkinson_macias_2009.AtkinsonMacias2009(**kwargs)

Bases: GMPE

Implements the Subduction Interface GMPE of Atkinson & Macias (2009) for large interface earthquakes in the Cascadia subduction zone. Atkinson, G. M. and Macias, M. (2009) “Predicted Ground Motions for Great Interface Earthquakes in the Cascadia Subduction Zone”, Bulletin of the Seismological Society of America, 99(3), 1552 - 1578

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Random horizontal'

Supported intensity measure component is assumed to be equivalent to the random horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are peak ground acceleration and Spectral Acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

The GMPE is derived for subduction interface earthquakes in Cascadia

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rupture distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

No required site parameters, the GMPE is derived for B/C site conditions

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

bahrampouri_2021_Arias_Intensity

Module exports bahrampouriEtAl2021IA, class:bahrampouriEtAl2021Asc, class:bahrampouriEtAl2021SSlab, class:bahrampouriEtAl2021SInter,

class openquake.hazardlib.gsim.bahrampouri_2021.BahrampouriEtAl2021Asc(**kwargs)

Bases: GMPE

Implements GMPE by Mahdi Bahrampouri, Adrian Rodriguez-Marek and Russell A Green developed from the Kiban-Kyoshin network (KiK)-net database. This GMPE is specifically derived for arias intensity. This GMPE is described in a paper published in 2021 on Earthquake Spectra, Volume 37, Pg 428-448 and titled ‘Ground motion prediction equations for Arias Intensity using the Kik-net database’.

COEFFS = <CoeffsTable a1 a2 a3 a4 a7 b1 b3b b3f b4m b4k b5 b6 b7 b8 b9 b10 b11 b12 b13 b14 c1 c2 c3 c4 phi_ss tau phi_s2s sig>

For Ia, coefficients are taken from table 3

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function IA>})

Supported intensity measure types are areas intensity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see paragraph “Equations for standard deviations”, page 1046.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measures are rrup (see Table 2, page 1031).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_lat', 'hypo_lon', 'mag', 'ztor'})

Required rupture parameters are magnitude,ztor

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Required site parameters are Vs30 and coordinates of the site

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.bahrampouri_2021.BahrampouriEtAl2021SInter(**kwargs)

Bases: GMPE

Implements GMPE by Mahdi Bahrampouri, Adrian Rodriguez-Marek and Russell A Green developed from the Kiban-Kyoshin network (KiK)-net database. This GMPE is specifically derived for arias intensity. This GMPE is described in a paper published in 2021 on Earthquake Spectra, Volume 37, Pg 428-448 and titled ‘Ground motion prediction equations for Arias Intensity using the Kik-net database’.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 b1 b2 b3b b3f b4m b4k b5 b6 b7 b8 b9 b10 b11 b12 b13 b14 c1 c2 c3 c4 phi_ss tau phi_s2s sig>

For Ia, coefficients are taken from table 3

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function IA>})

Supported intensity measure types are areas intensity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see paragraph “Equations for standard deviations”, page 1046.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is SUBDUCTION INTERFACE, see title!

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measures are rrup (see Table 2, page 1031).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_lat', 'hypo_lon', 'mag', 'ztor'})

Required rupture parameters are magnitude,ztor

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Required site parameters are Vs30 and coordinates of the site

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.bahrampouri_2021.BahrampouriEtAl2021SSlab(**kwargs)

Bases: GMPE

Implements GMPE by Mahdi Bahrampouri, Adrian Rodriguez-Marek and Russell A Green developed from the Kiban-Kyoshin network (KiK)-net database. This GMPE is specifically derived for arias intensity. This GMPE is described in a paper published in 2021 on Earthquake Spectra, Volume 37, Pg 428-448 and titled ‘Ground motion prediction equations for Arias Intensity using the Kik-net database’.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 b1 b2 b3b b3f b4m b4k b5 b6 b7 b8 b9 b10 b11 b12 b13 b14 c1 c2 c3 c4 phi_ss tau phi_s2s sig>

For Ia, coefficients are taken from table 3

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function IA>})

Supported intensity measure types are areas intensity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see paragraph “Equations for standard deviations”, page 1046.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is SUBDUCTION INTERSLAB, see title!

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measures are rrup (see Table 2, page 1031).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_lat', 'hypo_lon', 'mag', 'ztor'})

Required rupture parameters are magnitude,ztor

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Required site parameters are Vs30 and coordinates of the site

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

bahrampouri_2021_duration

Module exports BahrampouriEtAldm2021

BahrampouriEtAldm2021ASC BahrampouriEtAldm2021SSlab BahrampouriEtAldm2021SInter

class openquake.hazardlib.gsim.bahrampouri_2021_duration.BahrampouriEtAldm2021Asc(**kwargs)

Bases: GMPE

Implements GMPE by Mahdi Bahrampouri, Adrian Rodriguez-Marek and Russell A Green developed from the KiK-net database. This GMPE is specifically derived for significant durations: Ds5-Ds95,D25-Ds75. This GMPE is described in a paper published in 2021 on Earthquake Spectra, Volume 37, Pg 903-920 and titled ‘Ground motion prediction equations for significant duration using the KiK-net database’.

COEFFS = <CoeffsTable m1 m2 m3_RS m3_SS m3_NS M1 M2 r1 r2 R1 s1 s2 s3 sig tau phi_s2s phi_ss>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function RSD595>, <function RSD575>})

Supported intensity measure types are 5 - 95 % Arias and 5 - 75 % Arias significant duration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is only total, see table 7, page 35

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and top of rupture depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Requires vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.bahrampouri_2021_duration.BahrampouriEtAldm2021SInter(**kwargs)

Bases: BahrampouriEtAldm2021Asc

Implements GMPE by Mahdi Bahrampouri, Adrian Rodriguez-Marek and Russell A Green developed from the KiK-net database. This GMPE is specifically derived for significant durations: Ds5-Ds95,D25-Ds75. This GMPE is described in a paper published in 2021 on Earthquake Spectra, Volume 37, Pg 903-920 and titled ‘Ground motion prediction equations for significant duration using the KiK-net database’.

COEFFS = <CoeffsTable m1 m2 m3_RS M1 M2 r1 r2 R1 s1 s2 s3 sig tau phi_s2s phi_ss>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function RSD595>, <function RSD575>})

Supported intensity measure types are 5 - 95 % Arias and 5 - 75 % Arias significant duration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is only total, see table 7, page 35

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and top of rupture depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Requires vs30

class openquake.hazardlib.gsim.bahrampouri_2021_duration.BahrampouriEtAldm2021SSlab(**kwargs)

Bases: BahrampouriEtAldm2021Asc

Implements GMPE by Mahdi Bahrampouri, Adrian Rodriguez-Marek and Russell A Green developed from the KiK-net database. This GMPE is specifically derived for significant durations: Ds5-Ds95,D25-Ds75. This GMPE is described in a paper published in 2021 on Earthquake Spectra, Volume 37, Pg 903-920 and titled ‘Ground motion prediction equations for significant duration using the KiK-net database’.

COEFFS = <CoeffsTable m1 m2 m3_RS m3_SS m3_NS M1 M2 r1 r2 R1 s1 s2 s3 sig tau phi_s2s phi_ss>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function RSD595>, <function RSD575>})

Supported intensity measure types are 5 - 95 % Arias and 5 - 75 % Arias significant duration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is only total, see table 7, page 35

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and top of rupture depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Requires vs30

baumont_2018

Module exports :

class:BaumontEtAl2018High2210IAVGDC30n7

class openquake.hazardlib.gsim.baumont_2018.BaumontEtAl2018High2210IAVGDC30n7(**kwargs)

Bases: GMPE

Implements “Intensity predictive attenuation models calibrated in Mw for metropolitan France David Baumont,Kevin Manchuel, Paola Traversa, Christophe Durouchoux, Emmanuelle Nayman, Gabriele Ameri Bull Earthquake Eng (2018) 16:2285–2310 https://doi.org/10.1007/s10518-018-0344-6 functional given on page 2293 for Rhypo This class implements the model Intensity Model:Q Domain:Depth Control:DBMI Data Selection given in Table 1: Intensity model: (1) Regional geometrical spreading (2) Geometrical spreading and regional intrinsic attenuation Q-domain:(0) France, (1) France and Italy, (2) Q-regions (France and Italy) Depth control: (0) Depth fixed, (1) Depth free within the plausible range defined in Table 3, (2) Similar to depth case # 1 but with Io constraints DBMI data selection: (0) IDP(MCS) <= VII, (1) IDP(MCS) <= VI Min Dc (km): 30, 50 Min # intensity classes: 3,5,7 Intensity metrics: IAVG, RAVG, ROBS, RP50, RP84

The model implemented is [2.2.1.0] for high attenuation, MinDc=30 and Min = 7 int. classes and IAVG as the base classes

Implemented by laurentiu.danciu@sed.ethz.ch

COEFFS = <CoeffsTable c1 c2 beta gamma we be>

Coefficient table constructed from the electronic suplements of the original paper

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function MMI>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance rhypo

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

bayless_abrahamson_2018

Module exports BaylessAbrahamson2018

class openquake.hazardlib.gsim.bayless_abrahamson_2018.BaylessAbrahamson2018(**kwargs)

Bases: GMPE

Implements the Bayless and Abrahamson (2018, 2019) model. References: - Bayless, J., and N. A. Abrahamson (2018b). An empirical model for Fourier amplitude spectra using the NGA-West2 database, PEER Rept. No. 2018/07, Pacific Earthquake Engineering Research Center, University of California, Berkeley, California. - Bayless, J. and N.A. Abrahamson (2019). Summary of the BA18 Ground-Motion Model for Fourier Amplitude Spectra for Crustal Earthquakes in California. Bull. Seism. Soc. Am., 109(5): 2088–2105

Disclaimer: The authors describe a smoothing technique that needs to be applied to the non linear component of the site response. We did not implement these smoothing functions in this initial versions since the match with the values in the verification tables is good even without it.

COEFFS = <CoeffsTable c1 c2 c3 cn cM c4 c5 c6 chm c7 c8 c9 c10 c11a c11b c11c c11d c1a s1 s2 s3 s4 s5 s6 f3 f4 f5>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function EAS>})

Supported intensity measure types

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see title!

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measures

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake', 'ztor'})

Required rupture parameters

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Required site parameters

compute(ctx: recarray, imts, mean, sigma, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

f = <_io.TextIOWrapper name='/home/runner/work/oq-engine/oq-engine/openquake/hazardlib/gsim/bayless_abrahamson_2018.csv' mode='r' encoding='UTF-8'>

bchydro_2016_epistemic

class openquake.hazardlib.gsim.bchydro_2016_epistemic.BCHydroESHM20SInter(**kwargs)

Bases: AbrahamsonEtAl2015SInter

ESHM20 adjustment of the BC Hydro GMPE for subduction interface events with theta6 calibrated to Mediterranean data.

Introduces several configurable parameters:

Parameters:

• theta6_adjustment (float) – The amount to increase or decrease the theta6 - should be +0.0015 (for slower attenuation) and -0.0015 (for faster attenuation)

• sigma_mu_epsilon (float) – The number of standard deviations above or below the mean to apply the statistical uncertainty sigma_mu term.

• faba_model – Choice of model for the forearc/backarc tapering function, choice of {“Step”, “Linear”, “SFunc”, “Sigmoid”, “Gaussian”}

Depending on the choice of taper model, additional parameters may be passed

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'xvf'})

Site amplification is dependent upon Vs30 For the Abrahamson et al (2013) GMPE a new term is introduced to determine whether a site is on the forearc with respect to the subduction interface, or on the backarc. This boolean is a vector containing True for a backarc site or False for a forearc or unknown site.

class openquake.hazardlib.gsim.bchydro_2016_epistemic.BCHydroESHM20SInterHigh(**kwargs)

Bases: AbrahamsonEtAl2015SInterHigh

ESHM20 adjustment of the BC Hydro GMPE for subduction interface events with theta6 calibrated to Mediterranean data, for the high magnitude scaling branch.

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'xvf'})

Site amplification is dependent upon Vs30 For the Abrahamson et al (2013) GMPE a new term is introduced to determine whether a site is on the forearc with respect to the subduction interface, or on the backarc. This boolean is a vector containing True for a backarc site or False for a forearc or unknown site.

class openquake.hazardlib.gsim.bchydro_2016_epistemic.BCHydroESHM20SInterLow(**kwargs)

Bases: AbrahamsonEtAl2015SInterLow

ESHM20 Adjustment of the BC Hydro GMPE for subduction interface events with theta6 calibrated to Mediterranean data, for the low magnitude scaling branch.

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'xvf'})

Site amplification is dependent upon Vs30 For the Abrahamson et al (2013) GMPE a new term is introduced to determine whether a site is on the forearc with respect to the subduction interface, or on the backarc. This boolean is a vector containing True for a backarc site or False for a forearc or unknown site.

class openquake.hazardlib.gsim.bchydro_2016_epistemic.BCHydroESHM20SSlab(**kwargs)

Bases: AbrahamsonEtAl2015SSlab

ESHM20 adjustment of the BC Hydro GMPE for subduction in-slab events with theta6 calibrated to Mediterranean data.

Introduces two configurable parameters:

a6_adjustment - the amount to increase or decrease the theta6 (should be +0.0015 (for slower attenuation) and -0.0015 (for faster attenuation)

sigma_mu_epsilon - number of standard deviations above or below the mean to apply the statistical uncertainty sigma_mu term.

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'xvf'})

Site amplification is dependent upon Vs30 For the Abrahamson et al (2013) GMPE a new term is introduced to determine whether a site is on the forearc with respect to the subduction interface, or on the backarc. This boolean is a vector containing True for a backarc site or False for a forearc or unknown site.

class openquake.hazardlib.gsim.bchydro_2016_epistemic.BCHydroESHM20SSlabHigh(**kwargs)

Bases: AbrahamsonEtAl2015SSlabHigh

ESHM20 adjustment of the BC Hydro GMPE for subduction interface events with theta6 calibrated to Mediterranean data, for the high magnitude scaling branch.

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'xvf'})

Site amplification is dependent upon Vs30 For the Abrahamson et al (2013) GMPE a new term is introduced to determine whether a site is on the forearc with respect to the subduction interface, or on the backarc. This boolean is a vector containing True for a backarc site or False for a forearc or unknown site.

class openquake.hazardlib.gsim.bchydro_2016_epistemic.BCHydroESHM20SSlabLow(**kwargs)

Bases: AbrahamsonEtAl2015SSlabLow

ESHM20 adjustment of the BC Hydro GMPE for subduction in-slab events with theta6 calibrated to Mediterranean data, for the low magnitude scaling branch.

COEFFS = <CoeffsTable vlin b theta1 theta2 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma sigma_ss>

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'xvf'})

Site amplification is dependent upon Vs30 For the Abrahamson et al (2013) GMPE a new term is introduced to determine whether a site is on the forearc with respect to the subduction interface, or on the backarc. This boolean is a vector containing True for a backarc site or False for a forearc or unknown site.

class openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperGaussian(a=-inf, b=inf, sigma=1.0)

Bases: FABATaperStep

Implements tapering of x according to a truncated Gaussian function

Parameters:

• sigma (float) – Bandwidth of function (according to a Gaussian standard deviation)

• a (float) – Initiation point of tapering (km)

• b (float) – Termination point of tapering (km)

class openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperLinear(width=1.0)

Bases: FABATaperStep

Implements a tapering of x according to a linear function with a fixed distance and a midpoint (y = 0.5) at x = 0

Parameters:

width (float) – Distance (km) across which x tapers to 0

class openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperSFunc(a=0.0, b=0.0)

Bases: FABATaperStep

Implements tapering of x according to a S-function (Named such because of its S-like shape.)

Parameters:

• a (float) – ‘ceiling’, where the function begins falling from 1.

• b (float) – ‘floor’, where the function reaches zero.

class openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperSigmoid(c=1.0)

Bases: FABATaperStep

Implements tapering of x according to a sigmoid function (Note that this only tends to 1, 0 it does not reach it)

Parameters:

c (float) – Bandwidth in km of the sigmoid function

class openquake.hazardlib.gsim.bchydro_2016_epistemic.FABATaperStep

Bases: object

General class for a tapering function, in this case a step function such that the backarc scaling term takes 0 for forearc sites (negative backarc distance), and 1 for backarc sites (positive backarc distance)

openquake.hazardlib.gsim.bchydro_2016_epistemic.phix(x)

berge_thierry_2003

Module exports BergeThierryEtAl2003SIGMA.

class openquake.hazardlib.gsim.berge_thierry_2003.BergeThierryEtAl2003Ms(**kwargs)

Bases: GMPE

Implements GMPE developed by Catherine Berge-Thierry, Fabrice Cotton, Oona Scoti, Daphne-Anne Griot-Pommera, and Yoshimitsu Fukushima and published as “New Empirical Response Spectral Attenuation Laws For Moderate European Earthquakes” (2003, Journal of Earthquake Engineering, 193-222) This class corresponds to the original formulation, usable with Ms.

COEFFS = <CoeffsTable a b c1 c2 sigma>

Coefficient tables are constructed from the electronic suplements of the original paper. Original coefficients in function of frequency.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is horizontal, see page 196.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration. The original manuscript provide coefficients only SA. For PGA, coefficients are assumed equal to the ones of SA for the smallest period (0.03 s)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total, see table 3, page 203

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see Introduction, page 194.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance, see equation 1 page 201

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters is magnitude, see equation 1 page 201

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30, used to distinguish between rock sites (Vs30 >= 800) m/s and alluvium sites (300 < Vs < 800), see section 2.2.3 page 201

compute(ctx: recarray, imts, mean, sig, tau, phi, mag_conversion_sigma=0.0)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

mag_conversion_sigma = 0.0

class openquake.hazardlib.gsim.berge_thierry_2003.BergeThierryEtAl2003MwL_GBL(**kwargs)

Bases: BergeThierryEtAl2003Ms

Mw version of the Berge-Thierry et al. (2003) GMPE. For this conversion we use the Lolli et al. (2014) conversion equation between Ms and Mw for the GBL region (i.e. Global Scale). Exponential model:

Mw = exp(a + b * Ms) + c with slope = b * exp(a + b * Ms)

Parameters:

for Ms<=5.5: (a,b,c) = (2.133,0.063,-6.205) for Ms>5.5: (a,b,c) = (-0.109,0.229,2.586)

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

class openquake.hazardlib.gsim.berge_thierry_2003.BergeThierryEtAl2003MwL_ITA(**kwargs)

Bases: BergeThierryEtAl2003Ms

Mw version of the Berge-Thierry et al. (2003) GMPE. For this conversion we use the Lolli et al. (2014) conversion equation between Ms and Mw for the ITA region. Exponential model: Mw = exp(a+b*Ms)+c with slope=b*exp(a+b*Ms) Parameters: (a,b,c) = (1.421,0.108,-1.863)

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

class openquake.hazardlib.gsim.berge_thierry_2003.BergeThierryEtAl2003MwL_MED(**kwargs)

Bases: BergeThierryEtAl2003Ms

Mw version of the Berge-Thierry et al. (2003) GMPE. For this conversion we use the Lolli et al. (2014) conversion equation between Ms and Mw for the Euro-Mediterranean region. Exponential model: Mw = exp(a+b*Ms)+c with slope=b*exp(a+b*Ms) Parameters: (a,b,c) = (2.133,0.063,-6.205)

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

class openquake.hazardlib.gsim.berge_thierry_2003.BergeThierryEtAl2003MwW(**kwargs)

Bases: BergeThierryEtAl2003Ms

Mw version of the Berge-Thierry et al. (2003) GMPE. For this conversion we use the Weatherill et al. (2016) conversion equation between Ms and Mw Bilinear magnitude conversion relation.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

class openquake.hazardlib.gsim.berge_thierry_2003.BergeThierryEtAl2003SIGMA(**kwargs)

Bases: BergeThierryEtAl2003Ms

Implements GMPE developed by Catherine Berge-Thierry, Fabrice Cotton, Oona Scoti, Daphne-Anne Griot-Pommera, and Yoshimitsu Fukushima and published as “New Empirical Response Spectral Attenuation Laws For Moderate European Earthquakes” (2003, Journal of Earthquake Engineering, 193-222) The class implements also adjustment of the sigma value as required by the SIGMA project to make standard deviations compatible with Mw (the GMPE was originally developed for Ms). Additional reference: Carbon, D. et al., 2012, Final preliminary Probabilistic Hazard map for France’s southeast 1/4, Deliverable D4-18, p.31, SIGMA project.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

bindi_2011

Module exports BindiEtAl2011.

class openquake.hazardlib.gsim.bindi_2011.BindiEtAl2011(**kwargs)

Bases: GMPE

Implements GMPE developed by D.Bindi, F.Pacor, L.Luzi, R.Puglia, M.Massa, G. Ameri, R. Paolucci and published as “Ground motion prediction equations derived from the Italian strong motion data”, Bull Earthquake Eng, DOI 10.1007/s10518-011-9313-z. SA are given up to 2 s. The regressions are developed considering the geometrical mean of the as-recorded horizontal components

COEFFS = <CoeffsTable e1 c1 c2 h c3 b1 b2 sA sB sC sD sE f1 f2 f3 f4 SigmaB SigmaW SigmaTot>

COEFFS_DELTA = <CoeffsTable a b c>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, page 1904

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ because the equations have been derived from data from Italian database ITACA, as explained in the ‘Introduction’.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is RRup (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

sgn = 0

class openquake.hazardlib.gsim.bindi_2011.BindiEtAl2011Ita19Low(**kwargs)

Bases: BindiEtAl2011

Implements the lower term of the ITA19 backbone model.

sgn = -1

class openquake.hazardlib.gsim.bindi_2011.BindiEtAl2011Ita19Upp(**kwargs)

Bases: BindiEtAl2011

Implements the upper term of the ITA19 backbone model.

sgn = 1

bindi_2011_ipe

Module exports : class:BindiEtAl2011Repi, class:BindiEtAl2011RepiFixedH,

class openquake.hazardlib.gsim.bindi_2011_ipe.BindiEtAl2011Repi(**kwargs)

Bases: GMPE

Implements IPE developed by Dino Bindi et al. 2011 and published as “Intensity prediction equations for Central Asia” (Geo-physical journal international, 2011, 187,327-337).

Model implemented by laurentiu.danciu@gmail.com

COEFFS = <CoeffsTable a1 a2 a3 a4 sigma>

Coefficient table constructed from the electronic suplements of the original paper.Table 1 .page 331

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function MMI>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance repi

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

fixedh = None

class openquake.hazardlib.gsim.bindi_2011_ipe.BindiEtAl2011RepiFixedH(**kwargs)

Bases: BindiEtAl2011Repi

Implements IPE developed by Dino Bindi et al. 2011 and published as “Intensity prediction equations for Central Asia” (Geo-physical journal international, 2011, 187,327-337). for a fixed depth of 15 km and epicentral distance (equation 5 in the paper) Implements the Repi with fixed depth at 15km /coeff on Table 1

Model implmented by laurentiu.danciu@gmail.com

COEFFS = <CoeffsTable a1 a2 a3 a4 sigma>

Coefficient table constructed from the electronic suplements of the original paper.

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance repi

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

fixedh = 15.0

bindi_2011scaled

Module exports BindiEtAl2011scaled.

class openquake.hazardlib.gsim.bindi_2011scaled.BindiEtAl2011scaled(**kwargs)

Bases: BindiEtAl2011

Implements scaled GMPE developed by D.Bindi, F.Pacor, L.Luzi, R.Puglia, M.Massa, G. Ameri, R. Paolucci and published as “Ground motion prediction equations derived from the Italian strong motion data”, Bull Earthquake Eng, DOI 10.1007/s10518-011-9313-z. SA are given up to 2 s. The regressions are developed considering the geometrical mean of the as-recorded horizontal components

COEFFS = <CoeffsTable e1 c1 c2 h c3 b1 b2 sA sB sC sD sE f1 f2 f3 f4 SigmaB SigmaW SigmaTot>

bindi_2014

Module exports BindiEtAl2014Rjb,

BindiEtAl2014RjbEC8, BindiEtAl2014RjbEC8NoSOF, BindiEtAl2014Rhyp, BindiEtAl2014RhypEC8, BindiEtAl2014RhypEC8NoSOF

class openquake.hazardlib.gsim.bindi_2014.BindiEtAl2014Rhyp(**kwargs)

Bases: BindiEtAl2014Rjb

Implements the Bindi et al (2014) GMPE for the case in which hypocentral distance is preferred, style-of-faulting is specfieid and for which the site amplification is dependent directly on Vs30

COEFFS = <CoeffsTable e1 c1 c2 h c3 b1 b2 b3 gamma sofN sofR sofS tau phi phis2s sigma>

Coefficients from Table 4

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo (eq. 1).

class openquake.hazardlib.gsim.bindi_2014.BindiEtAl2014RhypEC8(**kwargs)

Bases: BindiEtAl2014RjbEC8

Implements the Bindi et al (2014) GMPE for the case in which hypocentral distance is preferred, style-of-faulting is specfied and site amplification is characterised according to the Eurocode 8 site class

COEFFS = <CoeffsTable e1 c1 c2 h c3 b1 b2 b3 eA eB eC eD sofN sofR sofS sofU tau phi phis2s sigma>

Coefficients from Table 3

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo

class openquake.hazardlib.gsim.bindi_2014.BindiEtAl2014RhypEC8NoSOF(**kwargs)

Bases: BindiEtAl2014RhypEC8

Implements the Bindi et al. (2014) GMPE for the case in which hypocentral distance is preferred, Eurocode 8 site amplification is used and style-of-faulting is unspecfied.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

sof = False

class openquake.hazardlib.gsim.bindi_2014.BindiEtAl2014Rjb(**kwargs)

Bases: GMPE

Implements European GMPE: D.Bindi, M. Massa, L.Luzi, G. Ameri, F. Pacor, R.Puglia and P. Augliera (2014), “Pan-European ground motion prediction equations for the average horizontal component of PGA, PGV and 5 %-damped PSA at spectral periods of up to 3.0 s using the RESORCE dataset”, Bulletin of Earthquake Engineering, 12(1), 391 - 340

The regressions are developed considering the geometrical mean of the as-recorded horizontal components The printed version of the GMPE was corrected by Erratum: D.Bindi, M. Massa, L.Luzi, G. Ameri, F. Pacor, R.Puglia and P. Augliera (2014), “Erratum to Pan-European ground motion prediction equations for the average horizontal component of PGA, PGV and 5 %-damped PSA at spectral periods of up to 3.0 s using the RESORCE dataset”, Bulletin of Earthquake Engineering, 12(1), 431 - 448. The erratum notes that the printed coefficients tables were in error. In this implementation coefficients tables were taken from the Electronic Supplementary material of the original paper, which are indicated as being unaffected.

COEFFS = <CoeffsTable e1 c1 c2 h c3 b1 b2 b3 gamma sofN sofR sofS tau phi phis2s sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

sof = True

class openquake.hazardlib.gsim.bindi_2014.BindiEtAl2014RjbEC8(**kwargs)

Bases: BindiEtAl2014Rjb

Implements the Bindi et al (2014) GMPE for the case where Joyner-Boore distance is specified but Eurocode 8 Site classification is used.

COEFFS = <CoeffsTable e1 c1 c2 h c3 b1 b2 b3 eA eB eC eD sofN sofR sofS sofU tau phi phis2s sigma>

Coefficients from Table 1

kind = 'EC8'

class openquake.hazardlib.gsim.bindi_2014.BindiEtAl2014RjbEC8NoSOF(**kwargs)

Bases: BindiEtAl2014RjbEC8

Implements the Bindi et al (2014) GMPE for the case in which the site amplification is defined according to the Eurocode 8 classification, but style-of-faulting is neglected

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

sof = False

bindi_2014scaled

Module exports BindiEtAl2014RhypEC8scaled

class openquake.hazardlib.gsim.bindi_2014scaled.BindiEtAl2014RhypEC8scaled(**kwargs)

Bases: BindiEtAl2014RhypEC8

Implements scaled European GMPE: D.Bindi, M. Massa, L.Luzi, G. Ameri, F. Pacor, R.Puglia and P. Augliera (2014), “Pan-European ground motion prediction equations for the average horizontal component of PGA, PGV and 5 %-damped PSA at spectral periods of up to 3.0 s using the RESORCE dataset”, Bulletin of Earthquake Engineering, 12(1), 391 - 340

The regressions are developed considering the geometrical mean of the as-recorded horizontal components The printed version of the GMPE was corrected by Erratum: D.Bindi, M. Massa, L.Luzi, G. Ameri, F. Pacor, R.Puglia and P. Augliera (2014), “Erratum to Pan-European ground motion prediction equations for the average horizontal component of PGA, PGV and 5 %-damped PSA at spectral periods of up to 3.0 s using the RESORCE dataset”, Bulletin of Earthquake Engineering, 12(1), 431 - 448. The erratum notes that the printed coefficients tables were in error. In this implementation coefficients tables were taken from the Electronic Supplementary material of the original paper, which are indicated as being unaffected.

COEFFS = <CoeffsTable e1 c1 c2 h c3 b1 b2 b3 eA eB eC eD sofN sofR sofS sofU tau phi phis2s sigma>

Coefficients from Table 3

bindi_2017

Module exports BindiEtAl2017Rjb,

BindiEtAl2017Rhypo

class openquake.hazardlib.gsim.bindi_2017.BindiEtAl2017Rhypo(**kwargs)

Bases: BindiEtAl2017Rjb

Version of the Bindi et al. (2017) GMPE using hypocentral distance.

COEFFS = <CoeffsTable e1 b1 b2 b3 c1 c2 c3 sA tau phi>

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo (eq. 1).

class openquake.hazardlib.gsim.bindi_2017.BindiEtAl2017Rjb(**kwargs)

Bases: GMPE

Implements the European GMPE of Bindi et al. (2017) for use in moderate-seismicity regions:

D.Bindi, F. Cotton, S. R. Kotha, C. Bosse, D. Stromeyer and G. Gruenthal (2017) “Application-driven ground motion prediction equation for seismic hazard assessments in non-cratonic moderate-seismicity areas”, J. Seismology, 21(5), 1201 - 1218

Two different GMPEs are supported here

COEFFS = <CoeffsTable e1 b1 b2 b3 c1 c2 c3 h sA tau phi>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

GMPE is defined only for PGA and SA (PGV coefficients not made public)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is ‘stable shallow crust’

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

bommer_2009

Module exports BommerEtAl2009RSD

class openquake.hazardlib.gsim.bommer_2009.BommerEtAl2009RSD(**kwargs)

Bases: GMPE

Implements the GMPE of Bommer et al. (2009) for significant duration with 5 - 75 % Arias Intensity and 5 - 95 % Arias Intensity

COEFFS = <CoeffsTable c0 m1 r1 r2 h1 v1 z1 tau phi>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function RSD595>, <function RSD575>})

Supported intensity measure types are 5 - 95 % Arias and 5 - 75 % Arias significant duration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is only total, see table 7, page 35

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Required rupture parameters are magnitude and top of rupture depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Requires vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.bommer_2009.get_distance_term(C, rrup, mag)

Returns distance scaling term

openquake.hazardlib.gsim.bommer_2009.get_magnitude_term(C, mag)

Returns linear magnitude scaling term

openquake.hazardlib.gsim.bommer_2009.get_site_amplification(C, vs30)

Returns linear site amplification term

openquake.hazardlib.gsim.bommer_2009.get_stddevs(C)

Returns the standard deviations

openquake.hazardlib.gsim.bommer_2009.get_ztor_term(C, ztor)

Returns depth to top of rupture scaling

boore_1993

Module exports BooreEtAl1993GSCBest, BooreEtAl1993GSCUpperLimit, BooreEtAl1993GSCLowerLimit.

class openquake.hazardlib.gsim.boore_1993.BooreEtAl1993GSCBest(**kwargs)

Bases: GMPE

Implement equation used by the Geological Survey of Canada (GSC) for the 2010 Western Canada National Seismic Hazard Model. The class implements the model of David M. Boore, William B. Joyner, and Thomas E. Fumal (“Estimation of Response Spectra and Peak Accelerations from Western North American Earthquakes: An Interim Report”, 1993, U.S. Geological Survey, Open File Report 93-509). Equation coefficients provided by GSC for the random horizontal component and corresponding to the ‘Best’ case (that is mean unaffected)

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma>

coefficient table provided by GSC

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Random horizontal'

Supported intensity measure component is random horizontal RANDOM_HORIZONTAL,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, given that the equations have been derived for Western North America

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb distance see paragraph ‘Predictor Variables’, page 6.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

site params are not required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.boore_1993.BooreEtAl1993GSCLowerLimit(**kwargs)

Bases: BooreEtAl1993GSCBest

Implement equation used by the Geological Survey of Canada (GSC) for the 2010 Western Canada National Seismic Hazard Model. The class implements the model of David M. Boore, William B. Joyner, and Thomas E. Fumal (“Estimation of Response Spectra and Peak Accelerations from Western North American Earthquakes: An Interim Report”, 1993, U.S. Geological Survey, Open File Report 93-509). Equation coefficients provided by GSC for the random horizontal component and corresponding to the ‘Lower Limit’ case (that is mean value - 0.7 nat log)

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma>

coefficient table provided by GSC

class openquake.hazardlib.gsim.boore_1993.BooreEtAl1993GSCUpperLimit(**kwargs)

Bases: BooreEtAl1993GSCBest

Implement equation used by the Geological Survey of Canada (GSC) for the 2010 Western Canada National Seismic Hazard Model. The class implements the model of David M. Boore, William B. Joyner, and Thomas E. Fumal (“Estimation of Response Spectra and Peak Accelerations from Western North American Earthquakes: An Interim Report”, 1993, U.S. Geological Survey, Open File Report 93-509). Equation coefficients provided by GSC for the random horizontal component and corresponding to the ‘Upper Limit’ case (that is mean value + 0.7 nat log)

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma>

coefficient table provided by GSC

boore_1997

Module exports BooreEtAl1997GeometricMean,

:class:’BooreEtAl1997GeometricMeanUnspecified’ :class:’BooreEtAl1997ArbitraryHorizontal’ and :class:’BooreEtAl1997ArbitraryHorizontalUnspecfied’

class openquake.hazardlib.gsim.boore_1997.BooreEtAl1997ArbitraryHorizontal(**kwargs)

Bases: BooreEtAl1997GeometricMean

Returns the ground motion values for the arbitrary horizontal component, rather than the geometric mean. This version includes the corrected intra-event terms, as defined in an erratum to the original paper: Boore, DM (2005). “Erratum: Equations for Estimating Horizontal Response Spectra and Peak Acceleration from Western North American Earthquakes: A Summary of Recent Work.” Seismological Research Letters, 76(3), 368-369

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is the arbitrary horizontal

horizontal = True

class openquake.hazardlib.gsim.boore_1997.BooreEtAl1997ArbitraryHorizontalUnspecified(**kwargs)

Bases: BooreEtAl1997ArbitraryHorizontal

As for the :class:’BooreEtAl1997Arbitrary’, here defined for the case when the style of faulting is not specified

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

sof = None

class openquake.hazardlib.gsim.boore_1997.BooreEtAl1997GeometricMean(**kwargs)

Bases: GMPE

Implements GMPE developed by David M. Boore and William B. Joyner and Thomas E. Fumal (1997). “Equations for Estimating Horizontal Response Spectra and Peak Acceleration form Western North American Earthquakes: A Summary of Recent Work”. Seismological Research Letters. 68(1). 128 - 153

COEFFS = <CoeffsTable B1ss B1rv B1all B2 B3 B5 Bv Va h sigma1 sigma_c sigma_r sigma_e sigma_tot>

Coefficient table is constructed from values in Table 8 Note that for periods between 0.1 s and 0.18s the inter-event term is originally 0. As this was causing test warnings we have set this to an arbitrarily infinitesimal number

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see table 3 pag. 110

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see paragraph ‘Introduction’, page 99.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

horizontal = False

sof = True

class openquake.hazardlib.gsim.boore_1997.BooreEtAl1997GeometricMeanUnspecified(**kwargs)

Bases: BooreEtAl1997GeometricMean

Where the faulting mechanism need not be specified it is preferable to use this instance of the Boore et al (1997) GMPE, which omits the need for rake to be defined.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

sof = None

boore_2014

Module exports BooreEtAl2014,

BooreEtAl2014HighQ, BooreEtAl2014LowQ

class openquake.hazardlib.gsim.boore_2014.BooreEtAl2014(**kwargs)

Bases: GMPE

Implements GMPE developed by David M. Boore, Jonathan P. Stewart, Emel Seyhan and Gail Atkinson, and published as “NGA-West2 Equations for Predicting PGA, PGV, nd 5 % Damped PGA for Shallow Crustal Earthquakes (2014, Earthquake Spectra, Volume 30, No. 3, pages 1057 - 1085).

COEFFS = <CoeffsTable e0 e1 e2 e3 e4 e5 e6 Mh c1 c2 c3 h Dc3 c Vc f4 f5 f6 f7 R1 R2 DfR DfV f1 f2 tau1 tau2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, pag 106.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.boore_2014.BooreEtAl2014HighQ(**kwargs)

Bases: BooreEtAl2014

This class implements the Boore et al. (2014) model considering the correction to the path scaling term for High Q regions (e.g. China and Turkey) The modification is made to the “Dc3” coefficient

COEFFS = <CoeffsTable e0 e1 e2 e3 e4 e5 e6 Mh c1 c2 c3 h Dc3 c Vc f4 f5 f6 f7 R1 R2 DfR DfV f1 f2 tau1 tau2>

class openquake.hazardlib.gsim.boore_2014.BooreEtAl2014LowQ(**kwargs)

Bases: BooreEtAl2014

This class implements the Boore et al. (2014) model considering the correction to the path scaling term for Low Q regions (e.g. Italy and Japan) The modification is made to the “Dc3” coefficient

COEFFS = <CoeffsTable e0 e1 e2 e3 e4 e5 e6 Mh c1 c2 c3 h Dc3 c Vc f4 f5 f6 f7 R1 R2 DfR DfV f1 f2 tau1 tau2>

openquake.hazardlib.gsim.boore_2014.CONSTS = {'Mref': 4.5, 'Rref': 1.0, 'Vref': 760.0, 'f1': 0.0, 'f3': 0.1, 'v1': 225.0, 'v2': 300.0}

Equation constants that are IMT-independent

openquake.hazardlib.gsim.boore_2014.california_basin_model(vs30)

Returns the centred z1.0 (mu_z1) based on the California model (equation 11)

openquake.hazardlib.gsim.boore_2014.cls

alias of BooreEtAl2014

openquake.hazardlib.gsim.boore_2014.japan_basin_model(vs30)

Returns the centred z1.0 (mu_z1) based on the Japan model (equation 12)

boore_2020

Created on Mon May 24 21:19:41 2021 Authors: thimios.sokos@upatras.gr, laurentiu.danciu@sed.ethz.ch

Module exports BooreEtAl2020

class openquake.hazardlib.gsim.boore_2020.BooreEtAl2020(**kwargs)

Bases: GMPE

Implements GMPE developed by David M. Boore, Jonathan P. Stewart, Andreas A. Skarlatoudis,Emel Seyhan, Basil Margaris, Nikos Theodoulidis,Emmanuel Scordilis, Ioannis Kalogeras,Nikolaos Klimis, and Nikolaos S. Melis, and published as “Ground-Motion Prediction Model for Shallow Crustal Earthquakes in Greece (2020, BSSA, ). implemented by thimios.sokos@upatras.gr & laurentiu.danciu@sed.ethz.ch

COEFFS = <CoeffsTable B e0 e1 e2 e3 e4 e5 e6 Mh c1 c2 c3 Mref Rref h clin V1 Vc Vref f1 f3 f4 f5 phi tau1 Mtau1 Mtau2 tau2 sigma_M_ge_6_0>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, pag 106.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

boore_atkinson_2008

class openquake.hazardlib.gsim.boore_atkinson_2008.Atkinson2010Hawaii(**kwargs)

Bases: BooreAtkinson2008

Modification of the original base class adjusted for application to the Hawaii region as described in: Atkinson, G. M. (2010) ‘Ground-Motion Prediction Equations for Hawaii from a Referenced Empirical Approach”, Bulletin of the Seismological Society of America, Vol. 100, No. 2, pp. 751–761

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean, see paragraph ‘Response Variables’, page 100 and table 8, pag 121.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total see equation 2, pag 106.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is active volcanic, see paragraph ‘Introduction’, page 99.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag', 'rake'})

Required rupture parameters are magnitude, and rake. See paragraph ‘Predictor Variables’, pag 103

kind = 'hawaii'

class openquake.hazardlib.gsim.boore_atkinson_2008.BooreAtkinson2008(**kwargs)

Bases: GMPE

Implements GMPE developed by David M. Boore and Gail M. Atkinson and published as “Ground-Motion Prediction Equations for the Average Horizontal Component of PGA, PGV, and 5%-Damped PSA at Spectral Periods between 0.01 and 10.0 s” (2008, Earthquake Spectra, Volume 24, No. 1, pages 99-138).

COEFFS = <CoeffsTable c1 c2 c3 h e1 e2 e3 e4 e5 e6 e7 Mh sigma tau std>

sigma, tau, std are the intra-event uncertainty, inter-event uncertainty, and total standard deviation, respectively. Note that only the inter-event and total standard deviation for ‘specified’ fault type are considered (because rake angle is always specified)

COEFFS_A08 = <CoeffsTable c d>

COEFFS_SOIL_RESPONSE = <CoeffsTable blin b1 b2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (GMRotI50)'

Supported intensity measure component is orientation-independent measure GMRotI50, see paragraph ‘Response Variables’, page 100 and table 8, pag 121.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see table 3 pag. 110

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, pag 106.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see paragraph ‘Introduction’, page 99.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb. See paragraph ‘Predictor Variables’, pag 103

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake. See paragraph ‘Predictor Variables’, pag 103

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30. See paragraph ‘Predictor Variables’, pag 103

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

sgn = 0

openquake.hazardlib.gsim.boore_atkinson_2008.hawaii_adjust(mean, ctx, imt)

boore_atkinson_2011

Module exports BooreAtkinson2011,

Atkinson2008prime

class openquake.hazardlib.gsim.boore_atkinson_2011.Atkinson2008prime(**kwargs)

Bases: BooreAtkinson2008

Implements the Boore & Atkinson (2011) adjustment to the Atkinson (2008) GMPE (not itself implemented in OpenQuake)

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is active shallow crust, see paragraph ‘Introduction’, page 99.

kind = 'prime'

class openquake.hazardlib.gsim.boore_atkinson_2011.BooreAtkinson2011(**kwargs)

Bases: BooreAtkinson2008

Implements GMPE based on the corrections proposed by Gail M. Atkinson and D. Boore in 2011 and published as “Modifications to Existing Ground-Motion Prediction Equations in Light of New Data “ (2011, Bulletin of the Seismological Society of America, Volume 101, No. 3, pages 1121-1135).

kind = '2011'

bora_2019

Module exports BoraEtAl2019, BoraEtAl2019Drvt

class openquake.hazardlib.gsim.bora_2019.BoraEtAl2019(**kwargs)

Bases: GMPE

Implements the Fourier amplitude spectra model proposed by Bora et al., 2019 as described in Bora, S.S., Cotton, F., & Scherbaum, F. (2019). NGA-West2 empirical Fourier and duration models to generate adjustable response spectra. Earthquake Spectra, 35(1), 61-93.

COEFFS = <CoeffsTable c0 c1 c2 c3 c5 c6 c7 b1 b2 c4 tau phis2s phiss>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function FAS>})

Supported intensity measure types

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see title!

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measures

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters

compute(ctx: recarray, imts, mean, sigma, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

class openquake.hazardlib.gsim.bora_2019.BoraEtAl2019Drvt(**kwargs)

Bases: BoraEtAl2019

Implements the duration model proposed by Bora et al., 2019 as described in Bora, S.S., Cotton, F., & Scherbaum, F. (2019). NGA-West2 empirical Fourier and duration models to generate adjustable response spectra. Earthquake Spectra, 35(1), 61-93.

COEFFS = <CoeffsTable d0 d1 d2 d3 d4 d5 tau phis2s phi>

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function DRVT>})

Supported intensity measure types

compute(ctx: recarray, imts, mean, sigma, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

bozorgnia_campbell_2016

Module exports BozorgniaCampbell2016

BozorgniaCampbell2016HighQ BozorgniaCampbell2016LowQ BozorgniaCampbell2016AveQJapanSite BozorgniaCampbell2016HighQJapanSite BozorgniaCampbell2016LowQJapanSite

class openquake.hazardlib.gsim.bozorgnia_campbell_2016.BozorgniaCampbell2016(**kwargs)

Bases: GMPE

Implements the BC15 GMPE by Bozorgnia & Campbell (2016) for vertical-component ground motions from the PEER NGA-West2 Project

This model follows the same functional form as in CB14 by Campbell & Bozorgnia (2014) with minor modifications to the underlying parameters.

Note that this is a more updated version than the GMPE described in the original PEER Report 2013/24.

Reference:

Bozorgnia, Y. & Campbell, K. (2016). Vertical Ground Motion Model for PGA, PGV, and Linear Response Spectra Using the NGA-West2 Database. Earthquake Spectra, 32(2), 979-1004.

Implements the global model that uses datasets from California, Taiwan, the Middle East, and other similar active tectonic regions to represent a typical or average Q region.

Applies the average attenuation case (Dc20=0)

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 c15 c17 c18 c19 c20 Dc20_JP Dc20_CH a2 h1 h2 h3 h5 h6 k1 phi1 phi2 tau1 tau2>

Table of regression coefficients obtained from supplementary material published together with the EQS paper

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical'

Supported intensity measure component is the Vertical direction component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total; see the section for “Aleatory Variability Model”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

Required distance measures are Rrup, Rjb and Rx

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'hypo_depth', 'mag', 'rake', 'width', 'ztor'})

Required rupture parameters are magnitude, rake, dip, ztor, rupture width and hypocentral depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z2pt5'})

Required site parameters are Vs30, Vs30 type (measured or inferred), and depth (km) to the 2.5 km/s shear wave velocity layer (z2pt5)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.bozorgnia_campbell_2016.get_mean_values(SJ, sgn, C, ctx)

Returns the mean values for a specific IMT

bozorgnia_campbell_2016_vh

Module exports BozorgniaCampbell2016VH

BozorgniaCampbell2016HighQVH BozorgniaCampbell2016LowQVH BozorgniaCampbell2016AveQJapanSiteVH BozorgniaCampbell2016HighQJapanSiteVH BozorgniaCampbell2016LowQJapanSiteVH

class openquake.hazardlib.gsim.bozorgnia_campbell_2016_vh.BozorgniaCampbell2016AveQJapanSiteVH(**kwargs)

Bases: BozorgniaCampbell2016VH

Implements the GMPE by Bozorgnia & Campbell (2016) vertical-to-horizontal ratio for ground motions from the PEER NGA-West2 Project

Incorporates the difference in linear Vs30 scaling for sites in Japan by activating the flag variable in shallow site reponse scaling

Applies the average attenuation case (Dc20=0)

HGMPE = [CampbellBozorgnia2014JapanSite]

VGMPE = [BozorgniaCampbell2016]

class openquake.hazardlib.gsim.bozorgnia_campbell_2016_vh.BozorgniaCampbell2016HighQJapanSiteVH(**kwargs)

Bases: BozorgniaCampbell2016AveQJapanSiteVH

Implements the GMPE by Bozorgnia & Campbell (2016) vertical-to-horizontal ratio for ground motions from the PEER NGA-West2 Project

Incorporates the difference in linear Vs30 scaling for sites in Japan by activating the flag variable in shallow site reponse scaling

Applies regional corrections in path scaling term for regions with low attenuation (high quality factor, Q)

HGMPE = [CampbellBozorgnia2014HighQJapanSite]

VGMPE = [BozorgniaCampbell2016]

class openquake.hazardlib.gsim.bozorgnia_campbell_2016_vh.BozorgniaCampbell2016HighQVH(**kwargs)

Bases: BozorgniaCampbell2016VH

Implements the GMPE by Bozorgnia & Campbell (2016) vertical-to-horizontal ratio for ground motions from the PEER NGA-West2 Project

Applies regional corrections in path scaling term for regions with low attenuation (high quality factor, Q) (e.g. eastern China)

HGMPE = [CampbellBozorgnia2014HighQ]

VGMPE = [BozorgniaCampbell2016]

class openquake.hazardlib.gsim.bozorgnia_campbell_2016_vh.BozorgniaCampbell2016LowQJapanSiteVH(**kwargs)

Bases: BozorgniaCampbell2016AveQJapanSiteVH

Implements the GMPE by Bozorgnia & Campbell (2016) vertical-to-horizontal ratio for ground motions from the PEER NGA-West2 Project

Incorporates the difference in linear Vs30 scaling for sites in Japan by activating the flag variable in shallow site reponse scaling

Applies regional corrections in path scaling term for regions with high attenuation (low quality factor, Q)

HGMPE = [CampbellBozorgnia2014LowQJapanSite]

VGMPE = [BozorgniaCampbell2016]

class openquake.hazardlib.gsim.bozorgnia_campbell_2016_vh.BozorgniaCampbell2016LowQVH(**kwargs)

Bases: BozorgniaCampbell2016VH

Implements the GMPE by Bozorgnia & Campbell (2016) vertical-to-horizontal ratio for ground motions from the PEER NGA-West2 Project

Applies regional corrections in path scaling term for regions with high attenuation (low quality factor, Q) (e.g. Japan and Italy)

HGMPE = [CampbellBozorgnia2014LowQ]

VGMPE = [BozorgniaCampbell2016]

class openquake.hazardlib.gsim.bozorgnia_campbell_2016_vh.BozorgniaCampbell2016VH(**kwargs)

Bases: GMPE

Implements the GMPE by Bozorgnia & Campbell (2016) vertical-to-horizontal ratio for ground motions from the PEER NGA-West2 Project

This V/H model is combined from VGMPE by Bozorgnia and Campbell (2016) as the vertical model, and HGMPE by Campbell and Bozorgnia (2014) as the horizontal model.

Reference:

Bozorgnia, Y. & Campbell, K. (2016). Ground Motion Model for the Vertical-to-Horizontal (V/H) Ratios of PGA, PGV, and Response Spectra Earthquake Spectra, 32(2), 951-978.

Implements the global model that uses datasets from California, Taiwan, the Middle East, and other similar active tectonic regions to represent a typical or average Q region.

Applies the average attenuation case (Dc20=0)

COEFFS = <CoeffsTable rhow1 rhow2 rhob1 rhob2>

Table of regression coefficients obtained from supplementary material published together with the EQS paper

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical-to-Horizontal Ratio'

Supported intensity measure component is the VERTICAL_TO_HORIZONTAL_RATIO

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total; see the section for “Aleatory Variability Model”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

HGMPE = [CampbellBozorgnia2014]

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

Required distance measures are taken from the V and H models

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'hypo_depth', 'mag', 'rake', 'width', 'ztor'})

Required rupture parameters are taken from the V and H models

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z2pt5'})

Required site parameters are taken from the V and H models

VGMPE = [BozorgniaCampbell2016]

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

bradley_2013

Module exports Bradley2013, Bradley2013Volc, Bradley2013ChchCBD, Bradley2013ChchWest, Bradley2013ChchEast, Bradley2013ChchNorth, Bradley2013ChchCBDAdditionalSigma, Bradley2013ChchWestAdditionalSigma, Bradley2013ChchEastAdditionalSigma, Bradley2013ChchNorthAdditionalSigma. Bradley2013ChchMaps. Bradley2013ChchMapsAdditionalSigma.

class openquake.hazardlib.gsim.bradley_2013.Bradley2013(**kwargs)

Bases: GMPE

Implements GMPE developed by Brendan Bradley for Active Shallow Crust Earthquakes for New Zealand, and published as “A New Zealand-Specific Pseudospectral Acceleration Ground-Motion Prediction Equation for Active Shallow Crustal Earthquakes Based on Foreign Models” (2013, Bulletin of the Seismological Society of America, Volume 103, No. 3, pages 1801-1822).

This model is modified from Chiou and Youngs, 2008 and has been adapted for New Zealand conditions. Specifically, the modifications are related to: 1) small magnitude scaling; 2) scaling of short period ground motion from normal faulting events in volcanic crust; 3) scaling of ground motions on very hard rock sites; 4) anelastic attenuation in the New Zealand crust; 5) consideration of the increates anelastic attenuation in the Taupo Volcanic Zone (not implemented in this model, use Bradley2013Volc)

COEFFS = <CoeffsTable c2 c3 c4 c4a crb chm cg3 c1 c1a c1b cn cm c5 c6 c7 c7a c8 c9 c9a c10 cg1 cg2 ctvz phi1 phi2 phi3 phi4 phi5 phi6 phi7 phi8 tau1 tau2 sig1 sig2 sig3 sig4>

Coefficient tables are constructed from values in tables 1, 2 and 3 (pages 197, 198 and 199) in Chiou & Youngs,2008. Only Coefficients c1, c1b, c3, cm, c8, cg1, cg2, ctvz are modified by Bradley 2013. Spectral acceleration is defined for damping of 5%, see page 208 (CY08).

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components attr:~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN, see abstract page 1801.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration. Note that PGV is the Chiou & Youngs PGV and has not been modified for New Zealand.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see chapter “Variance model”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see page 1801

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

Required distance measures are RRup, Rjb and Rx (all are in eq. 13a).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'ztor'})

Required rupture parameters are magnitude, rake (eq. 13a and 13b), dip (eq. 13a) and ztor (eq. 13a).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'vs30measured', 'z1pt0'})

Required site parameters are Vs30 (eq. 13b), Vs30 measured flag (eq. 20) and Z1.0 (eq. 13b).

additional_sigma = 0.0

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.bradley_2013.Bradley2013AdditionalSigma(**kwargs)

Bases: Bradley2013LHC

Extend Bradley2013LHC to implement the ‘additional epistemic uncertainty’ version of the model in: Gerstenberger, M., McVerry, G., Rhoades, D., Stirling, M. 2014. “Seismic hazard modelling for the recovery of Christchurch”, Earthquake Spectra, 30(1), 17-29.

additional_sigma = 0.35

class openquake.hazardlib.gsim.bradley_2013.Bradley2013LHC(**kwargs)

Bases: Bradley2013

Extend Bradley2013 to provide the model in terms of the larger of two as-recorded horizontal components. This definition is required by New Zealand building design standards.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Greater of two horizontal'

Supported intensity measure component is geometric mean of two horizontal components attr:~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN, see abstract page 1801.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

This implementation is non-verified because this version of the model has not been published, nor is independent code available.

class openquake.hazardlib.gsim.bradley_2013.Bradley2013Volc(**kwargs)

Bases: Bradley2013

Extend Bradley2013 for earthquakes with paths across the Taupo Volcanic Zone (rtvz) that have increased anelastic attenuation.

Implements GMPE developed by Brendan Bradley for Active Shallow Crust Earthquakes for New Zealand, and published as “A New Zealand-Specific Pseudospectral Acceleration Ground-Motion Prediction Equation for Active Shallow Crustal Earthquakes Based on Foreign Models” (2013, Bulletin of the Seismological Society of America, Volume 103, No. 3, pages 1801-1822).

This model is modified from Chiou and Youngs, 2008 and has been adapted for New Zealand conditions. Specifically, the modifications are related to: 1) small magnitude scaling; 2) scaling of short period ground motion from normal faulting events in volcanic crust; 3) scaling of ground motions on very hard rock sites; 4) anelastic attenuation in the New Zealand crust; 5) consideration of the increates anelastic attenuation in the Taupo Volcanic Zone (rtvz is equal to rrup)

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is active shallow crust, see page 1801

class openquake.hazardlib.gsim.bradley_2013.Bradley2013VolcLHC(**kwargs)

Bases: Bradley2013LHC

Extend Bradley2013LHC for earthquakes with paths across the Taupo Volcanic Zone (rtvz) that have increased anelastic attenuation.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is active shallow crust, see page 1801

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchCBD(**kwargs)

Bases: Bradley2013LHC

Implements GMPE developed by Brendon Bradley for Christchurch subregions, and published as: Bradley, B. (2013). “Systematic ground motion observations in the Canterbury earthquakes and region-specific nonergodic empirical ground motion modelling”” (2013), University of Canterbury Research Report 2013-03, Department of Civil Engineering, University of Canterbury, Christchurch, New Zealand.”

This model was also published as: Bradley, B. (2015). Systematic Ground Motion Observations in the Canterbury Earthquakes And Region-Specific Non-Ergodic Empirical Ground Motion Modeling. Earthquake Spectra: August 2015, Vol. 31, No. 3, pp. 1735-1761. but this implementation has been developed from the information in the 2013 report.

The original code by the author could not be made available at the time of development of this code. For this reason, this implementation is untested and marked as non_verified.

It appears from the model documentation that the dL2L and dS2S terms are relative to a baseline Vs30 value of 250 m/s and a baseline Z1 value of 330 m, although this is unconfirmed.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

This implementation is non-verified because this version of the model has not been published, nor is independent code available.

region = 'CBD'

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchCBDAdditionalSigma(**kwargs)

Bases: Bradley2013bChchCBD

Extend Bradley2013ChchCBD to implement the ‘additional epistemic uncertainty’ version of the model in: Gerstenberger, M., McVerry, G., Rhoades, D., Stirling, M. 2014. “Seismic hazard modelling for the recovery of Christchurch”, Earthquake Spectra, 30(1), 17-29.

additional_sigma = 0.35

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchEast(**kwargs)

Bases: Bradley2013bChchCBD

Extend Bradley2013bChchCBD to implement the ‘eastern suburbs’ dS2S model.

region = 'East'

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchEastAdditionalSigma(**kwargs)

Bases: Bradley2013bChchEast

Extend Bradley2013ChchEast to implement the ‘additional epistemic uncertainty’ version of the model in: Gerstenberger, M., McVerry, G., Rhoades, D., Stirling, M. 2014. “Seismic hazard modelling for the recovery of Christchurch”, Earthquake Spectra, 30(1), 17-29.

additional_sigma = 0.35

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchMaps(**kwargs)

Bases: Bradley2013bChchCBD

Implements GMPE developed by Brendon Bradley for Christchurch subregions, and published as “”Systematic ground motion observations in the Canterbury earthquakes and region-specific nonergodic empirical ground motion modelling”” (2013), University of Canterbury Research Report 2013-03, Department of Civil Engineering, University of Canterbury, Christchurch, New Zealand.

The original code by the author was not made available at the time of development of this code. For this reason, this implementation is untested.

It appears from the model documentation that the CBD dL2L and dS2S are relative to a baseline Vs30 value of 250 m/s and a baseline Z1 value of 330 m, although this is unconfirmed.

Only the CBD subregion dS2S term is implemented here, because of difficulties defining the boundaries of other subregions. Full details behind the choices here are detailed in: Van Houtte and Abbott (2019), “Implementation of the GNS Canterbury Seismic Hazard Model in the OpenQuake Engine”, Lower Hutt (NZ): GNS Science. 38 p. (GNS Science report; 2019/11). doi:10.21420/1AEM-PZ85.

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30', 'vs30measured', 'z1pt0'})

Required site parameters are Vs30 (eq. 13b), Vs30 measured flag (eq. 20) and Z1.0 (eq. 13b), longitude and latitude.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

This implementation is non-verified because the author of the model does not have code that can be made available.

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchMapsAdditionalSigma(**kwargs)

Bases: Bradley2013bChchMaps

Extend Bradley2013ChchNorth to implement the ‘additional epistemic uncertainty’ version of the model in: Gerstenberger, M., McVerry, G., Rhoades, D., Stirling, M. 2014. “Seismic hazard modelling for the recovery of Christchurch”, Earthquake Spectra, 30(1), 17-29.

additional_sigma = 0.35

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchNorth(**kwargs)

Bases: Bradley2013bChchCBD

Extend Bradley2013bChchCBD to implement the ‘northern suburbs’ dS2S model.

region = 'North'

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchNorthAdditionalSigma(**kwargs)

Bases: Bradley2013bChchNorth

Extend Bradley2013ChchNorth to implement the ‘additional epistemic uncertainty’ version of the model in: Gerstenberger, M., McVerry, G., Rhoades, D., Stirling, M. 2014. “Seismic hazard modelling for the recovery of Christchurch”, Earthquake Spectra, 30(1), 17-29.

additional_sigma = 0.35

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchWest(**kwargs)

Bases: Bradley2013bChchCBD

Extend Bradley2013bChchCBD to implement the ‘extended western suburbs’ dS2S model.

region = 'West'

class openquake.hazardlib.gsim.bradley_2013.Bradley2013bChchWestAdditionalSigma(**kwargs)

Bases: Bradley2013bChchWest

Extend Bradley2013ChchWest to implement the ‘additional epistemic uncertainty’ version of the model in: Gerstenberger, M., McVerry, G., Rhoades, D., Stirling, M. 2014. “Seismic hazard modelling for the recovery of Christchurch”, Earthquake Spectra, 30(1), 17-29.

additional_sigma = 0.35

openquake.hazardlib.gsim.bradley_2013.convert_to_LHC(imt)

Converts from GMRotI50 to Larger of two horizontal components using global equation of: Boore, D and Kishida, T (2016). Relations between some horizontal- component ground-motion intensity measures used in practice. Bulletin of the Seismological Society of America, 107(1), 334-343. doi:10.1785/0120160250 No standard deviation modification required.

openquake.hazardlib.gsim.bradley_2013.set_adjusted_stddevs(clsname, additional_sigma, ctx, C, ln_y_ref, exp1, exp2, in_cshm, in_cbd, imt_per, sig, tau, phi)

openquake.hazardlib.gsim.bradley_2013.set_stddevs(additional_sigma, ctx, C, ln_y_ref, exp1, exp2, sig, tau, phi)

campbell_1997

Module exports Campbell1997

class openquake.hazardlib.gsim.campbell_1997.Campbell1997(**kwargs)

Bases: GMPE

Implements GMPE (PGA) by Campbell, Kenneth W. “Empirical near-source attenuation relationships for horizontal and vertical components of peak ground acceleration, peak ground velocity, and pseudo-absolute acceleration response spectra.” Seismological research letters 68.1 (1997): 154-179.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>})

Supported intensity measure types are PGA, PGV, PSA, but we only define PGA because this is the only IMT used by an implemented model (09/18)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total, see equation 4, pg 164

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported TRT active…we specify active_shallow_crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture. In the publication, Rseis is used. We assume Rrup=Rseis, justified by our calculations matching the verification tables

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and top of rupture depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Requires vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.campbell_1997.get_Shr_term(vs30)

Returns site term for hard rock (pg 157)

openquake.hazardlib.gsim.campbell_1997.get_Ssr_term(vs30)

Returns site term for soft rock (pg 157)

openquake.hazardlib.gsim.campbell_1997.get_fault_term(rake)

Returns coefficient for faulting style (pg 156)

campbell_2003

Module exports Campbell2003, Campbell2003SHARE, Campbell2003MblgAB1987NSHMP2008, Campbell2003MblgJ1996NSHMP2008, Campbell2003MwNSHMP2008

class openquake.hazardlib.gsim.campbell_2003.Campbell2003(**kwargs)

Bases: GMPE

Implements GMPE developed by K.W Campbell and published as “Prediction of Strong Ground Motion Using the Hybrid Empirical Method and Its Use in the Development of Ground Motion (Attenuation) Relations in Eastern North America” (Bulletting of the Seismological Society of America, Volume 93, Number 3, pages 1012-1033, 2003). The class implements also the corrections given in the erratum (2004).

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13>

Coefficient tables are constructed from the electronic suplements of the original paper.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 6, page 1022 (PGA is assumed to be equal to SA at 0.01 s)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total, see equation 35, page 1021

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust given that the equations have been derived for Eastern North America.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude, see equation 30 page 1021.

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters are needed

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.campbell_2003.Campbell2003MblgAB1987NSHMP2008(**kwargs)

Bases: Campbell2003

Implement GMPE developed by Ken Campbell and described in “Development of semi-empirical attenuation relationships for the CEUS”, U.S. Geological Survey, Award 01HQGR0011, final report.

Document available at: http://earthquake.usgs.gov/research/external/reports/01HQGR0011.pdf

This GMPE is used by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 central and eastern US hazard model.

This class replicates the algorithm as implemented in subroutine getCampCEUS in the hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

The class assumes rupture magnitude to be in Mblg scale (given that MFDs for central and eastern US are given in this scale). Mblg is converted to Mw using Atkinson and Boore 1987 conversion equation

Coefficients are given for the B/C (firm rock) conditions.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13>

Coefficient tables extracted from subroutine getCampCEUS in hazgridXnga2.f

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'Mblg87'

class openquake.hazardlib.gsim.campbell_2003.Campbell2003MblgJ1996NSHMP2008(**kwargs)

Bases: Campbell2003MblgAB1987NSHMP2008

Extend Campbell2003MblgAB1987NSHMP2008 but uses Johnston 1996 equation for converting Mblg to Mw

kind = 'Mblg96'

class openquake.hazardlib.gsim.campbell_2003.Campbell2003MwNSHMP2008(**kwargs)

Bases: Campbell2003MblgAB1987NSHMP2008

Extend Campbell2003MblgAB1987NSHMP2008 but assumes magnitude to be in Mw scale, so no converion is applied.

kind = 'Mw'

class openquake.hazardlib.gsim.campbell_2003.Campbell2003SHARE(**kwargs)

Bases: Campbell2003

Extends Campbell2003 and introduces adjustments for style of faulting and default rock soil conditions as needed by the SHARE (http://www.share-eu.org/) project.

COEFFS_FS_ROCK = <CoeffsTable Frss AFrock>

Coefficients for faulting style and rock adjustment

CONSTS_FS = {'Fnss': 0.95, 'pN': 0.01, 'pR': 0.81}

Constants for faulting style adjustment

DEFINED_FOR_REFERENCE_VELOCITY = 800.0

Shear-wave velocity for reference soil conditions in [m s-1]

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

campbell_bozorgnia_2003

Module exports CampbellBozorgnia2003NSHMP2007.

class openquake.hazardlib.gsim.campbell_bozorgnia_2003.CampbellBozorgnia2003NSHMP2007(**kwargs)

Bases: GMPE

Implements GMPE developed by Kenneth W. Campbell and Yousef Bozorgnia and published as “Updated Near-Source Ground-Motion (Attenuation) Relations for the Horizontal and Vertical Components of Peak Ground Acceleration and Acceleration Responce Spectra”, Bulletin of the Seismological Society of America, Vol. 93, No. 1, pp. 314-331, 2003.

The class implement the equation as modified by the United States Geological Survey - National Seismic Hazard Mapping Project (USGS-NSHMP) for the 2007 Alaska model (http://earthquake.usgs.gov/hazards/products/ak/2007/).

The class replicates the equation as coded in subroutine getCamp2000 in hazFXv7.f available from http://earthquake.usgs.gov/hazards/products/ak/2007/software/.

The equation compute mean value for the ‘firm rock’ conditon.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 c15 c16>

Coefficient table (table 4, page 321. Coefficients for horizontal component and for corrected PGA)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components (see paragraph ‘Strong-Motion Database’, page 316)

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are PGA and SA (see Abstract)

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

No ctx parameters are required. Mean value is computed for ‘firm rock’.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is Total (see equations 11, 12 pp. 319 320)

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ (see Abstract)

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup'})

Required distance measure are RRup and Rjb (eq. 1 and following, page 319).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake'})

Required rupture parameters are magnitude, rake and dip (eq. 1 and following, page 319).

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

campbell_bozorgnia_2008

Module exports CampbellBozorgnia2008, and :class:’CampbellBozorgnia2008Arbitrary’

class openquake.hazardlib.gsim.campbell_bozorgnia_2008.CampbellBozorgnia2008(**kwargs)

Bases: GMPE

Implements GMPE developed by Kenneth W. Campbell and Yousef Bozorgnia, published as “NGA Ground Motion Model for the Geometric Mean Horizontal Component of PGA, PGV, PGD and 5 % Damped Linear Elastic Response Spectra for Periods Ranging from 0.01 to 10s” (2008, Earthquake Spectra, Volume 24, Number 1, pages 139 - 171). This class implements the model for the Geometric Mean of the elastic spectra. Included in the coefficient set are the coefficients for the Campbell & Bozorgnia (2010) GMPE for predicting Cumulative Absolute Velocity (CAV), published as “A Ground Motion Prediction Equation for the Horizontal Component of Cumulative Absolute Velocity (CSV) Based on the PEER-NGA Strong Motion Database” (2010, Earthquake Spectra, Volume 26, Number 3, 635 - 650).

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 k1 k2 k3 c n s_lny t_lny s_lnAF c_lny rho>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (GMRotI50)'

Supported intensity measure component is orientation-independent average horizontal GMRotI50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGV>, <function CAV>, <function SA>, <function PGA>, <function PGD>})

Supported intensity measure types are spectral acceleration, peak ground velocity, peak ground displacement and peak ground acceleration Additional model for cumulative absolute velocity defined in Campbell & Bozorgnia (2010)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see section “Aleatory Uncertainty Model”, page 147.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup'})

Required distance measures are Rrup and Rjb.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'ztor'})

Required rupture parameters are magnitude, rake, dip, ztor

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z2pt5'})

Required site parameters are Vs30, Vs30 type (measured or inferred), and depth (km) to the 2.5 km/s shear wave velocity layer (z2pt5)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.campbell_bozorgnia_2008.CampbellBozorgnia2008Arbitrary(**kwargs)

Bases: CampbellBozorgnia2008

Implements the Campbell & Bozorgnia (2008) GMPE as modified to represent the arbitrary horizontal component of ground motion, instead of the Rotationally Independent Geometric Mean (GMRotI) originally defined in the paper.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is arbitrary horizontal HORIZONTAL,

kind = 'arbitrary'

campbell_bozorgnia_2014

Module exports CampbellBozorgnia2014

CampbellBozorgnia2014HighQ CampbellBozorgnia2014LowQ CampbellBozorgnia2014JapanSite CampbellBozorgnia2014HighQJapanSite CampbellBozorgnia2014LowQJapanSite

class openquake.hazardlib.gsim.campbell_bozorgnia_2014.CampbellBozorgnia2014(**kwargs)

Bases: GMPE

Implements NGA-West 2 GMPE developed by Kenneth W. Campbell and Yousef Bozorgnia, published as “NGA-West2 Ground Motion Model for the Average Horizontal Components of PGA, PGV, and 5 % Damped Linear Acceleration Response Spectra” (2014, Earthquake Spectra, Volume 30, Number 3, pages 1087 - 1115).

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 c9 c10 c11 c12 c13 c14 c15 c16 c17 c18 c19 c20 Dc20 a2 h1 h2 h3 h5 h6 k1 k2 k3 phi1 phi2 tau1 tau2 phiC rholny>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent average horizontal GMRotI50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see section “Aleatory Variability Model”, page 1094.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

Required distance measures are Rrup, Rjb and Rx

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'hypo_depth', 'mag', 'rake', 'width', 'ztor'})

Required rupture parameters are magnitude, rake, dip, ztor, rupture width and hypocentral depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z2pt5'})

Required site parameters are Vs30, Vs30 type (measured or inferred), and depth (km) to the 2.5 km/s shear wave velocity layer (z2pt5)

SJ = 0

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.campbell_bozorgnia_2014.CampbellBozorgnia2014HighQ(**kwargs)

Bases: CampbellBozorgnia2014

Implements the Campbell & Bozorgnia (2014) NGA-West2 GMPE for regions with low attenuation (high quality factor, Q) (i.e. China, Turkey)

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 c9 c10 c11 c12 c13 c14 c15 c16 c17 c18 c19 c20 Dc20 a2 h1 h2 h3 h5 h6 k1 k2 k3 phi1 phi2 tau1 tau2 phiC rholny>

class openquake.hazardlib.gsim.campbell_bozorgnia_2014.CampbellBozorgnia2014HighQJapanSite(**kwargs)

Bases: CampbellBozorgnia2014HighQ

Implements the Campbell & Bozorgnia (2014) NGA-West2 GMPE, for the low attenuation (high quality factor) coefficients, for the case in which the “Japan” shallow site response term is activited

SJ = 1

class openquake.hazardlib.gsim.campbell_bozorgnia_2014.CampbellBozorgnia2014JapanSite(**kwargs)

Bases: CampbellBozorgnia2014

Implements the Campbell & Bozorgnia (2014) NGA-West2 GMPE for the case in which the “Japan” shallow site response term is activited

SJ = 1

class openquake.hazardlib.gsim.campbell_bozorgnia_2014.CampbellBozorgnia2014LowQ(**kwargs)

Bases: CampbellBozorgnia2014

Implements the Campbell & Bozorgnia (2014) NGA-West2 GMPE for regions with high attenuation (low quality factor, Q) (i.e. Japan, Italy)

COEFFS = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 c9 c10 c11 c12 c13 c14 c15 c16 c17 c18 c19 c20 Dc20 a2 h1 h2 h3 h5 h6 k1 k2 k3 phi1 phi2 tau1 tau2 phiC rholny>

class openquake.hazardlib.gsim.campbell_bozorgnia_2014.CampbellBozorgnia2014LowQJapanSite(**kwargs)

Bases: CampbellBozorgnia2014LowQ

Implements the Campbell & Bozorgnia (2014) NGA-West2 GMPE, for the high attenuation (low quality factor) coefficients, for the case in which the “Japan” shallow site response term is activited

SJ = 1

openquake.hazardlib.gsim.campbell_bozorgnia_2014.get_mean_values(SJ, C, ctx, a1100=None)

Returns the mean values for a specific IMT

cauzzi_2014

Module exports CauzziEtAl2014,

CauzziEtAl2014NoSOF, CauzziEtAl2014FixedVs30, CauzziEtAl2014FixedVs30NoSOF, CauzziEtAl2014Eurocode8, CauzziEtAl2014Eurocode8NoSOF, CauzziEtAl2014Eurocode8scaled

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014(**kwargs)

Bases: GMPE

Implements GMPE developed by Carlo Cauzzi et al (2014) and published as C.Cauzzi, E. Faccioli, M. Vanini and A. Bianchini (2014) “Updated predictive equations for broadband (0.0 - 10.0 s) horizontal response spectra and peak ground motions, based on a global dataset of digital acceleration records”, Bulletin of Earthquake Engineering, In Press

Spectral acceleration (SA) values are obtained from displacement response spectrum (DSR) values (as provided by the original equations) using the following formula

SA = DSR * (2 * π / T) ** 2

COEFFS = <CoeffsTable c1 m1 m2 r1 r2 r3 sB sC sD bV bV800 VA fN fR fSS f t s tM sM>

Coefficient table constructed from the electronic suplements of the original paper.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground acceleration and peak ground velocity. The original paper provides coefficients for PGA and PGV, while SA is obtained from displacement response spectrum values. Coefficients for PGA are taken from the SA (0.01 s) spectral acceleration, as indicated in Page 11 (at the time of writing) of Cauzzi et al. (2014)

DEFINED_FOR_REFERENCE_VELOCITY = 800.0

The reference rock conditions. The definition of this parameter is unclear in the paper so we assume a value of 800 m/s

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust,

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup,

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

sof = True

style of faulting term

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014Eurocode8(**kwargs)

Bases: CauzziEtAl2014

Implemements the Cauzzi et al. (2014) GMPE for the case in which the Eurocode 8 site classification is preferred

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014Eurocode8NoSOF(**kwargs)

Bases: CauzziEtAl2014NoSOF

Implemements the Cauzzi et al. (2014) GMPE for the case in which the Eurocode 8 site classification is preferred and style of faulting is not specified.

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014Eurocode8scaled(**kwargs)

Bases: CauzziEtAl2014Eurocode8

Implements GMPE developed by Carlo Cauzzi et al (2014) and published as C.Cauzzi, E. Faccioli, M. Vanini and A. Bianchini (2014) “Updated predictive equations for broadband (0.0 - 10.0 s) horizontal response spectra and peak ground motions, based on a global dataset of digital acceleration records”, Bulletin of Earthquake Engineering, In Press

Spectral acceleration (SA) values are obtained from displacement response spectrum (DSR) values (as provided by the original equations) using the following formula

SA = DSR * (2 * π / T) ** 2

COEFFS = <CoeffsTable c1 m1 m2 r1 r2 r3 sB sC sD bV bV800 VA fN fR fSS f t s tM sM>

Coefficient table constructed from the electronic suplements of the original paper.

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014FixedVs30(**kwargs)

Bases: CauzziEtAl2014

Implements the Cauzzi et al (2014) model for the case in which the reference Vs30 in the site amplification term is fixed at 800 m/s

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014FixedVs30NoSOF(**kwargs)

Bases: CauzziEtAl2014NoSOF

Implements the Cauzzi et al (2014) model for the case in which the reference Vs30 in the site amplification term is fixed at 800 m/s

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014NoSOF(**kwargs)

Bases: CauzziEtAl2014

Returns the Cauzzi et al (GMPE) for the case when no style-of-faulting is input. This modifies both the expected ground motion as well as the inter-event (and thus total) standard deviations.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

sof = False

style of faulting term

class openquake.hazardlib.gsim.cauzzi_2014.CauzziEtAl2014RhypoGermany(**kwargs)

Bases: CauzziEtAl2014

Implements the Cauzzi et al. (2015) GMPE applying the rhypo to rrup adjustment factor adopted for Germany

REQUIRES_DISTANCES = frozenset({'rhypo', 'rrup'})

Required distance measure is Rrup,

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake', 'width'})

Required rupture parameters are magnitude and rake

openquake.hazardlib.gsim.cauzzi_2014.rhypo_to_rrup(rhypo, mag)

Converts hypocentral distance to an equivalent rupture distance dependent on the magnitude

cauzzi_faccioli_2008

Module exports CauzziFaccioli2008.

class openquake.hazardlib.gsim.cauzzi_faccioli_2008.CauzziFaccioli2008(**kwargs)

Bases: GMPE

Implements GMPE developed by Carlo Cauzzi and Ezio Faccioli and published as “Broadband (0.05 to 20s) prediction of displacement response spectra based on worldwide digital records” (Journal of Seismology, 2008, volume 12, pages 453-475). This class implements the prediction equations for horizontal peak ground acceleration, peak ground velocity and 5%-damped spectral acceleration (equation 2, page 462, plus faulting style term as given in equation 5, page 465). Coefficients for PGV are not present in the original paper but were developed for the SHARE (http://www.share-eu.org/) project. Hypocentral distances are clipped at 15 km (as for Faccioli’s personal communication). Spectral acceleration (SA) values are obtained from displacement response spectrum (DSR) values (as provided by the original equations) using the following formula

SA = DSR * (2 * π / T) ** 2

COEFFS = <CoeffsTable a1 a2 aN aR aS a3 aB aC aD sigma>

Coefficient table constructed from the electronic suplements of the original paper.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN, see paragraph ‘On functional forms’, page 462.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground acceleration and peak ground velocity. The original paper provides coefficients for PGA and PGV, while SA is obtained from displacement response spectrum values.

DEFINED_FOR_REFERENCE_VELOCITY = 1000.0

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total, see paragraph ‘On functional forms’, page 462.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see end of ‘Introduction’, page 454.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo, see paragraph ‘Distance’, page 456.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake, see paragraph ‘On functional forms’, page 463

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock and deep soils), see paragraph ‘On functional forms’, page 463.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = '2008'

class openquake.hazardlib.gsim.cauzzi_faccioli_2008.FaccioliEtAl2010(**kwargs)

Bases: CauzziFaccioli2008

Implements GMPE developed by Ezio Faccioli, Aldo Bianchini and Manuela Villani and published as “New ground motion prediction equations for T>1 s and their influence on seismic hazard assessment” (Proceedings of the University of Tokyo Symposium on Long-Period Ground Motion and Urban Disaster Mitigation, March 17-18, 2010). This class implements the prediction equations for horizontal peak ground acceleration, and 5%-damped spectral acceleration - equation 2 page 2, plus site and faulting style terms (equations 3 and 5, page 3). Spectral acceleration (SA) values are obtained from displacement response spectrum (DSR) values (as provided by the original equations) using the following formula:

SA = DSR * (2 * π / T) ** 2

This class extends :class: ~openquake.hazardlib.gsim.cauzzi_faccioli_2008.CauzziFaccioli2008 because the functional form is almost identical - the only difference is in the third term which rather then using hypocentral distance, uses closest distance to the rupture and additionaly considers a magnitude dependence.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 aB aC aD aN aR aS sigma>

Coefficient table as from table 1 page 7

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 1, page 7.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rrup, equation 2, page 2.

kind = '2010'

cauzzi_faccioli_2008_swiss

Module exports CauzziFaccioli2008SWISS01

CauzziFaccioli2008SWISS04 CauzziFaccioli2008SWISS08.

class openquake.hazardlib.gsim.cauzzi_faccioli_2008_swiss.CauzziFaccioli2008SWISS01(**kwargs)

Bases: CauzziFaccioli2008

This class extends openquake.hazardlib.gsim.cauzzi_faccioli_2008.CauzziFaccioli2008 adjusted to be used for the Swiss Hazard Model [2014]. This GMPE is valid for a fixed value of vs30=700m/s

#. kappa value K-adjustments corresponding to model 01 - as prepared by Ben Edwards K-value for PGA were not provided but infered from SA[0.01s] the model considers a fixed value of vs30=700 to match the reference vs30=1100m/s

1. small-magnitude correction

2. single station sigma - inter-event magnitude/distance adjustment

Disclaimer: these equations are modified to be used for the Swiss Seismic Hazard Model [2014].

The use of these models is the soly responsability of the hazard modeler.

Model implemented by laurentiu.danciu@gmail.com

COEFFS = <CoeffsTable a1 a2 aN aR aS a3 aB aC aD phi tau sigma>

Coefficient table

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground acceleration and peak ground velocity. The original paper provides coefficients for PGA and PGV, while SA is obtained from displacement response spectrum values.

DEFINED_FOR_REFERENCE_VELOCITY = 1105.0

Vs30 value representing typical rock conditions in Switzerland. confirmed by the Swiss GMPE group

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is total, inter-event and intra-event

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.cauzzi_faccioli_2008_swiss.CauzziFaccioli2008SWISS04(**kwargs)

Bases: CauzziFaccioli2008SWISS01

This class extends openquake.hazardlib.gsim.cauzzi_faccioli_2008.CauzziFaccioli2008, following same strategy as for openquake.hazardlib.gsim.cauzzi_faccioli_2008_swiss.CauzziFaccioli2008SWISS01

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

class openquake.hazardlib.gsim.cauzzi_faccioli_2008_swiss.CauzziFaccioli2008SWISS08(**kwargs)

Bases: CauzziFaccioli2008SWISS01

This class extends openquake.hazardlib.gsim.cauzzi_faccioli_2008.CauzziFaccioli2008, following same strategy as for openquake.hazardlib.gsim.cauzzi_faccioli_2008_swiss.CauzziFaccioli2008SWISS01

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

cauzzi_faccioli_2008_swiss_coeffs

chao_2020

Module exports ChaoEtAl2020SInter

ChaoEtAl2020SSlab ChaoEtAl2020Asc

class openquake.hazardlib.gsim.chao_2020.ChaoEtAl2020Asc(**kwargs)

Bases: ChaoEtAl2020SInter

Chao et al. (2020) for Crustal.

CONST_FAULT = {'C4': 0, 'href': 0}

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

MC = 7.6

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake', 'ztor'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

SBCR = '_cr'

SUFFIX = '_cr'

class openquake.hazardlib.gsim.chao_2020.ChaoEtAl2020SInter(**kwargs)

Bases: GMPE

Chao et al. (2020) for Subduction Interface.

COEFFS = <CoeffsTable c1 c2 c3 c4_if c4_is c6 c7 c8_cr c8_sb c10 c11_cr c11_sb c13 c14_cr c14_if c14_is c17_cr c17_sb c19_cr c19_sb c21_cr c21_sb c23 c24 c25 c26 c27 c28 c29_if c29_is tau1_cr tau2_cr tau1_sb tau2_sb phiss1_cr phiss2_cr phiss1_sb phiss2_sb phis2s>

CONST_FAULT = {'C4': 0.3, 'href': 0}

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function SA>, <function PGA>, <function PGV>, <function PGD>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_REFERENCE_VELOCITY = 1180

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

MC = 7.1

REQUIRES_ATTRIBUTES = frozenset({'aftershocks', 'geology', 'manila'})

Set of required GSIM attributes

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'vs30measured', 'z1pt0'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

SBCR = '_sb'

SUFFIX = '_if'

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.chao_2020.ChaoEtAl2020SSlab(**kwargs)

Bases: ChaoEtAl2020SInter

Chao et al. (2020) for Subduction Slab.

CONST_FAULT = {'C4': 0.2, 'href': 35}

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

SUFFIX = '_is'

openquake.hazardlib.gsim.chao_2020.get_stddevs(f, C, mag)

Standard deviation. tau: between event stddev ln(g) phis2s: between site stddev in ln(g) phiss: single station stddev in ln(g)

chiou_youngs_2008

Module exports ChiouYoungs2008.

class openquake.hazardlib.gsim.chiou_youngs_2008.ChiouYoungs2008(**kwargs)

Bases: GMPE

Implements GMPE developed by Brian S.-J. Chiou and Robert R. Youngs and published as “An NGA Model for the Average Horizontal Component of Peak Ground Motion and Response Spectra” (2008, Earthquake Spectra, Volume 24, No. 1, pages 173-215).

COEFFS = <CoeffsTable c2 c3 c4 c4a crb chm cg3 c1 c1a c1b cn cm c5 c6 c7 c7a c9 c9a c10 cg1 cg2 phi1 phi2 phi3 phi4 phi5 phi6 phi7 phi8 tau1 tau2 sig1 sig2 sig3 sig4>

Coefficient tables are constructed from values in tables 1, 2 and 3 (pages 197, 198 and 199). Spectral acceleration is defined for damping of 5%, see page 208.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (GMRotI50)'

Supported intensity measure component is orientation-independent measure GMRotI50, see page 174.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see tables at pages 198 and 199.

DEFINED_FOR_REFERENCE_VELOCITY = 1130.0

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see chapter “Variance model”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see page 174.

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

Required distance measures are RRup, Rjb and Rx (all are in eq. 13a).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'ztor'})

Required rupture parameters are magnitude, rake (eq. 13a and 13b), dip (eq. 13a) and ztor (eq. 13a).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'vs30measured', 'z1pt0'})

Required site parameters are Vs30 (eq. 13b), Vs30 measured flag (eq. 20) and Z1.0 (eq. 13b).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

chiou_youngs_2008_swiss

Module exports ChiouYoungs2008SWISS01, ChiouYoungs2008SWISS06, ChiouYoungs2008SWISS04.

class openquake.hazardlib.gsim.chiou_youngs_2008_swiss.ChiouYoungs2008SWISS01(**kwargs)

Bases: ChiouYoungs2008

This class extends :class:ChiouYoungs2008, adjusted to be used for the Swiss Hazard Model [2014]. This GMPE is valid for a fixed value of vs30=620m/s

1. kappa value K-adjustments corresponding to model 01 - as prepared by Ben Edwards K-value for PGA were not provided but infered from SA[0.01s] the model considers a fixed value of vs30==620 to match the reference vs30=1100m/s

2. small-magnitude correction

3. single station sigma - inter-event magnitude/distance adjustment

Disclaimer: these equations are modified to be used for the Swiss Seismic Hazard Model [2014]. The use of these models in other models is the soly responsability of the hazard modeler.

Model implemented by laurentiu.danciu@gmail.com

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

DEFINED_FOR_REFERENCE_VELOCITY = 1105.0

Vs30 value representing typical rock conditions in Switzerland. confirmed by the Swiss GMPE group

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is total, inter-event and intra-event

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.chiou_youngs_2008_swiss.ChiouYoungs2008SWISS04(**kwargs)

Bases: ChiouYoungs2008SWISS01

This class extends :class:ChiouYoungs2008,following same strategy as for :class:ChiouYoungs2008SWISS01 to be used for the Swiss Hazard Model [2014].

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

class openquake.hazardlib.gsim.chiou_youngs_2008_swiss.ChiouYoungs2008SWISS06(**kwargs)

Bases: ChiouYoungs2008SWISS01

This class extends :class:ChiouYoungs2008,following same strategy as for :class:ChiouYoungs2008SWISS01 to be used for the Swiss Hazard Model [2014].

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

openquake.hazardlib.gsim.chiou_youngs_2008_swiss.get_nl(C, ln_y_ref, exp1, exp2)

openquake.hazardlib.gsim.chiou_youngs_2008_swiss.get_tau(C, ctx)

chiou_youngs_2008_swiss_coeffs

chiou_youngs_2014

Module exports ChiouYoungs2014

ChiouYoungs2014Japan ChiouYoungs2014Italy ChiouYoungs2014Wenchuan ChiouYoungs2014PEER ChiouYoungs2014NearFaultEffect

class openquake.hazardlib.gsim.chiou_youngs_2014.ChiouYoungs2014(**kwargs)

Bases: GMPE

Implements GMPE developed by Brian S.-J. Chiou and Robert R. Youngs.

Chiou, B. S.-J. and Youngs, R. R. (2014), “Update of the Chiou and Youngs NGA Model for the Average Horizontal Component of Peak Ground Motion and Response Spectra, Earthquake Spectra, 30(3), 1117 - 1153, DOI: 10.1193/072813EQS219M

Parameters:

• sigma_mu_epsilon – Epsilon for the statistical uncertainty term.

• use_hw – Bool which if true turns on the hanging-wall effect.

• alpha_nm – Style-of-faulting correction for normal-faulting as described in Boore et al. (2022) backbone paper. This correction is magnitude independent.

• stress_par_host – Stress parameter for the host-region in bars. Used in Boore et al. (2022) backbone methodology.

• stress_par_target – Stress parameter for the target-region in bars. Used in Boore et al. (2022) backbone methodology.

• delta_gamma_tab – Filename containing path adjustments as described in Boore et al. (2022) backbone paper.

Poram add_delta_c1:

Long-period adjustment parameter as described in Boore et al. (2022) backbone paper.

COEFFS = <CoeffsTable c1 c1a c1b c1c c1d cn cm c2 c3 c4 c4a crb c5 chm c6 c7 c7b c8 c8a c8b c9 c9a c9b c11 c11b cg1 cg2 cg3 phi1 phi2 phi3 phi4 phi5 phi6 gjpit gwn phi1jp phi5jp phi6jp tau1 tau2 sig1 sig2 sig3 sig2jp>

Coefficient tables are constructed from values in tables 1 - 5

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 1130

Reference shear wave velocity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see chapter “Variance model”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

Required distance measures are RRup, Rjb and Rx.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'ztor'})

Required rupture parameters are magnitude, rake, dip and ztor.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'vs30measured', 'z1pt0'})

Required site parameters are Vs30, Vs30 measured flag and Z1.0.

adapted = False

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.chiou_youngs_2014.ChiouYoungs2014ACME2019(**kwargs)

Bases: ChiouYoungs2014

Implements a modified version of the CY2014 GMM. Main changes: - Hanging wall term excluded - Centered Ztor = 0 - Centered Dpp = 0

adapted = True

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.chiou_youngs_2014.ChiouYoungs2014Italy(**kwargs)

Bases: ChiouYoungs2014

Adaption of the Chiou & Youngs (2014) GMPE for the the Italy far-field attenuation scaling, but assuming the California site amplification model

class openquake.hazardlib.gsim.chiou_youngs_2014.ChiouYoungs2014Japan(**kwargs)

Bases: ChiouYoungs2014

Regionalisation of the Chiou & Youngs (2014) GMPE for use with the Japan far-field distance attuation scaling and site model

class openquake.hazardlib.gsim.chiou_youngs_2014.ChiouYoungs2014NearFaultEffect(**kwargs)

Bases: ChiouYoungs2014

This implements the Chiou & Youngs (2014) GMPE include the near fault effect prediction. In this version, we add the distance measure, rcdpp for directivity prediction.

REQUIRES_DISTANCES = frozenset({'rcdpp', 'rjb', 'rrup', 'rx'})

Required distance measures are RRup, Rjb, Rx, and Rcdpp

class openquake.hazardlib.gsim.chiou_youngs_2014.ChiouYoungs2014PEER(**kwargs)

Bases: ChiouYoungs2014

This implements the Chiou & Youngs (2014) GMPE for use with the PEER tests. In this version the total standard deviation is fixed at 0.65

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>})

The PEER tests requires only PGA

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Only the total standars deviation is defined

class openquake.hazardlib.gsim.chiou_youngs_2014.ChiouYoungs2014Wenchuan(**kwargs)

Bases: ChiouYoungs2014

Adaption of the Chiou & Youngs (2014) GMPE for the Wenchuan far-field attenuation scaling, but assuming the California site amplification model. It should be note that according to Chiou & Youngs (2014) this adjustment is calibrated only for the M7.9 Wenchuan earthquake, so application to other scenarios is at the user’s own risk

openquake.hazardlib.gsim.chiou_youngs_2014.get_basin_depth_term(clsname, C, centered_z1pt0)

Returns the basin depth scaling

openquake.hazardlib.gsim.chiou_youngs_2014.get_delta_c1(rrup, imt, mag)

Return the delta_c1 long-period adjustment parameter as defined by equation 2 of Boore et al.(2022).

openquake.hazardlib.gsim.chiou_youngs_2014.get_directivity(clsname, C, ctx)

Returns the directivity term.

The directivity prediction parameter is centered on the average directivity prediction parameter. Here we set the centered_dpp equal to zero, since the near fault directivity effect prediction is off by default in our calculation.

openquake.hazardlib.gsim.chiou_youngs_2014.get_far_field_distance_scaling_1(region, C, mag, rrup, delta_g)

Returns the far-field distance scaling term - both magnitude and distance - for California and other regions

openquake.hazardlib.gsim.chiou_youngs_2014.get_far_field_distance_scaling_2(region, C, mag, rrup, delta_g)

Returns the far-field distance scaling term - both magnitude and distance - for Japan

openquake.hazardlib.gsim.chiou_youngs_2014.get_far_field_distance_scaling_3(region, C, mag, rrup, delta_g)

Returns the far-field distance scaling term - both magnitude and distance - for Italy

openquake.hazardlib.gsim.chiou_youngs_2014.get_far_field_distance_scaling_4(region, C, mag, rrup, delta_g)

Returns the far-field distance scaling term - both magnitude and distance - for Wenchuan

openquake.hazardlib.gsim.chiou_youngs_2014.get_geometric_spreading(C, mag, rrup)

Returns the near-field geometric spreading term

openquake.hazardlib.gsim.chiou_youngs_2014.get_hanging_wall_term(C, ctx)

Returns the hanging wall term

openquake.hazardlib.gsim.chiou_youngs_2014.get_linear_site_term(clsname, C, ctx)

Returns the linear site scaling term

openquake.hazardlib.gsim.chiou_youngs_2014.get_ln_y_ref(clsname, C, ctx, conf)

Returns the ground motion on the reference rock, described fully by Equation 11 in CY14 (page 1131).

openquake.hazardlib.gsim.chiou_youngs_2014.get_magnitude_scaling(C, mag, delta_cm)

Returns the magnitude scaling

openquake.hazardlib.gsim.chiou_youngs_2014.get_mean_stddevs(name, C, ctx, imt, conf)

Return mean and standard deviation values

openquake.hazardlib.gsim.chiou_youngs_2014.get_nonlinear_site_term(C, ctx, y_ref)

Returns the nonlinear site term and the Vs-scaling factor (to be used in the standard deviation model

openquake.hazardlib.gsim.chiou_youngs_2014.get_phi(C, mag, ctx, nl0)

Returns the within-event variability described in equation 13, line 3

openquake.hazardlib.gsim.chiou_youngs_2014.get_region(clsname)

Returns the region parameter

openquake.hazardlib.gsim.chiou_youngs_2014.get_source_scaling_terms(C, ctx, delta_ztor, alpha_nm)

Returns additional source scaling parameters related to style of faulting, dip and top of rupture depth

openquake.hazardlib.gsim.chiou_youngs_2014.get_stddevs(clsname, C, ctx, mag, y_ref, f_nl_scaling)

Returns the standard deviation model described in equation 13

openquake.hazardlib.gsim.chiou_youngs_2014.get_stress_scaling(C)

Returns the stress drop scaling factor

openquake.hazardlib.gsim.chiou_youngs_2014.get_tau(C, mag)

Returns the between-event variability described in equation 13, line 2

climent_1994

Module exports :class:’ClimentEtAl1994’.

class openquake.hazardlib.gsim.climent_1994.ClimentEtAl1994(**kwargs)

Bases: GMPE

Implements GMPE developed by Climent, A, W. Taylor, M. Ciudad Real, W. Strauch, M. Villagran, A. Dahle, and H. Bungum. Published as a NORSAR report: “Spectral strong motion attenuation in Central Ame- rica”, NORSAR Technical Report No. 2-17, 46 pp. The original formulation predict PGA (m/s*s) and 5% damped PSV (m/s) for the largest component of horizontal ground motion. In this implementation: Spectral acceleration (SA) values are obtained from PSV ones using the following formula :

SA = [PSV * (2 * pi/ T)]/ratio(SA_larger/SA_geo_mean) StdDev.TOTAL=StdDev.TOTAL/sd_ratio(SA_larger/SA_geo_mean)

The ratio() and sd_ratio() from Beyer and Bommer(2006)

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 SigmaB r_SA r_std>

Equation coefficients, described in Table 4.1 on pp. 22 the original imt values are defined as frequencies values the sigma_ls was excluded

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Greater of two horizontal'

Supported intensity measure component is the largest component of two horizontal components openquake.hazardlib.const.IMC.GREATER_OF_TWO_HORIZONTAL, see paragraph before table on Summary, page 1.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration. See Table 2 in page 1865

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total. See equation 1 on the Summary and Table 4.1, page 22.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust and/or interface subduction the authors did not distinction between shallow and sudbdution events (see topic 5.3 “Shallow crustal vs.subduction events, pag. 32). Any factor/parameter is used in the formulation to discriminate between shallow or interface tectonic regime, here this GMPE is implemented for active_shallow_crust only

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo, explained in page 1(eq. 1)

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters. The GMPE was developed for rock and soil site conditions. The parameter S in eq. 1 (see Summary) define the soil condition: S=0 for rock, S=1 for soil. Here we use the Vs30=760 as limit between the two soil conditions

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

coeffs_table

Module openquake.hazardlib.gsim.base defines base classes for different kinds of ground shaking intensity models.

exception openquake.hazardlib.gsim.base.AdaptedWarning

Bases: UserWarning

Raised for GMPEs that are intended for experimental use or maybe subject to changes in future version.

exception openquake.hazardlib.gsim.base.ExperimentalWarning

Bases: UserWarning

Raised for GMPEs that are intended for experimental use or maybe subject to changes in future version.

class openquake.hazardlib.gsim.base.GMPE(**kwargs)

Bases: GroundShakingIntensityModel

Ground-Motion Prediction Equation is a subclass of generic GroundShakingIntensityModel with a distinct feature that the intensity values are log-normally distributed.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

set_parameters()

Combines the parameters of the GMPE provided at the construction level with the ones originally assigned to the backbone modified GMPE.

set_poes(mean_std, cmaker, ctx, out)

Calculate and return probabilities of exceedance (PoEs) of one or more intensity measure levels (IMLs) of one intensity measure type (IMT) for one or more pairs “site – rupture”.

Parameters:

• mean_std – An array of shape (2, M, N) with mean and standard deviations for the sites and intensity measure types

• cmaker – A ContextMaker instance, used only in nhsm_2014

• ctx – A recarray used only in avg_poe_gmpe

• out – An array of PoEs of shape (N, L) to be filled

Raises:

ValueError – If truncation level is not None and neither non-negative float number, and if imts dictionary contain wrong or unsupported IMTs (see DEFINED_FOR_INTENSITY_MEASURE_TYPES).

class openquake.hazardlib.gsim.base.GroundShakingIntensityModel(**kwargs)

Bases: object

Base class for all the ground shaking intensity models.

A Ground Shaking Intensity Model (GSIM) defines a set of equations for computing mean and standard deviation of a normal distribution representing the variability of an intensity measure (or of its logarithm) at a site given an earthquake rupture.

This class is not intended to be subclassed directly, instead the actual GSIMs should subclass GMPE.

Subclasses of both must implement get_mean_and_stddevs() and all the class attributes with names starting from DEFINED_FOR and REQUIRES.

abstract property DEFINED_FOR_INTENSITY_MEASURE_COMPONENT

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

abstract property DEFINED_FOR_INTENSITY_MEASURE_TYPES

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

abstract property DEFINED_FOR_STANDARD_DEVIATION_TYPES

Set of standard deviation types this GSIM can calculate.

abstract property DEFINED_FOR_TECTONIC_REGION_TYPE

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_ATTRIBUTES = frozenset({})

Set of required GSIM attributes

abstract property REQUIRES_DISTANCES

Set of types of distance measures between rupture and sites. Possible values are:

rrup

Closest distance to rupture surface. See get_min_distance().

rjb

Distance to rupture’s surface projection. See get_joyner_boore_distance().

rx

Perpendicular distance to rupture top edge projection. See get_rx_distance().

ry0

Horizontal distance off the end of the rupture measured parallel to strike. See get_ry0_distance().

rcdpp

Direct point parameter for directivity effect centered on the site- and earthquake-specific average DPP used. See get_dppvalue().

rvolc

Source to site distance passing through surface projection of volcanic zone.

All the distances are available from the DistancesContext object attributes with same names. Values are in kilometers.

abstract property REQUIRES_RUPTURE_PARAMETERS

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

abstract property REQUIRES_SITES_PARAMETERS

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

adapted = False

experimental = False

get_mean_and_stddevs(sites, rup, dists, imt, stddev_types)

Calculate and return mean value of intensity distribution and it’s standard deviation.

Method must be implemented by subclasses.

Parameters:

• sites – Instance of openquake.hazardlib.site.SiteCollection with parameters of sites collection assigned to respective values as numpy arrays. Only those attributes that are listed in class’ REQUIRES_SITES_PARAMETERS set are available.

• rup – Instance of openquake.hazardlib.source.rupture.BaseRupture with parameters of a rupture assigned to respective values. Only those attributes that are listed in class’ REQUIRES_RUPTURE_PARAMETERS set are available.

• dists – Instance of DistancesContext with values of distance measures between the rupture and each site of the collection assigned to respective values as numpy arrays. Only those attributes that are listed in class’ REQUIRES_DISTANCES set are available.

• imt – An instance (not a class) of intensity measure type. See openquake.hazardlib.imt.

• stddev_types – List of standard deviation types, constants from openquake.hazardlib.const.StdDev. Method result value should include standard deviation values for each of types in this list.

Returns:

Method should return a tuple of two items. First item should be a numpy array of floats – mean values of respective component of a chosen intensity measure type, and the second should be a list of numpy arrays of standard deviation values for the same single component of the same single intensity measure type, one array for each type in stddev_types parameter, preserving the order.

Combining interface to mean and standard deviation values in a single method allows to avoid redoing the same intermediate calculations if there are some shared between stddev and mean formulae without resorting to keeping any sort of internal state (and effectively making GSIM not reenterable).

However it is advised to split calculation of mean and stddev values and make get_mean_and_stddevs() just combine both (and possibly compute interim steps).

non_verified = False

requires()

Returns:

ordered tuple with the required parameters except the mag

superseded_by = None

class openquake.hazardlib.gsim.base.MetaGSIM(name, bases, dic)

Bases: ABCMeta

A metaclass converting set class attributes into frozensets, to avoid mutability bugs without having to change already written GSIMs. Moreover it performs some checks against typos.

exception openquake.hazardlib.gsim.base.NotVerifiedWarning

Bases: UserWarning

Raised when a non verified GSIM is instantiated

openquake.hazardlib.gsim.base.add_alias(name, cls, **kw)

Add a GSIM alias to both gsim_aliases and the registry.

openquake.hazardlib.gsim.base.bad_methods(clsdict)

Returns:

list of not acceptable method names

openquake.hazardlib.gsim.base.to_distribution_values(vals, imt)

Returns:

the logarithm of the values unless the IMT is MMI

convertito_2012

Module exports :class:’ConvertitoEtAl2012Geysers’

class openquake.hazardlib.gsim.convertito_2012.ConvertitoEtAl2012Geysers(**kwargs)

Bases: GMPE

Implements the PGA GMPE for Induced Seismicity in the Geysers Geothermal field, published in Convertito, V., Maercklin, N., Sharma, N., and Zollo, A. (2012) From Induced Seismicity to Direct Time-Dependent Seismic Hazard. Bulletin of the Seismological Society of America, 102(6), 2563 - 2573

COEFFS = <CoeffsTable a b c d h e sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Greater of two horizontal'

Supported intensity measure component is the larger of two components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>})

Supported intensity measure types are peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Geothermal'

The GMPE is derived from induced earthquakes in the Geysers Geothermal field

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters. The GMPE was developed for two site conditions “with” and “without” site effect. No information is given regarding the soil conditions, so we assume “with site effect” to correspond to NEHRP Classes C, D or E (i.e. Vs30 < 760), and “without site effect” to corresponse to NEHRP Classes A and B (i.e. Vs30 >= 760)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

GMPE not tested against independent implementation so raise not verified warning

derras_2014

Module exports DerrasEtAl2014

class openquake.hazardlib.gsim.derras_2014.DerrasEtAl2014(**kwargs)

Bases: GMPE

Implements GMPE developed by: B. Derras, P. Y. Bard, F. Cotton (2014) “Toward fully data driven ground- motion prediction models for Europe”, Bulletin of Earthquake Engineering 12, 495-516

The GMPE is derived from an artifical neural network approach, and therefore does not assume the form of source, path and site scaling that is conventionally adopted by GMPEs. Instead the influence of each variable is modelled via a hyperbolic tangent-sigmoid function which is then applied to the vector of normalised predictor variables. As a consequence the expected ground motion for each site is derived from a set of matrix products from the respective weighting and bias vectors. This means that vectorisation by ctx cannot be achieved and a loop is implemented instead.

B_1 = array([-1.27123249,  1.51261103,  0.59108901, -0.12662269, -0.41572122])

COEFFS = <CoeffsTable tmin tmax W_21 W_22 W_23 W_24 W_25 B_2 tau phi>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

The supported intensity measure component is ‘average horizontal’,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

The supported intensity measure types are PGA, PGV, and SA

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

The supported standard deviations are total, inter and intra event

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

The supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb'})

The required distance parameter is ‘Joyner-Boore’ distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag', 'rake'})

The required rupture parameters are rake and magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

The required site parameter is vs30

W_1 = array([[ 2.64789163, -1.07021796,  0.17408776,  0.09219129, -0.01376368],        [-1.90867544, -0.53501737, -0.70514162,  0.16761158, -0.02661049],        [ 0.20354214,  1.78055764, -0.08049459,  0.01359636,  0.06150821],        [-0.6927375 ,  0.44150523,  0.77557997, -0.03171773, -0.16306571],        [ 0.01616282,  0.21814134, -1.60609945, -0.04163626,  0.02605798]])

adjustment_factor = 0.0

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

region = 'base'

class openquake.hazardlib.gsim.derras_2014.DerrasEtAl2014RhypoGermany(**kwargs)

Bases: DerrasEtAl2014

Re-calibration of the Derras et al. (2014) GMPE taking hypocentral distance as an input and converting to Rjb

REQUIRES_DISTANCES = frozenset({'rhypo', 'rjb'})

The required distance parameter is hypocentral distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag', 'rake', 'width'})

The required rupture parameters are rake and magnitude

region = 'germany'

openquake.hazardlib.gsim.derras_2014.get_mean(region, W_1, B_1, C, ctx)

Returns the mean ground motion in terms of log10 m/s/s, implementing equation 2 (page 502)

openquake.hazardlib.gsim.derras_2014.get_pn(region, ctx, sof)

Normalise the input parameters within their upper and lower defined range.

Returns:

an array of shape (N, 5) with rjb, magn, vs30, depth, sof

openquake.hazardlib.gsim.derras_2014.rhypo_to_rjb(rhypo, mag)

Converts hypocentral distance to an equivalent Joyner-Boore distance dependent on the magnitude

dost_2004

Module exports :class:’DostEtAl2004’

class openquake.hazardlib.gsim.dost_2004.DostEtAl2004(**kwargs)

Bases: GMPE

Implements the GMPE of Dost et al. (2004) for PGA and PGV from induced seismicity earthquakes in the Netherlands Dost, B., van Eck, T. and Haak, H. (2004) Scaling of peak ground acceleration and peak ground velocity recorded in the Netherlands. Bollettino di Geofisica Teorica ed Applicata. 45(3), 153 - 168

COEFFS = <CoeffsTable c0 c1 c2 c3 sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (GMRotD100)'

Supported intensity measure component is the average horizontal

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>})

Supported intensity measure types are peak ground acceleration and peak ground velocity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Induced'

The GMPE is derived from induced earthquakes

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude (ML is used)

REQUIRES_SITES_PARAMETERS = frozenset({})

No required site parameters

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

non_verified = True

GMPE not tested against independent implementation so raise not verified warning

class openquake.hazardlib.gsim.dost_2004.DostEtAl2004BommerAdaptation(**kwargs)

Bases: DostEtAl2004

Adaptation of the GMPE for application to higher magnitudes proposed by Bommer et al. (2013)

COEFFS = <CoeffsTable c0 c1 c1e c2 c3 tau phi sigma>

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types is total.

kind = 'bommer'

douglas_stochastic_2013

Module exports DouglasEtAl2013StochasticSD001Q200K005 DouglasEtAl2013StochasticSD001Q200K020 DouglasEtAl2013StochasticSD001Q200K040 DouglasEtAl2013StochasticSD001Q200K060 DouglasEtAl2013StochasticSD001Q600K005 DouglasEtAl2013StochasticSD001Q600K020 DouglasEtAl2013StochasticSD001Q600K040 DouglasEtAl2013StochasticSD001Q600K060 DouglasEtAl2013StochasticSD001Q1800K005 DouglasEtAl2013StochasticSD001Q1800K020 DouglasEtAl2013StochasticSD001Q1800K040 DouglasEtAl2013StochasticSD001Q1800K060 DouglasEtAl2013StochasticSD010Q200K005 DouglasEtAl2013StochasticSD010Q200K020 DouglasEtAl2013StochasticSD010Q200K040 DouglasEtAl2013StochasticSD010Q200K060 DouglasEtAl2013StochasticSD010Q600K005 DouglasEtAl2013StochasticSD010Q600K020 DouglasEtAl2013StochasticSD010Q600K040 DouglasEtAl2013StochasticSD010Q600K060 DouglasEtAl2013StochasticSD010Q1800K005 DouglasEtAl2013StochasticSD010Q1800K020 DouglasEtAl2013StochasticSD010Q1800K040 DouglasEtAl2013StochasticSD010Q1800K060 DouglasEtAl2013StochasticSD100Q200K005 DouglasEtAl2013StochasticSD100Q200K020 DouglasEtAl2013StochasticSD100Q200K040 DouglasEtAl2013StochasticSD100Q200K060 DouglasEtAl2013StochasticSD100Q600K005 DouglasEtAl2013StochasticSD100Q600K020 DouglasEtAl2013StochasticSD100Q600K040 DouglasEtAl2013StochasticSD100Q600K060 DouglasEtAl2013StochasticSD100Q1800K005 DouglasEtAl2013StochasticSD100Q1800K020 DouglasEtAl2013StochasticSD100Q1800K040 DouglasEtAl2013StochasticSD100Q1800K060

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q1800K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 1800 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q1800K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 1800 - Kappa 0.020

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q1800K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 1800 - Kappa 0.040

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q1800K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 1800 - Kappa 0.060

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q200K005(**kwargs)

Bases: GMPE

Implements the GMPE for induced seismicity in Geothermal Areas derived from stochastic simulations of ground motion constructed by:

Douglas, J., Edwards, B., Convertito, V., Sharma, N., Tramelli, A.,

Kraaijpoel, D., Cabrera, B. M., Maercklin, N., and Troise, C. (2013) “Predicting Ground Motion for Induced Earthquakes in Geothermal Areas” Bulleting of the Seismological Society of America, 103(3), 1875 - 1897

The stochastic model by Douglas et al. (2013) provides coefficients for 36 GMPEs, corresponding to different values of Stress Drop (1 bar, 10 bar, 100 bar), Attentuation Quality Factor Q (200, 600, 1800) and high-frequency Kappa (0.005, 0.02, 0.04, 0.05 s).

The present model is implemented for Stress Drop 1 bar, Q 200 and Kappa 0.005 s.

The models for each combination of Stress Drop, Q and Kappa are implemented in subclasses, with only the median coefficients modified in each subclass

Notes on implementation:

1. Aleatory uncertainty terms are not supplied for the stochastic coefficients. Instead the adjusted aleatory uncertainty coefficients derived from empirical observations are applied to the stochastic model.

2. In the initial coefficient set for the stochastic model coefficients for spectral accelerations up to 10 s are provided. However, the empirical aleatory uncertainties are provided only for periods up to 0.5012 s. Therefore, after consulation with J. Douglas, it is decided to limit longest applicable spectral period to Sa (0.5 s), rather than extrapolate the empricial aleatory coefficients to longer periods.

3. For PGA and Sa (< 0.01 s) the aleatory uncertainty coefficients for Sa (0.01 s) are applied (J. Douglas, pers. comm.)

4. For Sa (< 0.01 s) the coefficients are interpolated assuming PGA occurs at Sa (0.005 s) (J. Dougla, pers. comm.). We therefore limit the short period range to 0.005 s

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

COEFFS_SIGMA = <CoeffsTable phi tau_s tau_b>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

The supported intensity measure component is ‘average horizontal’, see section entitiled “Empirical Analysis”, paragraph 1

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

The supported intensity measure types are PGA, PGV, and SA, see table 4.a, pages 22-23

DEFINED_FOR_REFERENCE_VELOCITY = 1100.0

Definined for a reference velocity of 1100 m/s (Table 4)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

The supported standard deviations are total, inter and intra event, see table 4.a, pages 22-23

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Geothermal'

The supported tectonic region type is Geothermal because the equations have been developed for geothermal regions

REQUIRES_DISTANCES = frozenset({'rhypo'})

The required distance parameter is hypocentral distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

The required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

No additional site term is defined

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q200K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 200 - Kappa 0.02

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q200K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 200 - Kappa 0.04

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q200K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 200 - Kappa 0.06

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q600K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 600 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q600K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 600 - Kappa 0.020

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q600K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 600 - Kappa 0.040

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD001Q600K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 001 - Q 600 - Kappa 0.060

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q1800K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 600 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q1800K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 1800 - Kappa 0.02

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q1800K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 1800 - Kappa 0.04

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q1800K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 1800 - Kappa 0.06

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q200K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 200 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q200K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 200 - Kappa 0.020

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q200K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 200 - Kappa 0.040

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q200K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 200 - Kappa 0.060

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q600K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 600 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q600K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 600 - Kappa 0.02

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q600K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 600 - Kappa 0.04

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD010Q600K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 010 - Q 600 - Kappa 0.06

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q1800K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 1800 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q1800K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 1800 - Kappa 0.02

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q1800K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 1800 - Kappa 0.04

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q1800K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 1800 - Kappa 0.04

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q200K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 200 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q200K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 200 - Kappa 0.02

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q200K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 200 - Kappa 0.04

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q200K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 200 - Kappa 0.06

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q600K005(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 600 - Kappa 0.005

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q600K020(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 600 - Kappa 0.02

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q600K040(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 600 - Kappa 0.04

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

class openquake.hazardlib.gsim.douglas_stochastic_2013.DouglasEtAl2013StochasticSD100Q600K060(**kwargs)

Bases: DouglasEtAl2013StochasticSD001Q200K005

Stress Drop 100 - Q 600 - Kappa 0.06

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 bh total>

openquake.hazardlib.gsim.douglas_stochastic_2013.get_distance_scaling_term(C, rhyp)

Returns the distance scaling term (equation 1)

openquake.hazardlib.gsim.douglas_stochastic_2013.get_magnitude_scaling_term(C, mag)

Returns the magnitude scaling term (equation 1)

openquake.hazardlib.gsim.douglas_stochastic_2013.get_stddevs(C_SIG)

Returns the standard deviations

N.B. In the paper, and with confirmation from the author, the aleatory variability terms from the empirical model are used in conjunction with the median coefficients from the stochastic model. In the empirical model, coefficients for a single-station intra-event sigma are derived. These are labeled as “phi”. Inter-event coefficients corresponding to two observed geothermal sequences (Soultz-Sous-Forets and Basel) are also derived. The inter-event standard deviation is therefore taken as the ordinary mean of the two inter-event sigma terms

dowrickrhoades_2005

Module exports DowrickRhoades2005Asc,:class:DowrickRhoades2005SInter DowrickRhoades2005SSlab, and DowrickRhoades2005Volc.

class openquake.hazardlib.gsim.dowrickrhoades_2005.DowrickRhoades2005Asc(**kwargs)

Bases: GMPE

Implements IPE developed by D.J. Dowrick and D.A. Rhoades published as “Revised models for attenuation of Modified Mercalli Intensity in New Zealand earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.38, no. 4, p. 185-214, December 2005.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/38(4)0185.pdf Last accessed 20 November 2015.

This class implements the IPE for Active Shallow Crust for different faulting types.

COEFFS = <CoeffsTable A1 A2 A2R A2V A3 A3S A3V A4 A5 d tau sigma>

Coefficient table (table 5, page 198)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is the horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function MMI>})

Supported intensity measure type is MMI.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type for base class is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rrup (paragraphy x, page xx) which is defined as nearest distance to the source.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag', 'rake'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.dowrickrhoades_2005.DowrickRhoades2005SInter(**kwargs)

Bases: DowrickRhoades2005Asc

Implements IPE developed by D.J. Dowrick and D.A. Rhoades published as “Revised models for attenuation of Modified Mercalli Intensity in New Zealand earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.38, no. 4, p. 185-214, December 2005.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/38(4)0185.pdf Last accessed 20 November 2015.

This class implements the IPE for Subduction Interface events

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type for base class is ‘active shallow crust’

class openquake.hazardlib.gsim.dowrickrhoades_2005.DowrickRhoades2005SSlab(**kwargs)

Bases: DowrickRhoades2005Asc

Implements IPE developed by D.J. Dowrick and D.A. Rhoades published as “Revised models for attenuation of Modified Mercalli Intensity in New Zealand earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.38, no. 4, p. 185-214, December 2005.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/38(4)0185.pdf Last accessed 20 November 2015.

This class implements the IPE for Subduction Slab events

COEFFS = <CoeffsTable A1 A2 A2R A2V A3 A3S A3V A4 A5 d tau sigma>

Coefficient table (table 7, page 198)

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type for base class is ‘active shallow crust’

class openquake.hazardlib.gsim.dowrickrhoades_2005.DowrickRhoades2005Volc(**kwargs)

Bases: DowrickRhoades2005Asc

Implements IPE developed by D.J. Dowrick and D.A. Rhoades published as “Revised models for attenuation of Modified Mercalli Intensity in New Zealand earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.38, no. 4, p. 185-214, December 2005.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/38(4)0185.pdf Last accessed 20 November 2015.

This class implements the IPE for events with a volcanic source

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type for base class is ‘active shallow crust’

drouet_2015_brazil

Module exports DrouetBrazil2015

DrouetBrazil2015_with_depth

class openquake.hazardlib.gsim.drouet_2015_brazil.DrouetBrazil2015(**kwargs)

Bases: GMPE

Implements GMPE developed by S. Drouet unpublished for Brazil based on the method described in Douet & Cotton (2015) BSSA doi: 10.1785/0120140240.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the original paper.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 6, page 1022 (PGA is assumed to be equal to SA at 0.01 s)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is only total, see equation 35, page 1021

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust given that the equations have been derived for Eastern North America.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude, see equation 30 page 1021.

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters are needed

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.drouet_2015_brazil.DrouetBrazil2015withDepth(**kwargs)

Bases: DrouetBrazil2015

Implements GMPE developed by S. Drouet unpublished for Brazil based on the method described in Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. Model with magnitude-dependent depth distribution and depth-dependent stress distribution

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 sigma tau>

Coefficient tables are constructed from the electronic supplements of the original paper.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameter is only magnitude, see equation 30 page 1021.

drouet_alpes_2015

Module exports DrouetAlpes2015Rjb

DrouetAlpes2015Rrup DrouetAlpes2015Repi DrouetAlpes2015Rhyp DrouetAlpes2015RjbHR DrouetAlpes2015RrupHR DrouetAlpes2015RepiHR DrouetAlpes2015RhypHR DrouetAlpes2015Rjb_50bars DrouetAlpes2015Rrup_50bars DrouetAlpes2015Repi_50bars DrouetAlpes2015Rhypo_50bars DrouetAlpes2015RjbHR_50bars DrouetAlpes2015RrupHR_50bars

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Repi(**kwargs)

Bases: DrouetAlpes2015Rjb

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the original paper.

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015RepiHR(**kwargs)

Bases: DrouetAlpes2015Repi

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 100 bars (recommended by the authors) Valid for vs30=2000 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the erratum to the original paper.

DEFINED_FOR_REFERENCE_VELOCITY = 2000

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Repi_50bars(**kwargs)

Bases: DrouetAlpes2015Repi

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 50 bars Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient table is not published

DEFINED_FOR_REFERENCE_VELOCITY = 800

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Rhyp(**kwargs)

Bases: DrouetAlpes2015Rjb

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the original paper.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015RhypHR(**kwargs)

Bases: DrouetAlpes2015Rhyp

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 100 bars (recommended by the authors) Valid for vs30=2000 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the erratum to the original paper.

DEFINED_FOR_REFERENCE_VELOCITY = 2000

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Rhyp_50bars(**kwargs)

Bases: DrouetAlpes2015Rhyp

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 50 bars Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient table is not published

DEFINED_FOR_REFERENCE_VELOCITY = 800

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Rjb(**kwargs)

Bases: GMPE

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 100 bars (recommended by the authors) Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the original paper.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two : horizontal components GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 6, page 1022 (PGA is assumed to be equal to SA at 0.01 s)

DEFINED_FOR_REFERENCE_VELOCITY = 800

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is only total, see equation 35, page 1021

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is stable continental crust given that the equations have been derived for Eastern North America.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude, see equation 30 page 1021.

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters are needed

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015RjbHR(**kwargs)

Bases: DrouetAlpes2015Rjb

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 100 bars (recommended by the authors) Valid for vs30=2000 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the erratum to the original paper.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015RjbHR_50bars(**kwargs)

Bases: DrouetAlpes2015Rjb

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 50 bars Valid for vs30=2000 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient table is not published

DEFINED_FOR_REFERENCE_VELOCITy = 2000

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Rjb_50bars(**kwargs)

Bases: DrouetAlpes2015Rjb

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 50 bars Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient table is not published

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Rrup(**kwargs)

Bases: DrouetAlpes2015Rjb

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the original paper.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rupture distance, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015RrupHR(**kwargs)

Bases: DrouetAlpes2015Rrup

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 100 bars (recommended by the authors) Valid for vs30=2000 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient tables are constructed from the electronic suplements of the erratum to the original paper.

DEFINED_FOR_REFERENCE_VELOCITY = 2000

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015RrupHR_50bars(**kwargs)

Bases: DrouetAlpes2015Rrup

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 50 bars Valid for vs30=2000 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient table is not published

DEFINED_FOR_REFERENCE_VELOCITY = 2000

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

class openquake.hazardlib.gsim.drouet_alpes_2015.DrouetAlpes2015Rrup_50bars(**kwargs)

Bases: DrouetAlpes2015Rrup

Implements GMPE developed by Douet & Cotton (2015) BSSA doi: 10.1785/0120140240. This version is for a large magnitude stress parameters of 50 bars Valid for vs30=800 m/s

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma tau>

Coefficient table is not published

DEFINED_FOR_REFERENCE_VELOCITY = 800

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, see equation 30 page 1021.

ecos_2009

Module exports: class:ECOS2009, class:ECOS2009Highest

class openquake.hazardlib.gsim.ecos_2009.ECOS2009(**kwargs)

Bases: GMPE

Implements the Intensity Prediction Equation of “Calibration of historical earthquakes for the earthquake catalogue of Switzerland (ECOS-09)”: Appendix D

This class implements the version using “all intensity levels”, fixed depth (h=10km) and the weighting scheme “no weighting”.

See page 18 for general equation (8) - needs to be solved for I_obs - and equation (9) for estimating coefficients c0,c1,c2,c3. Coefficients a,b are taken from Table 4 on page 19. Coefficients alpha,beta are taken from Table 5 on page 19.

Implemented by laurentiu.danciu@sed.ethz.ch

COEFFS = <CoeffsTable a b alpha beta hypo_depth sigma>

Coefficient table constructed from the electronic suplements of the original paper.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function MMI>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance rhypo

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.ecos_2009.ECOS2009Highest(**kwargs)

Bases: ECOS2009

This class implements the version using “three highest intensity levels”, fixed depth (h=10km) and the weighting scheme “no weighting”.

See page 18 for general equation (8) - needs to be solved for I_obs - and equation (9) for estimating coefficients c0,c1,c2,c3. Coefficients a,b are taken from Table 4 on page 19. Coefficients alpha,beta are taken from Table 5 on page 19.

COEFFS = <CoeffsTable a b alpha beta hypo_depth sigma>

Coefficient table constructed from the electronic suplements of the original paper.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

edwards_fah_2013a

Module exports EdwardsFah2013Alpine10Bars, EdwardsFah2013Alpine20Bars, EdwardsFah2013Alpine30Bars, EdwardsFah2013Alpine50Bars, EdwardsFah2013Alpine60Bars, EdwardsFah2013Alpine75Bars, EdwardsFah2013Alpine90Bars, EdwardsFah2013Alpine120Bars.

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine10Bars(**kwargs)

Bases: GMPE

This function implements the GMPE developed by Ben Edwars and Donath Fah and published as “A Stochastic Ground-Motion Model for Switzerland” Bulletin of the Seismological Society of America, Vol. 103, No. 1, pp. 78–98, February 2013. The GMPE was parametrized by Carlo Cauzzi to be implemented in OpenQuake. This class implements the equations for ‘Alpine’ and ‘Foreland - two tectonic regionalizations defined for the Switzerland - therefore this GMPE is region specific”. @ implemented by laurentiu.danciu@sed.ethz.zh

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see tables 3 and 4, pages 227 and 228.

DEFINED_FOR_REFERENCE_VELOCITY = 1105.0

Vs30 value representing typical rock conditions in Switzerland. confirmed by the Swiss GMPE group

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation type is total, inter-event and intra-event

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ALPINE which is a sub-region of Active Shallow Crust.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters: magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock and deep soil).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine120Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This class extends EdwardsFah2013Alpine10Bars and implements the 120Bars Model EdwardsFah2013Alpine120Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine20Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This class extends EdwardsFah2013Alpine10Bars and implements the 20Bars Model EdwardsFah2013Alpine20Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine30Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This class extends EdwardsFah2013Alpine10Bars and implements the 30Bars Model EdwardsFah2013Alpine30Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine50Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This class extends EdwardsFah2013Alpine10Bars and implements the 50Bars Model EdwardsFah2013Alpine50Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine60Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This class extends EdwardsFah2013Alpine10Bars and implements the 60Bars Model EdwardsFah2013Alpine60Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine75Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This class extends EdwardsFah2013Alpine10Bars and implements the 75Bars Model EdwardsFah2013Alpine75Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013a.EdwardsFah2013Alpine90Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This class extends EdwardsFah2013Alpine10Bars and implements the 90Bars Model EdwardsFah2013Alpine90Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

openquake.hazardlib.gsim.edwards_fah_2013a.M1 = 5.0

Fixed magnitude terms

edwards_fah_2013a_coeffs

edwards_fah_2013f

Module exports EdwardsFah2013Foreland10Bars, EdwardsFah2013Foreland20Bars, EdwardsFah2013Foreland30Bars, EdwardsFah2013Foreland50Bars, EdwardsFah2013Foreland60Bars, EdwardsFah2013Foreland75Bars, EdwardsFah2013Foreland90Bars, EdwardsFah2013Foreland120Bars

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland10Bars(**kwargs)

Bases: EdwardsFah2013Alpine10Bars

This function implements the GMPE developed by Ben Edwards and Donath Fah and published as “A Stochastic Ground-Motion Model for Switzerland” Bulletin of the Seismological Society of America, Vol. 103, No. 1, pp. 78–98, February 2013. The GMPE was parametrized by Carlo Cauzzi to be implemented in OpenQuake. This class implements the equations for ‘Foreland - two tectonic regionalizations defined for the Switzerland - therefore this GMPE is region specific”.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland120Bars(**kwargs)

Bases: EdwardsFah2013Foreland10Bars

This class extends EdwardsFah2013Foreland10Bars and implements the 120Bars Model EdwardsFah2013Foreland120Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland20Bars(**kwargs)

Bases: EdwardsFah2013Foreland10Bars

This class extends EdwardsFah2013Foreland10Bars and implements the 20Bars Model EdwardsFah2013Foreland20Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland30Bars(**kwargs)

Bases: EdwardsFah2013Foreland10Bars

This class extends EdwardsFah2013Foreland10Bars and implements the 30Bars Model EdwardsFah2013Foreland30Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland50Bars(**kwargs)

Bases: EdwardsFah2013Foreland10Bars

This class extends EdwardsFah2013Foreland10Bars and implements the 50Bars Model EdwardsFah2013Foreland50Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland60Bars(**kwargs)

Bases: EdwardsFah2013Foreland10Bars

This class extends EdwardsFah2013Foreland10Bars and implements the 60Bars Model EdwardsFah2013Foreland60Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland75Bars(**kwargs)

Bases: EdwardsFah2013Foreland10Bars

This class extends EdwardsFah2013Foreland10Bars and implements the 75Bars Model EdwardsFah2013Foreland75Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

class openquake.hazardlib.gsim.edwards_fah_2013f.EdwardsFah2013Foreland90Bars(**kwargs)

Bases: EdwardsFah2013Foreland10Bars

This class extends EdwardsFah2013Foreland10Bars and implements the 90Bars Model EdwardsFah2013Foreland90Bars

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 a11 a12 a13 a14 a15 a16 a17 a18 a19 a20 a21 a22 a23 tau mean_phi_ss sigma_tot phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21>

edwards_fah_2013f_coeffs

eshm20_craton

Module exports ESHM20Craton

class openquake.hazardlib.gsim.eshm20_craton.ESHM20Craton(**kwargs)

Bases: GMPE

Implements a scalable backbone GMPE for application to stable cratonic regions (primarily intended for cratonic Europe). The median ground motion is determined by fitting a parametric model to an extensive set of ground motion scenarios from the suite of NGA East ground motion models for 800 m/s site class. The form of the parametric model is based on that of openquake.hazardlib.gsim.kotha_2019.KothaEtAl2019, and the scaling in terms of the number of standard deviations of the epistemic uncertainty (sigma).

The aleatory uncertainty model is that of Al Atik (2015), which is common to all NGA East ground motion models and configurable by the user.

Parameters:

• epsilon (float) – Number of standard deviations above or below the median to be applied to the epistemic uncertainty sigma

• tau_model (str) – Choice of model for the inter-event standard deviation (tau), selecting from “global” {default}, “cena” or “cena_constant”

• phi_model (str) – Choice of model for the single-station intra-event standard deviation (phi_ss), selecting from “global” {default}, “cena” or “cena_constant”

• TAU – Inter-event standard deviation model

• PHI_SS – Single-station standard deviation model

• PHI_S2SS – Station term for ergodic standard deviation model

• ergodic (bool) – True if an ergodic model is selected, False otherwise

• tau_quantile (float) – Epistemic uncertainty quantile for the inter-event standard deviation models. Float in the range 0 to 1, or None (mean value used)

• phi_ss_quantile (float) – Epistemic uncertainty quantile for the intra-event standard deviation models. Float in the range 0 to 1, or None (mean value used)

• phi_s2ss_quantile (float) – Epistemic uncertainty quantile for the site-to-site standard deviation models. Float in the range 0 to 1, or None (mean value used)

• site_epsilon (float) – Number of standard deviations above or below median for the uncertainty in the site amplification model

COEFFS = <CoeffsTable e1 b1 b2 b3 c1 c2 c3 sigma_mu>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

The GMPE is defined only for PGA and SA

DEFINED_FOR_REFERENCE_VELOCITY = 3000.0

Defined for a reference velocity of 3000 m/s

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Requires only magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Median calibrated for Vs30 3000 m/s Vs30, no site term required Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

Returns the mean and standard deviations

openquake.hazardlib.gsim.eshm20_craton.get_distance_term(C, mag, rrup)

Returns the distance attenuation factor

openquake.hazardlib.gsim.eshm20_craton.get_hard_rock_mean(C, ctx)

Returns the mean and standard deviations for the reference very hard rock condition (Vs30 = 3000 m/s)

openquake.hazardlib.gsim.eshm20_craton.get_magnitude_scaling(C, mag)

Returns the magnitude scaling term

openquake.hazardlib.gsim.eshm20_craton.get_site_amplification(site_epsilon, imt, pga_r, ctx)

Returns the sum of the linear (Stewart et al., 2019) and non-linear (Hashash et al., 2019) amplification terms

openquake.hazardlib.gsim.eshm20_craton.get_stddevs(ergodic, tau_model, TAU, PHI_SS, imt, ctx)

Returns the standard deviations for either the ergodic or non-ergodic models

faccioli_cauzzi_2006

Module exports : class:FaccioliCauzzi2006

class openquake.hazardlib.gsim.faccioli_cauzzi_2006.FaccioliCauzzi2006(**kwargs)

Bases: GMPE

Implements “Macroseismic Intensities for seismic scenarios estimated from instrumentally based correlations” by E. Faccioli and C. Cauzzi First European Conference on Earthquake Engineering and Seismology Geneva, Switzerland, 3-8 September 2006 Paper Number: 569

Implemented by laurentiu.danciu@sed.ethz.ch

COEFFS = <CoeffsTable c1 c2 c3 h sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function MMI>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'repi'})

Required distances

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

frankel_1996

Module exports FrankelEtAl1996MblgAB1987NSHMP2008, FrankelEtAl1996MblgJ1996NSHMP2008, FrankelEtAl1996MwNSHMP2008.

class openquake.hazardlib.gsim.frankel_1996.FrankelEtAl1996MblgAB1987NSHMP2008(**kwargs)

Bases: GMPE

Implements GMPE developed by Arthur Frankel et al. and documented in “National Seismic-Hazard Maps: Documentation June 1996” (USGS - Open File Report 96-532) available at: http://earthquake.usgs.gov/hazards/products/conterminous/1996/documentation/ofr96-532.pdf

The GMPE is used by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 central and eastern US hazard model.

This class replicates the algorithm as implemented in subroutine getFEA in the hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

The GMPE is defined by a set of lookup tables (see Appendix A) defined from minimum magnitude Mw=4.4 to maximum magnitude Mw=8.2, and from (hypocentral) distance 10 km to 1000 km. Values outside these range are clipped.

Lookup tables are defined for PGA, and SA at the following periods: 0.1, 0.2, 0.3, 0.5, 1.0, 2.0. The GMPE does not allow for interpolation on unsupported periods.

The class assumes rupture magnitude to be in Mblg scale (given that MFDs for central and eastern US are given in this scale). However lookup tables are defined for Mw. Therefore Mblg is converted to Mw by using Atkinson and Boore 1987 conversion equation.

Coefficients are given for the B/C site conditions.

COEFFS = <CoeffsTable sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components attr:~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust, given that the equations have been derived for central and eastern north America

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is rhypo

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude (Mblg).

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

Raises:

ValueError – if imt is instance of openquake.hazardlib.imt.SA with unsupported period.

kind = 'Mblg87'

class openquake.hazardlib.gsim.frankel_1996.FrankelEtAl1996MblgJ1996NSHMP2008(**kwargs)

Bases: FrankelEtAl1996MblgAB1987NSHMP2008

Extend FrankelEtAl1996MblgAB1987NSHMP2008 but uses Johnston 1996 equation for converting from Mblg to Mw.

kind = 'Mblg96'

class openquake.hazardlib.gsim.frankel_1996.FrankelEtAl1996MwNSHMP2008(**kwargs)

Bases: FrankelEtAl1996MblgAB1987NSHMP2008

Extend FrankelEtAl1996MblgAB1987NSHMP2008 but assumes magnitude to be in Mw scale and therefore no conversion is applied.

kind = 'Mw'

fukushima_tanaka_1990

Module exports :class:’FukushimaTanaka1990’ and :class: ‘FukushimaTanakaSite1990’

class openquake.hazardlib.gsim.fukushima_tanaka_1990.FukushimaTanaka1990(**kwargs)

Bases: GMPE

Implements the PGA GMPE of Fukushima and Tanaka (1990) Fukushima, Y. and Tanaka, T. (1990) A New Attenuation Relation for Peak Horizontal Acceleration of Strong Earthquake Ground Motion in Japan. Bulletin of the Seismological Society of America, 80(4), 757 - 783

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the average horizontal component openquake.hazardlib.const.IMC.GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>})

Supported intensity measure types are peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

The GMPE is derived from shallow earthquakes in California and Japan

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rupture distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

Required site parameters. The GMPE was developed for an ‘’average’’ site conditions. The authors specify that for rock sites the values should be lowered by 40 % and for soil site they should be raised by 40 %. For greatest consistencty the site condition is neglected currently but a site-dependent GMPE may be implemented inside a subclass.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.fukushima_tanaka_1990.FukushimaTanakaSite1990(**kwargs)

Bases: FukushimaTanaka1990

Implements the Fukushima and Tanaka (1990) model correcting for site class. The authors specify that the ground motions should be raised by 40 % on soft soil sites and reduced by 40 % on rock sites. The specific site classification is not known, so it is assumed that in this context “average” site conditions refer to NEHRP C, rock conditions to NEHRP A and B, and soft soil conditions to NEHRP D and E

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Input sites as vs30 although only three classes considered

garcia_2005

Module exports :class:’GarciaEtAl2005SSlab’, :class:’GarciaEtAl2005SSlabVert’

class openquake.hazardlib.gsim.garcia_2005.GarciaEtAl2005SSlab(**kwargs)

Bases: GMPE

Implements GMPE developed by Garcia, D., Singh, S. K., Harraiz, M, Ordaz, M., and Pacheco, J. F. and published in BSSA as:

“Inslab earthquakes of Central Mexico: Peak ground-motion parameters and response spectra”, vol. 95, No. 6, pp. 2272-2282.”

The original formulation predict peak ground acceleration (PGA), in cm/s*s, peak ground velocity PGV (cm/s) and 5% damped pseudo-acceleration response spectra (PSA) in cm/s*s for the geometric average of the maximum component of the two horizontal component of ground motion (see last paragraph of Summary in pag. 2272

The GMPE predicted values for Mexican inslab events and NEHRP B site condition.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 s_t s_r s_e>

Equation coefficients for geometric average of the maximum of the two horizontal components, as described in Table 2 on pp. 2275, but generated from a Fortran implementation code provided by Daniel Garcia (higher precision than in the paper). The original IMT values are defined as frequencies values.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

openquake.hazardlib.const.IMC.GEOMETRIC_MEAN, see Data processing in page 2274.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration. See Table 2 in page 1865

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total See Tables 2 and 3, page 2275.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction intraslab, given that the equations have been derived using Mexican inslab events

REQUIRES_DISTANCES = frozenset({'rhypo', 'rrup'})

Required distance measure is Rrup (closest distance to fault surface for the larger events, Mw > 6.5) or Rhypo (hypocentral distance for the rest (both in kilometers) as explained in page 2274

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and focal depth See equation (1) in pag 2274

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

No site parameters required All data from 51 hard (NEHRP B) sites

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.garcia_2005.GarciaEtAl2005SSlabVert(**kwargs)

Bases: GarciaEtAl2005SSlab

Extend GarciaEtAl2005SSlab

Implements GMPE developed by Garcia, D., Singh, S. K., Harraiz, M, Ordaz, M., and Pacheco, J. F. and published in BSSA as:

“Inslab earthquakes of Central Mexico: Peak ground-motion parameters and r esponse spectra”, vol. 95, No. 6, pp. 2272-2282.”

The original formulation predict peak ground acceleration (PGA), in cm/s*s, peak ground velocity PGV (cm/s) and 5% damped pseudo-acceleration response spectra (PSA) in cm/s*s for the vertical component of ground motion (see last paragraph of Summary in pag. 2272

The GMPE predicted values for Mexican inslab events and NEHRP B site

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 s_t s_r s_e>

Equation coefficients for Vertical Component, as described in Table 3 on pp 2275. The original imt values are defined as frequencies values

geomatrix_1993

Module exports Geomatrix1993SSlabNSHMP2008.

class openquake.hazardlib.gsim.geomatrix_1993.Geomatrix1993SSlabNSHMP2008(**kwargs)

Bases: GMPE

Implements GMPE for subduction intraslab events developed by Geomatrix Consultants, Inc., 1993, “Seismic margin earthquake for the Trojan site: Final unpublished report prepared for Portland General Electric Trojan Nuclear Plant”, Ranier, Oregon.

This class implements the equation as coded in the subroutine getGeom in the hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

Coefficients are given for the B/C site conditions.

COEFFS = <CoeffsTable gc1 gc2 gc3 gc4 gc5>

Coefficient table obtained from coefficient arrays and variables defined in subroutine getGeom in hazgridXnga2.f

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction intraslab

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rrup (closest distance to rupture)

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Required rupture parameters are magnitude and top of rupture depth

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

ghasemi_2009

Module exports :class:’GhasemiEtAl2009’

class openquake.hazardlib.gsim.ghasemi_2009.GhasemiEtAl2009(**kwargs)

Bases: GMPE

Implements the PGA GMPE of H.Ghasemi, M.Zare, Y,Fukushima, K.Koketsu (2009a) An empirical spectral ground-motion model for Iran, J Seismol, 13:499-515, DOI 10.1007/s10950-008-9143-x.

COEFFS = <CoeffsTable a1 a2 a3 a4 a6 a7 sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (GMRotI50)'

Supported intensity measure component is the average horizontal component openquake.hazardlib.const.IMC.GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types is spectral acceleration The attenuation relation developed by Ghasemi et. al estimates only the ‘SA’. Here in this code, the intensity measure of ‘PGA’ is also considered with the same coefficients as SA(0.05 s), in case of need.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

The GMPE is derived from shallow earthquakes in California and Japan

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rupture distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

ghofrani_atkinson_2014

Module exports GhofraniAtkinson2014,

GhofraniAtkinson2014Cascadia, GhofraniAtkinson2014Lower, GhofraniAtkinson2014Upper, GhofraniAtkinson2014CascadiaLower, GhofraniAtkinson2014CascadiaUpper

class openquake.hazardlib.gsim.ghofrani_atkinson_2014.GhofraniAtkinson2014(**kwargs)

Bases: GMPE

Implements the Subduction Interface GMPE of Ghofrani & Atkinson (2014) for large magnitude earthquakes, based on the Tohoku records. Ghofrani, H. and Atkinson, G. M. (2014) Ground Motion Prediction Equations for Interface Earthquakes of M7 to M9 based on Empirical Data from Japan. Bulletin of Earthquake Engineering, 12, 549 - 571

COEFFS = <CoeffsTable c0 a b c1 c2 c3 sig_init af sigma tau sig_tot>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is assumed to be geometric mean

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are peak ground acceleration, peak ground velocity and spectral acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

The GMPE is derived for subduction interface earthquakes in Japan

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rupture distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'backarc', 'vs30'})

The GMPE provides a Vs30-dependent site scaling term and a forearc/ backarc attenuation term

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.ghofrani_atkinson_2014.GhofraniAtkinson2014Cascadia(**kwargs)

Bases: GhofraniAtkinson2014

Implements the Subduction Interface GMPE of Ghofrani & Atkinson (2014) adapted for application to Cascadia

kind = 'cascadia'

class openquake.hazardlib.gsim.ghofrani_atkinson_2014.GhofraniAtkinson2014CascadiaLower(**kwargs)

Bases: GhofraniAtkinson2014

Implements the Subduction Interface GMPE of Ghofrani & Atkinson (2014) with the “lower” epistemic uncertainty model and the Cascadia correction term.

kind = 'cascadia_lower'

class openquake.hazardlib.gsim.ghofrani_atkinson_2014.GhofraniAtkinson2014CascadiaUpper(**kwargs)

Bases: GhofraniAtkinson2014

Implements the Subduction Interface GMPE of Ghofrani & Atkinson (2014) with the “upper” epistemic uncertainty model and the Cascadia correction term.

kind = 'cascadia_upper'

class openquake.hazardlib.gsim.ghofrani_atkinson_2014.GhofraniAtkinson2014Lower(**kwargs)

Bases: GhofraniAtkinson2014

Implements the Subduction Interface GMPE of Ghofrani & Atkinson (2014) with the “lower” epistemic uncertainty model

kind = 'lower'

class openquake.hazardlib.gsim.ghofrani_atkinson_2014.GhofraniAtkinson2014Upper(**kwargs)

Bases: GhofraniAtkinson2014

Implements the Subduction Interface GMPE of Ghofrani & Atkinson (2014) with the “upper” epistemic uncertainty model

kind = 'upper'

gmpe_table

Module openquake.hazardlib.gsim.gmpe_table defines the openquake.hazardlib.gsim.gmpe_table.GMPETable for defining GMPEs in the form of binary tables

class openquake.hazardlib.gsim.gmpe_table.GMPETable(**kwargs)

Bases: GMPE

Implements ground motion prediction equations in the form of a table from which the expected ground motion intensity levels and standard deviations are interpolated.

In a GMPE tables the expected ground motions for each of the IMTs over the range of magnitudes and distances are stored in an hdf5 file on the path specified by the user.

In this version of the GMPE the expected values are interpolated to the required IMT, magnitude and distance in three stages.

1. Initially the correct IMT values are identified, interpolating in log-T|log-IML space between neighbouring spectral periods.

2. The IML values are then interpolated to the correct magnitude using linear-M|log-IML space

3. The IML values are then interpolated to the correct distance via linear-D|linear-IML interpolation

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = ''

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({})

REQUIRES_DISTANCES is set at the instance level

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

gmpe_table = None

kind = 'base'

set_tables(mags, imts)

Parameters:

• mags – a list of magnitudes as strings

• imts – a list of IMTs as strings

Set the .mean_table and .sig_table attributes

openquake.hazardlib.gsim.gmpe_table.todict(hdfgroup)

Convert an hdf5 group contains only data sets to a dictionary of data sets

Parameters:

hdfgroup – Instance of h5py.Group

Returns:

Dictionary containing each of the datasets within the group arranged by name

gulerce_abrahamson_2011

Module exports GulerceAbrahamson2011

openquake.hazardlib.gsim.gulerce_abrahamson_2011.CONSTS = {'a3': 0.0147, 'a4': 0.0334, 'a5': -0.034, 'c': 1.88, 'c1': 6.75, 'c4': 10.0, 'n': 1.18}

equation constants (that are IMT independent)

class openquake.hazardlib.gsim.gulerce_abrahamson_2011.GulerceAbrahamson2011(**kwargs)

Bases: GMPE

Implements the GMPE by Gulerce & Abrahamson (2011) for the vertical-to-horizontal (V/H) ratio model derived using ground motions from the PEER NGA-West1 Project.

Developing of the vertical spectra is applicable only to nonlinear horizontal ground-motion models.

This model follows the same functional form as in AS08 by Abrahamson & Silva (2008) with minor modifications to the underlying parameters.

Reference:

Gulerce, Z. & Abrahamson, N. (2011), “Site-Specific Design Spectra for Vertical Ground Motion”, Earthquake Spectra, 27(4), 1023-1047.

COEFFS = <CoeffsTable VLIN b a1 a2 a6 a7 a8 a10 s1 s2 s3 s4>

Coefficients obtained from Table 3, page 1030 Note the atypical periods 0.029 s and 0.260 s used.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical-to-Horizontal Ratio'

Supported intensity measure component is the VERTICAL_TO_HORIZONTAL_RATIO

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are peak ground acceleration, peak ground velocity, and spectral acceleration at T=0.01 to 10.0 s; see Table 3, page 1030

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total; see Equations 7 to 9, page 1029.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, as part of the NGA-West1 Database; re-defined here for clarity.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup; see the section for “Functional Form of the Model”, Equation 1.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, rake; see section for “Functional Form of the Model”, Equation 6.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30 only. Unlike in AS08, the nonlinear site response and Z1.0 scaling is not available for the vertical component; see section for “Functional Form of the Model”, Equation 3.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

Verification of mean value data was done by digitizing Figures 7 to 10 using https://apps.automeris.io/wpd/ . Only SA is covered.

gulerce_2017

Module exports GulerceEtAl2017

GulerceEtAl2017RegTWN GulerceEtAl2017RegITA GulerceEtAl2017RegMID GulerceEtAl2017RegCHN GulerceEtAl2017RegJPN

openquake.hazardlib.gsim.gulerce_2017.CONSTS = {'h1': 0.25, 'h2': 1.5, 'h3': -0.75, 'm1': 6.75, 'm2': 5.5}

equation constants (that are IMT independent)

class openquake.hazardlib.gsim.gulerce_2017.GulerceEtAl2017(**kwargs)

Bases: GMPE

Implements the GKAS16 GMPE by Gulerce et al. (2017) for vertical-component ground motions from the PEER NGA-West2 Project.

This model follows the same functional form as in ASK14 by Abrahamson et al. (2014) with minor modifications to the underlying parameters.

Note that this is a more updated version than the GMPE described in the original PEER Report 2013/24.

Reference:

Gulerce, Z., Kamai, R., Abrahamson, N., & Silva, W. (2017) “Ground Motion Prediction Equations for the Vertical Ground Motion Component Based on the NGA-W2 Database”, Earthquake Spectra, 33(2), 499-528.

COEFFS = <CoeffsTable vlin c c4 a1 a2 a3 a4 a5 a6 a8 a10 a11 a12 a13 a14 a15 a17 a25 a26 a27 a28 a29 a31 a35 s1 s2_all s3 s4_all s2_noJP s4_noJP>

Coefficients obtained from Tables 1a, 1b, 2, and 3 in Gulerce et al. (2017). This coefficient table is also provided in a free supplementary material distributed by the authors.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical'

Supported intensity measure component is the Vertical direction component; see title.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function SA>})

Supported intensity measure type is spectral acceleration at T=0.01 to 10.0 s; see Tables 1a and 1b.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total; see the section for “Equations for Standard Deviation”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, as part of the NGA-West2 Database; re-defined here for clarity.

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx', 'ry0'})

Required distance measures are Rrup, Rjb, Ry0 and Rx; see the section for “Functional Form of the Model”.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'width', 'ztor'})

Required rupture parameters are magnitude, rake, dip, ztor, and width; see the section for “Functional Form of the Model”.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30 only. Unlike in ASK14, the nonlinear site response and Z1.0 scaling is not incorporated; see the section for “Site Amplification Effects”.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

region = 'CAL'

class openquake.hazardlib.gsim.gulerce_2017.GulerceEtAl2017RegCHN(**kwargs)

Bases: GulerceEtAl2017

Implements the GKAS16 GMPE by Gulerce et al. (2017) for vertical-component ground motions from the PEER NGA-West2 Project.

Regional corrections for China

region = 'CHN'

class openquake.hazardlib.gsim.gulerce_2017.GulerceEtAl2017RegITA(**kwargs)

Bases: GulerceEtAl2017

Implements the GKAS16 GMPE by Gulerce et al. (2017) for vertical-component ground motions from the PEER NGA-West2 Project.

Regional corrections for Italy

region = 'ITA'

class openquake.hazardlib.gsim.gulerce_2017.GulerceEtAl2017RegJPN(**kwargs)

Bases: GulerceEtAl2017

Implements the GKAS16 GMPE by Gulerce et al. (2017) for vertical-component ground motions from the PEER NGA-West2 Project.

Regional corrections for Japan

region = 'JPN'

class openquake.hazardlib.gsim.gulerce_2017.GulerceEtAl2017RegMID(**kwargs)

Bases: GulerceEtAl2017

Implements the GKAS16 GMPE by Gulerce et al. (2017) for vertical-component ground motions from the PEER NGA-West2 Project.

Regional corrections for Middle East

region = 'MID'

class openquake.hazardlib.gsim.gulerce_2017.GulerceEtAl2017RegTWN(**kwargs)

Bases: GulerceEtAl2017

Implements the GKAS16 GMPE by Gulerce et al. (2017) for vertical-component ground motions from the PEER NGA-West2 Project.

Regional corrections for Taiwan

region = 'TWN'

gupta_2010

Module openquake.hazardlib.gsim.gupta_2010 exports Gupta2010SSlab

class openquake.hazardlib.gsim.gupta_2010.Gupta2010SSlab(**kwargs)

Bases: AtkinsonBoore2003SSlab

Implements GMPE of Gupta (2010) for Indo-Burmese intraslab subduction.

This model is closely related to the model of Atkinson & Boore (2003). In particular the functional form and coefficients C2-C7 of Gupta (2010) are adopted from Atkinson & Boore (2003). The only substantive changes are a) the horizontal component modeled is different (as noted below) b) a coefficient C8 and a dummy variable v are added to model vertical motion and c) the coefficient C1 is recalculated based on a database of “a total of 56 three-component accelerograms at 37 different sites from three in-slab earthquakes along the Indo-Burmese subduction zone” (p 370).

Equation (2) p. 373 gives the form of the equation which was fitted:

log Y - C2*M - C3*h - C4*R + g log R = C1 + C8*v + sigma

The left-hand side of this equation was computed using event parameters and the coefficients of Atkinson & Boore (2003). The regression coefficients C1 and C8 on the right-hand side were slightly smoothed after fitting. Note that since “v=0 for horizontal and 1 for vertical motion”, and since the current implementation only models horizontal motion, we can subclass directly from openquake.hazardlib.gsim.atkinson_boore_2003.AtkinsonBoore2003SSlab, modifying only the metadata constants and regression coefficients.

Page number citations in this documentation refer to Gupta (2010).

References

Gupta, I. (2010). Response spectral attenuation relations for in-slab earthquakes in Indo-Burmese subduction zone. Soil Dyn. Earthq. Eng., 30(5):368–377.

Atkinson, G. M. and Boore, D. M. (2003). Empirical ground-motion relations for subduction-zone earthquakes and their application to Cascadia and other regions. Bull. Seism. Soc. Am., 93(4):1703–1729.

COEFFS_SSLAB = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 sigma>

Coefficients taken from Table 3, p. 884. The row for 0.02 was relabeled PGA since the paper indicates this is what it actually is (see p. 371) and since these were the coefficients for PGA in Atkinson & Boore (2003).

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Unlike Atkinson & Boore (2003), “rather than the random horizontal component, the geometric mean of both the horizontal components has been used in the modified attenuation relations.” (p. 376)

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

“The actual peak ground acceleration (PGA) from the corrected time histories are taken as the response spectral amplitudes at a period of 0.02 s (50 Hz frequency).” p. 371. Based on this comment, the coefficients labeled as being for 0.02 s have been relabeld as PGA.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Since the database is small only the total standard deviation is reported.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

As stated in the title.

non_verified = True

Mean value data obtained from author matched well at 1 s and below but not at longer periods. As a temporary measure the reference test result has been generated from the current implementation.

hassani_atkinson_2018

Module exports HassaniAtkinson2018

class openquake.hazardlib.gsim.hassani_atkinson_2018.HassaniAtkinson2018(**kwargs)

Bases: GMPE

Implements the model of Hassani and Atkinson (2018) as described in the BSSA paper titled “Adjustable Generic Ground-Motion Prediction Equation Based on Equivalent Point-Source Simulations: Accounting for Kappa Effects” (doi: 10.1785/0120170333).

Parameters:

• d_sigma – Stress frop [bar]

• kappa0 – Kappa_0 [s]

• gamma_fle – The name of the file containing the anelastic attenuation term.

COEFFS = <CoeffsTable Mh e0 e1 e2 e3 b3 b4 g1_0 g1_1 g1_2 g1_3 g1_4 g2_0 g2_1 g2_2 g2_3 g2_4 d1_0_0 d1_0_1 d1_0_2 d1_1_0 d1_1_1 d1_1_2 d1_2_0 d1_2_1 d1_2_2 d1_3_0 d1_3_1 d1_3_2 d2_0_0 d2_0_1 d2_0_2 d2_1_0 d2_1_1 d2_1_2 d2_2_0 d2_2_1 d2_2_2 d2_3_0 d2_3_1 d2_3_2 d3_0_0 d3_0_1 d3_0_2 d3_1_0 d3_1_1 d3_1_2 d3_2_0 d3_2_1 d3_2_2 d3_3_0 d3_3_1 d3_3_2 d4_0_0 d4_0_1 d4_0_2 d4_1_0 d4_1_1 d4_1_2 d4_2_0 d4_2_1 d4_2_2 d4_3_0 d4_3_1 d4_3_2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is orientation-independent average horizontal RotD50, see page 1025.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see tables 4 pages 1036

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types are inter-event, intra-event and total, see paragraph “Equations for standard deviations”, page 1046.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see title!

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measures is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and hypocenter depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

Compute mean

openquake.hazardlib.gsim.hassani_atkinson_2018.get_gm_rock(C, ctx, kappa0, d_sigma, CAE)

Compute ground-motion on bedrock

hassani_atkinson_2020

Module exports HassaniAtkinson2020SInter

HassaniAtkinson2020SSlab HassaniAtkinson2020Asc

class openquake.hazardlib.gsim.hassani_atkinson_2020.HassaniAtkinson2020Asc(**kwargs)

Bases: HassaniAtkinson2020SInter

Hassani Atkinson (2020) for Crustal.

CONST_REGION = {'cc': 0.45, 'cd0': 2.5011, 'cd1': 0, 'dp0': 0, 'dp1': 30, 'rt': 50}

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

SUFFIX = '_cr'

class openquake.hazardlib.gsim.hassani_atkinson_2020.HassaniAtkinson2020SInter(**kwargs)

Bases: GMPE

Hassani Atkinson (2020) for Subduction Interface.

COEFFS = <CoeffsTable f amp_cr b3 b4 chf clf0_if clf1_if clf0_is clf1_is clf0_cr clf1_cr cv1 cv2 cz0 cz1 cz2 barc_if farc_ne_if farc_sw_if barc_is farc_ne_is farc_sw_is barc_cr farc_ne_cr farc_sw_cr d000 d001 d002 d010 d011 d012 d020 d021 d022 d030 d031 d032 d100 d101 d102 d110 d111 d112 d120 d121 d122 d130 d131 d132 d200 d201 d202 d210 d211 d212 d220 d221 d222 d230 d231 d232 d300 d301 d302 d310 d311 d312 d320 d321 d322 d330 d331 d332 mh e0 e1 e2 e3 f4 f5 g10 g11 g12 g13 g14 g20 g21 g22 g23 g24 tau ps2s pss_if pss_is pss_cr s_if s_is s_cr>

CONST_REGION = {'cc': 0.85, 'cd0': 1.606, 'cd1': 0.0097, 'dp0': 25, 'dp1': 55, 'rt': 150}

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground acceleration and peak ground velocity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_ATTRIBUTES = frozenset({'backarc', 'forearc_ne', 'forearc_sw', 'kappa'})

Set of required GSIM attributes

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distances

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({'f0', 'vs30', 'z2pt5'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

SUFFIX = '_if'

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

gmpe_table = None

class openquake.hazardlib.gsim.hassani_atkinson_2020.HassaniAtkinson2020SSlab(**kwargs)

Bases: HassaniAtkinson2020SInter

Hassani Atkinson (2020) for Subduction IntraSlab.

CONST_REGION = {'cc': 0.9, 'cd0': 1.9241, 'cd1': 0.0133, 'dp0': 40, 'dp1': 90, 'rt': 250}

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

SUFFIX = '_is'

openquake.hazardlib.gsim.hassani_atkinson_2020.get_stddevs(suffix, C)

Between event standard deviations as tau. Intra event from site to site stddev and within site stddev. Total given in COEFFS to 3dp.

hong_goda_2007

module exports HongGoda2007RotD100.

class openquake.hazardlib.gsim.hong_goda_2007.HongGoda2007(**kwargs)

Bases: GMPE

Implements GMPE developed for RotD100 ground motion as defined by Hong, H. P. and Goda, K. (2007), “Orientation-Dependent Ground Motion Measure for Seismic Hazard Assessment”, Bull. Seism. Soc. Am. 97(5), 1525 - 1538

This is really an experimental GMPE in which the amplification term is taken directly from Atkinson & Boore (2006) rather than constrained by the records themselves. There may exist a possible units issue as the amplification function for AB2006 is in cm/s/s whereas the GMPE here is given in g

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 h sig1 sig2 sigtot>

COEFFS_AMP = <CoeffsTable blin b1sa b2sa>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal Maximum Direction (RotD100)'

The supported intensity measure component is RotD100

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

The supported intensity measure types are PGA, PGV, and SA

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

The supported standard deviations are total, inter and intra event, see table 4.a, pages 22-23

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

The supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rjb'})

The required distance parameter is ‘Joyner-Boore’ distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

The required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

The required site parameter is vs30, see equation 1, page 20.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

Implements equation 14 of Hong & Goda (2007)

non_verified = True

GMPE not tested against independent implementation

idini_2017

Module exports IdiniEtAl2017SInter

IdiniEtAl2017SSlab

class openquake.hazardlib.gsim.idini_2017.IdiniEtAl2017SInter(**kwargs)

Bases: GMPE

Implements the GMPE developed by Idini et al. (2017) for subduction interface earthquakes, publised as:

Idini, B., F. Rojas, S. Ruiz, and C. Pastén. 2017. “Ground motion prediction equations for the Chilean subduction zone.” Bull. Earthq. Eng. 15(5): 1853–1880.

COEFFS = <CoeffsTable c1 c2 c9 c8 dc1 dc2 sigma_e sigma_t c3 c5 dc3 sigma_r s2 s3 s4 s5 s6>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rhypo', 'rrup'})

Required distance measure is closest distance to rupture, for interface events M>=7.7, and hypocentral distance for interface events M<7.7

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'soiltype', 'vs30'})

Site amplification is dependent on the Site Class and Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.idini_2017.IdiniEtAl2017SSlab(**kwargs)

Bases: IdiniEtAl2017SInter

Implements the GMPE developed by Idini et al. (2017) for subduction inslab (intraslab) earthquakes, publised as:

Idini, B., F. Rojas, S. Ruiz, and C. Pastén. 2017. “Ground motion prediction equations for the Chilean subduction zone.” Bull. Earthq. Eng. 15(5): 1853–1880.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are only magnitude for the interface model

idriss_2014

Module exports Idriss2014,

class openquake.hazardlib.gsim.idriss_2014.Idriss2014(**kwargs)

Bases: GMPE

Implements GMPE developed by Idriss 2014 and published as “An NGA-West2 Empirical Model for Estimating the Horizontal Spectral Values Generated by Shallow Crustal Earthquakes. (2014, Earthquake Spectra, Volume 30, No. 3, pages 1155 - 1177).

Idriss (2014) defines the GMPE only for the case in which Vs30 >= 450 m/s. In the present implementation no check is made for the use of this model for ctx with Vs30 < 450 m/s

COEFFS = <CoeffsTable a1_lo a2_lo b1_lo b2_lo a1_hi a2_hi b1_hi b2_hi a3 xi gamma phi>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 2000

The reference Vs30. See paper.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types are total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

jaimes_2020

Module exports :class:’JaimesEtAl2020SSlab’,

:class:’JaimesEtAl2020SSlabVert’, :class:’JaimesEtAl2020SSlabVHratio’

class openquake.hazardlib.gsim.jaimes_2020.JaimesEtAl2020SSlab(**kwargs)

Bases: GMPE

Implements GMPE developed by Jaimes et al. (2020) for Mexican intermediate-depth intraslab earthquake and published as:

Jaimes M. A., García-Soto A. D. (2020) “Updated ground motion prediction model for Mexican intermediate-depth intraslab earthquakes including V/H ratios” Earthq. Spectra, 36(3):1298-1330. doi:10.1177/8755293019899947.

The original formulation predict peak ground acceleration, PGA (cm/s**2), peak ground velocity, PGV (cm/s), and 5% damped pseudo-acceleration response spectra, PSA (cm/s**2), for the quadratic mean of the two horizontal component of ground motion (see the ‘Regression Analysis’ section on page 1304).

The GMPE predicted values for Mexican intraslab events at rock sites (NEHRP B site condition).

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 s_b s_w s_t>

Regression coefficients for geometric average of the maximum of the two horizontal components, as described in Table 2, page 1306.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are peak ground acceleration, peak ground velocity and spectral acceleration. See Table 2 in page 1306.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total. See Table 2, page 1306.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction intraslab, given that the equations have been derived using Mexican intraslab events.

REQUIRES_DISTANCES = frozenset({'rhypo', 'rrup'})

Required distance measure is Rrup (closest distance to fault surface) for large events (Mw>6.5) or Rhypo (hypocentral distance) for the rest, both in kilometers, as explained in page 1304

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameter is the magnitude and focal depth See equation 1 in page 1304

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.jaimes_2020.JaimesEtAl2020SSlabVHratio(**kwargs)

Bases: JaimesEtAl2020SSlab

Extend :class:’JaimesEtAl2020SSlab’

Implements GMPE developed by Jaimes et al. (2020) for Mexican intermediate-depth intraslab earthquake and published as:

Jaimes M. A., García-Soto A. D. (2020) “Updated ground motion prediction model for Mexican intermediate-depth intraslab earthquakes including V/H ratios” Earthq. Spectra, 36(3):1298-1330. doi:10.1177/8755293019899947.

The original formulation predict peak ground acceleration, PGA (cm/s**2), peak ground velocity, PGV (cm/s), and 5% damped pseudo-acceleration response spectra, PSA (cm/s**2), for the V/H ratio (see the ‘Regression Analysis’ section on page 1304).

The GMPE predicted values for Mexican intraslab events at rock sites (NEHRP B site condition).

COEFFS = <CoeffsTable c1 c2 c3 s_t rho_b rho_w sh_b sh_w sv_b sv_w>

Regression coefficients for geometric average of the maximum of the two horizontal components, as described in Table 2, page 1306.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical-to-Horizontal Ratio'

Supported intensity measure component is the V/H ratio.

class openquake.hazardlib.gsim.jaimes_2020.JaimesEtAl2020SSlabVert(**kwargs)

Bases: JaimesEtAl2020SSlab

Extend :class:’JaimesEtAl2020SSlab’

Implements GMPE developed by Jaimes et al. (2020) for Mexican intermediate-depth intraslab earthquake and published as:

Jaimes M. A., García-Soto A. D. (2020) “Updated ground motion prediction model for Mexican intermediate-depth intraslab earthquakes including V/H ratios” Earthq. Spectra, 36(3):1298-1330. doi:10.1177/8755293019899947.

The original formulation predict peak ground acceleration, PGA (cm/s**2), peak ground velocity, PGV (cm/s), and 5% damped pseudo-acceleration response spectra, PSA (cm/s**2), for the vertical component of ground motion (see the ‘Regression Analysis’ section on page 1304).

The GMPE predicted values for Mexican intraslab events at rock sites (NEHRP B site condition).

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 s_b s_w s_t>

Regression coefficients for vertical component, as described in Table 3, page 1307.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical'

Supported intensity measure component is the vertical component.

kale_2015

Module exports KaleEtAl2015Turkey

KaleEtAl2015Iran.

class openquake.hazardlib.gsim.kale_2015.KaleEtAl2015Iran(**kwargs)

Bases: KaleEtAl2015Turkey

Implements GMPE developed by O. Kale, S. Akkar, A. Ansari and H. Hamzehloo as published in “A ground-motion predictive model for Iran and Turkey for horizontal PGA, PGV and 5%-damped response spectrum: Investigation of possible regional effects”, Bulletin of the Seismological Society of America (2015), 105(2A): 963 - 980. The class implements the equations for Joyner-Boore distance and based on manuscript provided by the original authors.

Version calibrated for the Iran case

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 b7 b8 b9 b10 a1 a2 sd1 sd2 sb1 sb2>

Coefficient tables obtained by joining tables 2, 3, 4, 5 and electronic supplementary

CONSTS = {'Vcon': 1000.0, 'Vref': 750.0, 'c': 2.5, 'c1': 7.0, 'n': 3.2}

equation constants (that are IMT independent)

class openquake.hazardlib.gsim.kale_2015.KaleEtAl2015Turkey(**kwargs)

Bases: GMPE

Implements GMPE developed by O. Kale, S. Akkar, A. Ansari and H. Hamzehloo as published in “A ground-motion predictive model for Iran and Turkey for horizontal PGA, PGV and 5%-damped response spectrum: Investigation of possible regional effects”, Bulletin of the Seismological Society of America (2015), 105(2A): 963 - 980. The class implements the equations for Joyner-Boore distance and based on manuscript provided by the original authors.

Version calibrated for the Turkey case

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 b7 b8 b9 b10 a1 a2 sd1 sd2 sb1 sb2>

Coefficient tables obtained by joining tables 2, 3, 4, 5 and electronic supplementary

CONSTS = {'Vcon': 1000.0, 'Vref': 750.0, 'c': 2.5, 'c1': 6.75, 'n': 3.2}

equation constants (that are IMT independent)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

The supported intensity measure component is ‘geometric mean’, see section ‘Functional Form of the GMPEs and Regression Analyses’, page 970

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

The supported intensity measure types are PGA, PGV, and SA, see table 5, page 973

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

The supported standard deviations are total, inter and intra event, see table 3 and equations 8 & 9, pages 972 and 971

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

The supported tectonic region type is active shallow crust.

REQUIRES_DISTANCES = frozenset({'rjb'})

The required distance parameter is ‘Joyner-Boore’ distance, see equation 3, page 970.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

The required rupture parameters are rake and magnitude, see equations 2 and 4, page 970.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

The required site parameter is vs30, see equation 6, page 970.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

Implement equation 1, page 970.

kanno_2006

Module openquake.hazardlib.gsim.kanno_2006 exports Kanno2006Shallow Kanno2006Deep

openquake.hazardlib.gsim.kanno_2006.CONSTS = {'e': 0.5}

“coefficient e_1 = 0.5 was selected for all periods in the present study.” (p. 881)

class openquake.hazardlib.gsim.kanno_2006.Kanno2006Deep(**kwargs)

Bases: Kanno2006Shallow

Implements GMPE of Kanno et al. (2006) for deep events based on data predominantly from Japan.

Deep events are defined as having “(focal depth of more than 30 km)” (p. 895).

COEFFS_BASE = <CoeffsTable a b c d epsilon>

Coefficients obtained from author via personal communcation with slightly more precision than Table 4, p. 884.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Although “only a slight difference can be seen between [shallow] crustal and subduction interface earthquakes … the focal depth of the two types of events is comparatively shallower than that of slab events.” (p. 881)

class openquake.hazardlib.gsim.kanno_2006.Kanno2006Shallow(**kwargs)

Bases: GMPE

Implements GMPE of Kanno et al. (2006) for shallow events based on data predominantly from Japan.

Note that “both crustal and subduction interface events fall into the category of shallow events” (p. 883) where “shallow” is defined as “focal depth of 30 km or less” (p. 895).

Verification of mean value data was performed against a test vector kindly provided by the lead author.

Reference

Page number citations in this documentation refer to:

Kanno, T., Narita, A., Morikawa, N., Fujiwara, H., and Fukushima, Y. (2006). A new attenuation relation for strong ground motion in Japan based on recorded data. Bull. Seism. Soc. Am. 96(3):879–897.

COEFFS_BASE = <CoeffsTable a b c d epsilon>

Coefficients obtained from author via personal communcation with slightly more precision than Table 3, p. 884.

COEFFS_SITE = <CoeffsTable p q>

Coefficients obtained from author via personal communcation with slightly more precision Table 5, p. 888.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Peak square root of sum of squares of horizontals'

“The peak value is the peak square root of the sum of squares of two orthogonal horizontal components in the time domain” (p. 880)

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

“regression coefficients for the base model in equations (5) and (6) for PGA , PGV , and 5% damped response spectral acceleration are given” (p. 883)

DEFINED_FOR_REFERENCE_VELOCITY = 800

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Although interevent and intraevent residuals are separately discussed in the context of focal depth and site conditions, only the total standard deviation is tabulated.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

This model is generally considered to be intended for subduction regions, but the authors do not constrain the type of event, only the depth: “both crustal and subduction interface events fall into the category of shallow events.” (p. 883)

REQUIRES_DISTANCES = frozenset({'rrup'})

“The source distance is the closest distance from a fault plane to the observation site and is the hypocentral distance in the case of earthquakes for which the fault model is not available.” (p. 880)

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Sole required rupture parameter is magnitude; faulting style is not addressed.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

“Coefficients p and q were derived by regression analysis on the residuals averaged at intervals of every 100 m/sec in AVS30.” (p. 884)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for specification of input and result values.

Implements the following equations:

Equation (5) on p. 881 predicts ground motion for shallow events (depth <= 30 km):

log(pre) = a*M + b*X - log(X + d*10^(e*M)) + c + epsilon

“where pre is the predicted PGA (cm/sec^2), PGV (cm/sec), or 5% damped response spectral acceleration (cm/sec^2)” (p. 883) and a, b, c and d are tabulated regression coefficients. Note that subscripts on the regression coeffients have been dropped - subscript 1 denoted “shallow” while subscript 2 denoted “deep” - so that the “deep” model of equation (6) can be implemented trivally by changing coefficients and setting d = 0.

Equation (8) on p. 883 gives the model used for site amplitfication:

G = p*log(VS30) + q

Where p and q are tabulated regression coefficients.

Equation (9) on p. 884 for the ground motion at a given site:

log(pre_G) = log(pre) + G

No adjustment of epsilon is made as a function of VS30.

Note finally that “log represents log_10 in the present study” (p. 880).

kuehn_2020

Module exports KuehnEtAl2020SInter,

KuehnEtAl2020SInterAlaska, KuehnEtAl2020SInterCascadia, KuehnEtAl2020SInterCentralAmericaMexico, KuehnEtAl2020SInterJapan, KuehnEtAl2020SInterNewZealand, KuehnEtAl2020SInterSouthAmerica, KuehnEtAl2020SInterTaiwan, KuehnEtAl2020SSlab, KuehnEtAl2020SSlabAlaska, KuehnEtAl2020SSlabCascadia KuehnEtAl2020SSlabCentralAmericaMexico, KuehnEtAl2020SSlabJapan, KuehnEtAl2020SSlabNewZealand, KuehnEtAl2020SSlabSouthAmerica, KuehnEtAl2020SSlabTaiwan

class openquake.hazardlib.gsim.kuehn_2020.KuehnEtAl2020SInter(**kwargs)

Bases: GMPE

Implements the NGA Subduction model of Kuehn et al. (2020) for subduction interface events.

Kuehn N, Bozorgnia Y, Campbell KW ad Gregor N (2021) “Partially Non-Ergodic Ground-Motion Model for Subduction Regions using the NGA-Subduction Database”, PEER Technical Report 2020/04, Pacific Earthquake Engineering Research Center (PEER)

The GMM define a “global” model as well as a set of region-specific coefficients (and in some cases methods). The coefficients are defined for seven specific subduction regions (with their region codes):

• Alaska (USA-AK)

• Cascadia (CAS)

• Central America & Mexico (CAM)

• Japan (JPN)

• New Zealand (NZL)

• South America (SAM)

• Taiwan (TWN)

In the original model defined by the authors, three of the regions (JPN, CAM, SAM) define a forearc/backarc dependent anelastic attenuation term. To implement this one needs to define the travel distance through each of the attenuation subregions. As of July 2021 this property is not supported by the OQ-engine, so on the author’s guidance a fixed anelastic attenuation term is used in these regions

For four of the regions (JPN, CAS, NZL, TWN) a basin response term is defined. In these cases either Z2.5 (JPN, CAS) or Z1.0 (NZL, TWN) must be specified.

Two forms of configurable epistemic uncertainty adjustments are supported:

m_b: The magnitude scaling breakpoint. This term is defined for each region

and tectonic region type, but this can also be over-ridden by the user

sigma_mu_epsilon: Within-model epistemic uncertainty (sigma_mu) is

described in Chapter 6 of the report by the authors. This uncertainty is region specific and is described by a magnitude- and distance-dependent standard deviation. The term “sigma_mu_epsilon” defines the number of standard deviations above or below the median by which to scale the mean ground motion within a backbone logic tree context. The scenario and period specific sigma_mu values are read in from hdf5 binary files and interpolated to the magnitude and distances required

COEFFS = <CoeffsTable dm_b mu_c_1_if mu_c_1_slab c_2_if c_2_slab c_3 c_4_if c_4_slab c_5 mu_c_6 mu_c_6b mu_c_7 c_9_if c_9_slab c_6xc c_1_if_reg_Al c_1_if_reg_Ca c_1_if_reg_CAM c_1_if_reg_Ja c_1_if_reg_NZ c_1_if_reg_SA c_1_if_reg_Tw c_1_slab_reg_Al c_1_slab_reg_Ca c_1_slab_reg_CAM c_1_slab_reg_Ja c_1_slab_reg_NZ c_1_slab_reg_SA c_1_slab_reg_Tw c_7_reg_Al c_7_reg_Ca c_7_reg_CAM c_7_reg_Ja c_7_reg_NZ c_7_reg_SA c_7_reg_Tw c_6_x1_reg_Al c_6_x1_reg_Ca c_6_x1_reg_CAM c_6_x1_reg_Ja c_6_x1_reg_NZ c_6_x1_reg_SA c_6_x1_reg_Tw c_6_x2_reg_Al c_6_x2_reg_Ca c_6_x2_reg_CAM c_6_x2_reg_Ja c_6_x2_reg_NZ c_6_x2_reg_SA c_6_x2_reg_Tw c_6_x3_reg_Al c_6_x3_reg_Ca c_6_x3_reg_CAM c_6_x3_reg_Ja c_6_x3_reg_NZ c_6_x3_reg_SA c_6_x3_reg_Tw c_6_1_reg_Al c_6_1_reg_Ca c_6_1_reg_CAM c_6_1_reg_Ja c_6_1_reg_NZ c_6_1_reg_SA c_6_1_reg_Tw c_6_2_reg_Al c_6_2_reg_Ca c_6_2_reg_CAM c_6_2_reg_Ja c_6_2_reg_NZ c_6_2_reg_SA c_6_2_reg_Tw c_6_3_reg_Al c_6_3_reg_Ca c_6_3_reg_CAM c_6_3_reg_Ja c_6_3_reg_NZ c_6_3_reg_SA c_6_3_reg_Tw dz_b_if dz_b_slab c_nft_1 c_nft_2 c_11_Ca c_12_Ca theta_11_Sea c_11_Ja c_12_Ja c_11_NZ c_12_NZ c_11_Tw c_12_Tw k1 k2 phi tau>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent average horizontal RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 1100.0

Defined for a reference velocity of 1100 m/s

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see section “Aleatory Variability Model”, page 1094.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Required rupture parameters are magnitude and depth-to-top-of-rupture

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters are Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

experimental = True

f = <_io.TextIOWrapper name='/home/runner/work/oq-engine/oq-engine/openquake/hazardlib/gsim/kuehn_2020_coeffs.csv' mode='r' encoding='UTF-8'>

class openquake.hazardlib.gsim.kuehn_2020.KuehnEtAl2020SSlab(**kwargs)

Bases: KuehnEtAl2020SInter

Implements NGA Subduction model of Kuehn et al. (2020) for Intraslab events

This class implements the global model. Adjustments with respect to the interface model are:

• different constant

• different magnitude scaling coefficent

• different geometrical spreading coefficient

• no magnitude break adjustment at long periods

• different depth scaling and adjustment to break point

• different depth centering and break point

• different default magnitude break point

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction in-slab

openquake.hazardlib.gsim.kuehn_2020.get_anelastic_attenuation_term(C, trt, region, rrup)

Returns the regionalised anelastic attenuation term described in equation 4.9.

Note that in the full implementation the anelastic attenuation terms for the Japan, Central America & Mexico, and South America regions contain multiple coefficients based on path distance through each sub-region. This is not yet supported in OpenQuake, so in the present case the c6,2 coefficient is adopted for all regions. For the other regions (Alaska, Cascadia, New Zealand and Taiwan) this is consistent with the preferred implementation suggesting by the authors

param numpy.ndarray rrup:

Rupture distance (in km)

openquake.hazardlib.gsim.kuehn_2020.get_base_term(C, trt, region)

Returns the region-dependent base term (c1) as seen in Equation 4.1

Parameters:

• C – Coefficient table for the specific intensity measure type

• trt (str) – Tectonic region type (either const.TRT.SUBDUCTION_INTERFACE or const.TRT.SUBDUCTION_INTRASLAB)

• region (str) – Supported region

openquake.hazardlib.gsim.kuehn_2020.get_basin_response_term(C, region, vs30, z_value)

Returns the basin response term, based on the region and the depth to a given velocity layer

Parameters:

z_value (numpy.ndarray) – Basin depth term (Z2.5 for JPN and CAS, Z1.0 for NZL and TWN)

openquake.hazardlib.gsim.kuehn_2020.get_depth_term(C, trt, ztor)

Returns the Z-tor scaling term (Eq. 4.7)

Parameters:

ztor (float) – Top of rupture depth

openquake.hazardlib.gsim.kuehn_2020.get_geometric_attenuation_term(C, trt, mag, rrup)

Returns the geometric attenuation term (Eq. 4.5) (as np.ndarray)

Parameters:

mag (float) – Earthquake magnitude

openquake.hazardlib.gsim.kuehn_2020.get_magnitude_scaling_term(C, trt, mbreak, mag)

Returns the magnitude scaling term (Eq. 4.4)

Parameters:

mbreak (float) – Magnitude scaling breakpoint

openquake.hazardlib.gsim.kuehn_2020.get_mean_values(C, region, trt, m_b, ctx, a1100=None)

Returns the mean ground values for a specific IMT

Parameters:

m_b (float) – Magnitude scaling breakpoint

openquake.hazardlib.gsim.kuehn_2020.get_shallow_site_response_term(C, region, vs30, pga1100)

Returns the shallow site response term in Eq. 4.8

Parameters:

• vs30 (numpy.ndarray) – Array of Vs30 values (m/s)

• pga1100 (numpy ndarray) – Peak ground acceleration on reference rock (Vs30 1100 m/s)

openquake.hazardlib.gsim.kuehn_2020.get_sigma_mu_adjustment(model, imt, mag, rrup)

Returns the sigma mu adjustment factor for the given scenario set by interpolation from the tables

Parameters:

• model (dict) – Sigma mu model as a dictionary containing the sigma mu tables (as output from _retrieve_sigma_mu_data)

• imt – Intensity measure type

• mag – Magnitude

• rrup – Distances

Returns:

sigma_mu for the scenarios (numpy.ndarray)

kotha_2016

Module exports KothaEtAl2016,

KothaEtAl2016Italy, KothaEtAl2016Turkey, KothaEtAl2016Others,

class openquake.hazardlib.gsim.kotha_2016.KothaEtAl2016(**kwargs)

Bases: GMPE

Implements unregionalised form of the European GMPE of: Kotha, S. R., Bindi, D. and Cotton, F. (2016) “Partially non-ergodic region specific GMPE for Europe and the Middle-East”, Bull. Earthquake Eng. 14: 1245 - 1263

COEFFS = <CoeffsTable e1 b1 b2 b3 c1 c2 c3 h g1 g2 tau phi0 phiS2S sigma Dc3IT Dc3OTH Dc3TR SE(Dc3IT) SE(Dc3OTH) SE(Dc3TR) tau_c3 Dg1IT Dg1OTH Dg1TR Dg2IT Dg2OTH Dg2TR SE(Dg2IT) SE(Dg2OTH) SE(Dg2TR) SE(Dg1IT) SE(Dg1OTH) SE(Dg1TR) tau_g1 tau_g2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude only (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.kotha_2016.KothaEtAl2016Italy(**kwargs)

Bases: KothaEtAl2016

Regional varient of the Kotha et al. (2016) GMPE for the Italy case

kind = 'ITA'

class openquake.hazardlib.gsim.kotha_2016.KothaEtAl2016Other(**kwargs)

Bases: KothaEtAl2016

Regional varient of the Kotha et al. (2016) GMPE for the “Other” case

kind = 'other'

class openquake.hazardlib.gsim.kotha_2016.KothaEtAl2016Turkey(**kwargs)

Bases: KothaEtAl2016

Regional varient of the Kotha et al. (2016) GMPE for the Turkey case

kind = 'TUR'

kotha_2020

Module exports KothaEtAl2020,

KothaEtAl2020Site, KothaEtAl2020Slope, KothaEtAl2020ESHM20, KothaEtAl2020ESHM20SlopeGeology KothaEtAl2020regional

class openquake.hazardlib.gsim.kotha_2020.KothaEtAl2020(**kwargs)

Bases: GMPE

Implements the first complete version of the newly derived GMPE for Shallow Crustal regions using the Engineering Strong Motion Flatfile. Kotha, S. R., Weatherill, G., Bindi, D., Cotton F. (2020) “A regionally- adaptable ground-motion model for shallow crustal earthquakes in Europe. Bulletin of Earthquake Engineering, 18:4091-4125 The GMPE is desiged for regional adaptation within a logic-tree framework, and as such contains several parameters that can be calibrated on input: 1) Source-region scaling, a simple scalar factor that defines how much to increase or decrease the “regional average” ground motion in the region. This value is taken as the maximum of the source-region variability term (tau_l2l) and the statistical uncertainty (sigma_mu). The latter defines the within-model uncertainty owing to the data set from which the model is derived and only exceeds the former at large magnitudes 2) Residual attenuation scaling “c3”, a factor that controls the residual attenuation part of the model to make the ground motion decay more or less rapidly with distance than the regional average. Both factors are period dependent. The two adaptable factors can be controlled either by direct specification at input (in the form of an imt-dependent dictionary) or by a number of standard deviations multiplying the existing variance terms. The two approaches are mutually exclusive, with the directly specified parameters always being used if defined on input. In the core form of the GMPE no site term is included. This is added in the subclasses.

Parameters:

• sigma_mu_epsilon (float) – Parameter to control the source-region scaling as a number of standard deviations by which to multiply the source-region to source- region variance, max(tau_l2l, sigma_mu)

• c3_epsilon (float) – Parameter to control the residual attenuation scaling as a number of standard deviations by which to multiply the attenuation-region variance, tau_c3. User supplied table for the coefficient c3 controlling the anelastic attenuation as an instance of :class: openquake.hazardlib.gsim.base.CoeffsTable. If absent, the value is taken from the normal coefficients table.

• ergodic (bool) – Use the ergodic standard deviation (True) or non-ergodic standard deviation (False)

• dl2l (dict) – If specifying the source-region scaling directly, defines the increase or decrease of the ground motion in the form of an imt- dependent dictionary of delta L2L factors

• c3 (dict) – If specifying the residual attenuation scaling directly, defines the apparent anelastic attenuation term, c3, as an imt-dependent dictionary

COEFFS = <CoeffsTable e1 b1 b2 b3 c1 c2 c3 tau_c3 phis2s tau_event_0 tau_l2l phi_0 g0_vs30 g1_vs30 g2_vs30 phi_s2s_vs30 g0_slope g1_slope g2_slope phi_s2s_slope>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and hypocentral depth

REQUIRES_SITES_PARAMETERS = frozenset({})

Required site parameter is not set

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.kotha_2020.KothaEtAl2020ESHM20(**kwargs)

Bases: KothaEtAl2020

Adaptation of the Kotha et al. (2020) GMPE for application to the 2020 European Seismic Hazard Model, as described in Weatherill et al. (2020) Weatherill, G., Kotha, S. R. and Cotton, F. (2020) “A regionally-adaptable ‘scaled-backbone’ ground motion logic tree for shallow seismicity in Europe: application to the 2020 European seismic hazard model”. Bulletin of Earthquake Engineering, 18:5087 - 5117 There are three key adaptations of the original Kotha et al. (2020) GMM: 1) The use of the residual attenuation regions, which represent the five main sub-regions of Europe with similar attenuation characteristics. The assignment to a particular group is now a site-dependent property, requiring the definition of the “eshm20_region”, an integer value between 0 and 5 indicating the residual attenuation region to which the site belongs (1 - 5) or else the default values (0). For each region an expected c3 and variance, tau_c3, are defined from which the resulting c3 is taken as a multiple of the number of standard deviations of tau_c3. 2) The site amplification is defined using a two-segment piecewise linear linear function. This form of the GMPE defines the site in terms of a measured or inferred Vs30, with the total aleatory variability adjusted accordingly. 3) A magnitude-dependent heteroskedastic aleatroy uncertainty model is used for the region-corrected between-event residuals and the site- corrected within event residuals. The former taken from the “global” tau model of Al Atik (2015), while the later is adapted from the “global” phi0 model of Al Atik (2015) adapted to the distribution of site-corrected within-event residuals determined by the original regression of Kotha et al. (2020). Al Atik, L. (2015) NGA-East: Ground-Motion Standard Deviation Models for Central and Eastern North America, PEER Technical Report, No 2015/07

COEFFS = <CoeffsTable e1 b1 b2 b3 c1 c2 c3 tau_c3 phi_s2s tau_event_0 tau_l2l phi_0 d0_obs d1_obs phi_s2s_obs d0_inf d1_inf phi_s2s_inf>

REQUIRES_SITES_PARAMETERS = frozenset({'region', 'vs30', 'vs30measured'})

Required site parameters are vs30, vs30measured and the eshm20_region

kind = 'ESHM20'

class openquake.hazardlib.gsim.kotha_2020.KothaEtAl2020ESHM20SlopeGeology(**kwargs)

Bases: KothaEtAl2020ESHM20

Adaptation of the ESHM20-implemented Kotha et al. (2020) model for use when defining site amplification based on with slope and geology rather than inferred/measured Vs30.

COEFFS_FIXED = <CoeffsTable V1 V2 phi_s2s>

COEFFS_RANDOM_GRAD = <CoeffsTable PRECAMBRIAN PALEOZOIC JURASSIC-TRIASSIC CRETACEOUS CENOZOIC PLEISTOCENE HOLOCENE UNKNOWN>

COEFFS_RANDOM_INT = <CoeffsTable PRECAMBRIAN PALEOZOIC JURASSIC-TRIASSIC CRETACEOUS CENOZOIC PLEISTOCENE HOLOCENE UNKNOWN>

GEOLOGICAL_UNITS = [b'CENOZOIC', b'HOLOCENE', b'JURASSIC-TRIASSIC', b'CRETACEOUS', b'PALEOZOIC', b'PLEISTOCENE', b'PRECAMBRIAN', b'UNKNOWN']

Geological Units

REQUIRES_SITES_PARAMETERS = frozenset({'geology', 'region', 'slope'})

Required site parameter is not set

kind = 'geology'

class openquake.hazardlib.gsim.kotha_2020.KothaEtAl2020Site(**kwargs)

Bases: KothaEtAl2020

Preliminary adaptation of the Kotha et al. (2020) GMPE using a polynomial site amplification function dependent on Vs30 (m/s)

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is not set

kind = 'site'

class openquake.hazardlib.gsim.kotha_2020.KothaEtAl2020Slope(**kwargs)

Bases: KothaEtAl2020

Preliminary adaptation of the Kotha et al. (2020) GMPE using a polynomial site amplification function dependent on slope (m/m)

REQUIRES_SITES_PARAMETERS = frozenset({'slope'})

Required site parameter is not set

kind = 'slope'

class openquake.hazardlib.gsim.kotha_2020.KothaEtAl2020regional(**kwargs)

Bases: KothaEtAl2020

Adaptation of the Kotha et al. (2020) GMPE using the source and site specific adjustments.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'hypo_lat', 'hypo_lon', 'mag'})

Required rupture parameters are magnitude, hypocentral location

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Required site parameter are vs30, lat and lon of the site

experimental = True

kind = 'regional'

openquake.hazardlib.gsim.kotha_2020.get_distance_coefficients_1(kind, c3, c3_epsilon, C, imt, sctx)

Returns either the directly specified c3 value or the c3 from the existing tau_c3 distribution

openquake.hazardlib.gsim.kotha_2020.get_distance_coefficients_2(kind, c3, c3_epsilon, C, imt, sctx)

Returns the c3 term. If c3 was input directly into the GMPE then this over-rides the c3 regionalisation. Otherwise the c3 and tau_c3 are determined according to the region to which each site is assigned. Note that no regionalisation is defined for PGV and hence the default values from Kotha et al. (2020) are taken unless defined otherwise in the input c3

openquake.hazardlib.gsim.kotha_2020.get_distance_coefficients_3(att, delta_c3_epsilon, C, imt, sctx)

Return site-specific coefficient ‘C3’. The function retrieves the value of delta_c3 and the standard error of delta_c3 from the ‘att’ geojson file depending on the location of site. This delta_c3 is added to the generic coefficient ‘c3’ from the GMPE. A delta_c3_epsilon value of +/- 1.6 gives the 95% confidence interval for delta_c3.

openquake.hazardlib.gsim.kotha_2020.get_distance_term(kind, c3, c3_epsilon, C, ctx, imt)

Returns the distance attenuation factor

openquake.hazardlib.gsim.kotha_2020.get_dl2l(tec, ctx, imt, delta_l2l_epsilon)

Returns rupture source specific delta_l2l values. The method retrieves the delta_l2l and standard error of delta_l2l values. if delta_l2l_epsilon is provided, standard error of delta_c3 will be included. A delta_l2l_epsilon value of +/- 1.6 gives the 95% confidence interval for delta_l2l.

openquake.hazardlib.gsim.kotha_2020.get_heteroskedastic_tau_phi0_avgsa(imt, mag)

Returns the heteroskedastic between-event and single-station within- event variability for AvgSa

openquake.hazardlib.gsim.kotha_2020.get_magnitude_scaling(C, mag)

Returns the magnitude scaling term

openquake.hazardlib.gsim.kotha_2020.get_phi_ss(imt, mag)

Returns the single station phi (or it’s variance) for a given magnitude and intensity measure type according to equation 5.14 of Al Atik (2015) with coefficients calibrated on the ESM data set and Kotha et al. (2020) GMPE

openquake.hazardlib.gsim.kotha_2020.get_sigma_mu_adjustment(kind, C, imt, ctx)

Returns the sigma_mu adjusment factor, which is taken as the maximum of tau_L2L and the sigma_mu. For M < 7.4 the sigma statistical does not exceed tau_L2L at any period or distance. For M > 7.4, sigma_mu is approximately linear up to M 8.0 so we interpolate between the two values and cap sigma statistical at M 8.0

openquake.hazardlib.gsim.kotha_2020.get_site_amplification(kind, extra, C, ctx, imt)

Apply the correct site amplification depending on the kind of GMPE

openquake.hazardlib.gsim.kotha_2020.get_stddevs(kind, ergodic, phi_s2s, C, ctx, imt)

Returns the homoskedastic standard deviation model

openquake.hazardlib.gsim.kotha_2020.get_tau(imt, mag)

Heteroskedastic Tau model adopts the “global” model from Al Atik (2015)

lanzano_2016

Module exports LanzanoEtAl2016.

class openquake.hazardlib.gsim.lanzano_2016.LanzanoEtAl2016_RJB(**kwargs)

Bases: GMPE

Implements GMPE developed by G.Lanzano, M. D’Amico, C.Felicetta, R.Puglia, L.Luzi, F.Pacor, D.Bindi and published as “Ground-Motion Prediction Equations for Region-Specific Probabilistic Seismic-Hazard Analysis”, Bull Seismol. Soc. Am., DOI 10.1785/0120150096 SA are given up to 4 s. The regressions are developed considering the geometrical mean of the as-recorded horizontal components

COEFFS = <CoeffsTable a b1 b2 c11 c21 c12 c22 c13 c23 c14 c24 h fNF fTF fUN sA sB sC dbas tau phi SigmaTot>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ because the equations have been derived from data from Italian database ITACA, as explained in the ‘Introduction’.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is R Joyner-Boore distance (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'bas', 'lat', 'lon', 'vs30'})

Required site parameter

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.lanzano_2016.LanzanoEtAl2016_Rhypo(**kwargs)

Bases: LanzanoEtAl2016_RJB

Implements GMPE developed by G.Lanzano, M. D’Amico, C.Felicetta, R.Puglia, L.Luzi, F.Pacor, D.Bindi and published as “Ground-Motion Prediction Equations for Region-Specific Probabilistic Seismic-Hazard Analysis”, Bull Seismol. Soc. Am., DOI 10.1785/0120150096 SA are given up to 4 s. The regressions are developed considering the geometrical mean of the as-recorded horizontal components

COEFFS = <CoeffsTable a b1 b2 c11 c21 c12 c22 c13 c23 c14 c24 fNF fTF fUN sA sB sC dbas tau phi SigmaTot>

Coefficients from SA PGA and PGV from esupp Table S3

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is R Hypocentral Distance.

lanzano_2019

Module exports LanzanoEtAl2019.

class openquake.hazardlib.gsim.lanzano_2019.LanzanoEtAl2019_RJB_OMO(**kwargs)

Bases: GMPE

Implements GMPE developed by G.Lanzano, L.Luzi, F.Pacor, L.Luzi, C.Felicetta, R.Puglia, S. Sgobba, M. D’Amico and published as “A Revised Ground-Motion Prediction Model for Shallow Crustal Earthquakes in Italy”, Bull Seismol. Soc. Am., DOI 10.1785/0120180210 SA are given up to 10 s.

The horizontal component of motion corresponds to RotD50, i.e. the median of the distribution of the intensity measures, obtained from the combination of the two horizontal components across all nonredundant azimuths (Boore, 2010).

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 k f1 f2 tau phi_S2S phi_0 Mh Mref h>

COEFFS_SITE = <CoeffsTable a b c>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, page 1904

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ because the equations have been derived from data from Italian database ITACA, as explained in the ‘Introduction’.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is R Joyner-Boore distance (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.lanzano_2019.LanzanoEtAl2019_RJB_OMO_RefRock(**kwargs)

Bases: GMPE

Implements GMPE developed by G.Lanzano, L.Luzi, F.Pacor, L.Luzi, C.Felicetta, R.Puglia, S. Sgobba, M. D’Amico and published as “A Revised Ground-Motion Prediction Model for Shallow Crustal Earthquakes in Italy”, Bull Seismol. Soc. Am., DOI 10.1785/0120180210 SA are given up to 10 s.

The horizontal component of motion corresponds to RotD50, i.e. the median of the distribution of the intensity measures, obtained from the combination of the two horizontal components across all nonredundant azimuths (Boore, 2010).

In this version we scale the ground-motion to reference rock conditions using the findings of Lanzano et al. (2020) “Generic-To-Reference Rock Scaling Factors for Seismic Ground Motion in Italy”, BSSA, 112(3), https://doi.org/10.1785/0120210063

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 k f1 f2 tau phi_S2S phi_0 Mh Mref h>

COEFFS_SITE = <CoeffsTable a b c>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, page 1904

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ because the equations have been derived from data from Italian database ITACA, as explained in the ‘Introduction’.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is R Joyner-Boore distance (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'kappa0', 'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.lanzano_2019.LanzanoEtAl2019_RJB_OMOscaled(**kwargs)

Bases: LanzanoEtAl2019_RJB_OMO

Implements GMPE developed by G.Lanzano, L.Luzi, F.Pacor, L.Luzi, C.Felicetta, R.Puglia, S. Sgobba, M. D’Amico and published as “A Revised Ground-Motion Prediction Model for Shallow Crustal Earthquakes in Italy”, Bull Seismol. Soc. Am., DOI 10.1785/0120180210 SA are given up to 10 s. The prediction is valid for RotD50, which is the median of the distribution of the intensity measures, obtained from the combination of the two horizontal components across all nonredundant azimuths (Boore, 2010). Application of a scaling factor that converts the prediction of LanzanoEtAl2019_RJB_OMO, valid for RotD50, to the corresponding prediction for the Maximum value.

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 k f1 f2 tau phi_S2S phi_0 Mh Mref h>

class openquake.hazardlib.gsim.lanzano_2019.LanzanoEtAl2019_RUP_OMO(**kwargs)

Bases: LanzanoEtAl2019_RJB_OMO

Implements GMPE developed by G.Lanzano, L.Luzi, F.Pacor, L.Luzi, C.Felicetta, R.Puglia, S. Sgobba, M. D’Amico and published as “A Revised Ground-Motion Prediction Model for Shallow Crustal Earthquakes in Italy”, Bull Seismol. Soc. Am., DOI 10.1785/0120180210 SA are given up to 10 s. The prediction is valid for RotD50, which is the median of the distribution of the intensity measures, obtained from the combination of the two horizontal components across all nonredundant azimuths (Boore, 2010).

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 k f1 f2 tau phi_S2S phi_0 Mh Mref h>

Coefficients from SA PGA and PGV from esupp Table S2

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, page 1904

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ because the equations have been derived from data from Italian database ITACA, as explained in the ‘Introduction’.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

lanzano_2020

Module openquake.hazardlib.gsim.lanzano_2020 implements LanzanoEtAl2020

class openquake.hazardlib.gsim.lanzano_2020.LanzanoEtAl2020_Cluster(**kwargs)

Bases: LanzanoEtAl2020_ref

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 s2 s3 s4 s5 s6 s7 s8 s9 Mref tau phi_S2S phi_0 sigma>

kind = 'cluster'

class openquake.hazardlib.gsim.lanzano_2020.LanzanoEtAl2020_EC8(**kwargs)

Bases: LanzanoEtAl2020_ref

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 sB sC sD sE Mref tau phi_S2S phi_0 sigma>

kind = 'ec8'

class openquake.hazardlib.gsim.lanzano_2020.LanzanoEtAl2020_ref(**kwargs)

Bases: GMPE

Implements the GMM proposed in Lanzano et al (2020): “Methodology to identify the reference rock sites in regions of medium-to-high seismicity: an application in Central Italy” by Lanzano G, Felicetta C, Pacor F, Spallarossa D, and Traversa P.

The site term for Reference Rock Sites is zero, whereas for other sites, the site term is provided.

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 s_other Mref tau phi_S2S phi_0 sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters is magnitude, ev_lat, ev_lon

REQUIRES_SITES_PARAMETERS = frozenset({'siteclass'})

Required site parameter is not set

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

kind = 'ref'

lanzano_luzi_2019

Module exports LanzanoLuzi2019shallow,

LanzanoLuzi2019deep

class openquake.hazardlib.gsim.lanzano_luzi_2019.LanzanoLuzi2019deep(**kwargs)

Bases: LanzanoLuzi2019shallow

kind = 'deep'

class openquake.hazardlib.gsim.lanzano_luzi_2019.LanzanoLuzi2019deep_scaled(**kwargs)

Bases: LanzanoLuzi2019shallow_scaled

kind = 'deep'

class openquake.hazardlib.gsim.lanzano_luzi_2019.LanzanoLuzi2019shallow(**kwargs)

Bases: GMPE

Implements GMPE developed by Giovanni Lanzano and Lucia Luzi (2019) and submitted as “A ground motion model for volcanic areas in Italy” Bulletin of Earthquake Engineering.

GMPE derives from earthquakes in the volcanic areas in Italy in the magnitude range 3<ML<5 for hypocentral distances <200 km, and for rock (EC8-A), stiff soil (EC8-B) and soft soil (EC8-C and EC8-D).

The GMPE distinguishes between shallow volcano-tectonic events related to flank movements (focal depths <5km) and deeper events occurring due to regional tectonics (focal depths >5km), considering two different attenuations with distances.

Test tables are generated from a spreadsheet provided by the authors, and modified according to OQ format (e.g. conversion from cm/s2 to m/s2).

COEFFS = <CoeffsTable a b c1 c2 c3 sB sC tau phiS2S sigma0 phi sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are PGA and SA

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, page 1904

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is ‘volcanic’

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'shallow'

class openquake.hazardlib.gsim.lanzano_luzi_2019.LanzanoLuzi2019shallow_scaled(**kwargs)

Bases: LanzanoLuzi2019shallow

Implements GMPE developed by Giovanni Lanzano and Lucia Luzi (2019) and submitted as “A ground motion model for volcanic areas in Italy” Bulletin of Earthquake Engineering.

GMPE derives from earthquakes in the volcanic areas in Italy in the magnitude range 3<ML<5 for hypocentral distances <200 km, and for rock (EC8-A), stiff soil (EC8-B) and soft soil (EC8-C and EC8-D).

The GMPE distinguishes between shallow volcano-tectonic events related to flank movements (focal depths <5km) and deeper events occurring due to regional tectonics (focal depths >5km), considering two different attenuations with distances.

Test tables are generated from a spreadsheet provided by the authors, and modified according to OQ format (e.g. conversion from cm/s2 to m/s2).

Application of a scaling factor that converts the prediction of LanzanoLuzi2019shallow to the corresponding prediction for the Maximum value.

COEFFS = <CoeffsTable a b c1 c2 c3 sB sC tau phiS2S sigma0 phi sigma>

lin_2009

Module exports Lin2009

class openquake.hazardlib.gsim.lin_2009.Lin2009(**kwargs)

Bases: GMPE

Implements GMPE developed by Po-Shen Lin and published as “Ground-motion attenuation relationship and path-effect study using Taiwan Data set” (Ph.D. dissertation of National Central University, Taiwan). This class implements the equations for ‘crustal events’.

COEFFS = <CoeffsTable C1 C2 C3 C4 C5 H C6 C7 C8 sigma>

Coefficient table for rock sites, see table 3 page 227.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components, see equation 4.1 page 46.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see Table 4.1 in pages 48-49.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total, see equation 4.1 page 46.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rupture distance, see equation 4.1 page 46.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake see equation 4.1 page 46.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.lin_2009.Lin2009AdjustedSigma(**kwargs)

Bases: Lin2009

Implements the Lin (2009) GMPE with the total sigma adjusted according to the values in Cheng et al. (2013): C. -T. Cheng, P. -S. Hsieh, P. -S. Lin, Y. -T. Yen, C. -H. Chan (2013) Probability Seismic Hazard Mapping of Taiwan

COEFFS = <CoeffsTable C1 C2 C3 C4 C5 H C6 C7 C8 sigma>

Coefficient table for rock sites, see table 3 page 227.

lin_2011

Module exports Lin2011foot, Lin2011hanging

class openquake.hazardlib.gsim.tem20.lin_2011.Lin2011foot(**kwargs)

Bases: GMPE

Implements GMPE developed by Po-Shen Lin and others and published as “Response spectral attenuation relations for shallow crustal earthquakes in Taiwan”, Engineering Geology, Volume 121, Issues 3–4, 10 August 2011, Pages 150-164.

COEFFS_ROCK = <CoeffsTable C1 C2 C3 C4 C5 sigma>

Coefficient table for rock sites, see table 3 page 153.

COEFFS_SOIL = <CoeffsTable C1 C2 C3 C4 C5 sigma>

Coefficient table for soil sites, see table 4 page 153.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components, see equation 10 page 226.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see tables 3 and 4, pages 227 and 228.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total, see equation 10 page 226.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is rrup distance, see equation 4 page 154.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude, and focal depth, see equation 10 page 226.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock and deep soil).

ROCK_VS30 = 360

Vs30 threshold value between rock sites (B, C) and soil sites (C, D).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.tem20.lin_2011.Lin2011hanging(**kwargs)

Bases: Lin2011foot

Implements GMPE developed by Po-Shen Lin and others and published as “Response spectral attenuation relations for shallow crustal earthquakes in Taiwan”, Engineering Geology, Vol. 121, Issues 3–4, 10 August 2011, Pages 150-164.

COEFFS_ROCK = <CoeffsTable C1 C2 C3 C4 C5 sigma>

Coefficient table for rock sites, see table 3 page 153.

COEFFS_SOIL = <CoeffsTable C1 C2 C3 C4 C5 sigma>

Coefficient table for soil sites, see table 4 page 153.

lin_lee_2008

Module exports LinLee2008SInter, class:LinLee2008SSlab

class openquake.hazardlib.gsim.lin_lee_2008.LinLee2008SInter(**kwargs)

Bases: GMPE

Implements GMPE developed by Po-Shen Lin and Chyi-Tyi Lee and published as “Ground-Motion Attenuation Relationships for Subduction-Zone Earthquakes in Northeastern Taiwan” (Bulletin of the Seismological Society of America, Volume 98, Number 1, pages 220-240, 2008). This class implements the equations for ‘Subduction Interface’ (that’s why the class name ends with ‘SInter’).

COEFFS_ROCK = <CoeffsTable C1 C2 C3 C4 C5 C6 C7 sigma>

Coefficient table for rock ctx, see table 3 page 227.

COEFFS_SOIL = <CoeffsTable C1 C2 C3 C4 C5 C6 C7 sigma>

Coefficient table for soil ctx, see table 4 page 228.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components, see equation 10 page 226.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see tables 3 and 4, pages 227 and 228.

DEFINED_FOR_REFERENCE_VELOCITY = 800

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total, see equation 10 page 226.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance, see equation 10 page 226.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude, and focal depth, see equation 10 page 226.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock and deep soil).

ROCK_VS30 = 360

Vs30 threshold value between rock ctx (B, C) and soil ctx (C, D).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.lin_lee_2008.LinLee2008SSlab(**kwargs)

Bases: LinLee2008SInter

Implements GMPE developed by Po-Shen Lin and Chyi-Tyi Lee and published as “Ground-Motion Attenuation Relationships for Subduction-Zone Earthquakes in Northeastern Taiwan” (Bulletin of the Seismological Society of America, Volume 98, Number 1, pages 220-240, 2008). This class implements the equations for ‘Subduction IntraSlab’ (that’s why the class name ends with ‘SSlab’).

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is Subduction IntraSlab

manea_2021

Created on Mon August 24, 2021 Authors: elena.manea@infp.ro, laurentiu.danciu@sed.ethz.ch

Module exports: ManeaEtAl2021

class openquake.hazardlib.gsim.manea_2021.ManeaEtAl2021(**kwargs)

Bases: GMPE

Implements the Subduction GMPE developed by Elena Florinela Manea, Carmen Ortanza Cioflan and Laurentiu Danciu, otherwise known as the “Ground-motion models for Vrancea intermediate-depth earthquakes (Earthquake Spectra,2021,87552930211032985), for subduction inslab events.

COEFFS = <CoeffsTable phi0 phi1 phi2 phi3 phi4 phi5 phi6 phi7 phi8 phi9 phi10 phi11 phi tau sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and depth for the inslab model

REQUIRES_SITES_PARAMETERS = frozenset({'backarc', 'f0', 'vs30'})

Required site measure as Vs30, fundamental frequency of resonance (if unknown set it as 15 - rock sites),

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

openquake.hazardlib.gsim.manea_2021.get_mean_values(C, ctx)

Returns the mean values for a specific IMT

mcverry_2006

Module exports McVerry2006Asc, McVerry2006SInter, McVerry2006SSlab, McVerry2006Volc, McVerry2006AscSC, McVerry2006SInterSC, McVerry2006SSlabSC, McVerry2006VolcSC.

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006Asc(**kwargs)

Bases: GMPE

Implements GMPE developed by G. McVerry, J. Zhao, N.A. Abrahamson, P. Somerville published as “New Zealand Acceleration Response Spectrum Attenuation Relations for Crustal and Subduction Zone Earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.39, no. 1, p. 1-58, March 2006.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/39(1)0001.pdf Last accessed 10 September 2014.

This class implements the GMPE for Active Shallow Crust earthquakes (Asc suffix).

The GMPE distinguishes between rock, stiff soil and soft soil which respectively equate to the New Zealand site class combined A/B C, and D. No model is provided for New Zealand site class E The rake angle is also taken into account to distinguish between faulting mechanisms. A hanging-wall term is noted in the functional form of the model in the paper but is not used at present. Furthermore, a Rvolc (volcanic path distance) is noted in the functional form but this is not implemented in the McVerry2006Asc model, it is implemented in a seperate GMPE McVerry2006Volc where Rvol=Rrup as this is how it is implemented in Stirling et al. 2012.

This is a legacy class based on the original implementation of McVerry et al. (2006), where the site terms are incorrectly implemented as functions of Vs30. The New Zealand site classification boundaries do not depend on Vs30 and so this class will yield erroneous results for some site locations. Instead, calling McVerry2006AscSC and specifying site class values in the .ini file will give the correct results.

COEFFS_PRIMED = <CoeffsTable c1 c3as c4as c5 c6as c8 ca9 c10as c11 c12y c13y c15 c17 c18y c19y c20 c24 c29 c30as c32 c33as c43 c46>

Coefficient table (table 3, page 108)

COEFFS_STD = <CoeffsTable sigmaM6 sigSlope tau>

Coefficient table for standard deviation calculation (table 4, page 109)

COEFFS_UNPRIMED = <CoeffsTable c1 c3as c4as c5 c6as c8 ca9 c10as c11 c12y c13y c15 c17 c18y c19y c20 c24 c29 c30as c32 c33as c43 c46>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Greater of two horizontal'

Supported intensity measure component is the stronger of two horizontal components (see Section 6 paragraph 2, page 21)

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are PGA and SA. PGA is assumed to have same coefficients as SA(0.00)

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type for base class is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is RRup (paragraphy 3, page 26) which is defined as nearest distance to the source.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag', 'rake'})

Required rupture parameters are magnitude, and rake and hypocentral depth rake is for determining fault style flags. Hypo depth is for subduction GMPEs

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

The legacy implementation of the McVerry model takes vs30 and maps to New Zealand’s categorical site classification scheme

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'asc'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006AscSC(**kwargs)

Bases: McVerry2006Asc

REQUIRES_SITES_PARAMETERS = frozenset({'siteclass'})

The legacy implementation of the McVerry model takes vs30 and maps to New Zealand’s categorical site classification scheme

kind = 'asc_sc'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006Chch(**kwargs)

Bases: McVerry2006AscSC

Extends McVerry2006AscSC to implement modifications required for the Canterbury Seismic Hazard Model (CSHM).

COEFFS_STRESS = <CoeffsTable delta M1 Mh>

Coefficient table (Atkinson and Boore, 2006, table 7, page 2201)

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'in_cshm', 'mag', 'rake'})

Required rupture parameters are magnitude, and rake and hypocentral depth rake is for determining fault style flags. Hypo depth is for subduction GMPEs

additional_sigma = 0

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'chch'

non_verified = True

This implementation is non-verified because the model has not been published, nor is independent code available.

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006ChchAdditionalSigma(**kwargs)

Bases: McVerry2006Chch

Extend McVerry2006AscChch to implement the ‘additional epistemic uncertainty’ version of the model in: McVerry, G., Gerstenberger, M., Rhoades, D., 2011. “Evaluation of the Z-factor and peak ground accelerations for Christchurch following the 13 June 2011 earthquake”, GNS Science Report 2011/45, 29p.

additional_sigma = 0.35

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006ChchStressDrop(**kwargs)

Bases: McVerry2006Chch

Extend McVerry2006AscChch to implement the ‘stress drop’ factors developed in: McVerry, G., Gerstenberger, M., Rhoades, D., 2011. “Evaluation of the Z-factor and peak ground accelerations for Christchurch following the 13 June 2011 earthquake”, GNS Science Report 2011/45, 29p.

The coefficient table is identical to that in Atkinson, G. and Boore, D., (2006), “Earthquake ground motion prediction equations for eastern North America, BSSA, 96(6), 2181-2205, doi:10.1785/0120050245. with a stress drop ratio of 1.5

kind = 'drop'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006SInter(**kwargs)

Bases: McVerry2006Asc

Extend McVerry2006Asc for Subduction Interface events (SInter)

Implements GMPE developed by G. McVerry, J. Zhao, N.A. Abrahamson, P. Somerville published as “New Zealand Acceleration Response Spectrum Attenuation Relations for Crustal and Subduction Zone Earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.39, no. 1, p. 1-58, March 2006.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/39(1)0001.pdf Last accessed 10 September 2014.

This class implements the GMPE for Subduction Interface earthquakes (SInter suffix).

The GMPE distinguishes between rock (vs30 >= 760) and deep soil (vs30 < 760) which equation to the New Zealand site class A and B (rock) and C,D and E (soil).

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type for base class is ‘active shallow crust’

kind = 'sinter'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006SInterSC(**kwargs)

Bases: McVerry2006AscSC

Extend McVerry2006AscSC for Subduction Interface events (SInter)

Identical to class McVerry2006SInter, except the site term is defined in terms of siteclass instead of Vs30.

Implements GMPE developed by G. McVerry, J. Zhao, N.A. Abrahamson, P. Somerville published as “New Zealand Acceleration Response Spectrum Attenuation Relations for Crustal and Subduction Zone Earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.39, no. 1, p. 1-58, March 2006.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/39(1)0001.pdf Last accessed 10 September 2014.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type for base class is ‘active shallow crust’

kind = 'sinter_sc'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006SSlab(**kwargs)

Bases: McVerry2006Asc

Extend McVerry2006Asc for Subduction Intraslab events (SSlab)

Implements GMPE developed by G. McVerry, J. Zhao, N.A. Abrahamson, P. Somerville published as “New Zealand Acceleration Response Spectrum Attenuation Relations for Crustal and Subduction Zone Earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.39, no. 1, p. 1-58, March 2006.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/39(1)0001.pdf Last accessed 10 September 2014.

This class implements the GMPE for Subduction Intraslab earthquakes (SSlab suffix).

The GMPE distinguishes between rock (vs30 >= 760) and deep soil (vs30 < 760) which equation to the New Zealand site class A and B (rock) and C,D and E (soil).

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type for base class is ‘active shallow crust’

kind = 'slab'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006SSlabSC(**kwargs)

Bases: McVerry2006AscSC

Extend McVerry2006AscSC for Subduction Intraslab events (SSlab)

Identical to class McVerry2006SSlab, except the site term is defined in terms of siteclass instead of Vs30.

Implements GMPE developed by G. McVerry, J. Zhao, N.A. Abrahamson, P. Somerville published as “New Zealand Acceleration Response Spectrum Attenuation Relations for Crustal and Subduction Zone Earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.39, no. 1, p. 1-58, March 2006.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/39(1)0001.pdf Last accessed 10 September 2014.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type for base class is ‘active shallow crust’

kind = 'slab_sc'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006Volc(**kwargs)

Bases: McVerry2006Asc

Extend McVerry2006Asc for earthquakes with Volcanic paths (Volc)

Implements GMPE developed by G. McVerry, J. Zhao, N.A. Abrahamson, P. Somerville published as “New Zealand Acceleration Response Spectrum Attenuation Relations for Crustal and Subduction Zone Earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.39, no. 1, p. 1-58, March 2006.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/39(1)0001.pdf Last accessed 10 September 2014.

This class implements the GMPE for earthquakes with Volcanic paths

The GMPE distinguishes between rock (vs30 >= 760) and deep soil (vs30 < 760) which equation to the New Zealand site class A and B (rock) and C,D and E (soil). The rake angle is also taken into account to distinguish between faulting mechanisms. A hanging-wall term is noted in the functional form of the model in the paper but is not used at present.

rvolc is equal to rrup

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type for base class is ‘active shallow crust’

kind = 'vol'

class openquake.hazardlib.gsim.mcverry_2006.McVerry2006VolcSC(**kwargs)

Bases: McVerry2006AscSC

Extend McVerry2006AscSC for earthquakes with Volcanic paths (Volc)

Identical to class McVerry2006Volc, except the site term is defined in terms of siteclass instead of Vs30.

Implements GMPE developed by G. McVerry, J. Zhao, N.A. Abrahamson, P. Somerville published as “New Zealand Acceleration Response Spectrum Attenuation Relations for Crustal and Subduction Zone Earthquakes”, Bulletin of the New Zealand Society for Earthquake Engineering, v.39, no. 1, p. 1-58, March 2006.

URL: http://www.nzsee.org.nz/db/Bulletin/Archive/39(1)0001.pdf Last accessed 10 September 2014.

This class implements the GMPE for earthquakes with Volcanic paths rvolc is equal to rrup

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type for base class is ‘active shallow crust’

kind = 'vol_sc'

megawati_2003

Module exports megawatiEtAl2003.

class openquake.hazardlib.gsim.megawati_2003.MegawatiEtAl2003(**kwargs)

Bases: GMPE

Implements GMPE developed by Megawati, Pan and Koketsu and published in 2003 as “Response spectral attenuation relationships for Singapore and the Malay Peninsula due to distant Sumatran-fault earthquakes”, Earthquake Engineering & Structural Dynamics Volume 32, pages 2241–2265.

COEFFS = <CoeffsTable a0 a1 a2 a3 a4 a5 sigma>

Coefficient table for rock ctx, see table 3 page 2257

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground veloacity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust Sumatra strike-slip fault

REQUIRES_DISTANCES = frozenset({'azimuth', 'rhypo'})

Required distance measure is hypocentral distance, and azimuth

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameter required. This GMPE is for very hard rock conditions

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

megawati_pan_2010

Module exports megawatipan2010.

class openquake.hazardlib.gsim.megawati_pan_2010.MegawatiPan2010(**kwargs)

Bases: GMPE

Implements GMPE developed by Kusnowidjaja Megawati and Tso-Chien Pan and published as “Ground-motion attenuation relationship for the Sumatran megathrust earthquakes” (2010, Earthquake Engineering & Structural Dynamics Volume 39, Issue 8, pages 827-845).

COEFFS = <CoeffsTable a0 a1 a2 a3 a4 a5 sigma>

Coefficient table for rock ctx, see table 3 page 227.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components, ####: PLEASE CONFIRM!!!!! 140709

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see table IV pag. 837

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total, see equation IV page 837.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface along the Sumatra subduction zone.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance, see equation 1 page 834.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude, and focal depth, see equation 10 page 226.

REQUIRES_SITES_PARAMETERS = frozenset({})

Required site parameter is only Vs30 (used to distinguish rock and deep soil). This GMPE is for very hard rock site condition, see the abstract page 827.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

montalva_2016

Module exports MontalvaEtAl2016SInter

MontalvaEtAl2016SSlab

class openquake.hazardlib.gsim.montalva_2016.MontalvaEtAl2016SInter(**kwargs)

Bases: AbrahamsonEtAl2015SInter

Adaptation of the Abrahamson et al. (2015) BC Hydro subduction interface GMPE, calibrated to Chilean strong motion data.

GMPE and related coefficients published by: Montalva, G., Bastias, N., Rodriguez-Marek, A. (2016), ‘Ground Motion Prediction Equation for the Chilean Subduction Zone’. Submitted to Seismological Research Letters

NOTE (August 2018): The original implementation of Montalva et al. (2016) was made prior to publication. The final published version of the model (Montalva et al. 2017) contains modified coefficients with respect to this version. It is strongly recommended to use the Montalva et al. (2017) model, however this version is retained for reproducibility of previous hazard models using this implementation

COEFFS = <CoeffsTable DC1 vlin b theta1 theta2 theta3 theta4 theta5 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma phi_s2s>

kind = 'montalva16'

superseded_by

alias of MontalvaEtAl2017SInter

class openquake.hazardlib.gsim.montalva_2016.MontalvaEtAl2016SSlab(**kwargs)

Bases: AbrahamsonEtAl2015SSlab

Adaptation of the Abrahamson et al. (2015) BC Hydro subduction in-slab GMPE, calibrated to Chilean strong motion data

NOTE (August 2018): The original implementation of Montalva et al. (2016) was made prior to publication. The final published version of the model (Montalva et al. 2017) contains modified coefficients with respect to this version. It is strongly recommended to use the Montalva et al. (2017) model, however this version is retained for reproducibility of previous hazard models using this implementation

COEFFS = <CoeffsTable DC1 vlin b theta1 theta2 theta3 theta4 theta5 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma phi_s2s>

kind = 'montalva16'

superseded_by

alias of MontalvaEtAl2017SSlab

montalva_2017

Module exports MontalvaEtAl2017SInter

MontalvaEtAl2017SSlab

class openquake.hazardlib.gsim.montalva_2017.MontalvaEtAl2017SInter(**kwargs)

Bases: AbrahamsonEtAl2015SInter

Adaptation of the Abrahamson et al. (2015) BC Hydro subduction interface GMPE, calibrated to Chilean strong motion data, by Montalva et al (2017)

Montalval, G. A., Bastias, N., and Rodriguez-Marek, A. (2017) “Ground- Motion Prediction Equation for the Chilean Subduction Zone”, Bulletin of the Seismological Society of America, 107(2), 901-911

Note: This should be used in place of previous Montalva et al. (2016) implementation, as coefficients and model changed at the point of publication

COEFFS = <CoeffsTable vlin b theta1 theta2 theta3 theta4 theta5 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma phi_S2S>

COEFFS_MAG_SCALE = <CoeffsTable dc1>

kind = 'montalva17'

class openquake.hazardlib.gsim.montalva_2017.MontalvaEtAl2017SSlab(**kwargs)

Bases: AbrahamsonEtAl2015SSlab

Adaptation of the Abrahamson et al. (2015) BC Hydro subduction in-slab GMPE, calibrated to Chilean strong motion data

COEFFS = <CoeffsTable vlin b theta1 theta2 theta3 theta4 theta5 theta6 theta7 theta8 theta10 theta11 theta12 theta13 theta14 theta15 theta16 phi tau sigma phi_S2S>

kind = 'montalva17'

multi

Module exports MultiGMPE, which can create a composite of multiple GMPEs for different IMTs when passed a dictionary of ground motion models organised by IMT type or by a string describing the association

class openquake.hazardlib.gsim.multi.MultiGMPE(**kwargs)

Bases: GMPE

The MultiGMPE can call ground motions for various IMTs when instantiated with a dictionary of ground motion models organised by IMT or a string describing the association. In the case of spectral accelerations the period of the IMT must be defined explicitly and only SA for that period will be computed.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is horizontal HORIZONTAL,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({})

Supported intensity measure types are not set

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type

DEFINED_FOR_TECTONIC_REGION_TYPE = ''

Supported tectonic region type is undefined

REQUIRES_DISTANCES = frozenset({})

Required distance metrics will be set by the GMPEs

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude, others will be set later

REQUIRES_SITES_PARAMETERS = frozenset({})

Required site parameters will be set be selected GMPES

compute(ctx: recarray, imts, mean, sig, tau, phi)

Call the get mean and stddevs of the GMPE for the respective IMT

munson_thurber_1997

Module exports MunsonThurber1997

MunsonThurber1997Hawaii MunsonThurber1997Vector.

class openquake.hazardlib.gsim.munson_thurber_1997.MunsonThurber1997(**kwargs)

Bases: GMPE

Implements GMPE developed by Clifford G. Munson and Clifford H. Thurber and published as “Analysis of the Attenuation of Strong Ground Motion on the Island of Hawaii” (1997, Bulletin of the Seismological Society of America, Vol. 87, No. 4, pp. 954-960).

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is maximum horizontal VECTORIAL,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>})

Supported intensity measure types is spectral acceleration, see table 3, pag. 110

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is volcanic, see paragraph ‘Introduction’, page 99.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is hypocentral distance see page 18 in Atkinson and Boore’s manuscript

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30. See paragraph ‘Predictor Variables’, pag 103

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.munson_thurber_1997.MunsonThurber1997Hawaii(**kwargs)

Bases: MunsonThurber1997

Modifies MunsonThurber1997 for use with the USGS Hawaii seismic hazard map of Klein FW, Frankel AD,Mueller CS, Wesson RL, Okubo PG. Seismic-hazard maps for Hawaii. US Geological Survey; 2000.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types is spectral acceleration, see table 3, pag. 110

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.munson_thurber_1997.MunsonThurber1997Vector(**kwargs)

Bases: MunsonThurber1997

Modification of the original base class to correct mean ground motion to geometric mean of horizontal components (Beyer and Bommer, 2006)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Square root of sum of squares of peak horizontals'

Supported intensity measure component is geometric mean of horizontal VECTORIAL,

morikawa_fujiwara_2013

Module exports class:MorikawaFujiwara2013

class openquake.hazardlib.gsim.morikawa_fujiwara_2013.MorikawaFujiwara2013Crustal(**kwargs)

Bases: GMPE

Implements the GMM from Morikawa and Fujiwara published as “A New Ground Motion Prediction Equation for Japan Applicable up to M9 Mega-Earthquake”, Journal of Disaster Research, Vol.8, No.5, 2013.

COEFFS = <CoeffsTable a b1 b2 b3 c1 c2 c3 d pd Dlmin ps Vsmax V0 gNE gEW PH sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function JMA>, <function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, pag 106.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup [km]

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude, and hypocentral depth [km].

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'xvf', 'z1pt4'})

Required site parameters are: - Vs30 - time averaged shear-wave velocity [m/s] - z1p4 - Depth to the 1.4 km/s interface [m] - xvf - Distance from the volcanic front [km, positive in the forearc]

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

model = 'model1'

region = None

class openquake.hazardlib.gsim.morikawa_fujiwara_2013.MorikawaFujiwara2013SubInterface(**kwargs)

Bases: MorikawaFujiwara2013Crustal

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is active shallow crust

model = 'model1'

region = None

class openquake.hazardlib.gsim.morikawa_fujiwara_2013.MorikawaFujiwara2013SubInterfaceNE(**kwargs)

Bases: MorikawaFujiwara2013SubInterface

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is active shallow crust

model = 'model1'

region = 'NE'

class openquake.hazardlib.gsim.morikawa_fujiwara_2013.MorikawaFujiwara2013SubInterfaceSW(**kwargs)

Bases: MorikawaFujiwara2013SubInterface

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is active shallow crust

model = 'model1'

region = 'SW'

class openquake.hazardlib.gsim.morikawa_fujiwara_2013.MorikawaFujiwara2013SubSlab(**kwargs)

Bases: MorikawaFujiwara2013Crustal

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is active shallow crust

model = 'model1'

region = None

class openquake.hazardlib.gsim.morikawa_fujiwara_2013.MorikawaFujiwara2013SubSlabNE(**kwargs)

Bases: MorikawaFujiwara2013SubSlab

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is active shallow crust

model = 'model1'

region = 'NE'

class openquake.hazardlib.gsim.morikawa_fujiwara_2013.MorikawaFujiwara2013SubSlabSW(**kwargs)

Bases: MorikawaFujiwara2013SubSlabNE

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is active shallow crust

model = 'model1'

region = 'SW'

nath_2012

Module openquake.hazardlib.gsim.nath_2012 exports NathEtAl2012Lower NathEtAl2012Upper

class openquake.hazardlib.gsim.nath_2012.NathEtAl2012Lower(**kwargs)

Bases: GMPE

Implements GMPE of Nath et. al (2012) for intraplate margin seismicity in the Shillong Plateau of India at 25-45 km deph.

This model is based on stochastic simulation with a mean stress drop of 150 bars.

Verification of mean value data was done by digitizing Figure 11 using http://arohatgi.info/WebPlotDigitizer/app/. Note that this independent verification did not include magnitude dependence or standard deviations.

PGV is not provided in this gsim class because the coefficients within the paper provide physically unrealistic values.

Reference

Page number citations in this documentation refer to:

Nath, S. K., Thingbaijam, K. K. S., Maiti, S. K., and Nayak, A. (2012). Ground-motion predictions in Shillong region, northeast India. Journal of Seismology, 16(3):475–488.

COEFFS_BEDROCK = <CoeffsTable c1 c2 c3 c4 c5 c6 sigma>

Coefficients taken from Table 5, p. 483.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical'

In simulations only the vertical component is estimated (see p. 479) and the stochastic dataset is what the GMPE is based on, so this model effectively predicts vertical motions.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_REFERENCE_VELOCITY = 800.0

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

The only sigma is reported in the main coefficient table, Table 5 on p. 483, and must be the total standard deviation.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

“studies on micro-earthquakes indicated that reverse faulting is predominant in the region” (p. 476)

REQUIRES_DISTANCES = frozenset({'rrup'})

It is noted that “r_rup is the fault-rupture distance in kilometers” following equation (11) on p. 484.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Sole required rupture parameter is magnitude, since faulting style is not addressed.

REQUIRES_SITES_PARAMETERS = frozenset({})

no site parameters are defined, the GMPE is calibrated for rock ctx m/s (provisionally set to 800 for compatibility with SiteTerm class)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for specification of input and result values.

Implements equation (11) on p. 484:

ln(P) = c1 + c2*M + c3*(10 - M)^3 + c4*ln(R + c5*exp(c6*M)

class openquake.hazardlib.gsim.nath_2012.NathEtAl2012Upper(**kwargs)

Bases: NathEtAl2012Lower

Implements GMPE of Nath et. al (2012) for intraplate margin seismicity in the Shillong Plateau of India above 25 km deph.

This model is based on stochastic simulation with a mean stress drop of 40 bars.

COEFFS_UPPER = <CoeffsTable correction>

Coefficients taken from Table 6, p. 485.

nga_east

Module exports NGAEastGMPE and NGAEastGMPETotalSigma

openquake.hazardlib.gsim.nga_east.ITPL(mag, tu, tl, ml, f)

class openquake.hazardlib.gsim.nga_east.NGAEastGMPE(**kwargs)

Bases: GMPETable

A generalised base class for the implementation of a GMPE in which the mean values are determined from tables (input by the user) and the standard deviation model taken from Al Atik (2015). Should be common to all NGA East ground motion models.

The site amplification model is developed using the model described by Stewart et al. (2019) and Hashash et al. (2019). The model contains a linear and a non-linear component of amplification.

The linear model is described in Stewart et al., (2017) and Stewart et al (2019), with the latter taken as the authoritative source where differences arise:

Stewart, J. P., Parker, G. A., Harmon, J. A., Atkinson, G. A., Boore, D. M., Darragh, R. B., Silva, W. J. and Hashash, Y. M. A. (2017) “Expert Panel Recommendations for Ergodic Site Amplification in Central and Eastern North America”, PEER Report No. 2017/04, Pacific Earthquake Engineering Research Center, University of California, Berkeley.

Stewart, J. P., Parker, G. A., Atkinson, G. M., Boore, D. M., Hashash, Y. M. A. and Silva, W. J. (2019) “Ergodic Site Amplification Model for Central and Eastern North America”, Earthquake Spectra, in press

The nonlinear model is described in Hashash et al. (2017) and Hashash et al. (2019), with the latter taken as the authoritarive source where differences arise:

Hashash, Y. M. A., Harmon, J. A., Ilhan, O., Parker, G. and Stewart, J. P. (2017), “Recommendation for Ergonic Nonlinear Site Amplification in Central and Eastern North America”, PEER Report No. 2017/05, Pacific Earthquake Engineering Research Center, University of California, Berkeley.

Hashash, Y. M. A., Ilhan, O., Harmon, J. A., Parker, G. A., Stewart, J. P. Rathje, E. M., Campbell, K. W., and Silva, W. J. (2019) “Nonlinear site amplification model for ergodic seismic hazard analysis in Central and Eastern North America”, Earthquake Spectra, in press

Note that the uncertainty provided in this model is treated as an epistemic rather than aleatory variable. As such there is no modification of the standard deviation model used for the bedrock case. The epistemic uncertainty can be added to the model by the user input site_epsilon term, which describes the number of standard deviations by which to multiply the epistemic uncertainty model, to then be added or subtracted from the median amplification model

Parameters:

• tau_model (str) – Choice of model for the inter-event standard deviation (tau), selecting from “global” {default}, “cena” or “cena_constant”

• phi_model (str) – Choice of model for the single-station intra-event standard deviation (phi_ss), selecting from “global” {default}, “cena” or “cena_constant”

• phi_s2ss_model (str) – Choice of station-term s2ss model. Can be either “cena” or None. When None is input then the non-ergodic model is used

• TAU – Inter-event standard deviation model

• PHI_SS – Single-station standard deviation model

• PHI_S2SS – Station term for ergodic standard deviation model

• ergodic (bool) – True if an ergodic model is selected, False otherwise

• site_epsilon (float) – Number of standard deviations above or below median for the uncertainty in the site amplification model

COEFFS_F760 = <CoeffsTable f760i f760g f760is f760gs>

COEFFS_LINEAR = <CoeffsTable c v1 v2 vf sigma_vc sigma_L sigma_U>

COEFFS_NONLINEAR = <CoeffsTable f3 f4 f5 Vc sigma_c>

CONSTANTS = {'vL': 200.0, 'vU': 2000.0, 'vref': 760.0, 'vw1': 600.0, 'vw2': 400.0, 'wt1': 0.767, 'wt2': 0.1}

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

PATH = '/home/runner/work/oq-engine/oq-engine/openquake/hazardlib/gsim/nga_east_tables'

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Returns the mean and standard deviations

kind = 'nga_east'

class openquake.hazardlib.gsim.nga_east.NGAEastGMPETotalSigma(**kwargs)

Bases: NGAEastGMPE

The Al Atik (2015) standard deviation model defines mean and quantiles for the inter- and intra-event residuals. However, it also defines separately a total standard deviation model with expectation and quantiles. As the inter- and intra-event quantile cannot be recovered unambiguously from the total standard deviation quantile this form of the model is defined only for total standard deviation. Most likely it is this form that would be used for seismic hazard analysis.

Parameters:

• SIGMA – Total standard deviation model at quantile

• magnitude_limits (list) – Magnitude limits corresponding to the selected standard deviation model

• tau_keys (list) – Keys for the tau values corresponding to the selected standard deviation model

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

openquake.hazardlib.gsim.nga_east.cena_constant_tau(imt, mag, params)

Returns the inter-event tau for the constant tau case

openquake.hazardlib.gsim.nga_east.cena_tau(imt, mag, params)

Returns the inter-event standard deviation, tau, for the CENA case

openquake.hazardlib.gsim.nga_east.get_fnl(C_NL, pga_rock, vs30, period)

Returns the nonlinear mean amplification according to equation 2 of Hashash et al. (2019)

openquake.hazardlib.gsim.nga_east.get_hard_rock_mean(self, mag, ctx, imt)

Returns the mean and standard deviations for the reference very hard rock condition (Vs30 = 3000 m/s)

openquake.hazardlib.gsim.nga_east.get_linear_stddev(C_LIN, vs30, CONSTANTS)

Returns the standard deviation of the linear amplification function, as defined in equation 4 of Stewart et al., (2019)

openquake.hazardlib.gsim.nga_east.get_mean_amp(self, mag, ctx, imt)

openquake.hazardlib.gsim.nga_east.get_nonlinear_stddev(C_NL, vs30)

Returns the standard deviation of the nonlinear amplification function, as defined in equation 2.5 of Hashash et al. (2017)

openquake.hazardlib.gsim.nga_east.get_phi_s2ss_at_quantile(phi_model, quantile)

Returns the phi_s2ss value for all periods at the specific quantile as an instance of class::openquake.hazardlib.gsim.base.CoeffsTable

openquake.hazardlib.gsim.nga_east.get_phi_ss(imt, mag, params)

Returns the single station phi (or it’s variance) for a given magnitude and intensity measure type according to equation 5.14 of Al Atik (2015)

openquake.hazardlib.gsim.nga_east.get_phi_ss_at_quantile(phi_model, quantile)

Returns the phi_ss values at the specified quantile as an instance of class:: openquake.hazardlib.gsim.base.CoeffsTable - applies to the magnitude-dependent cases

openquake.hazardlib.gsim.nga_east.get_site_amplification(self, imt, pga_r, sites)

Returns the sum of the linear (Stewart et al., 2019) and non-linear (Hashash et al., 2019) amplification terms

openquake.hazardlib.gsim.nga_east.get_site_amplification_sigma(self, sites, f_rk, C_LIN, C_F760, C_NL)

Returns the epistemic uncertainty on the site amplification factor

openquake.hazardlib.gsim.nga_east.get_stddevs(self, mag, imt)

Returns the standard deviations for either the ergodic or non-ergodic models

openquake.hazardlib.gsim.nga_east.get_tau_at_quantile(mean, stddev, quantile)

Returns the value of tau at a given quantile in the form of a dictionary organised by intensity measure

openquake.hazardlib.gsim.nga_east.global_tau(imt, mag, params)

‘Global’ model of inter-event variability, as presented in equation 5.6 (p103)

nrcan15_site_term

Module openquake.hazardlib.mgmp.nrcan15_site_term implements NRCan15SiteTerm

openquake.hazardlib.gsim.mgmpe.nrcan15_site_term.BA08_AB06_base(kind, C, C2, vs30, imt, pgar)

Computes amplification factor similarly to what is done in the 2015 version of the Canada building code. An initial version of this code was kindly provided by Michal Kolaj - Geological Survey of Canada

Parameters:

• vs30 – Can be either a scalar or a ndarray instance

• imt – The intensity measure type

• pgar – The value of hazard on rock (vs30=760). Can be either a scalar or a ndarray instance. Unit of measure is fractions of gravity acceleration.

Returns:

A scalar or a ndarray instance with the amplification factor.

openquake.hazardlib.gsim.mgmpe.nrcan15_site_term.BA08_AB06_linear(kind, C, C2, vs30, imt, pgar)

Computes amplification factor using an approach similar to the one used for the 2015 Canada Buiding code. Michal Kolaj’s help is acknoledged.

Parameters:

• vs30 – an be either a scalar or a ndarray instance

• imt – The intensity measure type

• pgar – The value of hazard on rock (vs30=760). Can be either a scalar or a ndarray instance. Unit of measure is fractions of gravity acceleration.

Returns:

A scalar or a ndarray instance with the amplification factor.

class openquake.hazardlib.gsim.mgmpe.nrcan15_site_term.NRCan15SiteTerm(**kwargs)

Bases: GMPE

Implements a modified GMPE class that can be used to account for local soil conditions in the estimation of ground motion.

Parameters:

gmpe_name – The name of a GMPE class

COEFFS_AB06r = <CoeffsTable c>

COEFFS_BA08 = <CoeffsTable blin b1 b2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = ''

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_REFERENCE_VELOCITY = None

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = ''

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({})

Required distances are set on the underlying gmpe

REQUIRES_RUPTURE_PARAMETERS = frozenset({})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.mgmpe.nrcan15_site_term.NRCan15SiteTermLinear(**kwargs)

Bases: NRCan15SiteTerm

Implements a modified GMPE class that can be used to account for local soil conditions in the estimation of ground motion.

This site term issimilar in structure to the openquake.hazardlib.gsim.mgmpe.NRCan15SiteTerm in the OQengine but uses a different scaling of the motion for values of Vs30 greater than 760 m/s.

This implementation follows what suggested in http://www.daveboore.com/pubs_online/ab06_gmpes_programs_and_tables.pdf.

Parameters:

gmpe_name – The name of a GMPE class

COEFFS_AB06r = <CoeffsTable c>

COEFFS_BA08 = <CoeffsTable blin b1 b2>

kind = 'linear'

nshmp_2014

Module exports AtkinsonMacias2009NSHMP2014 and NSHMP2014

class openquake.hazardlib.gsim.nshmp_2014.NSHMP2014(**kwargs)

Bases: GMPE

Implements the NSHMP adjustment factors for the NGA West GMPEs. Requires two parameters gmpe_name (one of Idriss2014, ChiouYoungs2014, CampbellBozorgnia2014, BooreEtAl2014, AbrahamsonEtAl2014) and sgn (one of -1, 0, +1).

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = ()

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = ()

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({})

REQUIRES_DISTANCES is set at the instance level

REQUIRES_RUPTURE_PARAMETERS = ()

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = ()

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Compute mean, sig, tau, phi and returns the so called adjustment

openquake.hazardlib.gsim.nshmp_2014.nga_west2_epistemic_adjustment(mag, dist)

Applies the “average” adjustment factor for epistemic uncertainty as defined in Table 17 of Petersen et al., (2014):

            |  R < 10.  | 10.0 <= R < 30.0  |    R >= 30.0
-----------------------------------------------------------
  M < 6.0   |   0.37    |      0.22         |       0.22
6 <= M <7.0 |   0.25    |      0.23         |       0.23
  M >= 7.0  |   0.40    |      0.36         |       0.33

pankow_pechmann_2004

Module exports PankowPechmann2004.

class openquake.hazardlib.gsim.pankow_pechmann_2004.PankowPechmann2004(**kwargs)

Bases: GMPE

Implements GMPE developed by Kris L. Pankow and James C. Pechmann and published as “The SEA99 Ground-Motion Predictive Relations for Extensional Tectonic Regimes: Revisions and a New Peak Ground Velocity Relation” Bulletin of the Seismological Society of America, Vol. 94, No. 1, pp. 341–348, February 2004

COEFFS = <CoeffsTable Bv b1 b2 b3 b5 b6 h SlZ S3>

coefficient table provided by GSC (corrected as in the erratum)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is VECTORIAL VECTORIAL, NOTE: The paper indicates it as Geometric mean

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

TO CHECK PSV!

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust,

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb distance see paragraph ‘Predictor Variables’, page 6.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

No independent tests - verification against paper for PGA and PGV, but not for SA and Standard Deviations

parker_2020

Module exports ParkerEtAl2020SInter

ParkerEtAl2020SInterB ParkerEtAl2020SSlab ParkerEtAl2020SSlabB

class openquake.hazardlib.gsim.parker_2020.ParkerEtAl2020SInter(**kwargs)

Bases: GMPE

Implements Parker et al. (2020) for subduction interface.

COEFFS = <CoeffsTable c0 AK_c0 Aleutian_c0 Cascadia_c0 CAM_N_c0 CAM_S_c0 JP_Pac_c0 JP_Phi_c0 SA_N_c0 SA_S_c0 TW_E_c0 TW_W_c0 c0slab AK_c0slab Aleutian_c0slab Cascadia_c0slab CAM_c0slab JP_c0slab SA_N_c0slab SA_S_c0slab TW_c0slab c1 c1slab b4 a0 AK_a0 CAM_a0 JP_a0 SA_a0 TW_a0 a0slab AK_a0slab Cascadia_a0slab CAM_a0slab JP_a0slab SA_a0slab TW_a0slab c4 c5 c6 c4slab c5slab c6slab d m db V2 JP_s1 TW_s1 s2 AK_s2 Cascadia_s2 JP_s2 SA_s2 TW_s2 f4 f4slab f5 J_e1 J_e2 J_e3 C_e1 C_e2 C_e3 del_None del_Seattle Tau phi21 phi22 phi2V VM phi2S2S,0 a1 phi2SS,1 phi2SS,2 a2>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground acceleration and peak ground velocity

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

MB_REGIONS = {'AK': 8.6, 'Aleutian': 8, 'CAM_N': 7.4, 'CAM_S': 7.4, 'Cascadia': 7.7, 'JP_Pac': 8.5, 'JP_Phi': 7.7, 'SA_N': 8.5, 'SA_S': 8.6, 'TW_E': 7.1, 'TW_W': 7.1, 'default': 7.9}

REQUIRES_ATTRIBUTES = frozenset({'basin', 'region', 'saturation_region'})

Set of required GSIM attributes

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture, for interface events

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are only magnitude for the interface model

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Site amplification is dependent only upon Vs30

SUFFIX = ''

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.parker_2020.ParkerEtAl2020SInterB(**kwargs)

Bases: ParkerEtAl2020SInter

For Cascadia and Japan where basins are defined (also require z2pt5).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z2pt5'})

Site amplification is dependent only upon Vs30

class openquake.hazardlib.gsim.parker_2020.ParkerEtAl2020SSlab(**kwargs)

Bases: ParkerEtAl2020SInter

Modifications for subduction slab.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

MB_REGIONS = {'AK': 7.2, 'Aleutian': 7.98, 'CAM_N': 7.4, 'CAM_S': 7.6, 'Cascadia': 7.2, 'JP_Pac': 7.65, 'JP_Phi': 7.55, 'SA_N': 7.3, 'SA_S': 7.25, 'TW_E': 7.7, 'TW_W': 7.7, 'default': 7.6}

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are only magnitude for the interface model

SUFFIX = 'slab'

class openquake.hazardlib.gsim.parker_2020.ParkerEtAl2020SSlabB(**kwargs)

Bases: ParkerEtAl2020SSlab

For Cascadia and Japan where basins are defined (also require z2pt5).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z2pt5'})

Site amplification is dependent only upon Vs30

openquake.hazardlib.gsim.parker_2020.get_stddevs(C, rrup, vs30)

Returns the standard deviations. Generate tau, phi, and total sigma computed from both total and partitioned phi models.

pezeshk_2011

Module exports :class:’PezeshkEtAl2011’,

:class:’PezeshkEtAl2011NEHRPBC’.

class openquake.hazardlib.gsim.pezeshk_2011.PezeshkEtAl2011(**kwargs)

Bases: GMPE

Implements GMPE developed by Shahram Pezeshk, Arash Zandieh and Behrooz Tavakoli. Published as “Hybrid Empirical Ground-Motion Prediction Equations for Eastern North America Using NGA Models and Updated Seismological Parameters”, 2011, Bulletin of the Seismological Society of America, vol. 101, no. 4, 1859 - 1870.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 SigmaReg>

Equation coefficients, described in Table 2 on pp. 1865

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (GMRotI50)'

Geometric mean determined from the fiftieth percentile values of the geometric means computed for all nonredundant rotation angles and all periods less than the maximum useable period, independent of sensor orientation. See page 1864. :attr:’~openquake.hazardlib.const.IMC.GMRotI50’.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration. See Table 2 in page 1865

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total. See equation 6 and 7, page 1866.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is RRup, explained in page 1864 (eq. 2 page 1861, eq. 5 page 1866).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude (eq. 4, page 1866).

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.pezeshk_2011.PezeshkEtAl2011NEHRPBC(**kwargs)

Bases: PezeshkEtAl2011

Adaptation of Pezeshk et al. (2011) to amplify the ground motions from the original hard rock (Vs30 > 2000 m/s) ctx to the NEHRP B/C site class using the factors of Atkinson and Adams (2013) (Table 2) Note: 1) Correction at PGA is distance dependent in the original paper. Here we use a fixed distance of 20km (factor -0.10) 2) All periods between 0.05s and PGA are kept constant at -0.10 3) All periods above 5s are kept constant at 0.00 (no correction)

COEFFS_SITE = <CoeffsTable F>

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

phung_2020

Module exports PhungEtAl2020SInter

PhungEtAl2020SSlab PhungEtAl2020Asc

class openquake.hazardlib.gsim.phung_2020.PhungEtAl2020Asc(**kwargs)

Bases: GMPE

Implements Phung et al. (2020) for crustal.

COEFFS = <CoeffsTable c1 c1_a c1_b c1_c c1_d c3 c5 c6 c7 c7_b c8 c8_b c9 c9_a c9_b c11 c11_b c12 c12_b c_n c_m c_g2 c_g3 c_hm dp phi2 phi3 phi4 c_g1tw phi1tw dc_g1as c_g1ca phi1ca c_g1jp phi1jp c_g1glb phi1glb phi5tw phi5ca phi5jp tau phiss phis2s>

CONSTANTS = {'c2': 1.06, 'c4': -2.1, 'c4_a': -0.5, 'c8_a': -0.2695, 'c_rb': 50}

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_REFERENCE_VELOCITY = 1130

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rjb', 'rrup', 'rx'})

rx for hanging wall

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'mag', 'rake', 'ztor'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.phung_2020.PhungEtAl2020SInter(**kwargs)

Bases: GMPE

Implements Phung et al. (2020) for Subduction Interface.

COEFFS = <CoeffsTable a1 a1_del a2 a4 a4_del a5 a6jptw a6tw a7 a8jptw a8tw a10 a11 a12jptw a12tw a13 a14 b mref vlin tau4jptw phiss4jptw phis2s4jptw tau4tw phiss4tw phis2s4tw>

CONSTANTS = {'a3': 0.1, 'a9': 0.25, 'c': 1.88, 'c4': 10, 'n': 1.18}

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_REFERENCE_VELOCITY = 1000

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rrup'})

rjb and rx not required for subduction

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

dip and rake not required for subduction

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.phung_2020.PhungEtAl2020SSlab(**kwargs)

Bases: PhungEtAl2020SInter

Implements Phung et al. (2020) for Subduction Intraslab.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

openquake.hazardlib.gsim.phung_2020.get_stddevs(C)

Return standard deviations.

openquake.hazardlib.gsim.phung_2020.pga_rock(trt, region, s, C_PGA, mag, rrup, ztor, vs30)

PGA at Vs30 (as Taiwan region, C_PGA)

raghukanth_iyengar_2007

Module openquake.hazardlib.gsim.raghukanth_iyengar_2007 exports RaghukanthIyengar2007 RaghukanthIyengar2007KoynaWarna RaghukanthIyengar2007Southern RaghukanthIyengar2007WesternCentral

class openquake.hazardlib.gsim.raghukanth_iyengar_2007.RaghukanthIyengar2007(**kwargs)

Bases: GMPE

Implements GMPE of Raghukanth & Iyengar (2007) for stable continental regions of peninsular India.

This model is intended to be used to predict ground motions in peninsular India, a stable continental region with nonetheless significant seismic hazard (see Section 1 “Introduction”, p. 199 and Section 2 “Seismological model”, p. 200)

Page number citations in this documentation refer to:

Raghukanth, S. and Iyengar, R. (2007). Estimation of seismic spectral acceleration in peninsular India. Journal of Earth System Science, 116(3):199–214.

COEFFS_BEDROCK = <CoeffsTable c1 c2 c3 c4 sigma_bedrock>

Coefficients taken from Table 3, p. 205.

COEFFS_NEHRP = {'A': <CoeffsTable a1 a2 sigma>, 'B': <CoeffsTable a1 a2 sigma>, 'C': <CoeffsTable a1 a2 sigma>, 'D': <CoeffsTable a1 a2 sigma>}

Site class coefficients taken from Table 5, p. 208.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

This is not clear in the paper, but Figure 7 shows the model “compared with the average of the response spectrum of the two horizontal components” of a particular recording. GEOMETRIC_MEAN, see p. 211.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Although “the coefficients of [equation (1)] are obtained from the simulated database of SA by a two-step stratified regression following Joyner and Boore (1981)” (p. 203), the standard deviations of the intermediate steps are not reported, so only total standard deviation is supported.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is ‘stable continental’ since peninsular India “is similar to many other stable continental regions (SCR) of the world” (p. 200).

NEHRP_VS30_UPPER_BOUNDS = {'A': inf, 'B': 1500.0, 'C': 760.0, 'D': 360.0, 'E': 180.0}

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is hypocentral distance, see p. 203.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Sole required rupture parameter is magnitude, since faulting style is not addressed.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter Vs30 is used to determing the NEHRP site class, and thus to choose site amplification coefficients and site amplification stanard error from Table 5 on p. 208.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements the following equations:

Equation (8) on p. 203 for the bedrock ground motion:

ln(y_br) = c1 + c2*(M - 6) + c3*(M - 6)**2 - lnR - c4*R + ln(ε_br)

Equation (9) on p. 207 gives the site amplification factor:

ln(F_s) = a1*y_br + a2 + ln(δ_site)

Equation (10) on p. 207 for the ground motion at a given site:

y_site = y_br*F_s

Equation (11) on p. 207 for total standard error at a given site:

σ{ln(ε_site)} = sqrt(σ{ln(ε_br)}**2 + σ{ln(δ_site)}**2)

non_verified = True

Verification of mean value data was done by digitizing Figures 3 and 5 using http://arohatgi.info/WebPlotDigitizer/ app/. Maximum error was relatively high, approximately 10%, but could be reduced to approximately 1.5% by making the following changes to what may be typographical errors in the published coefficients. In each case the value sugstituted is interpolated from neighbouring values.

RaghukanthIyengar2007 COEFFS_BEDROCK (Table 3) at 1.200 s:

• change c1 from 0.2904 to 0.1904

RaghukanthIyengar2007 COEFFS_NEHRP_C (Table 5) at 0.750 s:

• change a1 from 0.36 to -0.30

RaghukanthIyengar2007Southern COEFFS_BEDROCK (Table 2(b)) at 2.000 s:

• change c4 from 0.0001 to 0.0010

Note that these would be in addition to the following more obvious correction which was implemented.

RaghukanthIyengar2007Southern COEFFS_BEDROCK (Table 2(b)) at 0.150 s:

• change c1 from .1941 to 2.1941

Note that since test data was dervied from Figures 3 and 5, PGA is not covered.

class openquake.hazardlib.gsim.raghukanth_iyengar_2007.RaghukanthIyengar2007KoynaWarna(**kwargs)

Bases: RaghukanthIyengar2007

Implements GMPE of Raghukanth & Iyengar (2007) for the Koyna-Warna region of India.

The Koyna-Warna region is defined for the purpose of this GMPE by Figure 2. It is approximately a circle of 2° radius centered on 17°N 75°E.

COEFFS_BEDROCK = <CoeffsTable c1 c2 c3 c4 sigma_bedrock>

Coefficients taken from Table 2(a), p. 202.

class openquake.hazardlib.gsim.raghukanth_iyengar_2007.RaghukanthIyengar2007Southern(**kwargs)

Bases: RaghukanthIyengar2007

Implements GMPE of Raghukanth & Iyengar (2007) for southern India.

Southern India is defined for the purpose of this GMPE by Figure 2, p. 201. It is that part of India which is south of a line from from approximately 22°N 72°E to 17°N 83°E and excluding the Koyna-Warna region, approximately a circle of 2° radius centered on 17°N 75°E.

Note that in Table 2(b) coefficient c1 at 0.150 s is inexplicably missing the digit before the decimal point. This was assumed to be “2”.

COEFFS_BEDROCK = <CoeffsTable c1 c2 c3 c4 sigma_bedrock>

Coefficients taken from Table 2(b), p. 203.

class openquake.hazardlib.gsim.raghukanth_iyengar_2007.RaghukanthIyengar2007WesternCentral(**kwargs)

Bases: RaghukanthIyengar2007

Implements GMPE of Raghukanth & Iyengar (2007) for western-central India.

Western-central India is defined for the purpose of this GMPE by Figure 2, p. 201. It is that part of India which is north of a line from from approximately 22°N 72°E to 17°N 83°E.

COEFFS_BEDROCK = <CoeffsTable c1 c2 c3 c4 sigma_bedrock>

Coefficients taken from Table 2(c), p. 204.

openquake.hazardlib.gsim.raghukanth_iyengar_2007.get_nehrp_classes(NEHRP_VS30_UPPER_BOUNDS, sites)

Site classification threshholds from Section 4 “Site correction coefficients” p. 205. Note that site classes E and F are not supported.

openquake.hazardlib.gsim.raghukanth_iyengar_2007.is_bedrock(sites)

A threshhold is not explicitly defined but the intention can be inferred from the statement that “The above results are valid at the bedrock level, with Vs nearly equal to 3.6 km/s.” p. 203

rietbrock_2013

Module exports RietbrockEtAl2013SelfSimilar,

RietbrockEtAl2013MagDependent

class openquake.hazardlib.gsim.rietbrock_2013.RietbrockEtAl2013MagDependent(**kwargs)

Bases: RietbrockEtAl2013SelfSimilar

Implements the Rietbrock et al (2013) GMPE for the case in which the stress parameter is magnitude-dependent (Table 6, Page 65)

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 sigma tau phi>

class openquake.hazardlib.gsim.rietbrock_2013.RietbrockEtAl2013SelfSimilar(**kwargs)

Bases: GMPE

Implements the ground motion prediction equation of Rietbrock et al (2013):

Rietbrock, A., Strasser, F., Edwards, B. (2013) A Stochastic Earthquake Ground-Motion Prediction Model for the United Kingdom. Bulletin of the Seismological Society of America, 103(1), 57 -77

The GMPE is derived for the United Kingdom, a low seismicity region. Consequently ground motions are generated via numerical simulations using a stochastic point-source model, calibrated with parameters derived from local weak-motion data. This implementation applies to the case when stress drop is considered to be self-similar (i.e. independent of magnitude).

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 sigma tau phi>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground acceleration and peak ground velocity.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stabe continental crust,

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameter is required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

rietbrock_edwards_2019

Module exports RietbrockEdwards2019Mean,

RietbrockEdwards2019Low, RietbrockEdwards2019Up

class openquake.hazardlib.gsim.rietbrock_edwards_2019.RietbrockEdwards2019Low(**kwargs)

Bases: RietbrockEdwards2019Mean

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 total tau phi>

class openquake.hazardlib.gsim.rietbrock_edwards_2019.RietbrockEdwards2019Mean(**kwargs)

Bases: GMPE

Implements the ground motion prediction equation of Rietbrock et al (2019):

Rietbrock, A., Edwards, B. (2019). Update of the UK stochastic ground motion model using a decade of broadband data. In Proceedings of the 2019 SECED conference.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 total tau phi>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground acceleration and peak ground velocity.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stabe continental crust,

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameter is required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.rietbrock_edwards_2019.RietbrockEdwards2019Up(**kwargs)

Bases: RietbrockEdwards2019Mean

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 total tau phi>

sadigh_1997

Module exports SadighEtAl1997.

openquake.hazardlib.gsim.sadigh_1997.COEFFS_SOIL_IMT_INDEPENDENT = {'c1r': -1.92, 'c1ss': -2.17, 'c2': 1.0, 'c3': 1.7, 'c4himag': 0.3825, 'c4lowmag': 2.1863, 'c5himag': 0.5882, 'c5lowmag': 0.32}

IMT-independent coefficients for deep soil ctx (table 4).

openquake.hazardlib.gsim.sadigh_1997.NEAR_FIELD_SATURATION_MAG = 6.5

Magnitude value to separate coefficients table because of near field saturation effect is 6.5. See page 184.

openquake.hazardlib.gsim.sadigh_1997.ROCK_VS30 = 750

If site vs30 is more than 750 m/s – treat the soil as rock. See page 180.

class openquake.hazardlib.gsim.sadigh_1997.SadighEtAl1997(**kwargs)

Bases: GMPE

Implements GMPE developed by Sadigh, K., C. -Y. Chang, J. A. Egan, F. Makdisi, and R. R. Youngs (1997) and published as “Attenuation relationships for shallow crustal earthquakes based on California strong motion data”, Seismological Research Letters, 68(1), 180-189.

COEFFS_ROCK_HIMAG = <CoeffsTable c1 c2 c3 c4 c5 c6 c7>

Coefficients tables for rock ctx (table 2), for magnitude values above NEAR_FIELD_SATURATION_MAG.

COEFFS_ROCK_LOWMAG = <CoeffsTable c1 c2 c3 c4 c5 c6 c7>

Coefficients tables for rock ctx (table 2), for magnitude values of NEAR_FIELD_SATURATION_MAG and below. Damping for spectral acceleration here and in other SA-tables is 5%, see “introduction” section.

COEFFS_ROCK_STDDERR = <CoeffsTable sigma0 magfactor maxsigma maxmag>

Coefficient tables for standard error on rock ctx (table 3).

COEFFS_SOIL = <CoeffsTable c6ss c6r c7 sigma0 magfactor maxmag>

Coefficient tables for deep soil ctx (table 4).

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two : horizontal components GEOMETRIC_MEAN, : see page 180.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see page 180.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total, see table 3.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, since data consists of California earthquakes mainly.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is RRup (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock and deep soil).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.sadigh_1997.get_mean_deep_soil(mag, rrup, is_reverse, C)

Calculate and return the mean intensity for deep soil ctx.

Implements an equation from table 4.

openquake.hazardlib.gsim.sadigh_1997.get_mean_rock(mag, rrup, is_reverse, low_coeffs, hi_coeffs)

Calculate and return the mean intensity for rock ctx.

Implements an equation from table 2.

openquake.hazardlib.gsim.sadigh_1997.get_stddev_deep_soil(mag, C)

Calculate and return total standard deviation for deep soil ctx.

Implements formulae from the last column of table 4.

openquake.hazardlib.gsim.sadigh_1997.get_stddev_rock(mag, C)

Calculate and return total standard deviation for rock ctx.

Implements formulae from table 3.

sera_amplification_models

Implements SERA site amplification models class:PitilakisEtAl2018, PitilakisEtAl2020, Eurocode8Amplification, Eurocode8AmplificationDefault,`SandikkayaDinsever2018`

class openquake.hazardlib.gsim.sera_amplification_models.Eurocode8Amplification(**kwargs)

Bases: PitilakisEtAl2018

Implements a general class to return a ground motion based on the Eurocode 8 design spectrum: CEN (2018): “Eurocode 8: Earthquake Resistant Design of Structures” Revised 2nd Draft SC8 PT1 - Rev 20

The potential notes highlighted in PitilakisEtAl2018 apply in this case too.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is horizontal HORIZONTAL,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are not set

DEFINED_FOR_REFERENCE_VELOCITY = 800.0

Defined reference velocity is 800 m/s

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type

DEFINED_FOR_TECTONIC_REGION_TYPE = ''

Supported tectonic region type is undefined (applies to any)

REQUIRES_DISTANCES = frozenset({})

Required distance metrics will be set by the GMPEs

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude, others will be set later

REQUIRES_SITES_PARAMETERS = frozenset({'h800', 'vs30'})

Required site parameters will be set be selected GMPES

kind = 'euro8'

class openquake.hazardlib.gsim.sera_amplification_models.Eurocode8AmplificationDefault(**kwargs)

Bases: Eurocode8Amplification

In the case that Vs30 and h800 are not known but a Eurocode 8 site class is otherwise determined then a set of default amplification factors are applied. This model implements the Eurocode 8 design spectrum

REQUIRES_SITES_PARAMETERS = frozenset({'ec8'})

Required site parameters are the EC8 site class, everything else will be set be selected GMPES

kind = 'euro8default'

class openquake.hazardlib.gsim.sera_amplification_models.PitilakisEtAl2018(**kwargs)

Bases: GMPE

Implements a site amplification model based on a design code approach, using the site characterisation and amplification coefficients proposed by Pitilakis et al. (2018) Pitilakis, K., Riga, E., Anastasiadis, A., Fotopoulou, S. and Karafagka, S. (2018) “Towards the revision of EC8: Proposal for an alternative site classification scheme and associated intensity dependent spectral amplification factors”, Soil Dynamics & Earthquake Engineering,

Care should be taken to note the following:

1. In the absence of a specific guidance from Eurocode 8 as to how the short period coefficient SS is determine from the UHS the choice is made to anchor the short period spectrum to PGA, with SS taken as being equal to 2.5 * PGA. This is implied by the Eurocode 8 decision to fix F0 to 2.5 and that the ground motion is fixed to SS / F0 for T -> 0

2. No uncertainty in amplification factor is presented in a code based approach and therefore the standard deviation of the original GMPE is retained.

Parameters:

• gmpe – Input ground motion prediction equation

• rock_vs30 (float) – Reference shearwave velocity used for the rock calculation

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is horizontal HORIZONTAL,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are not set

DEFINED_FOR_REFERENCE_VELOCITY = 800.0

Defined reference velocity is 800 m/s

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type

DEFINED_FOR_TECTONIC_REGION_TYPE = ''

Supported tectonic region type is undefined (applies to any)

F1 = {'A': [1.0, 1.0, 1.0, 1.0, 1.0, 1.0], 'B1': [1.4, 1.4, 1.4, 1.4, 1.3, 1.3], 'B2': [1.6, 1.5, 1.5, 1.5, 1.4, 1.3], 'C1': [1.7, 1.6, 1.5, 1.5, 1.4, 1.3], 'C2': [2.1, 2.0, 1.9, 1.8, 1.8, 1.7], 'C3': [3.2, 3.0, 2.7, 2.5, 2.4, 2.3], 'D': [4.1, 3.8, 3.3, 3.0, 2.8, 2.7], 'E': [1.3, 1.3, 1.2, 1.2, 1.2, 1.2]}

FS = {'A': [1.0, 1.0, 1.0, 1.0, 1.0, 1.0], 'B1': [1.3, 1.3, 1.2, 1.2, 1.2, 1.2], 'B2': [1.4, 1.3, 1.3, 1.2, 1.1, 1.1], 'C1': [1.7, 1.6, 1.4, 1.3, 1.3, 1.2], 'C2': [1.6, 1.5, 1.3, 1.2, 1.1, 1.0], 'C3': [1.8, 1.6, 1.4, 1.2, 1.1, 1.0], 'D': [2.2, 1.9, 1.6, 1.4, 1.2, 1.0], 'E': [1.7, 1.6, 1.6, 1.5, 1.5, 1.5]}

REQUIRES_DISTANCES = frozenset({})

Required distance metrics will be set by the GMPEs

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude, others will be set later

REQUIRES_SITES_PARAMETERS = frozenset({'ec8_p18', 'vs30'})

Required site parameters are Vs30 and the Pitilakis et al (2018) site class (others will be added for the GMPE in question)

compute(ctx: recarray, imts, mean, sig, tau, phi)

Returns the mean and standard deviations calling the input GMPE for the mean acceleration for PGA and Sa (1.0) on the reference rock, defining the amplification factors and code spectrum to return the mean ground motion at the desired period, before the calling the input GMPE once more in order to return the standard deviations for the required IMT.

kind = 'base'

class openquake.hazardlib.gsim.sera_amplification_models.PitilakisEtAl2020(**kwargs)

Bases: PitilakisEtAl2018

Adaptation of the Pitilakis et al. (2018) amplification model adopting the revised FS and F1 factors proposed by Pitilakis et al., (2020)

Pitilakis, K., Riga, E. and Anastasiadis, A. (2020), Towards the Revision of EC8: Proposal for an Alternative Site Classification Scheme and Associated Intensity-Dependent Amplification Factors. In the Proceedings of the 17th World Conference on Earthquake Engineering, 17WCEE, Sendai, Japan, September 13th to 18th 2020. Paper No. C002895.

F1 = {'A': [1.0, 1.0, 1.0, 1.0, 1.0, 1.0], 'B1': [1.1, 1.1, 1.1, 1.1, 1.1, 1.1], 'B2': [1.4, 1.4, 1.3, 1.3, 1.3, 1.3], 'C1': [1.5, 1.5, 1.4, 1.4, 1.4, 1.4], 'C2': [2.3, 2.2, 2.0, 1.9, 1.9, 1.8], 'C3': [2.4, 2.3, 2.1, 2.0, 2.0, 1.9], 'D': [4.0, 3.5, 3.0, 2.7, 2.4, 2.3], 'E': [1.2, 1.1, 1.1, 1.1, 1.1, 1.1]}

FS = {'A': [1.0, 1.0, 1.0, 1.0, 1.0, 1.0], 'B1': [1.3, 1.3, 1.3, 1.2, 1.2, 1.2], 'B2': [1.3, 1.3, 1.2, 1.2, 1.2, 1.1], 'C1': [1.7, 1.7, 1.6, 1.5, 1.5, 1.4], 'C2': [1.6, 1.5, 1.3, 1.2, 1.1, 1.0], 'C3': [1.7, 1.6, 1.4, 1.2, 1.2, 1.1], 'D': [1.8, 1.7, 1.5, 1.4, 1.3, 1.2], 'E': [1.7, 1.6, 1.6, 1.5, 1.5, 1.4]}

class openquake.hazardlib.gsim.sera_amplification_models.SandikkayaDinsever2018(**kwargs)

Bases: GMPE

Implements the nonlinear site amplification model of Sandikkaya & Dinsever (2018), see Sandikkaya, M. A. and Dinsever, L. D. (2018) “A Site Amplification Model for Crustal Earthquakes”, Geosciences, 264(8), doi:10.3390/geosciences8070264

Note that the nonlinear amplification model has its own standard deviation, which should be applied with the phi0 model of the original GMPE. This is not defined for all GMPEs in the literature, nor is the retrieval of it consistently applied in OpenQuake. Therefore we allow the user to define manually the input phi0 model, and if this is not possible a “default” phi0 is taken by reducing the original GMPE’s phi by 15 %.

The amplification model is compatible only with GMPEs with separate inter- and intra-event standard deviation, otherwise an error is raised.

Parameters:

• gmpe – Input GMPE for calculation on reference rock and standrd deviation at the period of interest on surface rock

• phi_0 – Single-station within-event standard deviation (as a period-dependent dictionary or None)

• region (str) – Defines the region for the region-adjusted version of the model

COEFFS_REG = <CoeffsTable ckUSNZ ckJP ckTW ckCH ckWA ckGRTR ckWMT ckNWE>

COEFFS_SITE = <CoeffsTable b1 b3 b2 sigma_s c0 c2 c1>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is horizontal HORIZONTAL,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are not set

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Defined reference velocity is 800 m/s

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type

DEFINED_FOR_TECTONIC_REGION_TYPE = ''

Supported tectonic region type is undefined

REQUIRES_DISTANCES = frozenset({})

Required distance metrics will be set by the GMPEs

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude, others will be set later

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z1pt0'})

Required site parameters will be set be selected GMPES

compute(ctx: recarray, imts, mean, sig, tau, phi)

Returns the mean and standard deviations

experimental = True

openquake.hazardlib.gsim.sera_amplification_models.get_amplification_factor_1(kind, F1, FS, s_s, s_1, sctx, ec8=None)

Returns the short and long-period amplification factors given the input Pitilakis et al. (2018) site class and the short and long-period input accelerations

openquake.hazardlib.gsim.sera_amplification_models.get_amplification_factor_2(kind, F1, FS, s_s_rp, s_1_rp, sctx, ec8)

Returns the amplification factors based on the proposed EC8 formulation in Table 3.4

openquake.hazardlib.gsim.sera_amplification_models.get_amplification_factor_3(kind, F1, FS, s_s_rp, s_1_rp, sctx, ec8=None)

Returns the default amplification factor dependent upon the site class

openquake.hazardlib.gsim.sera_amplification_models.get_amplified_mean(s_s, s_1, s_1_rp, imt)

Given the amplified short- and long-period input accelerations, returns the mean ground motion for the IMT according to the design spectrum construction in equations 1 - 5 of Pitilakis et al., (2018)

openquake.hazardlib.gsim.sera_amplification_models.get_ec8_class(vsh, h800)

Method to return the vector of Eurocode 8 site classes based on Vs30 and h800

openquake.hazardlib.gsim.sera_amplification_models.get_site_amplification(C, psarock, ctx, ck)

Returns the site amplification model define in equation (9)

openquake.hazardlib.gsim.sera_amplification_models.get_stddevs(phi_0, C, tau, phi, psa_rock, vs30, imt)

Returns the standard deviation adjusted for the site-response model

sgobba_2020

Module openquake.hazardlib.gsim.sgobba_2020 implements SgobbaEtAl2020

class openquake.hazardlib.gsim.sgobba_2020.Data(smodel, cluster, periods, betaS2S, idxs)

Bases: object

Helper class

class openquake.hazardlib.gsim.sgobba_2020.SgobbaEtAl2020(**kwargs)

Bases: GMPE

Implements the GMM proposed by Sgobba et al. (2020). Warning: This GMM is not meant for national models where it would be too slow, it is meant for scenario calculations.

Parameters:

• event_id – A string identifying an event amongst the ones comprised in the list available in the file event.csv

• directionality – A boolean

• cluster – If set to ‘None’, the OQ Engine finds the corresponding cluster using the rupture epicentral location. If cluster=0, no cluster correction applied. Otherwise, if an integer ID is provided, that corresponds to the cluster id (available cluster indexes are 1, 4 and 5), the corresponding correction id applied.

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 mref tau_ev tau_L2L phi_S2S_ref phi_S2S phi_P2P sigma_0 dL2L_cluster1 dL2L_cluster4 dL2L_cluster5>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

PERIODS = array([0.        , 0.2       , 0.50251256, 1.        , 2.        ])

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_lat', 'hypo_lon', 'mag'})

Required rupture parameters is magnitude, hypo_lat, hypo_lon

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon'})

Required site parameters are lon and lat

compute(ctx: recarray, imts, mean, sig, tau, phi)

Eq.1 - page 2

shahjouei_pezeshk_2016

Module exports :class:’ShahjoueiPezeshk2016’.

class openquake.hazardlib.gsim.shahjouei_pezeshk_2016.ShahjoueiPezeshk2016(**kwargs)

Bases: GMPE

Implements GMPE developed by Alireza Shahjouei and Shahram Pezeshk. Published as “Alternative Hybrid Empirical Ground‐Motion Model for Central and Eastern North America Using Hybrid Simulations and NGA‐West2 Models”, 2016, Bulletin of the Seismological Society of America, vol. 106, no. 2, 734 - 754.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 SigmaReg SigmaPar>

Equation coefficients, described in Table 2 on pp. 1865

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

An orientation-independent alternative to GEOMETRIC_MEAN. Defined at Boore et al. (2006, Bull. Seism. Soc. Am. 96, 1502-1511) and is used for all the NGA GMPEs. See page 742. :attr:’~openquake.hazardlib.const.IMC.RotD50’.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration. See Table 7 on page 743

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total. See equation 4 and 5, page 744. We use aleatory uncertainty as the total standard deviation since page 745 states, The epistemic uncertainty for an individual GMM is infrequently employed…

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb (eq. 3 page 742).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude (eq. 4, page 742).

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

GMPE not tested against independent implementation so raise not verified warning

sharma_2009

Module openquake.hazardlib.gsim.sharma_2009 exports SharmaEtAl2009

openquake.hazardlib.gsim.sharma_2009.NEHRP_BC_BOUNDARY = 760.0

Sharma et al. (2009) does not use VS30 so no threshhold is given. A value of 760 m/s was selected. This is consistent with openquake.hazardlib.gsim.atkinson_boore_2003, corresponds to NEHRP class A/B, and is close to the threshhold for Eurocode 8 Class 8 (800 m/s).

openquake.hazardlib.gsim.sharma_2009.RAKE_THRESH = 30.0

Rake threshhold of 30 degrees was selected, same as openquake.hazardlib.gsim.atkinson_boore_2006 and openquake.hazardlib.gsim.campbell_bozorgnia_2008. Contrast with 45 degree threshhold used by 30 degree threshhold used in openquake.hazardlib.gsim.zhao_2006.

class openquake.hazardlib.gsim.sharma_2009.SharmaEtAl2009(**kwargs)

Bases: GMPE

Implements GMPE of Sharma et al. (2009). This GMPE is intended for the Indian Himalayas but is based on data from both Zagros in Iran and the Himalayas. The combination of these two regions is motivated by the sparsity of near field data. Seismotectonic similarity is supposed based on both regions being continental collision zones, and in spite of the lack of subduction in Zagros.

Note that Figure 7-9 of Sharma et al. (2009) are in error (Sharma, personal communication). This implementation is verified against test vector obtained from lead author.

Support for PGA has been added by assuming it to be equal to the spectral acceleration at 0.04 s. This is assumed by the authors in the captions for Figures 11-13 anyway.

Reference:

Sharma, M. L., Douglas, J., Bungum, H., and Kotadia, J. (2009). Ground-motion prediction equations based on data from the Himalayan and Zagros regions. Journal of Earthquake Engineering, 13(8):1191–1210.

ALREADY_WARNED = False

COEFFS = <CoeffsTable b1 b2 b3 b4 b5 b6 sigma>

Coefficients taken from Table 2, p. 1202. Note that “In this article, only the coefficients for a subset of these periods [between 0.04 and 2.5 s] are reported” and the damping is 5% (Sharma et al., 2009, p. 1200). “After trials with different values b4 was fixed to be 15km for all periods.” (Sharma et al., 2009, p. 1201)

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN, see p. 1200.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Only total standard deviation is supported, see Table 2, p. 1202.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’ however as inndicated the introduction the tectonics of the Himalayas have a “great range of focal depths” (Sharma et al., 2009, p. 1192).

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Joyner-Boore distance, see p. 1200

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake, see equation (1) on p. 1200. Rake is used to distinguish between reverse and strike-slip faulting, and to detect mis-application of GMPE to normal faulting.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter Vs30 is used to set binary rock/soil classification dummy variable, see equation (1) on p. 1200.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for specification of input and result values.

openquake.hazardlib.gsim.sharma_2009.get_fault_type_dummy_variables(ctx, warned=[False])

Fault-type classification dummy variable based on ctx.rake.

“H is 1 for a strike-slip mechanism and 0 for a reverse mechanism” (p. 1201).

Note:

UserWarning is raised if mechanism is determined to be normal faulting, since as summarized in Table 2 on p. 1197 the data used for regression included only reverse and stike-slip events.

openquake.hazardlib.gsim.sharma_2009.get_site_type_dummy_variables(ctx)

Binary rock/soil classification dummy variable based on ctx.vs30.

“S is 1 for a rock site and 0 otherwise” (p. 1201).

si_midorikawa_1999

Module exports SiMidorikawa1999Asc, SiMidorikawa1999SInter, SiMidorikawaSSlab, SiMidorikawa1999SInterNorthEastCorrection, SiMidorikawa1999SInterSouthWestCorrection, SiMidorikawa1999SSlabNorthEastCorrection and SiMidorikawa1999SSlabSouthWestCorrection.

class openquake.hazardlib.gsim.si_midorikawa_1999.SiMidorikawa1999Asc(**kwargs)

Bases: GMPE

Implements GMPE developed by Hongjun Si and Saburoh Midorikawa (1999) as described in “Technical Reports on National Seismic Hazard Maps for Japan” (2009, National Research Institute for Earth Science and Disaster Prevention, Japan, pages 148-151). This class implements the equations for ‘Active Shallow Crust’ (that’s why the class name ends with ‘Asc’).

AMP_F = 1.41

Amplification factor to scale PGV from 600 to 400 m/s vs30, see equation 3.5.1-1 page 148

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Greater of two horizontal'

Supported intensity measure component is greater of of two horizontal components : attr:~openquake.hazardlib.const.IMC.GREATER_OF_TWO_HORIZONTAL

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>})

Supported intensity measure type is PGV

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude, and hypocentral depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements equation 3.5.1-1 page 148 for mean value and equation 3.5.5-2 page 151 for total standard deviation.

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.si_midorikawa_1999.SiMidorikawa1999SInter(**kwargs)

Bases: SiMidorikawa1999Asc

Implements GMPE developed by Hongjun Si and Saburoh Midorikawa (1999) as described in “Technical Reports on National Seismic Hazard Maps for Japan” (2009, National Research Institute for Earth Science and Disaster Prevention, Japan, pages 148-151). This class implements the equations for ‘Subduction Interface’ (that’s why the class name ends with ‘SInter’).

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements equation 3.5.1-1 page 148 for mean value and equation 3.5.5-1 page 151 for total standard deviation.

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.si_midorikawa_1999.SiMidorikawa1999SInterNorthEastCorrection(**kwargs)

Bases: SiMidorikawa1999SInter

Extend SiMidorikawa1999SInter and takes into account correction for northeast Japan (i.e. proximity to subduction trench)

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements equation 3.5.1-1 page 148 for mean value and equation 3.5.5-1 page 151 for total standard deviation.

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.si_midorikawa_1999.SiMidorikawa1999SInterSouthWestCorrection(**kwargs)

Bases: SiMidorikawa1999SInter

Extend SiMidorikawa1999SInter and takes into account correction for southwest Japan (i.e. proximity with volcanic front)

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements equation 3.5.1-1 page 148 for mean value and equation 3.5.5-1 page 151 for total standard deviation.

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.si_midorikawa_1999.SiMidorikawa1999SSlab(**kwargs)

Bases: SiMidorikawa1999SInter

Implements GMPE developed by Hongjun Si and Saburoh Midorikawa (1999) as described in “Technical Reports on National Seismic Hazard Maps for Japan” (2009, National Research Institute for Earth Science and Disaster Prevention, Japan, pages 148-151). This class implements the equations for ‘Subduction IntraSlab’ (that’s why the class name ends with ‘SSlab’).

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction intraslab

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements equation 3.5.1-1 page 148 for mean value and equation 3.5.5-1 page 151 for total standard deviation.

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.si_midorikawa_1999.SiMidorikawa1999SSlabNorthEastCorrection(**kwargs)

Bases: SiMidorikawa1999SSlab

Extend SiMidorikawa1999SSlab and takes into account correction for northeast Japan (i.e. proximity to subduction trench)

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements equation 3.5.1-1 page 148 for mean value and equation 3.5.5-1 page 151 for total standard deviation.

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.si_midorikawa_1999.SiMidorikawa1999SSlabSouthWestCorrection(**kwargs)

Bases: SiMidorikawa1999SSlab

Extend SiMidorikawa1999SSlab and takes into account correction for southwest Japan (i.e. proximity to volcanic front)

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Implements equation 3.5.1-1 page 148 for mean value and equation 3.5.5-1 page 151 for total standard deviation.

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.si_midorikawa_1999.set_mean(imt, mag, hypo_depth, rrup, d, mean)

Return mean value as defined in equation 3.5.1-1 page 148

openquake.hazardlib.gsim.si_midorikawa_1999.set_sig_asc(trt, rrup, sig)

Set standard deviation as defined in equation 3.5.5-2 page 151

openquake.hazardlib.gsim.si_midorikawa_1999.set_sig_sub(trt, pgv, sig)

Set standard deviation as defined in equation 3.5.5-1 page 151

si_2020

Module exports SiEtAl2020SInter

SiEtAl2020SSlab

class openquake.hazardlib.gsim.si_2020.SiEtAl2020SInter(**kwargs)

Bases: GMPE

Implements NGA Subduction model of Si, Midorikawa, Kishida (2020) for interface events

Si H, Midorikawa S, Kishida T (2020) “Development of NGA-Sub Ground-Motion Model of 5%-Damped Psuedo-Spectral Acceleration Based on Database for Subduction Earthquakes in Japan” PEER Report No. 2020/06

Implementation is based on preliminary PEER report and R implementation obtained from T. Kishida on 09/16/2020

COEFFS = <CoeffsTable e a1 d0 d1 a2 h Cd Dd c Vc Vref f1 f3 f4 f5 phi tau sigma Mb c_gs c_attn>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent average horizontal GMRotI50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see section “Aleatory Variability Model”, page 1094.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and hypocentral deph

REQUIRES_SITES_PARAMETERS = frozenset({'vs30', 'z2pt5'})

Required site parameters are Vs30 and Z2.5

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.si_2020.SiEtAl2020SSlab(**kwargs)

Bases: SiEtAl2020SInter

Implements NGA Subduction model of Si, Midorikawa, Kishida (2020) For Intraslab events.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction interface

openquake.hazardlib.gsim.si_2020.get_anelastic_attenuation_term(C, rrup)

Returns the anelastic attenuation term (Eq. 3.15) The period dependent coefficients are calculated and added to the coefficients table.

openquake.hazardlib.gsim.si_2020.get_base_term(trt, C)

Returns the constant term of the GMM. Depends on tectonic type

openquake.hazardlib.gsim.si_2020.get_basin_response_term(C, z_value)

Returns the basin response term (Eq. 3.10)

openquake.hazardlib.gsim.si_2020.get_depth_scaling_term(C, hypo_depth)

Returns the depth scaling term (Eqation 3.16)

openquake.hazardlib.gsim.si_2020.get_geometric_attenuation_term(C, ctx)

Returns the geometric attenuation term (Eq. 3.13/3.14) Period dependent coefficients are calculated and added to the coefficients table.

openquake.hazardlib.gsim.si_2020.get_magnitude_scaling_term(C, imt, mag)

Returns the magnitude scaling term (Equation 3.16)

openquake.hazardlib.gsim.si_2020.get_mean_values(C, trt, imt, ctx, a760)

Returns the mean values for a specific IMT

openquake.hazardlib.gsim.si_2020.get_moho_depth(ctx)

get Moho depth dependent on hypocenter location for now, return 30km everywhere

openquake.hazardlib.gsim.si_2020.get_shallow_site_response_term(C, vs30, pga760)

Returns the shallow site response term (Eq. 3.2 tp 3.4)

silva_2002

Module exports SilvaEtAl2002MblgAB1987NSHMP2008, SilvaEtAl2002MblgJ1996NSHMP2008, SilvaEtAl2002MwNSHMP2008, SilvaEtAl2002SingleCornerSaturation, SilvaEtAl2002DoubleCornerSaturation.

class openquake.hazardlib.gsim.silva_2002.SilvaEtAl2002DoubleCornerSaturation(**kwargs)

Bases: SilvaEtAl2002MwNSHMP2008

This implements the Silva et al. (2002) GMPE for the double corner model with saturation as described in the report from Silva, W., N. Gregor and R. Darragh (2002), titled “DEVELOPMENT OF REGIONAL HARD ROCK ATTENUATION RELATIONS FOR CENTRAL AND EASTERN NORTH AMERICA” available at www.pacificengineering.org

For the construction of verification tables - given the unavailability of an independent code - we digitized values from figures included in the report.

COEFFS = <CoeffsTable c1 c2 c4 c5 c6 c7 c8 c10 sigma_par sigma>

Coefficient table obtained from coefficient arrays (c1, c2, c4, c6, c7, c10, sigma) defined in suroutine getSilva in hazgridXnga2.f

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'Mw'

class openquake.hazardlib.gsim.silva_2002.SilvaEtAl2002MblgAB1987NSHMP2008(**kwargs)

Bases: GMPE

Implements GMPE developed by Walter Silva, Nick Gregor and Robert Darragh and documented in “Development of regional hard rock attenuation relations for central and eastern north America” (2002). Document available at: http://pbadupws.nrc.gov/docs/ML0423/ML042310569.pdf

This class replicates the algorithm as coded in the subroutine getSilva in the hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

The class assumes rupture magnitude to be in Mblg scale (given that MFDs for central and eastern US are given in this scale). Therefore Mblg is converted to Mw using the Atkinson & Boore 1987 conversion equation.

Coefficients are given for the B/C site conditions.

COEFFS = <CoeffsTable c1 c2 c4 c6 c7 c10 sigma>

Coefficient table obtained from coefficient arrays (c1, c2, c4, c6, c7, c10, sigma) defined in suroutine getSilva in hazgridXnga2.f

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the average horizontal component

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust, given that the equations have been derived for central and eastern north America

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude (Mblg).

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'Mblg87'

class openquake.hazardlib.gsim.silva_2002.SilvaEtAl2002MblgJ1996NSHMP2008(**kwargs)

Bases: SilvaEtAl2002MblgAB1987NSHMP2008

Extend SilvaEtAl2002MblgAB1987NSHMP2008 but uses Johnston 1996 equation for converting Mblg to Mw.

kind = 'Mblg96'

class openquake.hazardlib.gsim.silva_2002.SilvaEtAl2002MwNSHMP2008(**kwargs)

Bases: SilvaEtAl2002MblgAB1987NSHMP2008

Extend SilvaEtAl2002MblgAB1987NSHMP2008 but assumes magnitude to be in Mw scale, therefore no conversion is applied

kind = 'Mw'

class openquake.hazardlib.gsim.silva_2002.SilvaEtAl2002SingleCornerSaturation(**kwargs)

Bases: SilvaEtAl2002DoubleCornerSaturation

This implements the Silva et al. (2002) GMPE for the single corner model with saturation.

COEFFS = <CoeffsTable c1 c2 c4 c5 c6 c7 c8 c10 sigma_par sigma>

Coefficient table obtained from coefficient arrays (c1, c2, c4, c6, c7, c10, sigma) defined in suroutine getSilva in hazgridXnga2.f

kind = 'Mw'

skarlatoudis_2013

Module exports SkarlatoudisEtAlSSlab2013.

class openquake.hazardlib.gsim.skarlatoudis_2013.SkarlatoudisEtAlSSlab2013(**kwargs)

Bases: GMPE

Implements GMPEs developed by A.A.Skarlatoudis, C.B.Papazachos, B.N.Margaris, C.Ventouzi, I.Kalogeras and EGELADOS group published as “Ground-Motion Prediction Equations of Intermediate-Depth Earthquakes in the Hellenic Arc, Southern Aegean Subduction Area“, Bull Seism Soc Am, DOI 10.1785/0120120265 SA are given up to 4 s. The regressions are developed considering the RotD50 (Boore, 2010) of the as-recorded horizontal components

COEFFS = <CoeffsTable c1 c2 c32 c41 c42 c51 c52 c61 c62 sigma tau epsilon>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the RotD50 of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, page 1961

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is ‘subduction intraslab’ because the equations have been derived from data from Hellenic Arc events, as explained in the ‘Introduction’.

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and hypocentral depth

REQUIRES_SITES_PARAMETERS = frozenset({'backarc', 'vs30'})

Required site parameter is Vs30 and backarc flag

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.skarlatoudis_2013.SkarlatoudisEtAlSSlab2013_scaled(**kwargs)

Bases: SkarlatoudisEtAlSSlab2013

Implements GMPEs developed by A.A.Skarlatoudis, C.B.Papazachos, B.N.Margaris, C.Ventouzi, I.Kalogeras and EGELADOS group published as “Ground-Motion Prediction Equations of Intermediate-Depth Earthquakes in the Hellenic Arc, Southern Aegean Subduction Area“, Bull Seism Soc Am, DOI 10.1785/0120120265

Application of a scaling factor that converts the prediction of SkarlatoudisEtAlSSlab2013 to the corresponding prediction for the Maximum value.

COEFFS = <CoeffsTable c1 c2 c32 c41 c42 c51 c52 c61 c62 sigma tau epsilon>

somerville_2001

Module exports SomervilleEtAl2001NSHMP2008.

class openquake.hazardlib.gsim.somerville_2001.SomervilleEtAl2001NSHMP2008(**kwargs)

Bases: GMPE

Implements GMPE developed by P. Somerville, N. Collins, N. Abrahamson, R. Graves, and C. Saika and documented in “GROUND MOTION ATTENUATION RELATIONS FOR THE CENTRAL AND EASTERN UNITED STATES” (Final report, June 30, 2001: Report to U.S. Geological Survey for award 99HQGR0098). This GMPE is used by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 US hazard model.

Document available at: http://earthquake.usgs.gov/hazards/products/conterminous/2002/99HQGR0098.pdf

This class replicates the algorithm for the Somerville et. al. 2001 GMPE as coded in the subroutine getSomer in the hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

Coefficients are given for the B/C site conditions.

COEFFS = <CoeffsTable a1 a2 a3 a4 a5 a6 a7 sigma>

Coefficient table obtained from coefficient arrays (a1, a2, a3, a4, a5, a6, a7, sig0) defined in subroutine getSomer in hazgridXnga2.f

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two : horizontal components attr:~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust, given that the equations have been derived for central and eastern north America

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude (Mw).

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

somerville_2009

Module exports SomervilleEtAl2009NonCratonic, SomervilleEtAl2009YilgarnCraton SomervilleEtAl2009NonCratonic_SS14 SomervilleEtAl2009YilgarnCraton_SS14

class openquake.hazardlib.gsim.somerville_2009.SomervilleEtAl2009NonCratonic(**kwargs)

Bases: GMPE

Implements GMPE developed by P. Somerville, R. Graves, N. Collins, S. G. Song, S. Ni, and P. Cummins for Non-Cratonic Australia published in “Source and Ground Motion Models for Australian Earthquakes”, Report to Geoscience Australia (2009). Document available at: http://www.ga.gov.au/cedda/publications/193?yp=2009

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 sigma>

Coefficients taken from table 3

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

The supported intensity measure component is set to ‘average horizontal’, however the original paper does not report this information

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

The supported intensity measure types are PGA, PGV, and SA, see table 3

DEFINED_FOR_REFERENCE_VELOCITY = 800.0

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

The supported standard deviations is total, see tables 3

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

The supported tectonic region type is stable continental region

REQUIRES_DISTANCES = frozenset({'rjb'})

The required distance parameter is ‘Joyner-Boore’ distance, see table 2

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

The required rupture parameter is magnitude, see table 2

REQUIRES_SITES_PARAMETERS = frozenset({})

no site parameters are defined, the GMPE is calibrated for Vs30 = 865 m/s (provisionally set to 800 for compatibility with SiteTerm class)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

Implement equations as defined in table 2.

class openquake.hazardlib.gsim.somerville_2009.SomervilleEtAl2009NonCratonic_SS14(**kwargs)

Bases: SomervilleEtAl2009NonCratonic

SomervilleEtAl2009NonCratonic model updated to apply the linear and non-linear amplification factors of Sayhan & Stewart (2014) as applied in the Boore et al (2014) NGE-West 2 GMMfor use in Geoscience Australia ShakeMap

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.somerville_2009.SomervilleEtAl2009YilgarnCraton(**kwargs)

Bases: SomervilleEtAl2009NonCratonic

Implements GMPE developed by P. Somerville, R. Graves, N. Collins, S. G. Song, S. Ni, and P. Cummins for Yilgarn Craton published in “Source and Ground Motion Models for Australian Earthquakes”, Report to Geoscience Australia (2009). Document available at: http://www.ga.gov.au/cedda/publications/193?yp=2009

Extends openquake.hazardlib.gsim.somerville_2009.SomervilleEtAl2009NonCratonic because the same functional form is used, only the coefficents differ.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 sigma>

Coefficients taken from table 4

class openquake.hazardlib.gsim.somerville_2009.SomervilleEtAl2009YilgarnCraton_SS14(**kwargs)

Bases: SomervilleEtAl2009YilgarnCraton

SomervilleEtAl2009YilgarnCraton model updated to apply the linear and non-linear amplification factors of Sayhan & Stewart (2014) as applied in the Boore et al (2014) NGE-West 2 GMM for use in Geoscience Australia ShakeMap

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

stewart_2016

Module exports StewartEtAl2016,

StewartEtAl2016RegCHN, StewartEtAl2016RegJPN, StewartEtAl2016NoSOF, StewartEtAl2016RegCHNNoSOF, StewartEtAl2016RegJPNNoSOF,

class openquake.hazardlib.gsim.stewart_2016.StewartEtAl2016(**kwargs)

Bases: BooreEtAl2014

Implements the SBSA15 GMPE by Stewart et al. (2016) for vertical-component ground motions from the PEER NGA-West2 Project.

This model follows the same functional form as in BSSA14 by Boore et al. (2014) with minor modifications.

Note that this is a more updated version than the GMPE described in the original PEER Report 2013/24.

Reference:

Stewart, J., Boore, D., Seyhan, E., & Atkinson, G. (2016). NGA-West2 Equations for Predicting Vertical-Component PGA, PGV, and 5%-Damped PSA from Shallow Crustal Earthquakes. Earthquake Spectra, 32(2), 1005-1031.

COEFFS = <CoeffsTable e0 e1 e2 e3 e4 e5 e6 Mh c1 c2 c3 Dc3CH Dc3JP h c Vc f4 f5 tau1 tau2 phi1 phi2>

Table of period-dependent regression coefficients obtained from the supplementary material in EQS paper

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical'

Supported intensity measure component is the Vertical direction component; see title.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration; see title.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total; see the section for “Aleatory-Uncertainty Function”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust; see title.

REQUIRES_ATTRIBUTES = frozenset({'region', 'sof'})

Set of required GSIM attributes

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (style-of-faulting).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30

kind = 'stewart'

region = 'CAL'

stewart_2016_vh

Module exports StewartEtAl2016VH,

StewartEtAl2016RegCHNVH, StewartEtAl2016RegJPNVH, StewartEtAl2016NoSOFVH, StewartEtAl2016RegCHNNoSOFVH, StewartEtAl2016RegJPNNoSOFVH,

class openquake.hazardlib.gsim.stewart_2016_vh.StewartEtAl2016NoSOFVH(**kwargs)

Bases: StewartEtAl2016VH

The Stewart et al. (2016) V/H GMPE can consider the case in which the style-of-faulting is unspecified. In this case the GMPE is no longer dependent on rake.

HGMPE = [BooreEtAl2014]

VGMPE = [StewartEtAl2016]

class openquake.hazardlib.gsim.stewart_2016_vh.StewartEtAl2016RegCHNNoSOFVH(**kwargs)

Bases: StewartEtAl2016RegCHNVH

The Stewart et al. (2016) V/H GMPE, implemented for High Q regional datasets, (e.g. China) for the case in which the style-of-faulting is unspecified. In this case the GMPE is no longer dependent on rake.

HGMPE = [BooreEtAl2014HighQ]

VGMPE = [StewartEtAl2016]

class openquake.hazardlib.gsim.stewart_2016_vh.StewartEtAl2016RegCHNVH(**kwargs)

Bases: StewartEtAl2016VH

This class implements the Stewart et al. (2016) V/H model considering the correction to the path scaling term for High Q regions (e.g. China)

HGMPE = [BooreEtAl2014HighQ]

VGMPE = [StewartEtAl2016]

class openquake.hazardlib.gsim.stewart_2016_vh.StewartEtAl2016RegJPNNoSOFVH(**kwargs)

Bases: StewartEtAl2016RegJPNVH

The Stewart et al. (2016) V/H GMPE, implemented for Low Q regional datasets, (e.g. Japan) for the case in which the style-of-faulting is unspecified. In this case the GMPE is no longer dependent on rake.

HGMPE = [BooreEtAl2014LowQ]

VGMPE = [StewartEtAl2016]

class openquake.hazardlib.gsim.stewart_2016_vh.StewartEtAl2016RegJPNVH(**kwargs)

Bases: StewartEtAl2016VH

This class implements the Stewart et al. (2016) V/H model considering the correction to the path scaling term for Low Q regions (e.g. Japan)

HGMPE = [BooreEtAl2014LowQ]

VGMPE = [StewartEtAl2016]

class openquake.hazardlib.gsim.stewart_2016_vh.StewartEtAl2016VH(**kwargs)

Bases: BozorgniaCampbell2016VH

Implements the SBSA15b GMPE by Stewart et al. (2016) vertical-to-horizontal ratio (V/H) for ground motions from the PEER NGA-West2 Project.

This V/H model is combined from SBSA15 by Stewart et al. (2016) as the vertical model, and BSSA14 by Boore et al. (2014) as the horizontal model.

Note that this is a more updated version than the GMPE described in the original PEER Report 2013/24.

Reference:

Stewart, J., Boore, D., Seyhan, E., & Atkinson, G. (2016). NGA-West2 Equations for Predicting Vertical-Component PGA, PGV, and 5%-Damped PSA from Shallow Crustal Earthquakes. Earthquake Spectra, 32(2), 1005-1031.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Vertical-to-Horizontal Ratio'

Supported intensity measure component is the VERTICAL_TO_HORIZONTAL_RATIO

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration; see title.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total; see the section for “Aleatory Variability Model”.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust; see title.

HGMPE = [BooreEtAl2014]

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measures are taken from the V and H models

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are taken from the V and H models

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters are taken from the V and H models

VGMPE = [StewartEtAl2016]

tavakoli_pezeshk_2005

Module exports TavakoliPezeshk2005, TavakoliPezeshk2005MblgAB1987NSHMP2008, TavakoliPezeshk2005MblgJ1996NSHMP2008, TavakoliPezeshk2005MwNSHMP2008

class openquake.hazardlib.gsim.tavakoli_pezeshk_2005.TavakoliPezeshk2005(**kwargs)

Bases: GMPE

Implements the GMPE developed by B. Tavakoli and S. Pezeshk in 2005 and published as “Empirical-Stochastic Ground-Motion Prediction for Eastern North America” (2005, Bull. Seism. Soc. Am., Volume 95, No. 6, pages 2283-2296).

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 c15 c16>

Coefficient table is constructed from an excel spreadsheet available on Pezeshk’s website http://www.ce.memphis.edu/pezeshk

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure horizontal.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are peak ground acceleration and spectral acceleration, see abstract

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total, see equation 23, pag 2291.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup. See equation 18 page page 2291

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters is magnitude See equation 18 page page 2291

REQUIRES_SITES_PARAMETERS = frozenset({})

This GMPE doesn’t require site parameters since it has been developed for hard rock ctx (see page 2290)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

class openquake.hazardlib.gsim.tavakoli_pezeshk_2005.TavakoliPezeshk2005MblgAB1987NSHMP2008(**kwargs)

Bases: TavakoliPezeshk2005

Extend TavakoliPezeshk2005 and implements equation as defined by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 US model.

The class replicates the equation as coded in suroutine getTP05 in hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

The class assumes rupture magnitude to be in Mblg scale. Therefore Mblg is converted to Mw using the Atkinson & Boore 1987 conversion equation.

Coefficients are given for the B/C site conditions.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 c15 c16>

Coefficient table is constructed using the values included in hazgridXnga2.f

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

kind = 'Mblg2008'

class openquake.hazardlib.gsim.tavakoli_pezeshk_2005.TavakoliPezeshk2005MblgJ1996NSHMP2008(**kwargs)

Bases: TavakoliPezeshk2005MblgAB1987NSHMP2008

Extend TavakoliPezeshk2005MblgAB1987NSHMP2008 but uses Johnston 1996 equation to convert Mblg to Mw

kind = 'Mblg'

class openquake.hazardlib.gsim.tavakoli_pezeshk_2005.TavakoliPezeshk2005MwNSHMP2008(**kwargs)

Bases: TavakoliPezeshk2005MblgAB1987NSHMP2008

Extend TavakoliPezeshk2005MblgAB1987NSHMP2008 but assumes magnitude to be in Mw scale, and therefore no conversion is applied

kind = '2008'

example_a_2021

class openquake.hazardlib.gsim.example_a_2021.ExampleA2021(**kwargs)

Bases: GMPE

Mimic ToroEtAl2002

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 m50 m55 m80 r5 r20>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Reference to a intensity measure component type this GSIM can calculate mean and standard deviation for.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Set of standard deviation types this GSIM can calculate.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Reference to a tectonic region type this GSIM is defined for. One GSIM can implement only one tectonic region type.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Set of rupture parameters (excluding distance information) required by GSIM. Supported parameters are:

mag

Magnitude of the rupture.

dip

Rupture’s surface dip angle in decimal degrees.

rake

Angle describing the slip propagation on the rupture surface, in decimal degrees. See nodalplane for more detailed description of dip and rake.

ztor

Depth of rupture’s top edge in km. See get_top_edge_depth().

These parameters are available from the RuptureContext object attributes with same names.

REQUIRES_SITES_PARAMETERS = frozenset({})

Set of site parameters names this GSIM needs. The set should include strings that match names of the attributes of a site object. Those attributes are then available in the SitesContext object with the same names.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

toro_1997

Module exports ToroEtAl1997MblgNSHMP2008, ToroEtAl1997MwNSHMP2008

class openquake.hazardlib.gsim.toro_1997.ToroEtAl1997MblgNSHMP2008(**kwargs)

Bases: GMPE

Implements GMPE developed by G. R. Toro, N. A. Abrahamson, J. F. Schneider and published in “Model of Strong Ground Motions from Earthquakes in Central and Eastern North America: Best Estimates and Uncertainties” (Seismological Research Letters, Volume 68, Number 1, 1997) as utilized by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 US hazard model.

This class replicates the algorithm for the Toro et. al. 1997 GMPE as coded in the subroutine getToro in the hazgridXnga2.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

The class assumes rupture magnitude to be in Mblg scale (given that MFDs for central and eastern US are given in this scale). The equation implements also the finite-fault correction as given in “Modification of the Toro et al. 1997 Attenuation Equations for Large Magnitudes and Short Distances” (available at: http://www.riskeng.com/downloads/attenuation_equations). The correction uses Mw. Therefore Mblg is converted to Mw using both the Atkinson & Boore 1987 and Johnston 1996 conversion equations and an average correction term is computed.

Coefficients are given for the B/C site conditions.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma>

Coefficient table obtained from coefficient arrays (tb1, tb2, tb3, tb4, tb5, tb6, tbh) defined from line 1596 - 1614 in hazgridXnga2.f

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_REFERENCE_VELOCITY = 760.0

Shear-wave velocity for reference soil conditions in [m s-1]

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust, given that the equations have been derived for central and eastern north America

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude (Mblg).

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'Mblg'

class openquake.hazardlib.gsim.toro_1997.ToroEtAl1997MwNSHMP2008(**kwargs)

Bases: ToroEtAl1997MblgNSHMP2008

Extend ToroEtAl1997MblgNSHMP2008 but assumes magnitude to be in Mw scale.

Coefficients are Mw-specific and no magnitude conversion is considered to take into account finite-fault correction.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 sigma>

Coefficient table obtained from coefficient arrays (tc1, tc2, tc3, tc4, tc5, tc6, th) defined in subroutine getToro in hazgridXnga2.f

kind = 'Mw'

toro_2002

Module exports ToroEtAl2002, class:ToroEtAl2002SHARE.

class openquake.hazardlib.gsim.toro_2002.ToroEtAl2002(**kwargs)

Bases: GMPE

Implements GMPE developed by G. R. Toro, N. A. Abrahamson, J. F. Schneider and published in “Model of Strong Ground Motions from Earthquakes in Central and Eastern North America: Best Estimates and Uncertainties” (Seismological Research Letters, Volume 68, Number 1, 1997) and “Modification of the Toro et al. 1997 Attenuation Equations for Large Magnitudes and Short Distances” (available at: http://www.riskeng.com/downloads/attenuation_equations) The class implements equations for Midcontinent, based on moment magnitude. SA at 3 and 4 s (not supported by the original equations) have been added in the context of the SHARE project and they are obtained from SA at 2 s scaled by specific factors for 3 and 4 s.

COEFFS = <CoeffsTable c1 c2 c3 c4 c5 c6 c7 m50 m55 m80 r5 r20>

Coefficient tables obtained by joining tables 2, 3, and 4, pages 47, 50, 51.

CONSTS_FS = {}

no fault style adjustement in the base class

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the geometric mean of two : horizontal components GEOMETRIC_MEAN,

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 2 page 47.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is only total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable continental crust, given that the equations have been derived for central and eastern north America

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is rjb, see equation 4, page 46.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is only magnitude.

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.toro_2002.ToroEtAl2002SHARE(**kwargs)

Bases: ToroEtAl2002

COEFFS_FS_ROCK = <CoeffsTable Frss AFrock>

Coefficients for faulting style and rock adjustment

CONSTS_FS = {'Fnss': 0.95, 'pN': 0.01, 'pR': 0.81}

Constants for faulting style adjustment

DEFINED_FOR_REFERENCE_VELOCITY = 800.0

Shear-wave velocity for reference soil conditions in [m s-1]

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake

travasarou_2003

Module exports Travasarou2003,

class openquake.hazardlib.gsim.travasarou_2003.TravasarouEtAl2003(**kwargs)

Bases: GMPE

Implements the ground motion prediction equation for Arias Intensity given by Travasarou et al., (2003): Travasarou, T., Bray, J. D. and Abrahamson, N. A. (2003) “Emprical Attenuation Relationship for Arias Intensity”, Earthquake Engineering and Structural Dynamics, 32: 1133 - 1155

Ground motion records are generally taken from active shallow crustal regions

COEFFS = <CoeffsTable c1 c2 c3 c4 h s11 s12 s21 s22 f1 f2>

For Ia, coefficients are taken from table 3

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is actually the arithmetic mean of two horizontal components - we find this to be equivalent to GEOMETRIC_MEAN

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function IA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equations 13 - 15

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is RRup (eq. 1, page 199).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and rake (eq. 1, page 199).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30 (used to distinguish rock and stiff and soft soil).

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

non_verified = True

No independent tests - verification against paper

tromans_2019

Module exports TromansEtAl2019

openquake.hazardlib.gsim.tromans_2019.ASK_TAU_COEFFS = <CoeffsTable s3 s4>

Coefficient tables as per annex B of Abrahamson et al. (2014)

openquake.hazardlib.gsim.tromans_2019.DELTA_PHI_S2S = <CoeffsTable dfs2s>

Single ststion dfS2S model

openquake.hazardlib.gsim.tromans_2019.PHI_SS_COEFFS = <CoeffsTable const_phiss phi1m phi2m>

Single station intra-event term for the constant and magnitude-dependent model, as provided in Table 4 of Rodriguez-Marek et al (2013)

class openquake.hazardlib.gsim.tromans_2019.TromansEtAl2019(**kwargs)

Bases: GMPE

Implements a modifiable GMPE to apply the standard deviation model and adjustments described in Tromans et al. (2019), for application to a nuclear power plant site in the UK:

Tromans, I. J., Aldama-Bustos, G., Douglas, J., Lessi-Cheimariou, A., Hunt, S., Davi, M., Musson, R. M. W., Garrard, G., Strasser, F. and Robertson, C. (2019) “Probabilistic seismic hazard assessment for a new-build nuclear power plant site in the UK”, Bulletin of Earthquake Engineering, 17: 1- 36

Parameters:

• gmpe – The GMPE for calculation of the medeian ground motion model

• branch (string) – The model defines three branches for the different aleatory uncertainty models “lower”, “central” and “upper”

• scaling_factor (float) – Factor to scale the median values of the GMPE to account for, for example, stress drop uncertainty

• sigma (bool homoskedastic) – Determines whether to use the homoskedastic uncertainty model (True) or the heteroskedastic model (False)

• vskappa – Apply vs-kappa adjustment factors defined using a dictionary organised by IMT, or else none.

• phi_ds2s – Adds the phi_ds2s term to the sigma model (True) or retains the single station model

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is ‘active shallow crust’

REQUIRES_DISTANCES = frozenset({})

Required distance measure will be set by the GMPE

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude, others will be taken from the GMPE

REQUIRES_SITES_PARAMETERS = frozenset({})

Required site parameter is not set

compute(ctx: recarray, imts, mean, sig, tau, phi)

Returns the mean and standard deviations applying, where specified, scalar adjustment and vs-kappa adjustment to the mean from the original GMPE.

class openquake.hazardlib.gsim.tromans_2019.TromansEtAl2019SigmaMu(**kwargs)

Bases: TromansEtAl2019

Extension of the Tromans et al. (2019) to facilitate the application of the statistical uncertainty (sigma_mu) adjustment using the factors described by Al Atik & Youngs (2014)

Al Atik, L. and Youngs, R. R. (2014) “Epistemic Uncertainty for NGA-West 2 Models”, Earthquake Spectra, 30(3): 1301 - 1318

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude and style of faulting, others will be taken from the GMPE

openquake.hazardlib.gsim.tromans_2019.get_alatik_youngs_sigma_mu(mag, rake, imt)

Implements the statistical uncertainty model of Al Atik & Youngs (2014) given in equations 9 to 11 in the manuscript.

openquake.hazardlib.gsim.tromans_2019.get_heteroskedastic_phi(imt, mag)

Returns the heteroskedastic intra-event term, taken as the maximum of the constant single-station phi and the magnitude dependent single-station phi provided in Table 4 of Rodriguez-Marek et al (2014)

openquake.hazardlib.gsim.tromans_2019.get_heteroskedastic_tau(imt, mag)

Returns the magnitude dependent inter-event variability using the model of Abrahamson et al (2014).

Parameters:

• C (dict) – Coefficients dictionary

• mag (float) – Magnitude

openquake.hazardlib.gsim.tromans_2019.get_stddevs(branch, phi_ds2s, homoskedastic_sigma, imt, mag)

Returns the standard deviations as described in Figure 10 and section 4 of Tromans et al. (2019).

tusa_langer_2016

Module exports TusaLanger2016RepiBA08SE,

TusaLanger2016RepiBA08DE, TusaLanger2016RepiSP87SE, TusaLanger2016RepiSP87DE, TusaLanger2016Rhypo

class openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiBA08DE(**kwargs)

Bases: TusaLanger2016RepiBA08SE

Implements Tusa and Langer (2016) using the BA08 model and DE.

Extends openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiBA08SE because the same functional form is used, only the coefficients differ.

COEFFS = <CoeffsTable a b1 b2 c1 c2 h c3 sA sB sD SigmaIE SigmaIS SigmaTot>

kind = 'BA08DE'

class openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiBA08SE(**kwargs)

Bases: GMPE

Implements GMPE developed by Giuseppina Tusa and Horst Langer (2016) and published as “Prediction of ground motion parameters for the volcanic area of Mount Etna” Journal of Seismology, DOI 10.1007/s10950-015-9508-x.

GMPE derives from earthquakes in the volcanic area of Mt. Etna in the magnitude range 3<ML<4.8 for epicentral distances <100 km, and for soil classes A, B, and D. Authors do NOT derive coefficients for site class C due to limited data. For implementation using hypocentral distance see TusaLanger2016Rhypo.

Two functional forms were considered by the authors: Sabetta and Pugliese, 1987 (SP87) and a simplified version of Boore and Atkinson, 2008 (BA08). The GMPE distinguishes between shallow volcano-tectonic events related to flank movements (SE, focal depths <5km) and deeper events occurring due to regional tectonics (DE, focal depths >5km).

Test tables are generated from a spreadsheet provided by the authors, and modified according to OQ format (e.g. conversion from cm/s2 to m/s2).

Jan 2019: After noticing an anomalous-looking spike in the response spectra of the TusaLanger2016RepiBA08SE model at T=0.14s, we contacted the authors who found a mistake in one of the coefficients in the publication. It has been updated according to the authors suggestion.

COEFFS = <CoeffsTable a b1 b2 c1 c2 h c3 sA sB sD SigmaIE SigmaIS SigmaTot>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Greater of two horizontal'

Supported intensity measure component is the maximum of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are PGA and SA

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is ‘volcanic’ because the equations have been derived from data from Etna (Sicily, Italy)

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance measure is Repi

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'BA08SE'

class openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiSP87DE(**kwargs)

Bases: TusaLanger2016RepiSP87SE

Implements Tusa and Langer (2016) using the SP87 model and DE.

Extends openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiSP87SE because the same functional form is used, only the coefficients differ.

COEFFS = <CoeffsTable a b1 c1 h sA sB sD SigmaIE SigmaIS SigmaTot>

kind = 'SP87DE'

class openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiSP87SE(**kwargs)

Bases: TusaLanger2016RepiBA08SE

Implements Tusa and Langer (2016) using the SP87 model and SE.

Extends openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiBA08SE with modification to the functional form and different coefficients.

COEFFS = <CoeffsTable a b1 c1 h sA sB sD SigmaIE SigmaIS SigmaTot>

kind = 'SP87SE'

class openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016Rhypo(**kwargs)

Bases: TusaLanger2016RepiBA08SE

Implements the GMPE using the BA08 model and hypocentral distance (not described in Tusa and Langer, 2016). This version has been developed in the frame of V3-2012 INGV-DPC Project in order to perform PSHA calculations when topography is taken into consideration (e.g. the flanks of Mt Etna), hence dependence on vertical distance is required.

Extends openquake.hazardlib.gsim.tusa_langer_2016.TusaLanger2016RepiBA08SE because the same functional form is used, only the distance type and coefficients differ.

COEFFS = <CoeffsTable a b1 b2 c1 c2 h c3 sA sB sD SigmaTot>

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Repi

kind = 'Rhypo'

tusa_langer_azzaro_2019

Module exports TusaLangerAzzaro2019_100b,

TusaLangerAzzaro2019_60b

class openquake.hazardlib.gsim.tusa_langer_azzaro_2019.TusaLangerAzzaro2019_100b(**kwargs)

Bases: GMPE

Implements GMPE developed by Giuseppina Tusa, Horst Langer and Raffaele Azzaro (2020) and published as “Localizing ground motion models in volcanic terranes: Shallow events at Mt. Etna, Italy, revisited.” BSSA, DOI: 10.1785/0120190325.

GMPEs derive from shallow earthquakes (focal depth <= 6 km) in the volcanic area of Mt. Etna in the magnitude range 3<ML<4.8, and for hypocentral distances up to 100 km, and for soil classes A, B, C, and D. For soil classes C and D, the authors derived just one coefficient due to limited data belonging to these two soil classes.

The functional form considered by the authors is a simplified version of Boore and Atkinson, 2008. Two GMPEs has been estimated taking into account two hypocentral distance ranges: (1) up to 100 km (TLA19-100) and (2) up to 60 km (TLA19-60).

With a slightly modified approach, the authors considered a regression model using a pseudodepth (h) depending on magnitude according to the scaling law by Azzaro et al. (2017).

Test tables are generated from a spreadsheet provided by the authors, and modified according to OQ format (e.g. conversion from cm/s2 to m/s2).

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 sA sB sCD SigmaIE SigmaIS SigmaTot>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Greater of two horizontal'

Supported intensity measure component is the maximum of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are PGA and SA

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation type is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is ‘volcanic’ because the equations have been derived from data from Etna (Sicily, Italy)

REQUIRES_DISTANCES = frozenset({'rhypo'})

Required distance measure is Rhypo

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = '100b'

class openquake.hazardlib.gsim.tusa_langer_azzaro_2019.TusaLangerAzzaro2019_60b(**kwargs)

Bases: TusaLangerAzzaro2019_100b

Implements Tusa, Langer and Azzaro (2020) for shallow events and hypocentral distance less than 60 km.

Extends openquake.hazardlib.gsim.tusa_langer_azzaro_2019.TusaLanger2019_60b because the same functional form is used, only the coefficients differ.

COEFFS = <CoeffsTable a b1 b2 c1 c2 c3 sA sB sCD SigmaIE SigmaIS SigmaTot>

kind = '60b'

utils

Module openquake.hazardlib.gsim.utils contains functions that are common to several GMPEs.

openquake.hazardlib.gsim.utils.clip_mean(imt, mean)

Clip GMPE mean value at 1.5 g for PGA and 3 g for short periods (0.02 < T < 0.55)

openquake.hazardlib.gsim.utils.get_fault_type_dummy_variables(ctx)

Get fault type dummy variables, see Table 2, pag 107. Fault type (Strike-slip, Normal, Thrust/reverse) is derived from rake angle. Rakes angles within 30 of horizontal are strike-slip, angles from 30 to 150 are reverse, and angles from -30 to -150 are normal. See paragraph ‘Predictor Variables’ pag 103. Note that the ‘Unspecified’ case is not considered, because rake is always given.

openquake.hazardlib.gsim.utils.mblg_to_mw_atkinson_boore_87(mag)

Convert magnitude value from Mblg to Mw using Atkinson and Boore 1987 conversion equation.

Implements equation as in line 1656 in hazgridXnga2.f

openquake.hazardlib.gsim.utils.mblg_to_mw_johnston_96(mag)

Convert magnitude value from Mblg to Mw using Johnston 1996 conversion equation.

Implements equation as in line 1654 in hazgridXnga2.f

utils_swiss_gmpe

usgs_ceus_2019

Module exports NGAEastUSGSGMPE

class openquake.hazardlib.gsim.usgs_ceus_2019.NGAEastUSGSGMPE(**kwargs)

Bases: NGAEastGMPE

For the “core” NGA East set the table is provided in the code in a subdirectory fixed to the path of the present file. The GMPE table option is therefore no longer needed if a GSIM alias is used.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Set of standard deviation types this GSIM can calculate.

PATH = '/home/runner/work/oq-engine/oq-engine/openquake/hazardlib/gsim/usgs_nga_east_tables'

compute(ctx: recarray, imts, mean, sig, tau, phi)

Returns the mean and standard deviations

kind = 'usgs'

openquake.hazardlib.gsim.usgs_ceus_2019.get_epri_tau_phi(imt, mag)

Returns the inter-event (tau) and intra_event standard deviation (phi) according to the updated EPRI (2013) model

openquake.hazardlib.gsim.usgs_ceus_2019.get_panel_tau_phi(imt, mag)

Returns the inter-event (tau) and intra_event standard deviation (phi) according to the USGS Sigma Panel recommendations

openquake.hazardlib.gsim.usgs_ceus_2019.get_stewart_2019_phis2s(imt, vs30)

Returns the phis2s model of Stewart et al. (2019)

vanhoutte_2018

Module exports VanHoutteEtAl2018RSD

class openquake.hazardlib.gsim.vanhoutte_2018.VanHoutteEtAl2018RSD(**kwargs)

Bases: GMPE

Implements the GMPE of Van Houtte et al. (2018) for significant duration with 5 - 75 % Arias Intensity. doi:10.1785/0120170076. The oscillator duration model has not yet been implemented.

COEFFS = <CoeffsTable b0 b1 b2 b3 b4 b5 b6 b7 tau phi>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function RSD575>})

Supported intensity measure types are 5 - 75 % Arias significant duration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are total, inter and intra-event

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Requires vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

openquake.hazardlib.gsim.vanhoutte_2018.get_distance_term(C, rrup, mag)

Returns distance scaling term

openquake.hazardlib.gsim.vanhoutte_2018.get_magnitude_term(C, mag)

Returns linear magnitude scaling term

openquake.hazardlib.gsim.vanhoutte_2018.get_site_amplification(C, vs30)

Returns linear site amplification term

weatherill_2024

Module exports Weatherill2024ESHM20AvgSA,

Weatherill2024ESHM20SlopeGeologyAvgSA, Weatherill2024ESHM20AvgSAHomoskedastic

class openquake.hazardlib.gsim.weatherill_2024.Weatherill2024ESHM20AvgSA(**kwargs)

Bases: KothaEtAl2020ESHM20

This class implements a variation of the Kotha et al (2020; 2022) GMM that was used for the ESHM20, but here the predicted intensity measure is average SA (AvgSA) rather than SA. This is a form of direct AvgSA GMM, which is fit using the same data set as that of KothaEtAl2020 with AvgSA defined according the specifications of (among others) Iacoletti et al. (2023):

AvgSA = sqrt(prod([0.2 x T <= T <= 1.5 x T]))

where a total of 10 linearly-spaced conditioning periods in the range are used to define the average SA.

As the same regression methods were used to fit AvgSA then all of the adjustment terms adopted by the ESHM20 (sigma_mu_epsilon, c3_epsilon, ergodic etc.) can be applied to the AvgSA GMM, which allows the same logic tree to be constructed for the direct AvgSA case.

Further details on the compilation and application of the GMM are being developed in the following publication (in preparation):

Weatherill, G (2024) “A Regionalised Direct AvgSA Ground Motion Model for Europe”, (Journal TBC)

As this is in preparation, futue changes to the model are possible so we therefore retain the experimental warning, which will be removed at a future date.

COEFFS = <CoeffsTable e1 b1 b2 b3 c1 c2 c3 tau_c3 phis2s tau_event_0 tau_l2l phi_0 d0_obs d1_obs phi_s2s_obs d0_inf d1_inf phi_s2s_inf>

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function AvgSA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types is are only total std.dev

REQUIRES_SITES_PARAMETERS = frozenset({'region', 'vs30', 'vs30measured'})

Required site parameters are vs30, vs30measured and the eshm20_region

experimental = True

kind = 'avgsa_ESHM20'

class openquake.hazardlib.gsim.weatherill_2024.Weatherill2024ESHM20AvgSAHomoskedastic(**kwargs)

Bases: Weatherill2024ESHM20AvgSA

Variant of the Weatherill2024ESHM20 direct GMPE for AvgSA with the homoskedastic sigma coming from the original mixed effects regression

experimental = True

kind = 'avgsa_ESHM20_homoskedastic'

class openquake.hazardlib.gsim.weatherill_2024.Weatherill2024ESHM20SlopeGeologyAvgSA(**kwargs)

Bases: Weatherill2024ESHM20AvgSA

Adaptation of the ESHM20-implemented Kotha et al. (2020) model taking direct Average Sa (AvgSA). For use when defining site amplification based on with slope and geology rather than inferred/measured Vs30.

COEFFS_FIXED = <CoeffsTable V1 V2 phi_s2s>

COEFFS_RANDOM_GRAD = <CoeffsTable PRECAMBRIAN PALEOZOIC JURASSIC-TRIASSIC CRETACEOUS CENOZOIC PLEISTOCENE HOLOCENE UNKNOWN>

COEFFS_RANDOM_INT = <CoeffsTable PRECAMBRIAN PALEOZOIC JURASSIC-TRIASSIC CRETACEOUS CENOZOIC PLEISTOCENE HOLOCENE UNKNOWN>

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function AvgSA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types is are only total std.dev

GEOLOGICAL_UNITS = [b'CENOZOIC', b'HOLOCENE', b'JURASSIC-TRIASSIC', b'CRETACEOUS', b'PALEOZOIC', b'PLEISTOCENE', b'PRECAMBRIAN', b'UNKNOWN']

Geological Units

REQUIRES_SITES_PARAMETERS = frozenset({'geology', 'region', 'slope'})

Required site parameter is not set

experimental = True

kind = 'avgsa_ESHM20_geology'

wong2022

Module exports WongEtAl2015.

WongEtAl2022Shallow. WongEtAl2022Deep.

class openquake.hazardlib.gsim.wong2022.WongEtAl2015(**kwargs)

Bases: GMPE

Implements GMPE developed by Wong IG, Silva WJ, Darragh R, Gregor N and Dober M (2015) “Ground motion prediction modelfor deep earthquakes beneath the Island of Hawaii” Earthquake Spectra31: 1763–1788. SA are given up to 10 s. Ground motion refers to Vs30 of 428m/s Model is for deep events depth >20km

COEFFS_2015 = <CoeffsTable freq C1 C2 C4 C6 C7 C10 param_sigma model_sigma SigmaTot>

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

class openquake.hazardlib.gsim.wong2022.WongEtAl2022Deep(**kwargs)

Bases: WongEtAl2022Shallow

For deep events (depth > 20km)

COEFFS_Vs30_1080 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_150 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

Coefficients from SA from Tables from Appendic C in Wong et al. 2022

COEFFS_Vs30_1500 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_185 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_260 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_365 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_428 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_530 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_760 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

class openquake.hazardlib.gsim.wong2022.WongEtAl2022Shallow(**kwargs)

Bases: GMPE

Implements GMPE developed by Ivan Wong, Robert Darragh, Sarah Smith, Qimin Wu, Walter Silva, Tadahiro Kishida; “Ground motion models for shallow crustal and deep earthquakes in Hawaii and analyses of the 2018 M 6.9 Kalapana sequence.” Earthquake Spectra 2022;; 38 (1): 579–614. doi: https://doi.org/10.1177/87552930211044521

SA are given up to 10 s. The regressions are developed considering the average horizontal component of the as-recorded horizontal components Ground motion refers to Vs30 of 150, 185, 260, 365, 428, 530, 760, 1080, 1500, m/s Model is for deep events (depth >20km) and crustal events. this class is only for shallow ebents

COEFFS_Vs30_1080 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_150 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

Coefficients from SA from Tables from Appendic C in Wong et al. 2022

COEFFS_Vs30_1500 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_185 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_260 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_365 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_428 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_530 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

COEFFS_Vs30_760 = <CoeffsTable Freq C1 C2 C4 C5 C6 C7 C8 C10 param_sigma model_sigma SigmaTot>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is the geometric mean of two horizontal components

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Set of intensity measure types this GSIM can calculate. A set should contain classes from module openquake.hazardlib.imt.

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types are inter-event, intra-event and total, page 1904

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Volcanic'

Supported tectonic region type is ‘active shallow crust’ because the equations have been derived from data from Italian database ITACA, as explained in the ‘Introduction’.

REQUIRES_DISTANCES = frozenset({'rjb'})

Required distance measure is RRup (eq. 1).

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameters are magnitude and rake (eq. 1).

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is only Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

yenier_atkinson_2015

Module exports YenierAtkinson2015BSSA

class openquake.hazardlib.gsim.yenier_atkinson_2015.YenierAtkinson2015BSSA(**kwargs)

Bases: GMPE

Implements the GMM of Yenier and Atkinson (2015) as described in the paper titled “Regionally Adjustable Generic Ground-Motion Prediction Equation to Central and Eastern North America” published on BSSA, vol 105.

Note that this model does not provide a standard deviation, hence, in order to use it for PSHA calculations if must be combined with a model for ground motion aleatory uncertainty such as, for example, the one proposed by Al Atik (2014).

Parameters:

• focal_depth – A float defining focal depth [km].

• region – A string specifying a region. Admitted values are ‘CENA’ (Central and East North America) and ‘CA’ (California). Default is ‘CENA’

COEFFS_TAB2 = <CoeffsTable Mh e0 e1 e2 e3 b3 b4>

COEFFS_TAB3 = <CoeffsTable s0 s1 s2 s3 s4 s5 s6 s7 s8 s9>

COEFFS_TAB4 = <CoeffsTable gCENA gCalifornia>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is orientation-independent average horizontal RotD50, see page 1025.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration, see tables 4 pages 1036

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types are inter-event, intra-event and total, see paragraph “Equations for standard deviations”, page 1046.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, see title!

REQUIRES_ATTRIBUTES = frozenset({'adapted', 'focal_depth', 'region'})

Set of required GSIM attributes

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measures is Rrup

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and hypocenter depth

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameter is Vs30

adapted = False

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

openquake.hazardlib.gsim.yenier_atkinson_2015.get_fs_SeyhanStewart2014(C, imt, pga_rock, vs30)

Implements eq. 11 and 12 at page 1992 in Yenier and Atkinson (2015)

Parameters:

• pga_rock – Median peak ground horizontal acceleration for reference

• vs30 –

openquake.hazardlib.gsim.yenier_atkinson_2015.get_sof_adjustment(rake, imt)

Computes adjustment factor for style-of-faulting following the scheme proposed by Bommer et al. (2003).

Parameters:

• rake – Rake value

• imt – The intensity measure type

Returns:

The adjustment factor

youd_etal_2002

Module openquake.hazardlib.gsim.youd_etal_2002 exports YoudEtAl2002

class openquake.hazardlib.gsim.youd_etal_2002.YoudEtAl2002(**kwargs)

Bases: GMPE

Implements the GMPE of Youd et al. (2002) for calculating Permanent ground defomation(m) from lateral spread

Youd, T. L., Hansen, C. M., & Bartlett, S. F. (2002). Revised multilinear regression equations for prediction of lateral spread displacement. Journal of Geotechnical and Geoenvironmental Engineering, 128(12), 1007-1017.

COEFFS_FREEFACE = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 sigma>

COEFFS_SLOPE = <CoeffsTable c0 c1 c2 c3 c4 c5 c6 c7 sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is the horizontal

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function LSD>})

Supported intensity measure types are Permanent ground deformation (m) from lateral spread

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

This GMPE is based on non-subduction earthquakes with M<8

REQUIRES_DISTANCES = frozenset({'repi'})

Required distance measure is epicentral distance

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude (ML is used)

REQUIRES_SITES_PARAMETERS = frozenset({'D50_15', 'F_15', 'T_15', 'freeface_ratio', 'slope'})

Required site parameters

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

non_verified = True

GMPE not tested against independent implementation so raise not verified warning

youngs_1997

Module exports YoungsEtAl1997SInter, YoungsEtAl1997SSlab, YoungsEtAl1997GSCSSlabBest, YoungsEtAl1997GSCSSlabUpperLimit, YoungsEtAl1997GSCSSlabLowerLimit, YoungsEtAl1997SInterNSHMP2008.

openquake.hazardlib.gsim.youngs_1997.CONSTS = {'A1_rock': 0.2418, 'A1_soil': -0.6687, 'A2_rock': 1.414, 'A2_soil': 1.438, 'A3_rock': 10, 'A3_soil': 10, 'A4_rock': 1.7818, 'A4_soil': 1.097, 'A5_rock': 0.554, 'A5_soil': 0.617, 'A6_rock': 0.00607, 'A6_soil': 0.00648, 'A7_rock': 0.3846, 'A7_soil': 0.3643}

constants for mean value calculation, see table 2, page 67.

class openquake.hazardlib.gsim.youngs_1997.YoungsEtAl1997GSCSSlabBest(**kwargs)

Bases: YoungsEtAl1997SSlab

Implement modification to YoungsEtAl1997SSlab as defined by GSC (Geological Survey of Canada) for the 2010 Western Canada Model. Includes adjustement for firm ground. The model is associated to the ‘Best’ case, that is mean value unaffected.

delta = 0.1501426584297194

class openquake.hazardlib.gsim.youngs_1997.YoungsEtAl1997GSCSSlabLowerLimit(**kwargs)

Bases: YoungsEtAl1997GSCSSlabBest

Implement modification to YoungsEtAl1997SSlab as defined by GSC (Geological Survey of Canada) for the 2010 Western Canada Model. Includes adjustement for firm ground. The model is associated to the ‘Lower Limit’ case, that is mean value minus 0.7 natural logarithm.

delta = -0.5498573415702805

class openquake.hazardlib.gsim.youngs_1997.YoungsEtAl1997GSCSSlabUpperLimit(**kwargs)

Bases: YoungsEtAl1997GSCSSlabBest

Implement modification to YoungsEtAl1997SSlab as defined by GSC (Geological Survey of Canada) for the 2010 Western Canada Model. Includes adjustement for firm ground. The model is associated to the ‘Upper Limit’ case, that is mean value plus 0.7 natural logarithm.

delta = 0.8501426584297194

class openquake.hazardlib.gsim.youngs_1997.YoungsEtAl1997SInter(**kwargs)

Bases: GMPE

Implements GMPE developed by R.R Youngs, S-J, Chiou, W.J. Silva, J.R. Humphrey and published as “Strong Ground Motion Attenuation Relationships for Subduction Zone Earthquakes” (Seismological Research Letters Volume 68, No. 1, pages 58-73, 1997). This class implements the equations for ‘Subduction Interface’ (that’s why the class name ends with ‘SInter’). Mean value for SA at 4 s on rock (not originally supported) is obtained from mean value at 3 s divided by a factor equal to 0.399 (scaling factor computed in the context of the SHARE project obtained as average ratio between median values at 4 and 3 seconds as predicted by SHARE subduction GMPEs).

COEFFS_ROCK = <CoeffsTable C1 C2 C3 C4 C5>

Coefficient table containing rock coefficients, taken from table 2, p. 67

COEFFS_SOIL = <CoeffsTable C1 C2 C3 C4 C5>

Coefficient table containing soil coefficients, taken from table 2, p. 67

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is the average horizontal component attr:~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN, see paragraph: ‘Analysis of peak horizontal accelerations’, p. 59.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see table 2, page 67.

DEFINED_FOR_REFERENCE_VELOCITY = 800

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total, table 2, page 67.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup, see equations 1 and 2, page 59 and 66, respectively.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and focal depth, see equations 1 and 2, pages 59 and 66, respectively.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30, used to distinguish between rock and soil ctx, see paragraph ‘Strong Motion Data Base’, page 59.

ROCK_VS30 = 760

Vs30 value representing typical rock conditions in California.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

delta = 0

class openquake.hazardlib.gsim.youngs_1997.YoungsEtAl1997SInterNSHMP2008(**kwargs)

Bases: YoungsEtAl1997SInter

Extends YoungsEtAl1997SInter and fix rupture hypocenter depth at 20 km as defined by the National Seismic Hazard Mapping Project (NSHMP) for the 2008 US model.

The class implement the equation as coded in subroutine getGeom in hazSUBXnga.f Fortran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

class openquake.hazardlib.gsim.youngs_1997.YoungsEtAl1997SSlab(**kwargs)

Bases: YoungsEtAl1997SInter

Implements GMPE developed by R.R Youngs, S-J, Chiou, W.J. Silva, J.R. Humphrey and published as “Strong Ground Motion Attenuation Relationships for Subduction Zone Earthquakes” (Seismological Research Letters Volume 68, No. 1, pages 58-73, 1997). This class implements the equations for ‘Subduction IntraSlab’ (that’s why the class name ends with ‘SSlab’). Mean value for SA at 4 s on rock (not originally supported) is obtained from mean value at 3 s divided by a factor equal to 0.399 (scaling factor computed in the context of the SHARE project obtained as average ratio between median values at 4 and 3 seconds as predicted by SHARE subduction GMPEs).

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction intraslab

openquake.hazardlib.gsim.youngs_1997.get(array, idx)

yu_2013

Module exports YuEtAl2013Ms, YuEtAl2013MsTibet, YuEtAl2013MsEastern, YuEtAl2013MsStable YuEtAl2013Mw, YuEtAl2013MwTibet, YuEtAl2013MwEastern, YuEtAl2013MwStable

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013Ms(**kwargs)

Bases: GMPE

Implements the Yu et al. (2013) GMPE used for the calculation of the 2015 version of the national seismic hazard maps for China. Note that magnitude supported is Ms.

COEFFS = <CoeffsTable a b c d e ua ub uc ud ue ma mb mc md me ia ib ic id ie sigma>

Coefficient table

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean (supposed)

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'azimuth', 'repi'})

Required distance measures are epicentral distance and azimuth

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag'})

Required rupture parameter is magnitude

REQUIRES_SITES_PARAMETERS = frozenset({})

No site parameters required

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013MsEastern(**kwargs)

Bases: YuEtAl2013Ms

COEFFS = <CoeffsTable a b c d e ua ub uc ud ue ma mb mc md me ia ib ic id ie sigma>

Coefficient table

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is eastern part of China

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013MsStable(**kwargs)

Bases: YuEtAl2013Ms

COEFFS = <CoeffsTable a b c d e ua ub uc ud ue ma mb mc md me ia ib ic id ie sigma>

Coefficient table

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable part of China

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013MsTibet(**kwargs)

Bases: YuEtAl2013Ms

COEFFS = <CoeffsTable a b c d e ua ub uc ud ue ma mb mc md me ia ib ic id ie sigma>

Coefficient table

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is Tibetan plateau

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013Mw(**kwargs)

Bases: YuEtAl2013Ms

This is a modified version of the original Yu et al. (2013) that supports the use of Mw rather than Ms. The Mw to Ms conversion equation used is the one proposed by Cheng et al. (2017). Note that this version does not propagate the uncertainty related to the magnitude conversion process.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013MwEastern(**kwargs)

Bases: YuEtAl2013Mw

COEFFS = <CoeffsTable a b c d e ua ub uc ud ue ma mb mc md me ia ib ic id ie sigma>

Coefficient table

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is eastern part of China

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013MwStable(**kwargs)

Bases: YuEtAl2013Mw

COEFFS = <CoeffsTable a b c d e ua ub uc ud ue ma mb mc md me ia ib ic id ie sigma>

Coefficient table

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Stable Shallow Crust'

Supported tectonic region type is stable part of China

class openquake.hazardlib.gsim.yu_2013.YuEtAl2013MwTibet(**kwargs)

Bases: YuEtAl2013Mw

COEFFS = <CoeffsTable a b c d e ua ub uc ud ue ma mb mc md me ia ib ic id ie sigma>

Coefficient table

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is Tibetan plateau

openquake.hazardlib.gsim.yu_2013.fnc(ra, *args)

Function used in the minimisation problem.

Parameters:

ra – Semi-axis of the ellipses used in the Yu et al.

Returns:

The absolute difference between the epicentral distance and the adjusted distance

openquake.hazardlib.gsim.yu_2013.gc(coeff, mag)

Returns the set of coefficients to be used for the calculation of GM as a function of earthquake magnitude

Parameters:

• coeff – A dictionary of parameters for the selected IMT

• mag – Magnitude value

Returns:

The set of coefficients

openquake.hazardlib.gsim.yu_2013.get_ras(repi, theta, mag, coeff)

Computes equivalent distance

Parameters:

• repi – Epicentral distance

• theta – Azimuth value

• mag – Magnitude

• coeff – GMPE coefficients

openquake.hazardlib.gsim.yu_2013.rbf(ra, coeff, mag)

Calculate the median ground motion for a given magnitude and distance

Parameters:

• ra – Distance value [km]

• coeff – The set of coefficients

• mag – Magnitude value

Returns:

zalachoris_rathje_2019

Module exports :class:’ZalachorisRathje2019’

class openquake.hazardlib.gsim.zalachoris_rathje_2019.ZalachorisRathje2019(**kwargs)

Bases: GMPE

Implements the Induced Seismicity GMPE of Zalachoris & Rathje (2019) for Texas, Oklahoma and Kansas. Ground Motion Model for Small-to-Moderate Earthquakes in Texas, Oklahoma, and Kansas. Earthquake Spectra. Data: 4528 observations from 376 EQs of Mw 3.0-5.8 in Texas, Oklahoma and Kansas, distances between 4 and 500km. PGA, PGV, SA(0-10s) version: Apr 28, 2020. Verified with margin 1%

COEFFS_BSSA14 = <CoeffsTable e0 e1 e2 e3 e4 e5 e6 Mh c1 c2 c3 h Dc3 c Vc f4 f5 f6 f7 R1 R2 DfR DfV f1 f2 t1 t2>

terms for HA15 terms for ZR19 coeffs for BSSA14 fewer decimals used for BSSA14 by Zalachoris compared to the original values

COEFFS_HA15 = <CoeffsTable C1 C2 C3 sigma tau phi>

coeffs for HA15

COEFFS_ZR19 = <CoeffsTable a Rb Mb b0 b1 c Vc Cadj tau phi sigma>

CONSTS = {'Mref': 4.5, 'Rref': 1.0, 'Vref': 760.0, 'f1': 0.0, 'f3': 0.1, 'v1': 225.0, 'v2': 300.0}

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal (RotD50)'

Supported intensity measure component is orientation-independent measure RotD50

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function PGV>, <function SA>})

Supported intensity measure types are spectral acceleration, peak ground velocity and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 2, pag 106.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Induced'

The GMPE is derived from induced earthquakes

REQUIRES_DISTANCES = frozenset({'rhypo', 'rjb'})

Required distance measure is Rjb

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude, and rake.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

kind = 'base'

non_verified = False

GMPE not tested against independent implementation so raise not verified warning

region = 'nobasin'

sof = True

openquake.hazardlib.gsim.zalachoris_rathje_2019.get_FENA(Cadj, ctx, imt)

See superclass method for spec of input and result values.

zhang_zhao_2005

Module exports Zhang_Zhao2005SInter,

Zhang_Zhao2005SSlab, Zhang_Zhao2005Crust,

class openquake.hazardlib.gsim.zhang_zhao_2005.Zhang_Zhao2005Crust(**kwargs)

Bases: Zhang_Zhao2005SInter

Implements the GMPE of Zhang and Zhao. (2005) for Permanent ground deformation (m) from lateral spread Zhang, J., & Zhao, J. X. (2005). Empirical models for estimating liquefaction-induced lateral spread displacement. Soil Dynamics and Earthquake Engineering, 25(6), 439-450. This model is based on Sadigh et al. (1997) and Young et al. (1997) models

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

This GMPE is based on crustal earthquakes

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake'})

Required rupture parameters are magnitude

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

class openquake.hazardlib.gsim.zhang_zhao_2005.Zhang_Zhao2005SInter(**kwargs)

Bases: GMPE

Implements the GMPE of Zhang and Zhao. (2005) for Permanent ground deformation (m) from lateral spread Zhang, J., & Zhao, J. X. (2005). Empirical models for estimating liquefaction-induced lateral spread displacement. Soil Dynamics and Earthquake Engineering, 25(6), 439-450. This model is based on Sadigh et al. (1997) and Young et al. (1997) models

COEFFS_FREEFACE = <CoeffsTable c4 c5 c6 c7 c8 sigma>

COEFFS_SLOPE = <CoeffsTable c4 c5 c6 c7 c8 sigma>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Horizontal'

Supported intensity measure component is the horizontal

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function LSD>})

Supported intensity measure types are Permanent ground deformation (m) from lateral spread

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Total'})

Supported standard deviation types is total.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

This GMPE is based on subduction interface earthquakes

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is closest distance to rupture surface

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and hypocentral depth

REQUIRES_SITES_PARAMETERS = frozenset({'D50_15', 'F_15', 'T_15', 'freeface_ratio', 'slope'})

Required site parameters

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

non_verified = True

GMPE not tested against independent implementation so raise not verified warning

class openquake.hazardlib.gsim.zhang_zhao_2005.Zhang_Zhao2005SSlab(**kwargs)

Bases: Zhang_Zhao2005SInter

Implements the GMPE of Zhang and Zhao. (2005) for Permanent ground deformation (m) from lateral spread Zhang, J., & Zhao, J. X. (2005). Empirical models for estimating liquefaction-induced lateral spread displacement. Soil Dynamics and Earthquake Engineering, 25(6), 439-450. This model is based on Sadigh et al. (1997) and Young et al. (1997) models

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

This GMPE is based on subduction intraslab earthquakes

compute(ctx: recarray, imts, mean, sig, tau, phi)

Parameters:

• ctx – a RuptureContext object or a numpy recarray of size N

• imts – a list of M Intensity Measure Types

• mean – an array of shape (M, N) for the means

• sig – an array of shape (M, N) for the TOTAL stddevs

• tau – an array of shape (M, N) for the INTER_EVENT stddevs

• phi – an array of shape (M, N) for the INTRA_EVENT stddevs

To be overridden in subclasses with a procedure filling the arrays and returning None.

zhao_2006

Module exports ZhaoEtAl2006Asc, ZhaoEtAl2006SInter, ZhaoEtAl2006SSlab, ZhaoEtAl2006SInterNSHMP2008 and ZhaoEtAl2006SSlabNSHMP2014

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006Asc(**kwargs)

Bases: GMPE

Implements GMPE developed by John X. Zhao et al. and published as “Attenuation Relations of Strong Ground Motion in Japan Using Site Classification Based on Predominant Period” (2006, Bulletin of the Seismological Society of America, Volume 96, No. 3, pages 898-913). This class implements the equations for ‘Active Shallow Crust’ (that’s why the class name ends with ‘Asc’).

COEFFS_ASC = <CoeffsTable a b c d e FR CH C1 C2 C3 C4 sigma QC WC tauC>

Coefficient table obtained by joining table 4 (except columns for SI, SS, SSL), table 5 (both at p. 903) and table 6 (only columns for QC WC TauC), p. 907.

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components : attr:~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN, see paragraph ‘Development of Base Model’, p. 901.

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see paragraph ‘Development of Base Model’ p. 901.

DEFINED_FOR_REFERENCE_VELOCITY = 800

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 3, p. 902.

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust, this means that factors SI, SS and SSL are assumed 0 in equation 1, p. 901.

REQUIRES_DISTANCES = frozenset({'rrup'})

Required distance measure is Rrup. See paragraph ‘Development of Base Model’, p. 902.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag', 'rake'})

Required rupture parameters are magnitude, rake, and focal depth. See paragraph ‘Development of Base Model’, p. 901.

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30. See table 2, p. 901.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006AscSGS(**kwargs)

Bases: ZhaoEtAl2006Asc

This class extends the original base class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006Asc by introducing a distance filter for the near field, as implemented by SGS for the national PSHA model for Saudi Arabia.

compute(ctx: recarray, imts, mean, sig, tau, phi)

Using a minimum distance of 5km for the calculation.

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006SInter(**kwargs)

Bases: ZhaoEtAl2006Asc

Implements GMPE developed by John X. Zhao et al and published as “Attenuation Relations of Strong Ground Motion in Japan Using Site Classification Based on Predominant Period” (2006, Bulletin of the Seismological Society of America, Volume 96, No. 3, pages 898-913). This class implements the equations for ‘Subduction Interface’ (that’s why the class name ends with ‘SInter’). This class extends the openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006Asc because the equation for subduction interface is obtained from the equation for active shallow crust, by removing the faulting style term and adding a subduction interface term.

COEFFS_SINTER = <CoeffsTable SI QI WI tauI>

Coefficient table containing subduction interface coefficients, taken from table 4, p. 903 (only column SI), and table 6, p. 907 (only columns QI, WI, TauI)

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface, this means that factors FR, SS and SSL are assumed 0 in equation 1, p. 901.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and focal depth.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006SInterCascadia(**kwargs)

Bases: ZhaoEtAl2006SInter

Implements the interface GMPE developed by John X. Zhao et al modified by the Japan/Cascadia site factors as proposed by Atkinson, G. M. (2012). White paper on proposed ground-motion prediction equations (GMPEs) for 2015 National Seismic Hazard Maps Final Version, Nov. 2012, 50 pp. This class extends the openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006Asc because the equation for subduction interface is obtained from the equation for active shallow crust, by removing the faulting style term and adding a subduction interface term.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006SInterNSHMP2008(**kwargs)

Bases: ZhaoEtAl2006SInter

Extend ZhaoEtAl2006SInter and fix hypocentral depth at 20 km as defined the by National Seismic Hazard Mapping Project for the 2008 US hazard model.

The calculation of the total standard deviation is done considering the inter-event standard deviation as defined in table 5, page 903 of Zhao’s paper.

The class implement the equation as coded in subroutine zhao in hazSUBXnga.f Fotran code available at: http://earthquake.usgs.gov/hazards/products/conterminous/2008/software/

COEFFS_SINTER = <CoeffsTable SI QI WI tauI>

Coefficient table containing subduction interface coefficients, taken from table 4, p. 903 (only column SI), and table 6, p. 907 (only columns QI, WI, TauI)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

Call super class method with hypocentral depth fixed at 20 km

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006SSlab(**kwargs)

Bases: ZhaoEtAl2006Asc

Implements GMPE developed by John X. Zhao et al and published as “Attenuation Relations of Strong Ground Motion in Japan Using Site Classification Based on Predominant Period” (2006, Bulletin of the Seismological Society of America, Volume 96, No. 3, pages 898-913). This class implements the equations for ‘Subduction Slab’. (that’s why the class name ends with ‘SSlab’). This class extends the openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006Asc because the equation for subduction slab is obtained from the equation for active shallow crust, by removing the faulting style term and adding subduction slab terms.

COEFFS_SSLAB = <CoeffsTable SS SSL PS QS WS tauS>

Coefficient table containing subduction slab coefficients taken from table 4, p. 903 (only columns for SS and SSL), and table 6, p. 907 (only columns for PS, QS, WS, TauS)

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction interface, this means that factors FR, SS and SSL are assumed 0 in equation 1, p. 901.

REQUIRES_RUPTURE_PARAMETERS = frozenset({'hypo_depth', 'mag'})

Required rupture parameters are magnitude and focal depth.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006SSlabCascadia(**kwargs)

Bases: ZhaoEtAl2006SSlab

Implements GMPE developed by John X. Zhao et al modified by the Japan/Cascadia site factors as proposed by Atkinson, G. M. (2012). White paper on proposed ground-motion prediction equations (GMPEs) for 2015 National Seismic Hazard Maps Final Version, Nov. 2012, 50 pp. This class extends the openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006Asc because the equation for subduction slab is obtained from the equation for active shallow crust, by removing the faulting style term and adding subduction slab terms.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.zhao_2006.ZhaoEtAl2006SSlabNSHMP2014(**kwargs)

Bases: ZhaoEtAl2006SSlab

For the 2014 US National Seismic Hazard Maps the magnitude of Zhao et al. (2006) for the subduction inslab events is capped at magnitude Mw 7.8

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

zhao_2006_swiss

Module exports ZhaoEtAl2006AscSWISS05, ZhaoEtAl2006AscSWISS03, ZhaoEtAl2006AscSWISS08.

class openquake.hazardlib.gsim.zhao_2006_swiss.ZhaoEtAl2006AscSWISS03(**kwargs)

Bases: ZhaoEtAl2006AscSWISS05

This class extends :class:ZhaoEtAl2006Asc,following same strategy as for :class:ZhaoEtAl2006AscSWISS05

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

class openquake.hazardlib.gsim.zhao_2006_swiss.ZhaoEtAl2006AscSWISS05(**kwargs)

Bases: ZhaoEtAl2006Asc

This class extends :class:ZhaoEtAl2006Asc, adjusted to be used for the Swiss Hazard Model [2014]. This GMPE is valid for a fixed value of vs30=700m/s

1. kappa value K-adjustments corresponding to model 01 - as prepared by Ben Edwards K-value for PGA were not provided but infered from SA[0.01s] the model applies to a fixed value of vs30=700m/s to match the reference vs30=1100m/s

2. small-magnitude correction

3. single station sigma - inter-event magnitude/distance adjustment

Disclaimer: these equations are modified to be used for the Swiss Seismic Hazard Model [2014]. The hazard modeller is solely responsible for the use of this GMPE in a different tectonic context.

Model implemented by laurentiu.danciu@gmail.com

COEFFS_ASC = <CoeffsTable a b c d e FR CH C1 C2 C3 C4 sigma QC WC tauC>

Original Coefficient table

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration, see paragraph ‘Development of Base Model’ p. 901.

DEFINED_FOR_REFERENCE_VELOCITY = 1105.0

Vs30 value representing typical rock conditions in Switzerland. confirmed by the Swiss GMPE group

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total, see equation 3, p. 902.

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.zhao_2006_swiss.ZhaoEtAl2006AscSWISS08(**kwargs)

Bases: ZhaoEtAl2006AscSWISS05

This class extends :class:ZhaoEtAl2006Asc,following same strategy as for :class:ZhaoEtAl2006AscSWISS05 to be used for the Swiss Hazard Model [2014].

COEFFS_FS_ROCK = <CoeffsTable k_adj a1 a2 b1 b2 Rm phi_11 phi_21 C2 Mc1 Mc2 Rc11 Rc21 mean_phi_ss>

zhao_2006_swiss_coeffs

zhao_2016

Module exports ZhaoEtAl2016Asc,

ZhaoEtAl2016AscSiteSigma, ZhaoEtAl2016UpperMantle, ZhaoEtAl2016UpperMantleSiteSigma, ZhaoEtAl2016SInter, ZhaoEtAl2016SInterSiteSigma, ZhaoEtAl2016SSlab, ZhaoEtAl2016SSlabSiteSigma, ZhaoEtAl2016SSlabPErg

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016Asc(**kwargs)

Bases: GMPE

Implements the GMPE of Zhao et al (2016a) for shallow crustal and upper mantle events from Japan. Only the shallow crustal version is implemented here.

Zhao, J. X., Zhou, S., Zhou, J., Zhao, C., Zhang, H., Zhang, Y., Gao, P., Lan, X., Rhoades, D. A., Fukushima, Y., Somerville, P., Irikura, K., (2016c), “Ground-Motion Prediction Equations for Shallow Crustal and Uppe-Mantle Earthquakes in Japan Using Site Class and Simple Geometric Attenuation Functions”, Bulletin of the Seismological Society of America, 106(4), 1518-1534

Main version with standard deviations independent of site term

COEFFS = <CoeffsTable c1 c2 ccr cum dcr FN_CR FRV_UM FN_UM FUM bcr gcr gUM gcrN gcrL ecr eum ecrV gamma_S lnSC1AM S2 S3 S4 sigma tau sigma_T sc1_sigma_S sc1_tau_S sc1_sigma_ST sc2_sigma_S sc2_tau_S sc2_sigma_ST sc3_sigma_S sc3_tau_S sc3_sigma_ST sc4_sigma_S sc4_tau_S sc4_sigma_ST>

COEFFS_SITE = <CoeffsTable LnAmax1D1 LnAmax1D2 LnAmax1D3 LnAmax1D4 Src1D1 Src1D2 Src1D3 Src1D4 fsr1 fsr2 fsr3 fsr4>

DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = 'Average Horizontal'

Supported intensity measure component is geometric mean of two horizontal components :

DEFINED_FOR_INTENSITY_MEASURE_TYPES = frozenset({<function PGA>, <function SA>})

Supported intensity measure types are spectral acceleration, and peak ground acceleration

DEFINED_FOR_STANDARD_DEVIATION_TYPES = frozenset({'Inter event', 'Intra event', 'Total'})

Supported standard deviation types are inter-event, intra-event and total

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Active Shallow Crust'

Supported tectonic region type is active shallow crust

REQUIRES_DISTANCES = frozenset({'rrup', 'rvolc'})

Required distance measure is Rrup and Rvolc

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'rake', 'ztor'})

Required rupture parameters are magnitude, top-of-rupture depth and style of faulting (rake)

REQUIRES_SITES_PARAMETERS = frozenset({'vs30'})

Required site parameters is Vs30 (converted to site class)

compute(ctx: recarray, imts, mean, sig, tau, phi)

See superclass method for spec of input and result values.

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016AscSiteSigma(**kwargs)

Bases: ZhaoEtAl2016Asc

Adaption of the Zhao et al (2016a) GMPE for active shallow crust events for the case when within-event variability is dependent on site class

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016SInter(**kwargs)

Bases: ZhaoEtAl2016Asc

Implements the subduction interface GMPE of Zhao et al (2016b)

Zhao, J. X., Liang, X., Jiang, F., Xing, H., Zhu, M., Hou, R., Zhang, Y., Lan, X., Rhoades, D. A., Irikura, K., Fukushima, Y., Somerville, P. (2016b), “Ground-Motion Prediction Equations for Subduction Interface Earthquakes in Japan Using Site Class and Simple Geometric Attenuation Functions”, Bulletin of the Seismological Society of America, 106(4), 1518-1534

Main version with standard deviations independent of site term

COEFFS = <CoeffsTable alpha beta cint cintS dint gamma_ints bint gint gintLD gintLS eintV eintS gammaint S2 S3 S4 S5 S6 S7 lnSC1AM sigma tau sigma_T sc1_sigma_S sc1_tau_S sc1_sigma_ST sc2_sigma_S sc2_tau_T sc2_sigma_ST sc3_sigma_S sc3_tau_S sc3_sigma_ST sc4_sigma_S sc4_tau_S sc4_sigma_ST>

COEFFS_SITE = <CoeffsTable LnAmax1D1 LnAmax1D2 LnAmax1D3 LnAmax1D4 Src1D1 Src1D2 Src1D3 Src1D4 fsr1 fsr2 fsr3 fsr4>

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction Interface'

Supported tectonic region type is subduction interface

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Required rupture parameters are magnitude and top-of-rupture depth

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016SInterSiteSigma(**kwargs)

Bases: ZhaoEtAl2016SInter

Subclass of the Zhao et al. (2016b) subduction interface GMPE for the case of site-dependent within-event variability

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016SSlab(**kwargs)

Bases: ZhaoEtAl2016Asc

Implements the subduction slab GMPE of Zhao et al (2016c)

Zhao, J. X., Jiang, F., Shi, P., Xing, H., Huang, H., Hou, R., Zhang, Y., Yu, P., Lan, X., Rhoades, D. A., Somerville, P. G., Irikura, K., Fukushima, Y. (2016c), “Ground-Motion Prediction Equations for Subduction Slab Earthquakes in Japan Using Site Class and Simple Geometric Attenuation Functions”, Bulletin of the Seismological Society of America, 106(4), 1535-1551

Main version with standard deviations independent of site term

COEFFS = <CoeffsTable alpha beta cSL cSL2 dSL bSLH gSL gLL eSLV eSL eSLH gamma S2 S3 S4 lnSC1AM sigma tau sigma_T sc1_sigma_S sc1_tau_S sc1_sigma_ST sc2_sigma_S sc2_tau_S sc2_sigma_ST sc3_sigma_S sc3_tau_S sc3_sigma_ST sc4_sigma_S sc4_tau_S sc4_sigma_ST>

COEFFS_SITE = <CoeffsTable LnAmax1D1 LnAmax1D2 LnAmax1D3 LnAmax1D4 Src1D1 Src1D2 Src1D3 Src1D4 fsr1 fsr2 fsr3 fsr4>

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction inslab

REQUIRES_RUPTURE_PARAMETERS = frozenset({'mag', 'ztor'})

Required rupture parameters are magnitude and top of rupture depth.

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016SSlabPErg(**kwargs)

Bases: ZhaoEtAl2016Asc

Implements the subduction in-slab GMPE of Zhao et al (2016c) with non-ergodic path correction for propagation through volcanic regions.

Zhao, J. X., Jiang, F., Shi, P., Xing, H., Huang, H., Hou, R., Zhang, Y., Yu, P., Lan, X., Rhoades, D. A., Somerville, P. G., Irikura, K., Fukushima, Y. (2016c), “Ground-Motion Prediction Equations for Subduction Slab Earthquakes in Japan Using Site Class and Simple Geometric Attenuation Functions”, Bulletin of the Seismological Society of America, 106(4), 1535-1551

Main version with standard deviations independent of site term

COEFFS = <CoeffsTable alpha beta cSL cSL2 dSL bSLH gSL gLL eSLV eSL eSLH gamma S2 S3 S4 lnSC1AM sigma tau sigma_T sc1_sigma_S sc1_tau_S sc1_sigma_ST sc2_sigma_S sc2_tau_S sc2_sigma_ST sc3_sigma_S sc3_tau_S sc3_sigma_ST sc4_sigma_S sc4_tau_S sc4_sigma_ST>

COEFFS_SITE = <CoeffsTable LnAmax1D1 LnAmax1D2 LnAmax1D3 LnAmax1D4 Src1D1 Src1D2 Src1D3 Src1D4 fsr1 fsr2 fsr3 fsr4>

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Subduction IntraSlab'

Supported tectonic region type is subduction inslab

REQUIRES_DISTANCES = frozenset({'clat', 'clon', 'rrup', 'rvolc'})

Required distance measure is Rrup, Rvolc and clon, clat

REQUIRES_RUPTURE_PARAMETERS = frozenset({'dip', 'hypo_depth', 'hypo_lat', 'hypo_lon', 'mag', 'rake', 'strike', 'ztor'})

Required rupture parameters are magnitude, top-of-rupture depth and style of faulting (rake)

REQUIRES_SITES_PARAMETERS = frozenset({'lat', 'lon', 'vs30'})

Required site parameters is Vs30 (converted to site class)

experimental = True

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016SSlabSiteSigma(**kwargs)

Bases: ZhaoEtAl2016SSlab

Subclass of the Zhao et al. (2016c) subduction in-slab GMPE for the case of site-dependent within-event variability

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016UpperMantle(**kwargs)

Bases: ZhaoEtAl2016Asc

Adaptation of the Zhao et al. (2016a) GMPE for the upper mantle events

COEFFS_SITE = <CoeffsTable LnAmax1D1 LnAmax1D2 LnAmax1D3 LnAmax1D4 Src1D1 Src1D2 Src1D3 Src1D4 fsr1 fsr2 fsr3 fsr4>

DEFINED_FOR_TECTONIC_REGION_TYPE = 'Upper Mantle'

Supported tectonic region type is upper mantle

class openquake.hazardlib.gsim.zhao_2016.ZhaoEtAl2016UpperMantleSiteSigma(**kwargs)

Bases: ZhaoEtAl2016UpperMantle

Adaption of the Zhao et al (2016a) GMPE for upper mantle events for the case when within-event variability is dependent on site class

openquake.hazardlib.gsim.zhao_2016.add_site_amplification(trt, C, C_SITE, sa_rock, idx, ctx)

Applies the site amplification scaling defined in equations from 10 to 15

openquake.hazardlib.gsim.zhao_2016.get_depth_term_SInter(trt, C, ctx)

Returns depth term (dependent on top of rupture depth) as given in equations 1 and 2

openquake.hazardlib.gsim.zhao_2016.get_depth_term_asc(trt, C, ctx)

Returns the top-of-rupture depth scaling (equation 1)

openquake.hazardlib.gsim.zhao_2016.get_depth_term_sslab(trt, C, ctx)

Returns depth term (dependent on top of rupture depth) as given in equations 1

Note that there is a ztor cap of 100 km that is introduced in the Fortran code but not mentioned in the original paper!

openquake.hazardlib.gsim.zhao_2016.get_depth_term_um(trt, C, ctx)

No top of rupture depth is considered for upper mantle events

openquake.hazardlib.gsim.zhao_2016.get_distance_term_SInter(trt, C, ctx, volc_arc_str=None, pgn_store=None, pgn_per_zone=None)

Returns distance scaling term, dependent on top of rupture depth, as described in equation 6

openquake.hazardlib.gsim.zhao_2016.get_distance_term_asc(trt, C, ctx, volc_arc_str=None, pgn_store=None, pgn_per_zone=None)

Returns the distance scaling term defined in equation 3

openquake.hazardlib.gsim.zhao_2016.get_distance_term_sslab(trt, C, ctx, volc_arc_str=None, pgn_store=None, pgn_per_zone=None)

Returns the distance scaling term in equation 2a

Non-ergodic path effects are applied here if specified within an implementation of ZhaoEtAl2016SSlabPErg.

openquake.hazardlib.gsim.zhao_2016.get_distance_term_um(trt, C, ctx, volc_arc_str=None, pgn_store=None, pgn_per_zone=None)

Returns the distance attenuation term

openquake.hazardlib.gsim.zhao_2016.get_magnitude_scaling_term_SInter(trt, C, ctx)

Returns magnitude scaling term, which is dependent on top of rupture depth - as described in equations 1 and 2

openquake.hazardlib.gsim.zhao_2016.get_magnitude_scaling_term_asc(trt, C, ctx)

Returns the magnitude scaling term in equations 1 and 2

openquake.hazardlib.gsim.zhao_2016.get_magnitude_scaling_term_sslab(trt, C, ctx)

Returns the magnitude scaling defined in equation 1

openquake.hazardlib.gsim.zhao_2016.get_sof_term_SInter(trt, C, ctx)

No style of faulting dependence here

openquake.hazardlib.gsim.zhao_2016.get_sof_term_asc(trt, C, ctx)

Shallow crustal faults have a style-of-faulting dependence as normal faulting is found to produce higher ground motion (equation 1)

openquake.hazardlib.gsim.zhao_2016.get_sof_term_sslab(trt, C, ctx)

No style of faulting dependence here

openquake.hazardlib.gsim.zhao_2016.get_sof_term_um(trt, C, ctx)

In the case of the upper mantle events separate coefficients are considered for normal, reverse and strike-slip

openquake.hazardlib.gsim.zhao_2016.get_volc_zones(volc_polygons)

Construct polygons from the vertex coordinates provided for each volcanic zone and assign the associated zone id