Package gov.usgs.earthquake.nshmp.gmm

Interface GroundMotionModel

All Known Implementing Classes:
AbrahamsonEtAl_2014, AbrahamsonGulerce_2020, AbrahamsonSilva_1997, Atkinson_2008p, Atkinson_2010, Atkinson_2015, AtkinsonBoore_2003, AtkinsonBoore_2006, AtkinsonBoore_2006p, AtkinsonMacias_2009, BcHydro_2012, BooreAtkinson_2008, BooreEtAl_1997, BooreEtAl_1997_Alaska, BooreEtAl_2014, Campbell_1997, Campbell_2003, CampbellBozorgnia_2003, CampbellBozorgnia_2003_Alaska, CampbellBozorgnia_2003_Alaska.Gridded, CampbellBozorgnia_2008, CampbellBozorgnia_2014, ChiouYoungs_2008, ChiouYoungs_2014, ConusStableCrust_2014, FrankelEtAl_1996, Geomatrix_1993, GmmTotalTree, Gomez_2022, Idriss_2014, KuehnEtAl_2020, MotazedianAtkinson_2003, MotazedianAtkinson_2005, MunsonThurber_1997, NgaEast, ParkerEtAl_2020, PezeshkEtAl_2011, PezeshkEtAl_2018, SadighEtAl_1997, ShahjoueiPezeshk_2016, SilvaEtAl_2002, SomervilleEtAl_2001, SpudichEtAl_1999_PRVI, TavakoliPezeshk_2005, ToroEtAl_1997, UsgsPrviBackbone2025, WongEtAl_2015, YoungsEtAl_1997, ZhaoEtAl_2006
public interface GroundMotionModel
Interface implemented by all ground motion models (GMMs); these are also commonly referred to as ground motion prediction equations (GMPEs) or attenuation relationships. Direct instantiation of GMMs is discouraged in concrete implementations in favor of using the corresponding Gmm enum identifier and its Gmm.instance(Imt) method. Concrete implementations are public solely for the purpose of documentation.

Models generally have a single concrete implementation. However, for those supplying region- or source-specific variants, there will typically be an abstract base-model implementation and subclasses to handle each flavor (e.g. ZhaoEtAl_2006. Each flavor has a unique Gmm identifier.

Author:
U.S. Geological Survey
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    LogicTree<GroundMotion>
    calc(GmmInput in)
    Computes a logic tree of scalar ground motions and standard deviations for the supplied arguments.
    default LogicTree<GroundMotion>
    dampedCalc(GmmInput in, Gmm.Type type, double dampingRatio)
    Computes a logic tree of scalar ground motions via calc(GmmInput), and then applies any damping scaling.
    Imt
    imt()
    The intensity measure type (IMT) of this GMM instance.

  • Method Details

    • imt

      Imt imt()
      The intensity measure type (IMT) of this GMM instance.

    • calc

      LogicTree<GroundMotion> calc(GmmInput in)
      Computes a logic tree of scalar ground motions and standard deviations for the supplied arguments. This method is implemented by GMMs to provide the horizontal peak ground acceleration and (optionally) velocity (PGA, PGV) as well as 5% damped pseudo-spectral acceleration for periods between 0.01 s and 10 s. For most modern GMMs, ground motions are computed as the average horizontal component (RotD50) but many older GMMs use some other average horizontal measure (e.g. GMRotI50).
      Parameters:
      in - a ground motion model input argument container

    • dampedCalc

      default LogicTree<GroundMotion> dampedCalc(GmmInput in, Gmm.Type type, double dampingRatio)
      Computes a logic tree of scalar ground motions via calc(GmmInput), and then applies any damping scaling. This method is called by most applications and services.
      Parameters:
      in - a ground motion model input argument container
      type - the GMM type
      dampingRatio -