environmentaltools.graphics.annual_maxima_analysis

environmentaltools.graphics.annual_maxima_analysis(boot, orig, ci, tr, peaks, npeaks, eventanu, func, flabel='H$_{m0}$ (m)', tr_plot=100)

Plot annual maxima extreme value analysis with bootstrap results.

Generates a comprehensive visualization including parameter distributions, return period estimates with confidence intervals, and goodness-of-fit assessment for extreme value distributions.

Parameters:

• boot (tuple) – Bootstrap results tuple (boot_params, boot_alternative). boot_params: Array of bootstrap parameter estimates (n_boot x n_params). boot_alternative: Optional alternative distribution bootstrap results.

• orig (tuple) – Original fitted parameters (orig_params, orig_alternative).

• ci (tuple) – Confidence intervals (ci_params, ci_alternative). Format: [lower_bounds, upper_bounds].

• tr (array-like) – Return periods for evaluation.

• peaks (array-like) – Peak values extracted from the time series.

• npeaks (array-like) – Empirical frequencies for plotting positions.

• eventanu (array-like) – Annual event values.

• func (str) – Distribution function name (‘genpareto’, ‘genextreme’, etc.).

• flabel (str, optional) – Label for the variable with LaTeX formatting. Defaults to r”H$_{m0}$ (m)”.

• tr_plot (int, optional) – Specific return period to highlight in histogram. Defaults to 100 years.

Returns:

Displays the plot.

Return type:

None

Note

The function displays parameter stability through histograms and evaluates model fit using return period curves with confidence bands.