9.5. MCA Results

plotter.plot_mca_analysis(cloud_dict, imt_label, edp_label, title=None, pFlag=True, export_path=None)[source]

Visualizes the Modified Cloud Analysis (MCA) regression including bootstrapping. This plot accounts for collapse cases using logistic regression, showing the ‘softening’ effect on the median and percentile structural response.

The figure uses self.figsize with constrained_layout and is saved without bbox_inches='tight' so that every output image has identical, deterministic pixel dimensions.

Parameters:

  • cloud_dict (dict) – Output of process_mca_results. Plots cloud data, damage thresholds, a fitted regression line, and upper/lower censoring limits in log-log space.

  • imt_label (str) – Intensity Measure label for the Y-axis (e.g., 'PGA [g]').

  • edp_label (str) – Engineering Demand Parameter label for the X-axis (e.g., 'PSD [-]').

  • title (str, optional) – Custom title for the figure. If not provided the title is omitted.

  • pFlag (bool, optional) – If True the plot is displayed or saved. Default is True.

  • export_path (str, optional) – Full path including filename to save the plot. Directories are created if missing.

Return type:

None

Example

from openquake.vmtk.plotter import plotter

pl = plotter()
# cloud_dict from postprocessor.process_mca_results()
pl.plot_mca_analysis(
    cloud_dict=cloud_dict,
    imt_label="Sa(T1) [g]",
    edp_label="Peak Storey Drift [-]",
    export_path="mca_analysis.png",
)