Model Building Toolkit (mbt) module

The Model Building Toolkit module contains code for building a PSHA earthquake occurrence model. The main goals of this tools are to:

Streamline the process of building a PSHA earthquake occurrence model
Ensure that the process adopted to build the model is reproducible and extendable.

Here you can find information on the available functions including their inputs and outputs. The tools in the mbt cover many important aspects of model construction. Some other functions are instead included in the wkf For an example of how they might be used in a workflow, see the SSC workflow module.

Available mbt and wkf functions

The mbt functions exist as part of the original version of the mbtk, when it was smaller and relied solely on a sequence of jupyter notebooks. Many functions that were here have been improved and/or moved to other locations. The wkf functions add further tools for building hazard models in the SSC workflow.

Catalogue tools

Tectonic regionalisation tools

These are used in conjunction with the subduction tools for classifying events in subduction regions.

MFD functions

Declustering

Primarily, the declustering is handled in the hmtk module of the OpenQuake engine, but this function in the mbtk is most commonly used by the hazard team (for now).

Distributed seismicity tools

Fault modeling tools

The fault modelling tools are used to create fault sources from fault data (trace, slip rate, dip, etc.) in json format and a dictionary of parameters that define modelling assumptions and how ruptures will be generated from the fault source. The functions use the following defaults:

defaults = {'name': 'unnamed',
            'b_value': 1.,
            'bin_width': 0.1,
            'm_min': 4.0,
            'm_max': None,
            'm_char': None,
            'm_cli': 6.0,
            'm_upper': 10.,
            'slip_class': 'mle',
            'aseismic_coefficient': 0.,
            'upper_seismogenic_depth': 0.,
            'lower_seismogenic_depth': 35.,
            'rupture_mesh_spacing': 2.,
            'rupture_aspect_ratio': 2.,
            'minimum_fault_length': 5.,
            'tectonic_region_type': 'Active Shallow Crust',
            'temporal_occurrence_model': hz.tom.PoissonTOM(1.0),
            'magnitude_scaling_relation': 'Leonard2014_Interplate',
            'width_scaling_relation': 'Leonard2014_Interplate',
            'subsurface_length': False,
            'rigidity': 32e9,
            'mfd_type': 'DoubleTruncatedGR'
         }

Other useful functions

These are mostly used within the model-building workflow