# -*- 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)