Source code for openquake.hazardlib.gsim.atkinson_boore_2003

# -*- coding: utf-8 -*-
# vim: tabstop=4 shiftwidth=4 softtabstop=4
#
# Copyright (C) 2012-2023 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:`AtkinsonBoore2003SInter`,
:class:`AtkinsonBoore2003SSlab`,
:class:`AtkinsonBoore2003SInterNSHMP2008`,
:class:`AtkinsonBoore2003SSlabNSHMP2008`,
:class:`AtkinsonBoore2003SSlabCascadia`,
:class:`AtkinsonBoore2003SSlabCascadiaNSHMP2008`,
:class:`AtkinsonBoore2003SSlabJapan`
:class:`AtkinsonBoore2003SSlabJapanNSHMP2008`
"""
import numpy as np
from scipy.constants import g
import copy

from openquake.hazardlib.gsim.base import GMPE, CoeffsTable
from openquake.hazardlib import const
from openquake.hazardlib.imt import PGA, SA
from openquake.baselib.general import CallableDict


def _compute_mean(kind, C, g, mag, hypo_depth, rrup, vs30, pga_rock, imt):
    """
    Compute mean according to equation 1, page 1706.
    """
    hypo_depth = np.clip(hypo_depth, 0, 100.)
    delta = 0.00724 * 10 ** (0.507 * mag)
    R = np.sqrt(rrup ** 2 + delta ** 2)

    s_amp = _compute_soil_amplification(kind, C, vs30, pga_rock, imt)

    mean = (
        # 1st term
        C['c1'] + C['c2'] * mag +
        # 2nd term
        C['c3'] * hypo_depth +
        # 3rd term
        C['c4'] * R -
        # 4th term
        g * np.log10(R) +
        # 5th, 6th and 7th terms
        s_amp)

    return mean


_compute_site_class_dummy_variables = CallableDict()


@_compute_site_class_dummy_variables.add('SInter')
def _compute_site_class_dummy_variables_SInter(kind, vs30):
    """
    Compute site class dummy variables as explained in paragraph
    'Functional Form', page 1706.
    """
    Sc = np.zeros_like(vs30)
    Sd = np.zeros_like(vs30)
    Se = np.zeros_like(vs30)

    Sc[(vs30 > 360) & (vs30 <= 760)] = 1
    Sd[(vs30 >= 180) & (vs30 <= 360)] = 1
    Se[vs30 < 180] = 1

    return Sc, Sd, Se


@_compute_site_class_dummy_variables.add('SInter2008', 'SSlab2008')
def _compute_site_class_dummy_variables_2008(kind, vs30):
    """
    Extend
    :meth:`AtkinsonBoore2003SInter._compute_site_class_dummy_variables`
    and includes dummy variable for B/C site conditions (vs30 > 760.)
    """
    Sbc = np.zeros_like(vs30)
    Sc = np.zeros_like(vs30)
    Sd = np.zeros_like(vs30)
    Se = np.zeros_like(vs30)

    Sbc[vs30 > 760.] = 1
    Sc[(vs30 > 360) & (vs30 <= 760)] = 1
    Sd[(vs30 >= 180) & (vs30 <= 360)] = 1
    Se[vs30 < 180] = 1

    return Sbc, Sc, Sd, Se


_compute_soil_amplification = CallableDict()


@_compute_soil_amplification.add('SInter')
def _compute_soil_amplification_SInter(kind, C, vs30, pga_rock, imt):
    """
    Compute soil amplification (5th, 6th, and 7th terms in equation 1,
    page 1706).
    """
    Sc, Sd, Se = _compute_site_class_dummy_variables(kind, vs30)
    sl = _compute_soil_linear_factor(pga_rock, imt)

    return C['c5'] * sl * Sc + C['c6'] * sl * Sd + C['c7'] * sl * Se


@_compute_soil_amplification.add('SInter2008', 'SSlab2008')
def _compute_soil_amplification_2008(kind, C, vs30, pga_rock, imt):
    """
    Compute soil amplification (5th, 6th, and 7th terms in equation 1,
    page 1706) and add the B/C site condition as implemented by NSHMP.
    """
    Sbc, Sc, Sd, Se = _compute_site_class_dummy_variables(kind, vs30)
    sl = _compute_soil_linear_factor(pga_rock, imt)

    return (
        C['c5'] * sl * Sbc * 0.5 +
        C['c5'] * sl * Sc +
        C['c6'] * sl * Sd +
        C['c7'] * sl * Se)


def _compute_soil_linear_factor(pga_rock, imt):
    """
    Compute soil linear factor as explained in paragraph 'Functional
    Form', page 1706.
    """
    if imt.period >= 1:
        return np.ones_like(pga_rock)
    else:
        sl = np.zeros_like(pga_rock)

        pga_between_100_500 = (pga_rock > 100) & (pga_rock < 500)
        pga_greater_equal_500 = pga_rock >= 500

        is_SA_between_05_1 = 0.5 < imt.period < 1

        is_SA_less_equal_05 = imt.period <= 0.5

        if is_SA_between_05_1:
            sl[pga_between_100_500] = (1 - (1. / imt.period - 1) *
                                       (pga_rock[pga_between_100_500] -
                                       100) / 400)
            sl[pga_greater_equal_500] = 1 - (1. / imt.period - 1)

        if is_SA_less_equal_05 or imt.period == 0:
            sl[pga_between_100_500] = (1 - (pga_rock[pga_between_100_500] -
                                       100) / 400)

        sl[pga_rock <= 100] = 1

        return sl


[docs]class AtkinsonBoore2003SInter(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'). """ #: Supported tectonic region type is subduction interface DEFINED_FOR_TECTONIC_REGION_TYPE = const.TRT.SUBDUCTION_INTERFACE #: Supported intensity measure types are spectral acceleration, #: and peak ground acceleration, see table 1, page 1715 DEFINED_FOR_INTENSITY_MEASURE_TYPES = {PGA, SA} #: 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_COMPONENT = const.IMC.RANDOM_HORIZONTAL #: Supported standard deviation types are inter-event, intra-event #: and total, see table 1, page 1715 DEFINED_FOR_STANDARD_DEVIATION_TYPES = { const.StdDev.TOTAL, const.StdDev.INTER_EVENT, const.StdDev.INTRA_EVENT} DEFINED_FOR_REFERENCE_VELOCITY = 800 #: Required site parameters is Vs30, used to distinguish between NEHRP #: soil classes, see paragraph 'Functional Form', page 1706 REQUIRES_SITES_PARAMETERS = {'vs30'} #: Required rupture parameters are magnitude and focal depth, see equation #: 1, page 1706 REQUIRES_RUPTURE_PARAMETERS = {'mag', 'hypo_depth'} #: Required distance measure is closest distance to rupture, see equation #: 1, page 1706 REQUIRES_DISTANCES = {'rrup'} kind = 'SInter'
[docs] def compute(self, ctx: np.recarray, imts, mean, sig, tau, phi): """ See :meth:`superclass method <.base.GroundShakingIntensityModel.compute>` for spec of input and result values. """ # cap magnitude values at 8.5, see page 1709 mag = np.clip(ctx.mag, 0, 8.5) if self.kind == 'SInter2008': ctx = copy.copy(ctx) ctx.hypo_depth = 20. # compute PGA on rock (needed for site amplification calculation) G = 10 ** (1.2 - 0.18 * mag) pga_rock = _compute_mean(self.kind, self.COEFFS_SINTER[PGA()], G, mag, ctx.hypo_depth, ctx.rrup, ctx.vs30, # by passing pga_rock > 500 the soil # amplification is 0 np.zeros_like(ctx.vs30) + 600, PGA()) pga_rock = 10 ** pga_rock for m, imt in enumerate(imts): C = self.COEFFS_SINTER[imt] # periods 0.4 s (2.5 Hz) and 0.2 s (5 Hz) need a special case # because of the erratum. SA for 0.4s and 0.2s is computed and a # weighted sum is returned if imt.period in (0.2, 0.4): C04 = self.COEFFS_SINTER[SA(period=0.4, damping=5.0)] C02 = self.COEFFS_SINTER[SA(period=0.2, damping=5.0)] mean04 = _compute_mean(self.kind, C04, G, mag, ctx.hypo_depth, ctx.rrup, ctx.vs30, pga_rock, imt) mean02 = _compute_mean(self.kind, C02, G, mag, ctx.hypo_depth, ctx.rrup, ctx.vs30, pga_rock, imt) if imt.period == 0.2: mean[m] = 0.333 * mean02 + 0.667 * mean04 else: mean[m] = 0.333 * mean04 + 0.667 * mean02 else: mean[m] = _compute_mean(self.kind, C, G, mag, ctx.hypo_depth, ctx.rrup, ctx.vs30, pga_rock, imt) # convert from log10 to ln and units from cm/s**2 to g mean[m] = np.log((10 ** mean[m]) * 1e-2 / g) if imt.period == 4.0: mean[m] /= 0.550 sig[m] = np.log(10 ** C['sigma']) if 's2' in C.dtype.names: # in the Gupta subclass tau[m] = np.log(10 ** C['s2']) phi[m] = np.log(10 ** C['s1'])
COEFFS_SINTER = CoeffsTable(sa_damping=5, table="""\ IMT c1 c2 c3 c4 c5 c6 c7 sigma s1 s2 pga 2.991000 0.035250 0.007590 -0.002060 0.190000 0.240000 0.290000 0.230000 0.200000 0.110000 0.0400 2.875300 0.070520 0.010040 -0.002780 0.150000 0.200000 0.200000 0.260000 0.220000 0.140000 0.1000 2.778900 0.098410 0.009740 -0.002870 0.150000 0.230000 0.200000 0.270000 0.250000 0.100000 0.2000 2.663800 0.123860 0.008840 -0.002800 0.150000 0.270000 0.250000 0.280000 0.250000 0.130000 0.4000 2.524900 0.147700 0.007280 -0.002350 0.130000 0.370000 0.380000 0.290000 0.250000 0.150000 1.0000 2.144200 0.134500 0.005210 -0.001100 0.100000 0.300000 0.550000 0.340000 0.280000 0.190000 2.0000 2.190700 0.071480 0.002240 0.000000 0.100000 0.250000 0.400000 0.340000 0.290000 0.180000 3.0000 2.301000 0.022370 0.000120 0.000000 0.100000 0.250000 0.360000 0.360000 0.310000 0.180000 4.0000 2.301000 0.022370 0.000120 0.000000 0.100000 0.250000 0.360000 0.360000 0.310000 0.180000 """)
[docs]class AtkinsonBoore2003SSlab(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'). """ #: Supported tectonic region type is subduction interface DEFINED_FOR_TECTONIC_REGION_TYPE = const.TRT.SUBDUCTION_INTRASLAB
[docs] def compute(self, ctx: np.recarray, imts, mean, sig, tau, phi): """ See :meth:`superclass method <.base.GroundShakingIntensityModel.compute>` for spec of input and result values. """ # cap magnitude values at 8.0, see page 1709 mag = np.clip(ctx.mag, 0, 8.0) # compute PGA on rock (needed for site amplification calculation) G = 10 ** (0.301 - 0.01 * mag) pga_rock = _compute_mean(self.kind, self.COEFFS_SSLAB[PGA()], G, mag, ctx.hypo_depth, ctx.rrup, ctx.vs30, # by passing pga_rock > 500 the soil # amplification is 0 np.zeros_like(ctx.vs30) + 600, PGA()) pga_rock = 10 ** pga_rock for m, imt in enumerate(imts): C = self.COEFFS_SSLAB[imt] # compute actual mean and convert from log10 to ln and units from # cm/s**2 to g mean[m] = _compute_mean( self.kind, C, G, mag, ctx.hypo_depth, ctx.rrup, ctx.vs30, pga_rock, imt) mean[m] = np.log((10 ** mean[m]) * 1e-2 / g) if imt.period == 4.0: mean[m] /= 0.550 sig[m] = np.log(10 ** C['sigma']) if 's2' in C.dtype.names: # in the Gupta subclass tau[m] = np.log(10 ** C['s2']) phi[m] = np.log(10 ** C['s1'])
COEFFS_SSLAB = CoeffsTable(sa_damping=5, table="""\ IMT c1 c2 c3 c4 c5 c6 c7 sigma s1 s2 pga -0.04713 0.69090 0.01130 -0.00202 0.19000 0.24000 0.29000 0.27000 0.23000 0.14000 0.0400 0.50697 0.63273 0.01275 -0.00234 0.15000 0.20000 0.20000 0.25000 0.24000 0.07000 0.1000 0.43928 0.66675 0.01080 -0.00219 0.15000 0.23000 0.20000 0.28000 0.27000 0.07000 0.2000 0.51589 0.69186 0.00572 -0.00192 0.15000 0.27000 0.25000 0.28000 0.26000 0.10000 0.4000 0.00545 0.77270 0.00173 -0.00178 0.13000 0.37000 0.38000 0.28000 0.26000 0.10000 1.0000 -1.02133 0.87890 0.00130 -0.00173 0.10000 0.30000 0.55000 0.29000 0.27000 0.11000 2.0000 -2.39234 0.99640 0.00364 -0.00118 0.10000 0.25000 0.40000 0.30000 0.28000 0.11000 3.0000 -3.70012 1.11690 0.00615 -0.00045 0.10000 0.25000 0.36000 0.30000 0.29000 0.08000 4.0000 -3.70012 1.11690 0.00615 -0.00045 0.10000 0.25000 0.36000 0.30000 0.29000 0.08000 """)
[docs]class AtkinsonBoore2003SInterNSHMP2008(AtkinsonBoore2003SInter): """ Extend :class:`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'
[docs]class AtkinsonBoore2003SSlabNSHMP2008(AtkinsonBoore2003SSlab): """ Extend :class:`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'
[docs]class AtkinsonBoore2003SSlabCascadia(AtkinsonBoore2003SSlab): """ Extends :class:`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(sa_damping=5, table="""\ IMT c1 c2 c3 c4 c5 c6 c7 sigma s1 s2 pga -0.25 0.69090 0.01130 -0.00202 0.19000 0.24000 0.29000 0.27000 0.23000 0.14000 0.0400 0.23 0.63273 0.01275 -0.00234 0.15000 0.20000 0.20000 0.25000 0.24000 0.07000 0.1000 0.16 0.66675 0.01080 -0.00219 0.15000 0.23000 0.20000 0.28000 0.27000 0.07000 0.2000 0.40 0.69186 0.00572 -0.00192 0.15000 0.27000 0.25000 0.28000 0.26000 0.10000 0.4000 -0.01 0.77270 0.00173 -0.00178 0.13000 0.37000 0.38000 0.28000 0.26000 0.10000 1.0000 -0.98 0.87890 0.00130 -0.00173 0.10000 0.30000 0.55000 0.29000 0.27000 0.11000 2.0000 -2.25 0.99640 0.00364 -0.00118 0.10000 0.25000 0.40000 0.30000 0.28000 0.11000 3.0000 -3.64 1.11690 0.00615 -0.00045 0.10000 0.25000 0.36000 0.30000 0.29000 0.08000 """)
[docs]class AtkinsonBoore2003SSlabCascadiaNSHMP2008(AtkinsonBoore2003SSlabNSHMP2008): """ Combines :class:`AtkinsonBoore2003SSlabNSHMP2008` for NSHMP site amplification with :class:`AtkinsonBoore2003SSlabCascadia` for Cascadia. """ COEFFS_SSLAB = AtkinsonBoore2003SSlabCascadia.COEFFS_SSLAB
[docs]class AtkinsonBoore2003SSlabJapan(AtkinsonBoore2003SSlab): """ Extends :class:`AtkinsonBoore2003SSlab` but substitutes values for c1 from Table 3 which incorporate correction factors for Japan. """ COEFFS_SSLAB = CoeffsTable(sa_damping=5, table="""\ IMT c1 c2 c3 c4 c5 c6 c7 sigma s1 s2 pga 0.10 0.69090 0.01130 -0.00202 0.19000 0.24000 0.29000 0.27000 0.23000 0.14000 0.0400 0.68 0.63273 0.01275 -0.00234 0.15000 0.20000 0.20000 0.25000 0.24000 0.07000 0.1000 0.61 0.66675 0.01080 -0.00219 0.15000 0.23000 0.20000 0.28000 0.27000 0.07000 0.2000 0.70 0.69186 0.00572 -0.00192 0.15000 0.27000 0.25000 0.28000 0.26000 0.10000 0.4000 0.07 0.77270 0.00173 -0.00178 0.13000 0.37000 0.38000 0.28000 0.26000 0.10000 1.0000 -0.98 0.87890 0.00130 -0.00173 0.10000 0.30000 0.55000 0.29000 0.27000 0.11000 2.0000 -2.44 0.99640 0.00364 -0.00118 0.10000 0.25000 0.40000 0.30000 0.28000 0.11000 3.0000 -3.73 1.11690 0.00615 -0.00045 0.10000 0.25000 0.36000 0.30000 0.29000 0.08000 """)
[docs]class AtkinsonBoore2003SSlabJapanNSHMP2008(AtkinsonBoore2003SSlabNSHMP2008): """ Combines :class:`AtkinsonBoore2003SSlabNSHMP2008` for NSHMP site amplification with :class:`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 = AtkinsonBoore2003SSlabJapan.COEFFS_SSLAB