Skip to content

SCECcode/cybershake-core

The SCEC cybershake-core software repository

License GitHub repo size

Description

CyberShake is a high-performance computational platform developed by the Southern California Earthquake Center (SCEC) to produce seismic hazard models from large suites of earthquake simulations. CyberShake is an integrated collection of scientific software and middleware that performs 3D physics-based probabilistic seismic hazard analysis (PSHA). The CyberShake platform populates a mesh with velocity information for a region of interest, which serves as input to AWP-ODC-SGT, which generates Strain Green Tensors (SGTs). A catalog of earthquakes is produced by extending a selected earthquake rupture forecast (ERF) by varying the hypocenter location and slip distribution, or using an eERF generated by an earthquake simulator. Seismic reciprocity is used to calculate synthetic seismograms for approximately 500,000 events per site. From these seismograms intensity measures (IMs), such as peak spectral acceleration and RotD100, are calculated, as well as duration metrics. IMs are combined with probabilities from the ERF into a PSHA curve for the site of interest. Hazard curves from hundreds of sites are combined into a hazard map for a region. CyberShake produces a rich suite of layered data that includes PSHA hazard maps, site-specific PSHA hazard curves, large sets of peak amplitude measurements, rupture descriptions, and synthetic seismograms.

Table of Contents

  1. Software Documentation
  2. Installation
  3. Support
  4. Datasets
  5. Citation
  6. Contributing
  7. Credits
  8. License

Installation

CyberShake was developed to support ground simulations run on Linux servers and high-performance computing systems, so it is designed to compile and run on Linux-based computers. The software included in this repository including the scientific codes used in the CyberShake physics-based PSHA. These can be compiled using recent GNU C, C++, and FORTRAN compilers. Installation of the complete CyberShake workflow system requires software tools in an associated SCEC CyberShake software tools respository and an HPC software stack including MPI, HPC-Condor, and Pegasus-WMS. Please see the detailed CyberShake software installatations instruction for information about installing the complete CyberShake workflow system.

Datasets

CyberShake results produced using these cybershake-core programs are available for several large PSHA hazard model datasets. Links to these existing CyberShake datasets are available here:

A table-based comparison of CyberShake studies in posted on a SCEC wiki at:

Individual CyberShake Studies are documented on a SCEC wiki at:

Documentation on how to retrieve specific CyberShake data products are documented on a SCEC wiki: https://strike.scec.org/scecpedia/CyberShake_Data

Support

Support for CyberShake is provided by that Southern California Earthquake Center (SCEC) Research Computing Group. This group supports several research software distributions including CyberShake. Users can report issues and feature requests using CyberShake's github-based issue tracking link below. Developers will also respond to emails sent to the SCEC software contact listed below.

  1. CyberShake Github Issue Tracker
  2. Email Contact: [email protected]

Citation

References, citations, and acknowledgements help us obtain continued support for the development of the CyberShake software. If you use the CyberShake software in your research, please include a citation of the CyberShake paper in the references/bibliography section of your publication. This is more effective than you providing in-text acknowledgements.

  • Body Text: The research described in this article used CyberShake v21.12 software (Graves, 2010) published under the BSD-3 license.

  • Acknowledgement: We would like to acknowledge use of the CyberShake software provided by the Southern California Earthquake Center (http://scec.org) which is funded by NSF Cooperative Agreement EAR-1600087 and USGS Cooperative Agreement G17AC00047.

  • Cite Code As: Graves, R., Jordan, T.H., Callaghan, S. et al. CyberShake: A Physics-Based Seismic Hazard Model for Southern California. Pure Appl. Geophys. 168, 367–381 (2010). https://doi.org/10.1007/s00024-010-0161-6 SCEC Contribution 1354

  • Primary Reference: Graves, R., Jordan, T.H., Callaghan, S. et al. CyberShake: A Physics-Based Seismic Hazard Model for Southern California. Pure Appl. Geophys. 168, 367–381 (2010). https://doi.org/10.1007/s00024-010-0161-6 SCEC Contribution 1354

Contributing

We welcome contributions to the CyberShake software framework. Geoscientists and software developers can improve and extend the CyberShake software. An overview of the process for contributing seismic models or software updates to the CyberShake Project is provided in the CyberShake contribution guidelines. CyberShake contributors agree to abide by the code of conduct found in our Code of Conduct guidelines.

Credits

Development of CyberShake is a group effort. A list of developers that have contributed to the CyberShake Software framework are listed in the Credits.md file in this repository.

License

The CyberShake software is distributed under the BSD 3-Clause open-source license. Please see the LICENSE.txt file for more information.