9.6. IDA Results

plotter.plot_ida_analysis(ida_dict, imt_label, edp_label, xlims, ylims, title=None, pFlag=True, export_path=None)[source]

Visualizes the Incremental Dynamic Analysis (IDA) suite and statistical summary.

This method generates a comprehensive IDA plot featuring individual ground motion record curves as a background “cloud” and overlays the statistical response percentiles. It is designed to provide an immediate visual assessment of structural performance across a range of intensities.

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:

  • ida_dict (dict) – The processed results dictionary returned by do_incremental_dynamic_analysis. Must contain the following nested keys: - [‘ida_inputs’][‘raw_curves’]: List of (IM, EDP) pairs for each record. - [‘ida_inputs’][‘damage_thresholds’]: EDP values for limit states. - [‘stats’]: Dictionary containing ‘fitted_edps’, ‘median_im’, ‘p16_im’, and ‘p84_im’. - [‘ida_inputs’][‘imt_key’]: The label of the intensity measure used.

  • 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 [-]’).

  • xlims (tuple of float) – (min, max) limits for the X-axis (EDP axis).

  • ylims (tuple of float) – (min, max) limits for the Y-axis (IML axis).

  • 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:

Displays the matplotlib figure.

Return type:

None