# -*- coding: utf-8 -*-
# vim: tabstop=4 shiftwidth=4 softtabstop=4
#
# Copyright (C) 2014-2020 GEM Foundation
#
# OpenQuake is free software: you can redistribute it and/or modify it
# under the terms of the GNU Affero General Public License as published
# by the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# OpenQuake is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with OpenQuake. If not, see <http://www.gnu.org/licenses/>.
"""
Module exports :class:`TavakoliPezeshk2005`,
:class:`TavakoliPezeshk2005MblgAB1987NSHMP2008`,
:class:`TavakoliPezeshk2005MblgJ1996NSHMP2008`,
:class:`TavakoliPezeshk2005MwNSHMP2008`
"""
import numpy as np
from openquake.hazardlib.gsim.base import GMPE, CoeffsTable
from openquake.hazardlib import const
from openquake.hazardlib.imt import PGA, SA
from openquake.hazardlib.gsim.utils import (
mblg_to_mw_atkinson_boore_87,
mblg_to_mw_johnston_96,
clip_mean)
[docs]class TavakoliPezeshk2005(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).
"""
#: Supported tectonic region type is stable continental crust
DEFINED_FOR_TECTONIC_REGION_TYPE = const.TRT.STABLE_CONTINENTAL
#: Supported intensity measure types are peak ground acceleration
#: and spectral acceleration, see abstract
DEFINED_FOR_INTENSITY_MEASURE_TYPES = {PGA, SA}
#: Supported intensity measure horizontal.
DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = const.IMC.HORIZONTAL
#: Supported standard deviation type is total, see equation 23, pag 2291.
DEFINED_FOR_STANDARD_DEVIATION_TYPES = {const.StdDev.TOTAL}
#: This GMPE doesn't require site parameters since it has been developed
#: for hard rock sites (see page 2290)
REQUIRES_SITES_PARAMETERS = set()
#: Required rupture parameters is magnitude
#: See equation 18 page page 2291
REQUIRES_RUPTURE_PARAMETERS = {'mag'}
#: Required distance measure is Rrup.
#: See equation 18 page page 2291
REQUIRES_DISTANCES = {'rrup'}
[docs] def get_mean_and_stddevs(self, sites, rup, dists, imt, stddev_types):
"""
See :meth:`superclass method
<.base.GroundShakingIntensityModel.get_mean_and_stddevs>`
for spec of input and result values.
"""
# extracting dictionary of coefficients
C = self.COEFFS[imt]
mag = self._convert_magnitude(rup.mag)
# computing the magnitude term. Equation 19, page 2291
f1 = self._compute_magnitude_scaling_term(C, mag)
# computing the geometrical spreading term. Equation 20, page 2291
f2 = self._compute_geometrical_spreading_term(C, dists.rrup)
# computing the anelastic attenuation term. Equation 21, page 2291
f3 = self._compute_anelastic_attenuation_term(C, dists.rrup, mag)
# computing the mean ln(IMT) using equation 18 at page 2290
mean = f1 + f2 + f3
mean = self._clip_mean(imt, mean)
# computing the total standard deviation
stddevs = self._get_stddevs(C, stddev_types, num_sites=len(dists.rrup),
mag=mag)
return mean, stddevs
def _get_stddevs(self, C, stddev_types, num_sites, mag):
"""
Returns standard deviation as defined in equation 23, page 2291
(Tavakoli and Pezeshk, 2005)
"""
stddevs = []
sigma = (C['c14'] + C['c15'] * mag) if mag < 7.2 else C['c16']
vals = sigma * np.ones((num_sites))
for _ in stddev_types:
stddevs.append(vals)
return stddevs
def _convert_magnitude(self, mag):
"""
Return magnitude value unchanged. This is a dummy method that
subclasses can change to incorporate magnitude conversion
equations.
"""
return mag
def _clip_mean(self, imt, mean):
"""
Return mean values unchanged. This is a dummy method that subclasses
can change to incorporate clipping of mean values.
"""
return mean
def _compute_magnitude_scaling_term(self, C, mag):
"""
Compute magnitude scaling term as defined in equation 19, page 2291
(Tavakoli and Pezeshk, 2005)
"""
if mag > 8.5:
raise ValueError('Magnitude %s > 8.5' % mag)
return C['c1'] + C['c2'] * mag + C['c3'] * (8.5 - mag) ** 2.5
def _compute_geometrical_spreading_term(self, C, rrup):
"""
Compute magnitude scaling term as defined in equation 19, page 2291
(Tavakoli and Pezeshk, 2005)
"""
f2 = np.ones_like(rrup)
idx1 = np.nonzero(rrup <= 70.)
idx2 = np.nonzero((rrup > 70.) & (rrup <= 130.))
idx3 = np.nonzero(rrup > 130.)
f2[idx1] = (C['c9'] * np.log(rrup[idx1] + 4.5))
f2[idx2] = (C['c10'] * np.log(rrup[idx2]/70.) +
C['c9'] * np.log(rrup[idx2] + 4.5))
f2[idx3] = (C['c11'] * np.log(rrup[idx3]/130.) +
C['c10'] * np.log(rrup[idx3]/70.) +
C['c9'] * np.log(rrup[idx3] + 4.5))
return f2
def _compute_anelastic_attenuation_term(self, C, rrup, mag):
"""
Compute magnitude-distance scaling term as defined in equation 21,
page 2291 (Tavakoli and Pezeshk, 2005)
"""
r = (rrup**2. + (C['c5'] * np.exp(C['c6'] * mag +
C['c7'] * (8.5 - mag)**2.5))**2.)**.5
f3 = ((C['c4'] + C['c13'] * mag) * np.log(r) +
(C['c8'] + C['c12'] * mag) * r)
return f3
#: Coefficient table is constructed from an excel spreadsheet available
#: on Pezeshk's website http://www.ce.memphis.edu/pezeshk
COEFFS = CoeffsTable(sa_damping=5, table="""\
IMT c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 c15 c16
pga 1.139E+00 6.228E-01 -4.834E-02 -1.807E+00 -6.516E-01 4.465E-01 -2.933E-05 -4.045E-03 9.456E-03 1.410E+00 -9.611E-01 4.315E-04 1.332E-04 1.205E+00 -1.109E-01 4.091E-01
0.05 1.823E+00 5.333E-01 -4.748E-02 -1.631E+00 -5.672E-01 4.538E-01 7.771E-03 -4.907E-03 -3.139E-03 9.797E-01 -9.386E-01 5.121E-04 9.301E-04 1.216E+00 -1.080E-01 4.413E-01
0.08 6.826E-01 7.428E-01 -2.928E-02 -1.715E+00 -7.562E-01 4.601E-01 -9.677E-04 -4.941E-03 -5.500E-03 1.135E+00 -9.156E-01 4.822E-04 7.331E-04 1.224E+00 -1.081E-01 4.494E-01
0.10 8.692E-01 6.070E-01 -4.736E-02 -1.522E+00 -7.044E-01 4.491E-01 -6.188E-03 -4.702E-03 -4.239E-03 1.039E+00 -9.129E-01 4.108E-04 3.584E-04 1.232E+00 -1.081E-01 4.562E-01
0.15 2.383E+00 5.009E-01 -6.422E-02 -1.732E+00 -9.763E-01 4.137E-01 6.598E-03 -4.805E-03 3.928E-03 1.506E+00 -8.650E-01 3.642E-04 6.841E-04 1.240E+00 -1.082E-01 4.643E-01
0.20 -5.476E-01 8.570E-01 -2.622E-02 -1.684E+00 -8.607E-01 4.332E-01 2.786E-03 -3.655E-03 -2.025E-03 1.643E+00 -9.252E-01 1.615E-04 6.434E-04 1.240E+00 -1.082E-01 4.691E-01
0.30 -5.130E-01 6.673E-01 -4.431E-02 -1.421E+00 -4.695E-01 4.681E-01 1.076E-02 -5.407E-03 6.436E-03 1.519E+00 -9.153E-01 4.324E-04 2.870E-04 1.260E+00 -1.088E-01 4.788E-01
0.50 2.403E-01 6.106E-01 -7.889E-02 -1.548E+00 -8.438E-01 4.145E-01 7.889E-03 -3.648E-03 -2.654E-04 1.592E+00 -8.586E-01 2.770E-04 1.457E-04 1.275E+00 -1.073E-01 5.051E-01
0.75 -6.789E-01 6.659E-01 -8.304E-02 -1.481E+00 -7.340E-01 4.347E-01 9.531E-03 -3.374E-03 -1.189E-03 1.546E+00 -7.839E-01 2.454E-04 5.470E-04 1.276E+00 -1.050E-01 5.222E-01
1.00 -1.550E+00 7.644E-01 -8.585E-02 -1.491E+00 -9.409E-01 4.238E-01 -5.836E-03 -2.088E-03 3.298E-03 1.519E+00 -7.568E-01 1.166E-04 7.589E-04 1.275E+00 -1.029E-01 5.368E-01
1.50 -2.296E+00 7.941E-01 -8.842E-02 -1.453E+00 -8.860E-01 4.122E-01 8.299E-03 -3.272E-03 2.506E-03 1.706E+00 -7.688E-01 2.329E-04 1.656E-04 1.268E+00 -9.990E-02 5.509E-01
2.00 -2.704E+00 8.053E-01 -9.294E-02 -1.444E+00 -9.235E-01 4.077E-01 2.062E-02 -2.143E-03 2.301E-03 1.426E+00 -7.551E-01 2.138E-04 3.908E-04 1.264E+00 -9.780E-02 5.617E-01
3.00 -2.421E+00 8.008E-01 -1.077E-01 -1.648E+00 -8.976E-01 4.368E-01 1.675E-02 -2.033E-03 3.576E-03 1.934E+00 -8.183E-01 1.158E-04 3.983E-04 1.257E+00 -9.520E-02 5.729E-01
4.00 -3.685E+00 8.166E-01 -1.177E-01 -1.463E+00 -8.448E-01 4.249E-01 1.135E-02 -1.719E-03 -3.345E-03 1.689E+00 -7.374E-01 1.100E-04 3.592E-04 1.254E+00 -9.260E-02 5.893E-01
""")
[docs]class TavakoliPezeshk2005MblgAB1987NSHMP2008(TavakoliPezeshk2005):
"""
Extend :class:`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.
"""
#: Shear-wave velocity for reference soil conditions in [m s-1]
DEFINED_FOR_REFERENCE_VELOCITY = 760.
def _convert_magnitude(self, mag):
"""
Convert Mblg to Mw using Atkinson and Boore 1987 conversion equation
"""
return mblg_to_mw_atkinson_boore_87(mag)
def _clip_mean(self, imt, mean):
"""
Return mean values unchanged. This is a dummy method that subclasses
can change to incorporate clipping of mean values.
"""
return clip_mean(imt, mean)
#: Coefficient table is constructed using the values included in
#: hazgridXnga2.f
COEFFS = CoeffsTable(sa_damping=5, table="""\
IMT c1 c2 c3 c4 c5 c6 c7 c8 c9 c10 c11 c12 c13 c14 c15 c16
pga 1.56E+00 6.23E-01 -4.83E-02 -1.81E+00 -6.52E-01 4.46E-01 -2.93E-05 -4.05E-03 9.46E-03 1.41E+00 -9.61E-01 4.32E-04 1.33E-04 1.21E+00 -1.11E-01 4.09E-01
5.00E-02 2.24E+00 5.33E-01 -4.75E-02 -1.63E+00 -5.67E-01 4.54E-01 7.77E-03 -4.91E-03 -3.14E-03 9.80E-01 -9.39E-01 5.12E-04 9.30E-04 1.22E+00 -1.08E-01 4.41E-01
8.00E-02 1.10E+00 7.43E-01 -2.93E-02 -1.71E+00 -7.56E-01 4.60E-01 -9.68E-04 -4.94E-03 -5.50E-03 1.13E+00 -9.16E-01 4.82E-04 7.33E-04 1.22E+00 -1.08E-01 4.49E-01
1.00E-01 1.4229 6.07E-01 -4.74E-02 -1.52E+00 -7.04E-01 4.49E-01 -6.19E-03 -4.70E-03 -4.24E-03 1.04E+00 -9.13E-01 4.11E-04 3.58E-04 1.23E+00 -1.08E-01 4.56E-01
1.50E-01 2.87E+00 5.01E-01 -6.42E-02 -1.73E+00 -9.76E-01 4.14E-01 6.60E-03 -4.80E-03 3.93E-03 1.51E+00 -8.65E-01 3.64E-04 6.84E-04 1.24E+00 -1.08E-01 4.64E-01
2.00E-01 1.70E-02 8.57E-01 -2.62E-02 -1.68E+00 -8.61E-01 4.33E-01 2.79E-03 -3.65E-03 -2.02E-03 1.64E+00 -9.25E-01 1.61E-04 6.43E-04 1.24E+00 -1.08E-01 4.69E-01
3.00E-01 0.491 6.67E-01 -4.43E-02 -1.42E+00 -4.70E-01 4.68E-01 1.08E-02 -5.41E-03 6.44E-03 1.52E+00 -9.15E-01 4.32E-04 2.87E-04 1.26E+00 -1.09E-01 4.79E-01
5.00E-01 6.97E-01 6.11E-01 -7.89E-02 -1.55E+00 -8.44E-01 4.14E-01 7.89E-03 -3.65E-03 -2.65E-04 1.59E+00 -8.59E-01 2.77E-04 1.46E-04 1.28E+00 -1.07E-01 5.05E-01
7.50E-01 -3.23E-01 6.66E-01 -8.30E-02 -1.48E+00 -7.34E-01 4.35E-01 9.53E-03 -3.37E-03 -1.19E-03 1.55E+00 -7.84E-01 2.45E-04 5.47E-04 1.28E+00 -1.05E-01 5.22E-01
1.00E+00 -1.26E+00 7.64E-01 -8.59E-02 -1.49E+00 -9.41E-01 4.24E-01 -5.84E-03 -2.09E-03 3.30E-03 1.52E+00 -7.57E-01 1.17E-04 7.59E-04 1.28E+00 -1.03E-01 5.37E-01
1.50E+00 -1.94E+00 7.94E-01 -8.84E-02 -1.45E+00 -8.86E-01 4.12E-01 8.30E-03 -3.27E-03 2.51E-03 1.71E+00 -7.69E-01 2.33E-04 1.66E-04 1.27E+00 -9.99E-02 5.51E-01
2.00E+00 -2.5177 8.05E-01 -9.29E-02 -1.44E+00 -9.23E-01 4.08E-01 2.06E-02 -2.14E-03 2.30E-03 1.43E+00 -7.55E-01 2.14E-04 3.91E-04 1.26E+00 -9.78E-02 5.62E-01
3.00E+00 -2.28 8.01E-01 -1.08E-01 -1.65E+00 -8.98E-01 4.37E-01 1.67E-02 -2.03E-03 3.58E-03 1.93E+00 -8.18E-01 1.16E-04 3.98E-04 1.26E+00 -9.52E-02 5.73E-01
4.00E+00 -2.28 8.17E-01 -1.18E-01 -1.46E+00 -8.45E-01 4.25E-01 1.13E-02 -1.72E-03 -3.34E-03 1.69E+00 -7.37E-01 1.10E-04 3.59E-04 1.25E+00 -9.26E-02 5.89E-01
""")
[docs]class TavakoliPezeshk2005MblgJ1996NSHMP2008(
TavakoliPezeshk2005MblgAB1987NSHMP2008):
"""
Extend :class:`TavakoliPezeshk2005MblgAB1987NSHMP2008` but uses Johnston
1996 equation to convert Mblg to Mw
"""
def _convert_magnitude(self, mag):
"""
Convert Mblg to Mw using Johnston 1996 conversion equation
"""
return mblg_to_mw_johnston_96(mag)
[docs]class TavakoliPezeshk2005MwNSHMP2008(
TavakoliPezeshk2005MblgAB1987NSHMP2008):
"""
Extend :class:`TavakoliPezeshk2005MblgAB1987NSHMP2008` but assumes
magnitude to be in Mw scale, and therefore no conversion is applied
"""
def _convert_magnitude(self, mag):
"""
Return magnitude value unchanged
"""
return mag