ShakemapSim: Simulate spatially correlated ground-motion intensity measures conditional on recordings
Example for the 2023 earthquake at the border of Turkey and Syria
ShakemapSim is a user-friendly tool to generate spatially correlated fields of ground-motion intensity measures (IMs) conditional on available recordings from a seismic network. This is particularly useful for validation and development of models for damage, loss and recovery predictions using data gathered after an event.
If you use this tool in your work please please cite it as:
Bodenmann, Lukas, and Stojadinović, Božidar. (2023). ShakemapSim: Simulate spatially correlated ground-motion intensity measures conditional on recordings (v1.2). Zenodo. https://doi.org/10.5281/zenodo.7646888
Quick start Open the notebook ShakemapSim_Example.ipynb on a hosted Jupyter notebook service (e.g., Google Colab). It does not require any local python setup and you can immediately start to customize the models and perform the computations yourself. It explains how to:
- import earthquake rupture information and recorded ground-motion IMs,
- specify (and customize) which ground-motion models and spatial correlation models are used to compute the shakemap,
- specify sites at which we would like to predict ground-motion IMs,
- use ShakemapSim to predict and sample ground-motion IMs.
The tool uses the openquake engine for geo-computations and implementations of ground-motion models. In the provided example we import rupture information and station data (including recorded IMs) from the USGS shakemap system.
The tool was developed by the research group of Prof. Bozidar Stojadinovic at the Department of Civil, Environmental and Geomatic Engineering at ETH Zürich.
Local installation
The required dependencies for a local setup are listed in the environment.yml file. We recommend to first create a new virtual (mini-)conda environment.
Limitation
The current implementation only considers spatial correlation and no spatial cross-correlation. Therefore, it can only be used to simulate and predict the same intensity measure (e.g., PGA) at multiple sites.
Important Note that the provided example data sets are only for illustrative purposes. Users should definitely check for updated rupture and station data from this event. The provided vs30 values were retrieved from USGS, and are based on geographic slope. Users should carefully assess whether these estimates are representative for that region.
New in version 1.2
Added second algorithm to compute shakemaps (EnglerEtAl2022) and updated rupture and fault data from USGS shakemap (v13). See the changelog for further information.
Structure
- modules contains the main objects, functions and methods to perform the computation including (relatively) rich documentation.
- data contains some example data sets used to explain the method. When working with these data sets, please take into account the notes from the section above!
- ShakemapSim_Example.ipynb is the main notebook that explains the workflow on the example of the 2023 M7.8 earthquake at the border of Turkey and Syria. As mentioned above, the notebook can be opened in colab.
- theoretical_background.ipynb provides a short mathematical overview on ground-motion models, spatial correlation models and the shakemap algorithm.
- test.ipynb contains a short script that uses simulated data to test the implemented shakemap algorithm.
- utils.py contains several functions to import rupture and station information from USGSs ShakeMap system.
Acknowledgments
We gratefully acknowledge support from the ETH Risk Center ("DynaRisk", Grant Nr. 395 2018-FE-213).
Licence
The code is licensed under the GNU Affero General Public License v3.0 (AGPL 3.0) license. Remember that the workflow is based on OpenQuake, which is also licensed under the AGPL 3.0 license. Feel free to use it based on the terms and conditions listed in the LICENSE file, reference the doi stated above, and reference OpenQuake. I intend this code to be used for NON-COMMERCIAL uses, if you'd like to use it for commercial uses, please contact Lukas Bodenmann via bodenmann (at) ibk.baug.ethz.ch .