Welcome to the OpenQuake Model Building Toolkit’s documentation!

The OpenQuake Model Building Toolkit (oq-mbt) is a suite of tools for the construction of components of a Probabilistic Seismic Hazard (PSH) model. The main contributors to this suite of tools are GEM Hazard Team members. Contribution from extena users are very welcome!

oq-mbt code is hosted on github at the following link https://github.com/GEMScienceTools/oq-mbtk. It is developed in close connection with the OpenQuake engine, the open-source hazard and risk calculation engine developed primarily by the GEM Foundation.

The oq-mbt relies on several functionalities included in the Hazard Modeller’s Toolkit library (oq-hmtk). The oq-hmtk code is accessible on github at the following link https://github.com/gem/oq-engine/tree/master/openquake/hmtk, while documentation for the oq-hmtk can be downloaded at https://github.com/GEMScienceTools/hmtk_docs/blob/master/hmtk_tutorial.pdf.

Currently the oq-mbt includes eight sub-modules:

• CATalogue Toolkit (cat) contains code used for creating a homogenised catalogue;

• Global Hazard Map (ghm) contains code used to produce homogenised hazard maps using results obtained using a collection of PSHA input models;

• Model ANalysis (man) contains code for analysing oq-engine formattted PSHA input models;

• Model Building tool (mbt) contains code for seismic source characterisation;

• SUBduction modelling (sub) contains code for building subduction earthquake sources;

• Strong-Motion Tools (smt) contains code for ground-motion characterisation activities;

• SEcondary Perils (sep) contains code for calculating secondary earthquake perils such as liquefaction and coseismic landslides

• SSC WorKFlow (wkf) contains functions for building automated workflows for building seismic source characterisation

Contents:

• Installation
• CAtalogue Toolkit (cat) module
  • Setting up a bash script
  • Merging
  • Homogenisation
  • Checking for duplicate events
• Global Hazard Map (ghm) module
  • Creating a grid of sites for one of the models
• Model ANalysis (man) module
  • The structure of a PSHA input model for the OpenQuake engine
• Model Building Toolkit (mbt) module
  • Input Datasets and their Format
• SUBduction (sub) module
  • Defining the geometry of the top of the slab
  • Building the top of the slab geometry
  • Classifying an earthquake catalog using the top of the slab surface [incomplete]
  • Creating inslab sources for the OpenQuake Engine [incomplete]
• Strong-Motion Tools (smt) module
  • Performing a Residual Analysis
  • Parsing a Ground-Motion Flatfile into Metadata
  • Computing the Ground-Motion Residuals
  • Plotting of Residuals
  • Single Station Residual Analysis
  • GMPE Performance Ranking Metrics
  • Comparing GMPEs
• Secondary Perils Analysis using the OQ-MBTK
  • Liquefaction and Landslide models
  • Site characterization for probabilistic liquefaction analysis
  • Tutorials for using the OQ-MBTK for analysis of secondary perils
• SSC workflow (wkf) module
  • Some notes on setup
  • Workflow inputs
  • Model set-up
  • Create sub-catalogues per zone
  • Calculate and apply completeness
  • Calculate and set Gutenberg-Richter parameters
  • Estimate and set maximum magnitudes
  • Analyse and set hypocentral depth
  • Model focal mechanism distribution
  • Discretise model to h3 zones
  • Boxcounting (for smoothing)
  • Apply smoothing
  • Distribute rates in sources
  • Write to xml

Indices and tables

• Index

• Module Index

• Search Page