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 Name | Year | Shorthand | IMs Calculated | TechtonicType |
---|---|---|---|---|
CampbellBorzorgina | 2014 | CB_14 | PGV, PGA, pSA | ACTIVE_SHALLOW |
CampbellBorzorgina | 2012 | CB_12 | AI | ACTIVE_SHALLOW |
CampbellBorzorgina | 2010 | CB_10 | CAV | ACTIVE_SHALLOW |
Bradley | 2010 | BR_10 | PGA, PGV, pSA | ACTIVE_SHALLOW, VOLCANIC |
AfshariStewart | 2016 | AS_16 | Ds575, Ds595, Ds2080 | ACTIVE_SHALLOW |
Zhao | 2006 | ZA_06 | pSA (interpolated above 5.0s), PGA | ACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
AbrahamsonSilvaKamai | 2014 | ASK_14 | PGV, PGA, pSA | ACTIVE_SHALLOW |
BC_Hydro | 2016 | BCH_16 | PGA, pSA | SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
BooreStewartSeyhanAtkinson | 2014 | BSSA_14 | PGV, PGA, pSA | ACTIVE_SHALLOW |
ChiouYoungs | 2014 | CY_14 | PGV, PGA, pSA | ACTIVE_SHALLOW |
McVerry | 2006 | MV_06 | PGA, PGV, pSA (interpolated above 3.0s) | ACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
Below models are examples from and part of the GEM OpenQuake package | ||||
ParkerEtAl | 2020 | P_20_SI P_20_SS | PGV, PGA, pSA | SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
PhungEtAl | 2020 | PH_20_CR | PGA, pSA | ACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
ChaoEtAl | 2020 | CH_20_CR CH_20_SI CH_20_SS | PGV, PGA, pSA, PGD | ACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
HassaniAtkinson | 2020 | HA_20_CR HA_20_SI HA_20_SS | PGV, PGA, pSA | ACTIVE_SHALLOW, SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
Gulerce et al | 2017 | G_17 | pSA | ACTIVE_SHALLOW (ver) |
BorzoginaCampbell | 2016 | BC_16 | PGV, PGA, pSA | ACTIVE_SHALLOW (ver) |
Stewart et al | 2016 | S_16 | PGV, PGA, pSA | ACTIVE_SHALLOW (ver) |
Abrahamson Gluerce et al | 2020 | AG_20_SI AG_20_SS | PGA, pSA | SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
Kuehn et al | 2020 | K_20_SI K_20_SS | PGV, PGA, pSA | SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
Zhao | 2016 | Z_16_SI Z_16_SS | PGA, pSA | SUBDUCTION_INTERFACE, SUBDUCTION_SLAB |
Site Parameters Needed
* Standard operation is to estimate from other parameters
Parameter | Description | BR_10 | AS_16 | CB_12/CB_10 | CB_14 | ZA_06 | ASK_14 | BCH_16 | BSSA_14 | CY_14 | MV_06 | P_20_SI P_20_SS | HA_20_CR HA_20_SI HA_20_SS | PhungEtAl | ChaoEtAl |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Rrup | Source-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 | ✓ | ||||||||||||||
hw | Flag for sites on the hanging wall | ✓ | ✓ | ✓ | |||||||||||
Rtvz | source-to-site distance in the Taupo volcanic zone (TVZ) in km | ✓ | ✓ | ||||||||||||
Vs30 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
Vs30measured | If the vs30 measurement is taken from a ____ True otherwise False | ✓ | ✓ | ✓ | ✓ | ||||||||||
siteclass | determined from vs30 'hardrock';'rock';'hardsoil';'mediumsoil';'softsoil' (also called siteType)
| * | * | * | |||||||||||
Z1p0 | Can be estimated from vs30 | * | * | * | * | * | ✓ | ✓ | |||||||
Z2p5 | Can be estimated from vs30 | * | * | * | ✓ | ||||||||||
backarc | Flag for if the site is on the backarc or forearc. Defaults to false. | ||||||||||||||
fpeak | ✓ |
Fault Parameters Needed
Parameter | Description | BR_10 | AS_16 | CB_12/CB_10 | CB_14 | ZA_06 | ASK_14 | BC_16 | BSSA_14 | CY_14 | MV_06 | P_20_SI P_20_SS | HA_20_CR HA_20_SI HA_20_SS | PhungEtAl | ChaoEtAl |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Mw | Moment magnitude | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
rake | rake angle | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ (crustal) | ✓ (crustal) | |||||||
dip | dip angle | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ (crustal) | ||||||||
ztor |
| ✓ | ✓ | ✓ | ✓ | ✓ | |||||||||
zbot |
| ✓ (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 | ||||||||||
hdepth | focal depth (km) (hypocentral depth) | ✓ (None if unknown) | ✓ | ✓ | ✓ | ✓ | |||||||||
width | down dip rupture width | ✓ | ✓ | ||||||||||||
as | flag to indicate aftershock (defaults to False) | ✓ |
Folder Structure
TBD
File Structure
IM_file