Source code for openquake.hazardlib.gsim.sadigh_1997

# -*- 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:`SadighEtAl1997`.
"""
import numpy as np

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

#: IMT-independent coefficients for deep soil ctx (table 4).
COEFFS_SOIL_IMT_INDEPENDENT = {
    'c1ss': -2.17,
    'c1r': -1.92,
    'c2': 1.0,
    'c3': 1.7,
    'c4lowmag': 2.1863,
    'c5lowmag': 0.32,
    'c4himag': 0.3825,
    'c5himag': 0.5882
}

#: If site vs30 is more than 750 m/s -- treat the soil as rock.
#: See page 180.
ROCK_VS30 = 750

#: Magnitude value to separate coefficients table because of near field
#: saturation effect is 6.5. See page 184.
NEAR_FIELD_SATURATION_MAG = 6.5


[docs]def 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. """ c1 = np.where(is_reverse, COEFFS_SOIL_IMT_INDEPENDENT['c1r'], COEFFS_SOIL_IMT_INDEPENDENT['c1ss']) c2 = COEFFS_SOIL_IMT_INDEPENDENT['c2'] c3 = COEFFS_SOIL_IMT_INDEPENDENT['c3'] c4 = np.where(mag <= NEAR_FIELD_SATURATION_MAG, COEFFS_SOIL_IMT_INDEPENDENT['c4lowmag'], COEFFS_SOIL_IMT_INDEPENDENT['c4himag']) c5 = np.where(mag <= NEAR_FIELD_SATURATION_MAG, COEFFS_SOIL_IMT_INDEPENDENT['c5lowmag'], COEFFS_SOIL_IMT_INDEPENDENT['c5himag']) c6 = np.where(is_reverse, C['c6r'], C['c6ss']) # clip mag if greater than 8.5. This is to avoid # ValueError: negative number cannot be raised to a fractional power mag = np.clip(mag, None, 8.5) return (c1 + c2 * mag + c6 + C['c7'] * ((8.5 - mag) ** 2.5) - c3 * np.log(rrup + c4 * np.exp(c5 * mag)))
[docs]def 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. """ # clip mag if greater than 8.5. This is to avoid # ValueError: negative number cannot be raised to a fractional power mag = np.clip(mag, None, 8.5) # determine the coefficients to use depending on the mag C = np.where(mag <= NEAR_FIELD_SATURATION_MAG, low_coeffs, hi_coeffs) # compute the mean mean = (C['c1'] + C['c2'] * mag + C['c3'] * ((8.5 - mag) ** 2.5) + C['c4'] * np.log(rrup + np.exp(C['c5'] + C['c6'] * mag)) + C['c7'] * np.log(rrup + 2)) # footnote in table 2 says that for reverse ruptures # the mean amplitude value should be multiplied by 1.2 mean[is_reverse] += 0.1823215567939546 # == log(1.2) return mean
[docs]def get_stddev_rock(mag, C): """ Calculate and return total standard deviation for rock ctx. Implements formulae from table 3. """ return np.where( mag > C['maxmag'], C['maxsigma'], C['sigma0'] + C['magfactor'] * mag)
[docs]def 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. """ # footnote from table 4 says that stderr for magnitudes over 7 # is equal to one of magnitude 7. return C['sigma0'] + C['magfactor'] * np.clip(mag, None, 7)
[docs]class SadighEtAl1997(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. """ #: Supported tectonic region type is active shallow crust, #: since data consists of California earthquakes mainly. DEFINED_FOR_TECTONIC_REGION_TYPE = const.TRT.ACTIVE_SHALLOW_CRUST #: Supported intensity measure types are spectral acceleration, #: and peak ground acceleration, see page 180. DEFINED_FOR_INTENSITY_MEASURE_TYPES = {PGA, SA} #: Supported intensity measure component is the geometric mean of #: two : horizontal components #: :attr:`~openquake.hazardlib.const.IMC.GEOMETRIC_MEAN`, : see #: page 180. DEFINED_FOR_INTENSITY_MEASURE_COMPONENT = const.IMC.GEOMETRIC_MEAN #: Supported standard deviation type is only total, see table 3. DEFINED_FOR_STANDARD_DEVIATION_TYPES = {const.StdDev.TOTAL} #: Required site parameter is only Vs30 (used to distinguish rock #: and deep soil). REQUIRES_SITES_PARAMETERS = {'vs30'} #: Required rupture parameters are magnitude and rake (eq. 1). REQUIRES_RUPTURE_PARAMETERS = {'rake', 'mag'} #: Required distance measure is RRup (eq. 1). REQUIRES_DISTANCES = {'rrup'}
[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. """ # GMPE differentiates strike-slip, reverse and normal ruptures, # but combines normal and strike-slip into one category. See page 180. reverse = (45 <= ctx.rake) & (ctx.rake <= 135) is_rock = ctx.vs30 > ROCK_VS30 is_soil = ctx.vs30 <= ROCK_VS30 mag_r = ctx.mag[is_rock] mag_s = ctx.mag[is_soil] rrup_r = ctx.rrup[is_rock] rrup_s = ctx.rrup[is_soil] reverse_r = reverse[is_rock] reverse_s = reverse[is_soil] for m, imt in enumerate(imts): mean[m, is_rock] = get_mean_rock( mag_r, rrup_r, reverse_r, self.COEFFS_ROCK_LOWMAG[imt], self.COEFFS_ROCK_HIMAG[imt]) sig[m, is_rock] = get_stddev_rock( mag_r, self.COEFFS_ROCK_STDDERR[imt]) mean[m, is_soil] = get_mean_deep_soil( mag_s, rrup_s, reverse_s, self.COEFFS_SOIL[imt]) sig[m, is_soil] = get_stddev_deep_soil( mag_s, self.COEFFS_SOIL[imt])
#: Coefficients tables for rock ctx (table 2), for magnitude #: values of :attr:`NEAR_FIELD_SATURATION_MAG` and below. Damping #: for spectral acceleration here and in other SA-tables is 5%, #: see "introduction" section. COEFFS_ROCK_LOWMAG = CoeffsTable(sa_damping=5, table="""\ IMT c1 c2 c3 c4 c5 c6 c7 PGA -0.624 1.0 0.000 -2.100 1.29649 0.250 0.0 0.07 0.110 1.0 0.006 -2.128 1.29649 0.250 -0.082 0.10 0.275 1.0 0.006 -2.148 1.29649 0.250 -0.041 0.20 0.153 1.0 -0.004 -2.080 1.29649 0.250 0.0 0.30 -0.057 1.0 -0.017 -2.028 1.29649 0.250 0.0 0.40 -0.298 1.0 -0.028 -1.990 1.29649 0.250 0.0 0.50 -0.588 1.0 -0.040 -1.945 1.29649 0.250 0.0 0.75 -1.208 1.0 -0.050 -1.865 1.29649 0.250 0.0 1.0 -1.705 1.0 -0.055 -1.800 1.29649 0.250 0.0 1.5 -2.407 1.0 -0.065 -1.725 1.29649 0.250 0.0 2.0 -2.945 1.0 -0.070 -1.670 1.29649 0.250 0.0 3.0 -3.700 1.0 -0.080 -1.610 1.29649 0.250 0.0 4.0 -4.230 1.0 -0.100 -1.570 1.29649 0.250 0.0 """) #: Coefficients tables for rock ctx (table 2), for magnitude #: values above :attr:`NEAR_FIELD_SATURATION_MAG`. COEFFS_ROCK_HIMAG = CoeffsTable(sa_damping=5, table="""\ IMT c1 c2 c3 c4 c5 c6 c7 PGA -1.274 1.1 0.000 -2.100 -0.48451 0.524 0.0 0.07 -0.540 1.1 0.006 -2.128 -0.48451 0.524 -0.082 0.10 -0.375 1.1 0.006 -2.148 -0.48451 0.524 -0.041 0.20 -0.497 1.1 -0.004 -2.080 -0.48451 0.524 0.0 0.30 -0.707 1.1 -0.017 -2.028 -0.48451 0.524 0.0 0.40 -0.948 1.1 -0.028 -1.990 -0.48451 0.524 0.0 0.50 -1.238 1.1 -0.040 -1.945 -0.48451 0.524 0.0 0.75 -1.858 1.1 -0.050 -1.865 -0.48451 0.524 0.0 1.0 -2.355 1.1 -0.055 -1.800 -0.48451 0.524 0.0 1.5 -3.057 1.1 -0.065 -1.725 -0.48451 0.524 0.0 2.0 -3.595 1.1 -0.070 -1.670 -0.48451 0.524 0.0 3.0 -4.350 1.1 -0.080 -1.610 -0.48451 0.524 0.0 4.0 -4.880 1.1 -0.100 -1.570 -0.48451 0.524 0.0 """) #: Coefficient tables for standard error on rock ctx (table 3). COEFFS_ROCK_STDDERR = CoeffsTable(sa_damping=5, table="""\ IMT sigma0 magfactor maxsigma maxmag PGA 1.39 -0.14 0.38 7.21 0.07 1.40 -0.14 0.39 7.21 0.10 1.41 -0.14 0.40 7.21 0.20 1.43 -0.14 0.42 7.21 0.30 1.45 -0.14 0.44 7.21 0.40 1.48 -0.14 0.47 7.21 0.50 1.50 -0.14 0.49 7.21 0.75 1.52 -0.14 0.51 7.21 1.0 1.53 -0.14 0.52 7.21 4.0 1.53 -0.14 0.52 7.21 """) #: Coefficient tables for deep soil ctx (table 4). COEFFS_SOIL = CoeffsTable(sa_damping=5, table="""\ IMT c6ss c6r c7 sigma0 magfactor maxmag PGA 0.0000 0.0000 0.0 1.52 -0.16 7 0.075 0.4572 0.4572 0.005 1.54 -0.16 7 0.1 0.6395 0.6395 0.005 1.54 -0.16 7 0.2 0.9187 0.9187 -0.004 1.565 -0.16 7 0.3 0.9547 0.9547 -0.014 1.58 -0.16 7 0.4 0.9251 0.9005 -0.024 1.595 -0.16 7 0.5 0.8494 0.8285 -0.033 1.61 -0.16 7 0.75 0.7010 0.6802 -0.051 1.635 -0.16 7 1.0 0.5665 0.5075 -0.065 1.66 -0.16 7 1.5 0.3235 0.2215 -0.090 1.69 -0.16 7 2.0 0.1001 -0.0526 -0.108 1.70 -0.16 7 3.0 -0.2801 -0.4905 -0.139 1.71 -0.16 7 4.0 -0.6274 -0.8907 -0.160 1.71 -0.16 7 """)