org.opensha.sha.imr.attenRelImpl
Class CB_2006_AttenRel

java.lang.Object
  org.opensha.sha.imr.AbstractIMR
      org.opensha.sha.imr.AttenuationRelationship
          org.opensha.sha.imr.attenRelImpl.CB_2006_AttenRel

All Implemented Interfaces:

Serializable, Comparable<IntensityMeasureRelationship>, EventListener, Named, XMLSaveable, ParameterChangeListener, IntensityMeasureRelationship, ScalarIMR

Deprecated.

@Deprecated
public class CB_2006_AttenRel
extends AttenuationRelationship
implements ParameterChangeListener

Title: CB_2006_AttenRel

Description: This implements the Attenuation Relationship developed by Campbell & Bozorgnia (2006, http://peer.berkeley.edu/lifelines/nga_docs/nov_13_06/Campbell-Bozorgnia_NGA_11-13-06.html)

Supported Intensity-Measure Parameters:

• pgaParam - Peak Ground Acceleration
• pgvParam - Peak Ground Velocity
• pgdParam - Peak Ground Displacement
• saParam - Response Spectral Acceleration

Other Independent Parameters:

• magParam - moment Magnitude
• fltTypeParam - Style of faulting
• rupTopDepthParam - depth to top of rupture
• dipParam - rupture surface dip
• distanceRupParam - closest distance to surface projection of fault
• distRupMinusJB_OverRupParam - used as a proxy for hanging wall effect
• vs30Param
• depthTo2pt5kmPerSecParam
• componentParam - Component of shaking
• stdDevTypeParam - The type of standard deviation

NOTES: distRupMinusJB_OverRupParam is used rather than distancJBParameter because the latter should not be held constant when distanceRupParameter is changed (e.g., in the AttenuationRelationshipApplet). This includes the stipulation that the mean of 0.2-sec SA should not be less than that of PGA (the latter being given if so).

Verification : This model has been tested with the test data provided by Campbell and Bozorgnia along with ther NGA report. I took values as provided in the file and created a text file where each line has following info:
Period (sec) Mag FType FRV FNM ZTOR DIP Vs30 Z25 Rrup Rjb GMP Sigma Tau Chi SigTot
Each element of the line is seperated by space. I read this file and provide the input parameters in OpenSHA with these values. Then I compare the OpenSHA result with that given by Campbell and Bozorgnia in the test data file. I am using JUnit testing to validate the implementation of the Campbell and Bozorgnia model. One can run the JUnit test and compare the OpenSHA results with the Campbell and Bozorgnia NGA model. If any of the result show discrepancy then JUnit test will fail. When it fails it will also show for which input parameters the test failed.

Version:

1.0

Author:

Ned Field & Nitin Gupta

See Also:

Serialized Form

Field Summary

protected static Double	DEPTH_2pt5_WARN_MAX Deprecated.
protected static Double	DEPTH_2pt5_WARN_MIN Deprecated.
protected static Double	DIP_WARN_MAX Deprecated.
protected static Double	DIP_WARN_MIN Deprecated.
protected static Double	DISTANCE_MINUS_WARN_MAX Deprecated.
protected static Double	DISTANCE_MINUS_WARN_MIN Deprecated.
protected static Double	DISTANCE_RUP_WARN_MAX Deprecated.
protected static Double	DISTANCE_RUP_WARN_MIN Deprecated.
static String	FLT_TYPE_NORMAL Deprecated.
static String	FLT_TYPE_REVERSE Deprecated.
static String	FLT_TYPE_STRIKE_SLIP Deprecated.
protected static Double	MAG_WARN_MAX Deprecated.
protected static Double	MAG_WARN_MIN Deprecated.
static String	NAME Deprecated.
protected static Double	RUP_TOP_WARN_MAX Deprecated.
protected static Double	RUP_TOP_WARN_MIN Deprecated.
static String	SHORT_NAME Deprecated.
protected static Double	VS30_WARN_MAX Deprecated.
protected static Double	VS30_WARN_MIN Deprecated.

Fields inherited from class org.opensha.sha.imr.AttenuationRelationship

aftershockParam, cavParam, componentParam, depthTo1pt0kmPerSecParam, depthTo2pt5kmPerSecParam, dipParam, distanceJBParam, distanceRupParam, distanceSeisParam, distRupMinusDistX_OverRupParam, distRupMinusJB_OverRupParam, ds575Param, ds595Param, ERR, exceedProbIndependentParams, fltTypeParam, focalDepthParam, hangingWallFlagParam, imlAtExceedProbIndependentParams, magParam, meanIndependentParams, pgaParam, pgdParam, pgvParam, rakeParam, rupTopDepthParam, rupWidthParam, saDampingParam, saParam, saPeriodParam, sigmaTruncLevelParam, sigmaTruncTypeParam, stdDevIndependentParams, stdDevTypeParam, tectonicRegionTypeParam, USER_MAX_DISTANCE, VERY_SMALL_MEAN, vs30_TypeParam, vs30Param

Fields inherited from class org.opensha.sha.imr.AbstractIMR

eqkRupture, eqkRuptureParams, EXCEED_PROB_DEFAULT, EXCEED_PROB_INFO, EXCEED_PROB_MAX, EXCEED_PROB_MIN, EXCEED_PROB_NAME, exceedProbParam, im, intensityMeasureChanged, listener, otherParams, propagationEffectParams, site, siteParams, supportedIMParams, url_info_string, XML_METADATA_IMT_NAME, XML_METADATA_NAME, XML_METADATA_SITE_PARAMETERS_NAME

Fields inherited from interface org.opensha.commons.metadata.XMLSaveable

XML_METADATA_NAME

Constructor Summary

CB_2006_AttenRel(ParameterChangeWarningListener listener)
Deprecated. This initializes several ParameterList objects.

Method Summary

URL	getInfoURL() Deprecated. This provides a URL where more info on this model can be obtained
double	getMean() Deprecated. Calculates the mean of the exceedence probability distribution.
double	getMean(int iper, double vs30, double rRup, double distJB, double f_rv, double f_nm, double mag, double depthTop, double depthTo2pt5kmPerSec, boolean magSaturation, double pgar) Deprecated.
String	getName() Deprecated. get the name of this IMR
String	getShortName() Deprecated. Returns the Short Name of each AttenuationRelationship
double	getStdDev() Deprecated. This returns the standard deviation (stdDev) of the intensity-measure level for the current set of parameters.
double	getStdDev(int iper, String stdDevType, String component) Deprecated.
protected void	initEqkRuptureParams() Deprecated. Creates the two Potential Earthquake parameters (magParam and fltTypeParam) and adds them to the eqkRuptureParams list.
protected void	initIndependentParamLists() Deprecated. This creates the lists of independent parameters that the various dependent parameters (mean, standard deviation, exceedance probability, and IML at exceedance probability) depend upon.
protected void	initOtherParams() Deprecated. Creates other Parameters that the mean or stdDev depends upon, such as the Component or StdDevType parameters.
protected void	initParameterEventListeners() Deprecated. Adds the parameter change listeners.
protected void	initPropagationEffectParams() Deprecated. Creates the Propagation Effect parameters and adds them to the propagationEffectParams list.
protected void	initSiteParams() Deprecated. Creates the Site-Type parameter and adds it to the siteParams list.
protected void	initSupportedIntensityMeasureParams() Deprecated. Creates the two supported IM parameters (PGA and SA), as well as the independenParameters of SA (periodParam and dampingParam) and adds them to the supportedIMParams list.
void	parameterChange(ParameterChangeEvent e) Deprecated. This listens for parameter changes and updates the primitive parameters accordingly
void	resetParameterEventListeners() Deprecated. Allows to reset the change listeners on the parameters
protected void	setCoeffIndex() Deprecated. This function returns the array index for the coeffs corresponding to the chosen IMT
void	setEqkRupture(EqkRupture eqkRupture) Deprecated. This sets the eqkRupture related parameters (magParam and fltTypeParam) based on the eqkRupture passed in.
void	setParamDefaults() Deprecated. Allows the user to set the default parameter values for the selected Attenuation Relationship.
protected void	setPropagationEffectParams() Deprecated. This sets the two propagation-effect parameters (distanceRupParam and isOnHangingWallParam) based on the current site and eqkRupture.
void	setSite(Site site) Deprecated. This sets the site-related parameter (siteTypeParam) based on what is in the Site object passed in (the Site object must have a parameter with the same name as that in siteTypeParam).

Methods inherited from class org.opensha.sha.imr.AttenuationRelationship

getAllParamMetadata, getEpsilon, getEpsilon, getExceedProbabilities, getExceedProbability, getExceedProbability, getExceedProbability, getExceedProbIndependentParams, getExceedProbIndependentParamsIterator, getIML_AtExceedProb, getIML_AtExceedProb, getIML_AtExceedProbIndependentParams, getIML_AtExceedProbIndependentParamsIterator, getMeanIndependentParams, getMeanIndependentParamsIterator, getSA_ExceedProbSpectrum, getSA_IML_AtExceedProbSpectrum, getStdDevIndependentParams, getStdDevIndependentParamsIterator, getTotExceedProbability, isTectonicRegionSupported, isTectonicRegionSupported, setIntensityMeasureLevel, setIntensityMeasureLevel, setSiteLocation, setUserMaxDistance

Methods inherited from class org.opensha.sha.imr.AbstractIMR

compareTo, fromXMLMetadata, getEqkRupture, getEqkRuptureParams, getEqkRuptureParamsIterator, getIntensityMeasure, getIntensityMeasureLevel, getOtherParams, getOtherParamsIterator, getParameter, getPropagationEffectParams, getPropagationEffectParamsIterator, getSite, getSiteParams, getSiteParamsIterator, getSupportedIntensityMeasures, getSupportedIntensityMeasuresIterator, isIntensityMeasureSupported, isIntensityMeasureSupported, setAll, setExceedProb, setIntensityMeasure, setIntensityMeasure, setWarningListener, toXMLMetadata

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensha.sha.imr.IntensityMeasureRelationship

getEqkRupture, getEqkRuptureParams, getEqkRuptureParamsIterator, getIntensityMeasure, getIntensityMeasureLevel, getOtherParams, getOtherParamsIterator, getParameter, getPropagationEffectParams, getPropagationEffectParamsIterator, getSite, getSiteParams, getSiteParamsIterator, getSupportedIntensityMeasures, getSupportedIntensityMeasuresIterator, isIntensityMeasureSupported, isIntensityMeasureSupported, setAll, setExceedProb, setIntensityMeasure, setIntensityMeasure, toXMLMetadata

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

SHORT_NAME

public static final String SHORT_NAME

Deprecated.

See Also:

Constant Field Values

NAME

public static final String NAME

Deprecated.

See Also:

Constant Field Values

MAG_WARN_MIN

protected static final Double MAG_WARN_MIN

Deprecated.

MAG_WARN_MAX

protected static final Double MAG_WARN_MAX

Deprecated.

DISTANCE_RUP_WARN_MIN

protected static final Double DISTANCE_RUP_WARN_MIN

Deprecated.

DISTANCE_RUP_WARN_MAX

protected static final Double DISTANCE_RUP_WARN_MAX

Deprecated.

DISTANCE_MINUS_WARN_MIN

protected static final Double DISTANCE_MINUS_WARN_MIN

Deprecated.

DISTANCE_MINUS_WARN_MAX

protected static final Double DISTANCE_MINUS_WARN_MAX

Deprecated.

VS30_WARN_MIN

protected static final Double VS30_WARN_MIN

Deprecated.

VS30_WARN_MAX

protected static final Double VS30_WARN_MAX

Deprecated.

DEPTH_2pt5_WARN_MIN

protected static final Double DEPTH_2pt5_WARN_MIN

Deprecated.

DEPTH_2pt5_WARN_MAX

protected static final Double DEPTH_2pt5_WARN_MAX

Deprecated.

DIP_WARN_MIN

protected static final Double DIP_WARN_MIN

Deprecated.

DIP_WARN_MAX

protected static final Double DIP_WARN_MAX

Deprecated.

RUP_TOP_WARN_MIN

protected static final Double RUP_TOP_WARN_MIN

Deprecated.

RUP_TOP_WARN_MAX

protected static final Double RUP_TOP_WARN_MAX

Deprecated.

FLT_TYPE_STRIKE_SLIP

public static final String FLT_TYPE_STRIKE_SLIP

Deprecated.

See Also:

Constant Field Values

FLT_TYPE_REVERSE

public static final String FLT_TYPE_REVERSE

Deprecated.

See Also:

Constant Field Values

FLT_TYPE_NORMAL

public static final String FLT_TYPE_NORMAL

Deprecated.

See Also:

Constant Field Values

Constructor Detail

CB_2006_AttenRel

public CB_2006_AttenRel(ParameterChangeWarningListener listener)

Deprecated.

This initializes several ParameterList objects.

Method Detail

setEqkRupture

public void setEqkRupture(EqkRupture eqkRupture)
                   throws InvalidRangeException

Deprecated.

This sets the eqkRupture related parameters (magParam and fltTypeParam) based on the eqkRupture passed in. The internally held eqkRupture object is also set as that passed in. Warning constraints are ingored.

Specified by:

setEqkRupture in interface IntensityMeasureRelationship

Overrides:

setEqkRupture in class AbstractIMR

Parameters:

eqkRupture - The new eqkRupture value

Throws:

InvalidRangeException - thrown if rake is out of bounds

setSite

public void setSite(Site site)
             throws ParameterException

Deprecated.

This sets the site-related parameter (siteTypeParam) based on what is in the Site object passed in (the Site object must have a parameter with the same name as that in siteTypeParam). This also sets the internally held Site object as that passed in.

Specified by:

setSite in interface IntensityMeasureRelationship

Overrides:

setSite in class AbstractIMR

Parameters:

site - The new site object

Throws:

ParameterException - Thrown if the Site object doesn't contain a Vs30 parameter

setPropagationEffectParams

protected void setPropagationEffectParams()

Deprecated.

This sets the two propagation-effect parameters (distanceRupParam and isOnHangingWallParam) based on the current site and eqkRupture. The hanging-wall term is rake independent (i.e., it can apply to strike-slip or normal faults as well as reverse and thrust). However, it is turned off if the dip is greater than 70 degrees. It is also turned off for point sources regardless of the dip. These specifications were determined from a series of discussions between Ned Field, Norm Abrahamson, and Ken Campbell.

Specified by:

setPropagationEffectParams in class AttenuationRelationship

setCoeffIndex

protected void setCoeffIndex()
                      throws ParameterException

Deprecated.

This function returns the array index for the coeffs corresponding to the chosen IMT

Throws:

ParameterException

getMean

public double getMean()

Deprecated.

Calculates the mean of the exceedence probability distribution.

Specified by:

getMean in interface ScalarIMR

Returns:

The mean value

getStdDev

public double getStdDev()

Deprecated.

Description copied from interface: ScalarIMR

This returns the standard deviation (stdDev) of the intensity-measure level for the current set of parameters.

Specified by:

getStdDev in interface ScalarIMR

Returns:

The stdDev value

setParamDefaults

public void setParamDefaults()

Deprecated.

Allows the user to set the default parameter values for the selected Attenuation Relationship.

Specified by:

setParamDefaults in interface IntensityMeasureRelationship

initIndependentParamLists

protected void initIndependentParamLists()

Deprecated.

This creates the lists of independent parameters that the various dependent parameters (mean, standard deviation, exceedance probability, and IML at exceedance probability) depend upon. NOTE: these lists do not include anything about the intensity-measure parameters or any of thier internal independentParamaters.

initSiteParams

protected void initSiteParams()

Deprecated.

Creates the Site-Type parameter and adds it to the siteParams list. Makes the parameters noneditable.

Specified by:

initSiteParams in class AttenuationRelationship

initEqkRuptureParams

protected void initEqkRuptureParams()

Deprecated.

Creates the two Potential Earthquake parameters (magParam and fltTypeParam) and adds them to the eqkRuptureParams list. Makes the parameters noneditable.

Specified by:

initEqkRuptureParams in class AttenuationRelationship

initPropagationEffectParams

protected void initPropagationEffectParams()

Deprecated.

Creates the Propagation Effect parameters and adds them to the propagationEffectParams list. Makes the parameters noneditable.

Specified by:

initPropagationEffectParams in class AttenuationRelationship

initSupportedIntensityMeasureParams

protected void initSupportedIntensityMeasureParams()

Deprecated.

Creates the two supported IM parameters (PGA and SA), as well as the independenParameters of SA (periodParam and dampingParam) and adds them to the supportedIMParams list. Makes the parameters noneditable.

Specified by:

initSupportedIntensityMeasureParams in class AttenuationRelationship

initOtherParams

protected void initOtherParams()

Deprecated.

Creates other Parameters that the mean or stdDev depends upon, such as the Component or StdDevType parameters.

Overrides:

initOtherParams in class AttenuationRelationship

getName

public String getName()

Deprecated.

get the name of this IMR

Specified by:

getName in interface Named

Specified by:

getName in interface IntensityMeasureRelationship

Overrides:

getName in class AbstractIMR

Returns:

the name of this IMR

getShortName

public String getShortName()

Deprecated.

Returns the Short Name of each AttenuationRelationship

Specified by:

getShortName in interface IntensityMeasureRelationship

Returns:

String

getMean

public double getMean(int iper,
                      double vs30,
                      double rRup,
                      double distJB,
                      double f_rv,
                      double f_nm,
                      double mag,
                      double depthTop,
                      double depthTo2pt5kmPerSec,
                      boolean magSaturation,
                      double pgar)

Deprecated.

Parameters:

iper -

vs30 -

rRup -

distJB -

f_rv -

f_nm -

mag -

depthTop -

depthTo2pt5kmPerSec -

magSaturation -

pgar -

Returns:

getStdDev

public double getStdDev(int iper,
                        String stdDevType,
                        String component)

Deprecated.

Parameters:

iper -

stdDevType -

component -

Returns:

parameterChange

public void parameterChange(ParameterChangeEvent e)

Deprecated.

This listens for parameter changes and updates the primitive parameters accordingly

Specified by:

parameterChange in interface ParameterChangeListener

Parameters:

e - ParameterChangeEvent

resetParameterEventListeners

public void resetParameterEventListeners()

Deprecated.

Allows to reset the change listeners on the parameters

Specified by:

resetParameterEventListeners in interface ScalarIMR

Overrides:

resetParameterEventListeners in class AttenuationRelationship

initParameterEventListeners

protected void initParameterEventListeners()

Deprecated.

Adds the parameter change listeners. This allows to listen to when-ever the parameter is changed.

Overrides:

initParameterEventListeners in class AttenuationRelationship

getInfoURL

public URL getInfoURL()
               throws MalformedURLException

Deprecated.

Description copied from class: AbstractIMR

This provides a URL where more info on this model can be obtained

Specified by:

getInfoURL in interface IntensityMeasureRelationship

Overrides:

getInfoURL in class AbstractIMR

Returns:

the URL to the AttenuationRelationship document on the Web.

Throws:

MalformedURLException - if returned URL is not a valid URL.