gov.usgs.earthquake.nshmp.gmm

Class GmmUtils

java.lang.Object

gov.usgs.earthquake.nshmp.gmm.GmmUtils

public final class GmmUtils
extends Object

Ground motion model (Gmm) utilities.

Author:

Peter Powers

Constructor Summary

Constructors

Constructor and Description
GmmUtils()

Method Summary

Modifier and Type	Method and Description
static double	getAvgHW_CB(double M, double D, double P) Returns the average hanging-wall factor appropriate for CampbellBozorgnia_2008 for a dipping point source at the supplied distance and magnitude and period of interest.
static double	getAvgHW_CY(double M, double D, double P) Returns the average hanging-wall factor appropriate for ChiouYoungs_2008 for a dipping point source at the supplied distance and magnitude and period of interest.
static double	getMeanRJB(double M, double D) Returns a corrected distance value corresponding to the supplied JB distance and magnitude.
static FaultStyle	rakeToFaultStyle_NSHMP(double rake) Returns the NSHMP interpretation of fault type based on rake; divisions are on 45° diagonals.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GmmUtils

public GmmUtils()

Method Detail

rakeToFaultStyle_NSHMP

public static FaultStyle rakeToFaultStyle_NSHMP(double rake)

Returns the NSHMP interpretation of fault type based on rake; divisions are on 45° diagonals.

Note: This is inconsistent with next generation attenuation relationship (NGAW1 and NGAW2) recommendations.

Parameters:

rake - to convert (in degrees)

Returns:

the corresponding FaultStyle

getMeanRJB

public static double getMeanRJB(double M,
                                double D)

Returns a corrected distance value corresponding to the supplied JB distance and magnitude. Magnitude is expected to be a 0.05 centered value between 6 and 7.6 (e.g [6.05, 6.15, ... 7.55]). Distance values should be <1000km. If D ≥ 1000km, method returns D.

Parameters:

M - magnitude

D - distance

Returns:

the corrected distance or D if D ??? 1000

Throws:

IllegalArgumentException - if M is not one of [6.05, 6.15, ... 8.55]

getAvgHW_CB

public static double getAvgHW_CB(double M,
                                 double D,
                                 double P)

Returns the average hanging-wall factor appropriate for CampbellBozorgnia_2008 for a dipping point source at the supplied distance and magnitude and period of interest. Magnitude is expected to be a 0.05 centered value between 6 and 7.5 (e.g [6.05, 6.15, ... 7.45]). Distance values should be ≤200km. If distance value is >200km, method returns 0. Valid periods are those prescribed by CampbellBozorgnia_2008.

Parameters:

M - magnitude

D - distance

P - period

Returns:

the hanging wall factor

Throws:

IllegalArgumentException - if M is not one of [6.05, 6.15, ... 7.45]

IllegalArgumentException - if P is not one of [-2.0 (pgd), -1.0 (pgv), 0.0 (pga), 0.01, 0.02, 0.03, 0.04, 0.05, 0.075, 0.1, 0.15, 0.2, 0.25, 0.3, 0.4, 0.5, 0.75, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.5, 10.0]

getAvgHW_CY

public static double getAvgHW_CY(double M,
                                 double D,
                                 double P)

Returns the average hanging-wall factor appropriate for ChiouYoungs_2008 for a dipping point source at the supplied distance and magnitude and period of interest. Magnitude is expected to be a 0.05 centered value between 5 and 7.5 (e.g [5.05, 6.15, ... 7.45]). If there is no match for the supplied magnitude, method returns 0. Distance values should be ≤200km. If distance value is >200km, method returns 0. Valid periods are those prescribed by ChiouYoungs_2008 (Note:PGV is currently missing).

Parameters:

M - magnitude

D - distance

P - period

Returns:

the hanging wall factor

Throws:

IllegalArgumentException - if P is not one of [0.0 (pga), 0.01, 0.02, 0.03, 0.04, 0.05, 0.075, 0.1, 0.15, 0.2, 0.25, 0.3, 0.4, 0.5, 0.75, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.5, 10.0]