For information on how to run the code see the readme: https://github.com/ucgmsim/Empirical_Engine/blob/master/README.md

Conceptual Model

OpenQuake

Models from OpenQuake can be used with Empirical Engine, the class needs to be passed in instead of the model name or shorthand. Some OpenQuake models have shorthand available. Install OpenQuake and then import the wanted class(es) if shorthand isn't available.
Some models may have rare parameters that aren't taken care of, most should work as-is and they are self-describing.

Models

Model NameYearShorthandIMs CalculatedTechtonicType
CampbellBorzorgina2014CB_14PGV, PGA, pSAACTIVE_SHALLOW
CampbellBorzorgina2012CB_12AIACTIVE_SHALLOW
CampbellBorzorgina2010CB_10CAVACTIVE_SHALLOW
Bradley

2010

BR_10PGA, PGV, pSAACTIVE_SHALLOW, VOLCANIC
AfshariStewart2016AS_16Ds575, Ds595, Ds2080ACTIVE_SHALLOW
Zhao2006ZA_06pSA (interpolated above 5.0s), PGAACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB
AbrahamsonSilvaKamai2014ASK_14PGV, PGA, pSAACTIVE_SHALLOW
BC_Hydro2016BCH_16PGA, pSASUBDUCTION_INTERFACE, SUBDUCTION_SLAB
BooreStewartSeyhanAtkinson2014BSSA_14PGV, PGA, pSAACTIVE_SHALLOW
ChiouYoungs2014CY_14PGV, PGA, pSAACTIVE_SHALLOW
McVerry2006MV_06PGA, PGV, pSA (interpolated above 3.0s)ACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB
Below models are examples from and part of the GEM OpenQuake package
ParkerEtAl2020P_20_SI
P_20_SS		PGV, PGA, pSASUBDUCTION_INTERFACE, SUBDUCTION_SLAB
PhungEtAl2020

PH_20_CR
PH_20_SI
PH_20_SS

PGA, pSAACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB
ChaoEtAl2020CH_20_CR
CH_20_SI
CH_20_SS		PGV, PGA, pSA, PGDACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB
HassaniAtkinson2020HA_20_CR
HA_20_SI
HA_20_SS		PGV, PGA, pSAACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB
Gulerce et al2017G_17pSAACTIVE_SHALLOW (ver)
BorzoginaCampbell2016BC_16PGV, PGA, pSAACTIVE_SHALLOW (ver)
Stewart et al2016S_16PGV, PGA, pSAACTIVE_SHALLOW (ver)
Abrahamson Gluerce et al2020

AG_20_SI

AG_20_SS

PGA, pSASUBDUCTION_INTERFACE, SUBDUCTION_SLAB
Kuehn et al2020

K_20_SI

K_20_SS

PGV, PGA, pSASUBDUCTION_INTERFACE, SUBDUCTION_SLAB
Zhao2016

Z_16_SI

Z_16_SS

PGA, pSASUBDUCTION_INTERFACE, SUBDUCTION_SLAB


Site Parameters Needed

 * Standard operation is to estimate from other parameters

ParameterDescriptionBR_10AS_16CB_12/CB_10CB_14ZA_06ASK_14BCH_16BSSA_14CY_14MV_06P_20_SI
P_20_SS		HA_20_CR
HA_20_SI
HA_20_SS		PhungEtAlChaoEtAl
RrupSource-to-site distance (km) (Rrup distance)✓✓ ✓✓✓✓✓
✓✓✓✓✓✓
Rjb
✓
✓✓
✓
✓✓


✓ (crustal)
Rx

distance measured perpendicular to fault strike from surface projection of updip edge of the fault rupture (+ve in downdip dir) (km)

✓

✓
✓

✓


✓ (crustal)
Ry





✓







hwFlag for sites on the hanging wall✓



✓

✓




Rtvz

source-to-site distance in the Taupo volcanic zone (TVZ) in km

✓







✓



Vs30
✓✓✓✓
✓✓✓✓
✓✓✓✓
Vs30measuredIf the vs30 measurement is taken from a ____ True otherwise False✓



✓

✓



✓
siteclass

determined from vs30

'hardrock';'rock';'hardsoil';'mediumsoil';'softsoil' (also called siteType)

  • %Hardrock 'hardrock'                      1100                   A

  • %SCI          'rock' T=0.2s                600                 A , B

  • %SCII     'hardsoil' 0.2<T<0.4s        300<V30<600               C

  • %SCIII  'mediumsoil' 0.4<T<0.6s        200<V30<300               D

  • %SCIV     'softsoil' T<0.6s              V30<200               E , F

*


*



*



Z1p0Can be estimated from vs30**


*
**


✓✓
Z2p5Can be estimated from vs30*
**






✓

backarcFlag for if the site is on the backarc or forearc. Defaults to false.













fpeak











✓

Fault Parameters Needed

ParameterDescriptionBR_10AS_16CB_12/CB_10CB_14ZA_06ASK_14BC_16BSSA_14CY_14MV_06P_20_SI
P_20_SS		HA_20_CR
HA_20_SI
HA_20_SS		PhungEtAlChaoEtAl
MwMoment magnitude✓✓✓✓✓✓✓✓✓✓✓✓✓✓

rake

rake angle✓
✓✓
✓

✓


✓ (crustal)✓ (crustal)
dipdip angle✓
✓✓
✓

✓


✓ (crustal)
ztor
  • minimum dtop for finite faults from the srfinfo file
  • Or hdepth for point sources
✓
✓

✓





✓✓
zbot
  • maximum dbot for finite faults from the srfinfo
  • Hdepth for point sources



✓ (only needed when width is unknown)









rupture_type

(reverse, normal, strikeslip, oblique, unknown)

This is currently estimated by

Reverse <- 45 < rake < 135;

Normal <- -135 < rake < -45;

StrikeSlip <- 0 < abs(rake) < 45, 135 < abs(rake) < 180,


✓

✓

✓
✓rupture_type in OpenQuake models is always
calculated from rake if required
Different models may have different cutoff points
usually 30 or 45 degrees.
tect_type(active_shallow, volcanic, subduction_interface, subduction_slab)



✓
✓

✓OpenQuake model classes are generally split
by tect_type so will only accept the relevant class
hdepthfocal depth (km) (hypocentral depth)


✓ (None if unknown)✓
✓

✓
✓

widthdown dip rupture width


✓
✓







asflag to indicate aftershock (defaults to False)




✓







Folder Structure

TBD

File Structure

IM_file


  • No labels