shakelib.conversions.imc.beyer_bommer_2006

Module implements BeyerBommer2006 class to convert between various horizontal intensity measure components.

class shakelib.conversions.imc.beyer_bommer_2006.BeyerBommer2006(imc_in, imc_out)[source]

Bases: ComponentConverter

Implements conversion for various “Intensity Measure Components” (IMCs) per Beyer and Bommer (2006).

IMC equivalencies:

OpenQuake

Beyer & Bommer

GEOMETRIC_MEAN

GMxy (Geometric mean)

HORIZONTAL

Random?

MEDIAN_HORIZONTAL

AMxy (Arithmetic mean)

GMRotI50

GMRotI50

RotD50

GMRotD50

RANDOM_HORIZONTAL

Random

GREATER_OF_TWO_HORIZONTAL

Env_xy

VERTICAL

Notes

  • GEOMETRIC_MEAN is the “reference” type.

  • The OQ IMC “HORIZONAL” indicates that the horizontal IMC category may be ambiguous. In these cases, we are assuming that it is a random horizontal component as a default.

  • Assumes ALL unknown IMC types are GEOMETRIC_MEAN

References

Beyer, K., & Bommer, J. J. (2006). Relationships between median values and between aleatory variabilities for different definitions of the horizontal component of motion. Bulletin of the Seismological Society of America, 96(4A), 1512-1522. [link]

convertAmpsOnce(imt, amps, rrups=None, mag=None)[source]

Returns amps converted from one IMC to another.

Important:

  • Assumes the input amps are in natural log (not linear) space

  • IMC type ‘VERTICAL’ is not supported

Parameters:
  • imt (IMT) – OpenQuake IMT of the input amps (must be one of PGA, PGV, or SA). [link] <http://docs.openquake.org/oq-hazardlib/master/imt.html>

  • amps (array) – Numpy array of ground motion amplitudes.

  • rrups (array) – A numpy array of the same shape as amps, containing the rupture distances of the ground motions. Ignored by this method.

  • mag (float) – The earthquake magnitude. Default is None. Ignored by this method.

Returns:

Numpy array of amps converted from imc_in to imc_out.

Return type:

array

convertSigmasOnce(imt, sigmas)[source]

Returns standard deviations converted from one IMC to another.

Important:

  • Assumes the input sigmas are in natural log space

  • IMC types ‘VERTICAL’ and ‘HORIZONTAL’ are not supported

Parameters:
  • imt (IMT) – OpenQuake IMT of the input sigmas (must be one of PGA, PGV, or SA) [link]

  • sigmas (array) – Numpy array of standard deviations.

Returns:

Numpy array of standard deviations converted from imc_in to

imc_out.

Return type:

array