# Disaggregation calculator

The Disaggregation Calculator allows calculating contributions (in terms of probabilities) to a specific level of seismic hazard (represented by a ground motion value corresponding to a probability of exceedence in given time span), in terms of:

- latitude and longitude of the surface projection of the closest point of

the rupture area

- magnitude

- epsilon

- tectonic region type (active shallow crust, stable tectonic, subduction

interface, subduction intraslab, volcanic)

The implementation of the disaggregation calculator requires the definition of a new CALCULATION_MODE = DISAGGREGATION

Given a region or a set of site where to compute disaggregation results, the following new parameters must be defined:

LATITUDE_BIN_LIMITS = list of latitude values representing bin limits used for disaggregation, values must be in increasing order

LONGITUDE_

MAGNITUDE_

EPSILON_BIN_LIMITS = list of epsilon values representing bin limits for disaggregation, values must be in increasing order

DISTANCE_BIN_LIMITS = list of distance values representing bin limits for disaggregation, values must be in increasing order

POES_TO_

The input for the disaggregation calculator is represented by a source model logic tree and a gmpe logic tree (represented by the keys SOURCE_

The parameters needed to compute the earthquake rupture forecast from a source model and to set the GMPE parameters must be also defined:

MINIMUM_MAGNITUDE

INVESTIGATION_TIME

MAXIMUM_DISTANCE

WIDTH_OF_MFD_BIN

COMPONENT

INTENSITY_

PERIOD

DAMPING

INTENSITY_

GMPE_TRUNCATION

TRUNCATION_LEVEL

STANDARD_

REFERENCE_

REFERENCE_

SADIGH_SITE_TYPE

INCLUDE_

TREAT_AREA_

AREA_SOURCE_

AREA_SOURCE_

INCLUDE_

TREAT_GRID_

GRID_SOURCE_

INCLUDE_

FAULT_RUPTURE_

FAULT_SURFACE_

FAULT_MAGNITUDE

FAULT_MAGNITUDE

RUPTURE_

RUPTURE_

INCLUDE_

SUBDUCTION_

SUBDUCTION_

SUBDUCTION_

SUBDUCTION_

SUBDUCTION_

SUBDUCTION_

A prototype of the disaggregation calculator has been implemented and can be found here: https:/

A test class checking the scientific validity of the calculator is here:

https:/

For a given a site of interest, the disaggregation calculator computes probability mass functions (PMF) for:

- magnitude

- distance

- tectonic region type

- magnitude- tectonic region type

- latitute-longitude

- latitude-

- latitude-

- latitude-

- latitude-

The above listed results must be calculated and saved for each site of interest and for each logic tree sample. The option to save the full disaggregation matrix must be also given.

Aggregated results must be also produced. From the set of results produced by the logic tree sampling, the mean disaggregation results must be computed and also the disaggregation results associated to quantile levels of the ground motion values.

## Blueprint information

- Status:
- Started

- Approver:
- John Tarter

- Priority:
- Medium

- Drafter:
- None

- Direction:
- Approved

- Assignee:
- Lars Butler

- Definition:
- Approved

- Series goal:
- None

- Implementation:
- Deployment

- Milestone target:
- 0.4.5

- Started by
- John Tarter

- Completed by

### Related branches

### Related bugs

### Sprints

### Whiteboard

The 1st 50% of the Disaggregation Calculator was done in 0.4.4. Balance of work planned for 0.4.5