OpenQuake-engine Manual 3.18.0

• 1. Introduction
  • 1.1. OpenQuake-engine Background
    • 1.1.1. Overview
    • 1.1.2. Supplementary resources
    • 1.1.3. Launching a calculation
• 2. Hazard
  • 2.1. Introduction to the Hazard Module
    • 2.1.1. Source typologies
      • 2.1.1.1. Source typologies for modelling distributed seismicity
      • 2.1.1.2. Fault sources with floating ruptures
      • 2.1.1.3. Fault sources without floating ruptures
      • 2.1.1.4. Non-Parametric Sources
    • 2.1.2. Magnitude-frequency distributions
    • 2.1.3. Magnitude-scaling relationships
      • 2.1.3.1. Relationships for shallow earthquakes in active tectonic regions
      • 2.1.3.2. Magnitude-scaling relationships for subduction earthquakes
      • 2.1.3.3. Magnitude-scaling relationships stable continental regions
      • 2.1.3.4. Miscellaneous Magnitude-Scaling Relationships
    • 2.1.4. Calculation workflows
      • 2.1.4.1. Classical Probabilistic Seismic Hazard
      • 2.1.4.2. Event-Based Probabilistic Seismic Hazard
      • 2.1.4.3. Scenario based Seismic Hazard Analysis
  • 2.2. Using the Hazard Module
    • 2.2.1. Defining Logic Trees
      • 2.2.1.1. Logic trees as described in the nrml schema
    • 2.2.2. The Seismic Source System
      • 2.2.2.1. The Seismic Source Logic Tree
      • 2.2.2.2. The Seismic Source Model
    • 2.2.3. The Ground Motion System
      • 2.2.3.1. The Ground Motion Logic Tree
    • 2.2.4. Configuration file
      • 2.2.4.1. Classical PSHA
      • 2.2.4.2. Seismic hazard disaggregation
      • 2.2.4.3. Event based PSHA
      • 2.2.4.4. Scenario hazard
  • 2.3. Hazard Calculations and Results
    • 2.3.1. Running OpenQuake-engine for hazard calculations
    • 2.3.2. Exporting results from a hazard calculation
    • 2.3.3. Description of hazard outputs
      • 2.3.3.1. Outputs from Classical PSHA
      • 2.3.3.2. Outputs from Hazard Disaggregation
      • 2.3.3.3. Outputs from Event Based PSHA
      • 2.3.3.4. Outputs from Scenario Hazard Analysis
  • 2.4. Demonstrative Examples
    • 2.4.1. Classical PSHA Demos
      • 2.4.1.1. Classical PSHA with different source typologies
      • 2.4.1.2. Classical PSHA with non trivial logic trees
    • 2.4.2. Hazard Disaggregation Demos
    • 2.4.3. Event Based PSHA Demos
• 3. Risk
  • 3.1. Introduction to the Risk Module
    • 3.1.1. Scenario Damage Assessment
    • 3.1.2. Scenario Risk Assessment
    • 3.1.3. Classical Probabilistic Seismic Damage Analysis
    • 3.1.4. Classical Probabilistic Seismic Risk Analysis
    • 3.1.5. Stochastic Event Based Probabilistic Seismic Damage Analysis
    • 3.1.6. Stochastic Event Based Probabilistic Seismic Risk Analysis
    • 3.1.7. Retrofit Benefit-Cost Ratio Analysis
    • 3.1.8. Infrastructure Risk Analysis
      • 3.1.8.1. Rationale
      • 3.1.8.2. Specification of the Input Model
      • 3.1.8.3. Calculation Steps
      • 3.1.8.4. Specification of the Outputs Obtained
      • 3.1.8.5. References
      • 3.1.8.6. Acknowledgements
  • 3.2. Risk Input Models
    • 3.2.1. Exposure Models
    • 3.2.2. Fragility Models
    • 3.2.3. Consequence Models
    • 3.2.4. Vulnerability Models
  • 3.3. Using the Risk Module
    • 3.3.1. Scenario Damage Calculator
    • 3.3.2. Scenario Risk Calculator
    • 3.3.3. Classical Probabilistic Seismic Damage Calculator
    • 3.3.4. Classical Probabilistic Seismic Risk Calculator
    • 3.3.5. Stochastic Event Based Seismic Damage
    • 3.3.6. Stochastic Event Based Seismic Risk Calculator
    • 3.3.7. Retrofit Benefit-Cost Ratio Calculator
    • 3.3.8. Exporting Risk Results
  • 3.4. Risk Results
    • 3.4.1. Scenario Damage Outputs
      • 3.4.1.1. Scenario damage statistics
      • 3.4.1.2. Scenario consequence statistics
    • 3.4.2. Scenario Risk Outputs
      • 3.4.2.1. Scenario loss statistics
      • 3.4.2.2. Scenario losses by event
    • 3.4.3. Probabilistic Damage Outputs
      • 3.4.3.1. Probabilistic damage distribution
    • 3.4.4. Probabilistic Risk Outputs
      • 3.4.4.1. Loss exceedance curves
      • 3.4.4.2. Probabilistic loss maps
      • 3.4.4.3. Stochastic event loss tables
    • 3.4.5. Benefit-Cost Ratio Outputs
      • 3.4.5.1. Retrofitting benefit/cost ratio maps
  • 3.5. Demonstrative Examples
    • 3.5.1. Scenario Damage
    • 3.5.2. Scenario Risk Demos
    • 3.5.3. Classical Probabilistic Seismic Damage Demos
    • 3.5.4. Classical Probabilistic Seismic Risk Demos
    • 3.5.5. Event Based Probabilistic Seismic Damage Demos
    • 3.5.6. Event Based Probabilistic Seismic Risk Demos
    • 3.5.7. Retrofit Benefit-Cost Ratio Demos
  • 3.6. Bibliography
• 4. Secondary Perils Analysis
  • 4.1. Liquefaction and Landslide models
    • 4.1.1. Liquefaction models
      • 4.1.1.1. HAZUS
      • 4.1.1.2. Geospatial models
      • 4.1.1.3. Permanent ground displacements due to liquefaction
    • 4.1.2. Landslide models
    • 4.1.3. Reference
  • 4.2. Tutorials for running secondary perils analysis
• 5. Thanks
  • 5.1. Public Partners
  • 5.2. Private Partners
    • 5.2.1. Governors
    • 5.2.2. Advisors
  • 5.3. Associate Partners
  • 5.4. Project Partners
  • 5.5. Products Distribution Partners
• 6. Glossary
  • 6.1. Area Source
  • 6.2. Asset
  • 6.3. Branch
  • 6.4. Branch Set
  • 6.5. Configuration File
  • 6.6. Consequence Function
  • 6.7. Consequence Model
  • 6.8. Characteristic Fault Source
  • 6.9. Complex Fault Source
  • 6.10. Deductible
  • 6.11. Seismic Hazard Disaggregation
  • 6.12. Dip
  • 6.13. Disaggregation Matrix
  • 6.14. Earthquake Rupture Forecast
  • 6.15. Earthquake Rupture Forecast Calculator
  • 6.16. Epsilon
  • 6.17. Exposure Model
  • 6.18. Fault Trace
  • 6.19. Fragility Function
  • 6.20. Fragility Model
  • 6.21. Frequency-Magnitude Distribution
  • 6.22. Grid Source
  • 6.23. Ground-Motion Field (GMF)
  • 6.24. Ground-Motion Field Calculator
  • 6.25. Ground-Motion Logic Tree
  • 6.26. Ground-Motion Model
  • 6.27. Ground-Motion Parameter
  • 6.28. Ground-Motion Prediction Equation (GMPE)
  • 6.29. Ground-Motion System
  • 6.30. Initial Seismic Source Input Model
  • 6.31. Insured Losses
  • 6.32. Integrated Risk Modelling Toolkit
  • 6.33. Investigation Time
  • 6.34. Limit
  • 6.35. Logic Tree
  • 6.36. Logic Tree Processor
  • 6.37. Magnitude-Scaling Relationship
  • 6.38. Magnitude-Frequency Distribution
  • 6.39. Non-Parametric Source
  • 6.40. Natural Hazards’ Risk Markup Language
  • 6.41. OpenSHA
  • 6.42. Point Source
  • 6.43. PSHA Input Model
  • 6.44. Probabilistic Seismic Hazard Analysis (PSHA)
  • 6.45. Earthquake Rupture
  • 6.46. Rupture Model
  • 6.47. Rupture Aspect Ratio
  • 6.48. Rake
  • 6.49. Scenario Based Seismic Hazard Analysis
  • 6.50. Seismicity History
  • 6.51. Seismicity Rate
  • 6.52. Seismic Source Data
  • 6.53. Seismic Source Logic Tree
  • 6.54. Seismic Source Input Model
  • 6.55. Seismic Source
  • 6.56. Seismic Source Model (SSM)
  • 6.57. Seismic Source System
  • 6.58. Simple Fault Source
  • 6.59. Stochastic Event Set
  • 6.60. Strike
  • 6.61. Tag
  • 6.62. Taxonomy
  • 6.63. Tectonic Region
  • 6.64. Temporal Occurrence Model
  • 6.65. Vulnerability Function
  • 6.66. Vulnerability Model
  • 6.67. VS30

globalquakemodel.org/openquake

Authors

Marco Pagani\(^1\), Vitor Silva\(^1\), Anirudh Rao\(^1\), Michele Simionato\(^1\), Kendra Johnson\(^1\)

Authors on previous versions

Helen Crowley\(^2\), Damiano Monelli\(^3\), Graeme Weatherill\(^4\), Robin Gee\(^5\)

\(^1\) GEM Foundation, via Ferrata 1, 27100 Pavia, Italy	\(^2\) EUCENTRE, via Ferrata 1, 27100 Pavia, Italy	\(^3\) RenRe, Beethovenstrasse 33, CH-8002 Zürich, Switzerland
\(^4\) GFZ, Helmholtzstraße 6/7, 14473 Potsdam, Germany	\(^5\) PartnerRe, Hardstrasse 301, CH-8002 Zürich, Switzerland

Email address for all current authors:

\(<\)firstname.lastname\(>\)@globalquakemodel.org

Citation

Please cite this document as: GEM (2022). The OpenQuake-engine User Manual. Global Earthquake Model (GEM) OpenQuake Manual for Engine version 3.18.0. doi: 10.13117/GEM.OPENQUAKE.MAN.ENGINE. 3.18.0

Disclaimer

The OpenQuake-engine User Manual is distributed in the hope that it will be useful, but without any warranty: without even the implied warranty of merchantability or fitness for a particular purpose. While every precaution has been taken in the preparation of this document, in no event shall the authors of the Manual and the GEM Foundation be liable to any party for direct, indirect, special, incidental, or consequential damages, including lost profits, arising out of the use of information contained in this document or from the use of programs and source code that may accompany it, even if the authors and GEM Foundation have been advised of the possibility of such damage. The Manual provided hereunder is on as “as is” basis, and the authors and GEM Foundation have no obligations to provide maintenance, support, updates, enhancements, or modifications.

License

This Manual is distributed under the Creative Commons License Attribution- NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). You can download this Manual and share it with others as long as you provide proper credit, but you cannot change it in any way or use it commercially.

RST format manual

This manual was adapted from LaTeX to reStructured Text format as part of the TREQ project by Paul Henshaw\(^1\) and Sandra Giacomini \(^1\).

The RST format manual is made possible by the support of the American People through the United States Agency for International Development (USAID.) The contents of this study are the sole responsibility of the GEM Foundation and do not necessarily reflect the views of USAID or the United States Government.

© 2013–2022 GEM Foundation

April 2022