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) – The processed results dictionary returned by do_cloud_analysis.

  • data (This method plots cloud)

  • thresholds (damage)

  • line (a fitted regression)

:param : :param and upper and lower censoring limits. The data is presented in logarithmic: :param scale for both axes.: :param Parameters: :param ———-: :param cloud_dict: A dictionary containing the data for the cloud analysis. The dictionary

should have the following keys (direct output from do_cloud_analysis method)

Parameters:

  • 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, default=None) – A custom title for the figure. If not provided, a default title incorporating the Intensity Measure (IM) label is used.

  • pFlag (bool, optional, default=True) – If True, the plot is processed (saved/shown).

  • export_path (str, optional) – Full path including filename to save the plot. Creates directories if missing.

  • Returns

  • --------

  • None – This function saves the plot to a file in the specified output directory.