shakelib.conversions.imc.beyer_bommer_2006

class shakelib.conversions.imc.beyer_bommer_2006.BeyerBommer2006[source]

Bases: object

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

IMC equivalencies:

OpenQuake Beyer & Bommer
AVERAGE_HORIZONTAL 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

  • AVERAGE_HORIZONTAL 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.

To do

  • Inherit from ConvertIMC class.

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]
static ampIMCtoIMC(amps, imc_in, imc_out, imt)[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:
  • amps (array) – Numpy array of ground motion amplitudes.
  • imc_in (IMC) – OpenQuake IMC type of the input amp array. [link]
  • imc_out (IMC) – Desired OpenQuake IMC type of the output amps. [link]
  • 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>
Returns:

Numpy array of amps converted from imc_in to imc_out.

Return type:

array

static sigmaIMCtoIMC(sigmas, imc_in, imc_out, imt)[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:
  • sigmas (array) – Numpy array of standard deviations.
  • imc_in (IMC) – OpenQuake IMC type of the input sigmas array. [link]
  • imc_out (IMC) – Desired OpenQuake IMC type of the output sigmas. [link]
  • imt (IMT) – OpenQuake IMT of the input sigmas (must be one of PGA, PGV, or SA) [link]
Returns:

Numpy array of standard deviations converted from imc_in to

imc_out.

Return type:

array