Source code for openquake.hazardlib.gsim.bozorgnia_campbell_2016

# -*- coding: utf-8 -*-
# vim: tabstop=4 shiftwidth=4 softtabstop=4
#
# Copyright (C) 2014-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:`BozorgniaCampbell2016`
               :class:`BozorgniaCampbell2016HighQ`
               :class:`BozorgniaCampbell2016LowQ`
               :class:`BozorgniaCampbell2016AveQJapanSite`
               :class:`BozorgniaCampbell2016HighQJapanSite`
               :class:`BozorgniaCampbell2016LowQJapanSite`
"""
import numpy as np
from openquake.hazardlib.gsim.base import GMPE, CoeffsTable, add_alias
from openquake.hazardlib.gsim.campbell_bozorgnia_2014 import (
    _select_basin_model, _get_magnitude_term, _get_geometric_attenuation_term,
    _get_hanging_wall_term, _get_fault_dip_term,
    _get_hypocentral_depth_term, _get_taulny, _get_philny)
from openquake.hazardlib import const
from openquake.hazardlib.imt import PGA, PGV, SA


def _get_anelastic_attenuation_term(sgn, C, rrup):
    """
    Returns the anelastic attenuation term, f_atn, defined in equation 25
    """
    Dc20 = _get_delta_c20(sgn, C)
    f_atn = np.zeros(len(rrup))
    idx = rrup > 80.0
    f_atn[idx] = (C["c20"] + Dc20) * (rrup[idx] - 80.0)
    return f_atn


def _get_basin_response_term(SJ, C, z2pt5):
    """
    Returns the basin response term, f_sed, defined in equation 20

    The deep basin response (z2.5 > 1km) is not included in this model
    """
    f_sed = np.zeros(len(z2pt5))
    idx = z2pt5 < 1.0
    f_sed[idx] = (C["c14"] + C["c15"] * SJ) * (z2pt5[idx] - 1.0)
    return f_sed


def _get_delta_c20(sgn, C):
    """
    Retrieve regional-dependent coefficient accounting for differences in
    anelastic attenuation in path scaling

    This is to derive a reference/base-case c20 that includes
    California, Taiwan, the Middle East, and other similar active tectonic
    regions to represent a typical or average Q region.
    """
    if sgn == 0:
        return 0.
    elif sgn == 1:
        return C['Dc20_CH']
    elif sgn == -1:
        return C['Dc20_JP']


def _get_shallow_site_response_term(SJ, C, vs30):
    """
    Returns the shallow site response term, f_site, defined in
    equations 17, 18, and 19

    Note that the effects of nonlinear soil response for the vertical
    component were not included in this model
    """
    vs_mod = vs30 / C["k1"]
    # Get linear global site response term
    f_site_g = C["c11"] * np.log(vs_mod)

    # For Japan ctx (SJ = 1) further scaling is needed (equation 19)
    if SJ:
        fsite_j = C["c13"] * np.log(vs_mod)
        # additional term activated for soft ctx (Vs30 <= 200m/s)
        # in Japan data
        idx = vs30 <= 200.0
        add_soft = C["c12"] * (np.log(vs_mod) - np.log(200.0 / C["k1"]))
        # combine terms
        fsite_j[idx] += add_soft[idx]
        return f_site_g + fsite_j
    else:
        return f_site_g


def _get_stddevs(C, ctx):
    """
    Returns the inter-event, intra-event, and total standard deviations

    Note that it is assumed here that the soil response of the vertical
    component is linear (i.e. nonlinear site response effects not
    included). Thus, the expressions for the aleatory std devs for the
    vertical component is much simpler than in the horizontal component,
    since the site response- and IMT-correlation functions are neglected.
    """
    # Evaluate tau according to equation 27
    tau = _get_taulny(C, ctx.mag)
    # Evaluate phi according to equation 28
    phi = _get_philny(C, ctx.mag)
    return [np.sqrt(tau ** 2 + phi ** 2), tau, phi]


def _get_style_of_faulting_term(C, ctx):
    """
    Returns the style-of-faulting scaling term, f_flt, defined in
    equations 4 to 6
    """
    frv = np.zeros_like(ctx.rake)
    fnm = np.zeros_like(ctx.rake)
    frv[(ctx.rake > 30.) & (ctx.rake < 150.)] = 1.
    fnm[(ctx.rake > -150.) & (ctx.rake < -30.0)] = 1.
    # Re-defined this method to replace c8, which is now
    # IMT-dependent in BC15
    fflt_f = C["c8"] * frv + C["c9"] * fnm
    fflt_m = np.clip(ctx.mag - 4.5, 0., 1.)
    return fflt_f * fflt_m


[docs]def get_mean_values(SJ, sgn, C, ctx): """ Returns the mean values for a specific IMT """ if isinstance(ctx.z2pt5, np.ndarray): # Site model defined temp_z2pt5 = ctx.z2pt5 else: # Estimate unspecified sediment depth according to # equations 33 and 34 of CB14 temp_z2pt5 = _select_basin_model(SJ, ctx.vs30) return (_get_magnitude_term(C, ctx.mag) + _get_geometric_attenuation_term(C, ctx.mag, ctx.rrup) + _get_style_of_faulting_term(C, ctx) + _get_hanging_wall_term(C, ctx) + _get_shallow_site_response_term(SJ, C, ctx.vs30) + _get_basin_response_term(SJ, C, temp_z2pt5) + _get_hypocentral_depth_term(C, ctx) + _get_fault_dip_term(C, ctx) + _get_anelastic_attenuation_term(sgn, C, ctx.rrup))
[docs]class BozorgniaCampbell2016(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) """ #: Supported tectonic region type is active shallow crust DEFINED_FOR_TECTONIC_REGION_TYPE = const.TRT.ACTIVE_SHALLOW_CRUST #: Supported intensity measure types are spectral acceleration, peak #: ground velocity and peak ground acceleration DEFINED_FOR_INTENSITY_MEASURE_TYPES = {PGA, PGV, SA} #: Supported intensity measure component is the #: :attr:`~openquake.hazardlib.const.IMC.Vertical` direction component DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = const.IMC.VERTICAL #: Supported standard deviation types are inter-event, intra-event #: and total; see the section for "Aleatory Variability Model". DEFINED_FOR_STANDARD_DEVIATION_TYPES = { const.StdDev.TOTAL, const.StdDev.INTER_EVENT, const.StdDev.INTRA_EVENT} #: Required site parameters are Vs30, Vs30 type (measured or inferred), #: and depth (km) to the 2.5 km/s shear wave velocity layer (z2pt5) REQUIRES_SITES_PARAMETERS = {'vs30', 'z2pt5'} #: Required rupture parameters are magnitude, rake, dip, ztor, rupture #: width and hypocentral depth REQUIRES_RUPTURE_PARAMETERS = { 'mag', 'rake', 'dip', 'ztor', 'width', 'hypo_depth'} #: Required distance measures are Rrup, Rjb and Rx REQUIRES_DISTANCES = {'rrup', 'rjb', 'rx'} def __init__(self, SJ=0, sgn=0, **kwargs): super().__init__(**kwargs) self.SJ = SJ self.sgn = sgn
[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. """ # Extract dictionary of coefficients specific to required IMT and PGA C_PGA = self.COEFFS[PGA()] # Get PGA on given ctx pga = get_mean_values(self.SJ, self.sgn, C_PGA, ctx) for m, imt in enumerate(imts): C = self.COEFFS[imt] # Get mean and standard deviations for IMT mean[m] = get_mean_values(self.SJ, self.sgn, C, ctx) if imt.string[:2] == "SA" and imt.period < 0.25: # If Sa (T) < PGA for T < 0.25 then set mean Sa(T) to mean PGA idx = mean[m] < pga mean[m, idx] = pga[idx] # Get standard deviations sig[m], tau[m], phi[m] = _get_stddevs(C, ctx)
#: Table of regression coefficients obtained from supplementary material #: published together with the EQS paper COEFFS = CoeffsTable(sa_damping=5, table="""\ IMT 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 pgv -3.86 1.51 0.27 -1.299 -0.379 -2.383 0.196 6.274 0.111 -0.128 0.14 -0.395 0.338 0.407 -0.0016 0.382 0.0581 0.0294 0.00761 -0.0019 0.0005 0.0019 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.608 0.442 0.334 0.24 pga -4.729 0.984 0.537 -1.499 -0.443 -2.666 0.214 7.166 0 -0.23 0.759 -0.356 1.019 0.373 -0.1172 -0.097 0.102 0.0442 0.00784 -0.0053 -0.0018 0.0039 0.167 0.241 1.474 -0.715 -0.337 -0.27 865 0.694 0.493 0.461 0.347 0.01 -4.674 0.977 0.533 -1.485 -0.445 -2.665 0.214 7.136 0 -0.229 0.759 -0.354 1.015 0.372 -0.1193 -0.094 0.1026 0.0452 0.00784 -0.0053 -0.0018 0.0039 0.168 0.242 1.471 -0.714 -0.336 -0.27 865 0.695 0.494 0.462 0.345 0.02 -4.548 0.976 0.549 -1.488 -0.453 -2.699 0.215 6.936 0 -0.27 0.768 -0.344 0.95 0.4 -0.1454 -0.081 0.1059 0.0427 0.00786 -0.0052 -0.0018 0.0036 0.166 0.244 1.467 -0.711 -0.339 -0.263 865 0.7 0.508 0.474 0.375 0.03 -4.05 0.931 0.628 -1.494 -0.464 -2.772 0.216 7.235 0 -0.315 0.766 -0.297 1.056 0.394 -0.1957 -0.091 0.1175 0.041 0.00815 -0.0052 -0.002 0.0033 0.167 0.246 1.467 -0.713 -0.338 -0.259 908 0.722 0.536 0.529 0.416 0.05 -3.435 0.887 0.674 -1.388 -0.552 -2.76 0.202 8.334 0 -0.329 0.764 -0.363 1.316 0.422 -0.187 -0.29 0.1238 0.0408 0.00783 -0.0062 -0.0026 0.0039 0.173 0.251 1.449 -0.701 -0.338 -0.263 1054 0.751 0.584 0.576 0.468 0.075 -3.435 0.902 0.726 -1.469 -0.543 -2.575 0.177 8.761 0 -0.29 0.795 -0.427 1.758 0.336 -0.095 -0.261 0.1088 0.0516 0.00726 -0.0072 -0.0021 0.0048 0.198 0.26 1.435 -0.695 -0.347 -0.219 1086 0.74 0.578 0.523 0.427 0.1 -3.93 0.993 0.698 -1.572 -0.47 -2.461 0.166 9.049 0 -0.203 0.842 -0.429 1.411 0.314 -0.0999 -0.091 0.0918 0.0559 0.00644 -0.0072 -0.0018 0.005 0.174 0.259 1.449 -0.708 -0.391 -0.201 1032 0.723 0.57 0.461 0.39 0.15 -5.505 1.267 0.51 -1.669 -0.452 -2.349 0.164 8.633 0 -0.203 0.736 -0.421 1.227 0.289 0.0017 -0.092 0.072 0.0447 0.00745 -0.0066 -0.0018 0.0048 0.198 0.254 1.461 -0.715 -0.449 -0.099 878 0.731 0.536 0.391 0.343 0.2 -6.28 1.366 0.447 -1.75 -0.435 -2.335 0.175 8.742 0 -0.203 0.801 -0.429 0.987 0.29 0.0402 -0.081 0.0602 0.0485 0.00789 -0.0056 -0.0022 0.0041 0.204 0.237 1.484 -0.721 -0.393 -0.198 748 0.701 0.51 0.363 0.308 0.25 -6.789 1.458 0.274 -1.711 -0.41 -2.332 0.183 8.4 0 -0.203 0.715 -0.438 0.577 0.303 0.0468 0.011 0.05 0.0416 0.00629 -0.0049 -0.0025 0.0034 0.185 0.206 1.581 -0.787 -0.339 -0.21 654 0.687 0.507 0.355 0.288 0.3 -7.4 1.528 0.193 -1.77 -0.305 -2.297 0.19 7.643 0 -0.203 0.708 -0.421 0.279 0.336 0.0255 0.092 0.0382 0.0438 0.00524 -0.0046 -0.0027 0.0031 0.164 0.21 1.586 -0.795 -0.447 -0.121 587 0.668 0.514 0.355 0.265 0.4 -8.75 1.739 -0.02 -1.594 -0.446 -2.219 0.185 7.059 0 -0.203 0.683 -0.401 0.358 0.358 0.0606 0.122 0.0264 0.0307 0.00522 -0.0037 -0.0024 0.0024 0.16 0.226 1.544 -0.77 -0.525 -0.086 503 0.628 0.521 0.36 0.28 0.5 -9.74 1.872 -0.121 -1.577 -0.489 -2.205 0.191 6.375 0 -0.203 0.704 -0.417 0.229 0.432 0.0904 0.287 0.0163 0.0287 0.00539 -0.0031 -0.0025 0.0021 0.184 0.217 1.554 -0.77 -0.407 -0.281 457 0.606 0.526 0.376 0.284 0.75 -11.05 2.021 -0.042 -1.757 -0.53 -2.143 0.188 5.166 0.016 -0.203 0.602 -0.49 0.574 0.459 0.1776 0.292 -0.0016 0.0277 0.00501 -0.0021 -0.0025 0.002 0.216 0.154 1.626 -0.78 -0.371 -0.285 410 0.568 0.536 0.416 0.322 1 -12.184 2.18 -0.069 -1.707 -0.624 -2.092 0.176 5.642 0.032 -0.115 0.394 -0.539 0.98 0.442 0.2389 0.316 -0.0072 0.0277 0.00506 -0.0012 -0.0023 0.0012 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.536 0.55 0.472 0.311 1.5 -13.451 2.27 0.047 -1.621 -0.686 -1.913 0.144 5.963 0.128 -0.005 0.328 -0.611 0.819 0.52 0.2758 0.45 -0.0262 0.0293 0.00353 -0.0004 -0.0013 0.0004 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.511 0.559 0.507 0.329 2 -13.7 2.271 0.149 -1.512 -0.84 -1.882 0.126 7.584 0.255 0.12 0.112 -0.63 0.044 0.566 0.3051 0.424 -0.0408 0.0221 0.0022 0 -0.0004 0 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.507 0.571 0.539 0.345 3 -13.9 2.15 0.368 -1.315 -0.89 -1.789 0.105 8.645 0.284 0.17 0.011 -0.562 -0.396 0.562 0.3482 0.3 -0.0512 0.0321 -0.00137 0 0 0 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.474 0.557 0.515 0.335 4 -14.59387 2.132 0.726 -1.506 -0.885 -1.78139 0.10009 10.20357 0.26112 0.17 0 -0.53663 0.00115 0.51499 0.35267 0.25726 -0.0567 0.02249 0.00053 0 0 0 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.466 0.566 0.553 0.331 5 -15.63449 2.116 1.027 -1.721 -0.878 -1.68982 0.098 8.38571 0.28229 0.17747 0 -0.44173 -0.59234 0.51133 0.30443 0.17039 -0.04288 0.02372 0.00233 0 0 0 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.43 0.568 0.578 0.294 7.5 -17.12864 2.223 0.169 -0.756 -1.077 -1.72135 0.125 5.77927 0.38692 0.38278 0 -0.3428 -1.13827 0.57479 0.16789 0.21872 -0.0308 0.0171 -0.00298 0 0 0 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.386 0.527 0.6 0.379 10 -17.65672 2.132 0.367 -0.8 -1.282 -1.948 0.163 4.13478 0.32216 0.33417 0 -0.19908 -0.32493 0.32431 0.16858 0.12681 0.00668 -0.00165 0.00092 0 0 0 0.596 0.117 1.616 -0.733 -0.128 -0.756 400 0.395 0.481 0.495 0.442 """)
add_alias('BozorgniaCampbell2016HighQ', BozorgniaCampbell2016, sgn=1) add_alias('BozorgniaCampbell2016LowQ', BozorgniaCampbell2016, sgn=-1) add_alias('BozorgniaCampbell2016AveQJapanSite', BozorgniaCampbell2016, SJ=1) add_alias('BozorgniaCampbell2016HighQJapanSite', BozorgniaCampbell2016, SJ=1, sgn=+1) add_alias('BozorgniaCampbell2016LowQJapanSite', BozorgniaCampbell2016, SJ=1, sgn=-1)