Release GSUA-CSB v1.7 · drojasd/GSUA-CSB

Highlights

Multiple global minima detection: gsua_ia and gsua_dia gained optional spectral-clustering
support (cluster, maxK, silThreshold) to detect and characterize distinct basins of attraction
among repeated parameter estimations, instead of assuming a single global minimum. Returns a
clusterInfo struct with per-cluster candidate parameter sets, sizes, and mean silhouette score.
New gsua_covmetric: reduces gsua_ua/gsua_pardeval Monte-Carlo output to a P5/P50/P95
percentile band and scores it with two costs on the same margin-normalized scale as gsua_costf
(below 1 = within tolerance): cost_data (band median vs. real data — accuracy) and cost_band
(P95 vs. P5 — precision/tightness), independent of each other. Gives semi-automated identification
workflows a principled stopping signal instead of ad hoc envelope checks.
Full source tree published for the first time. Previous releases shipped only the packaged
.mltbx; the GitHub repo now also carries Functions/, Examples/, Add Funcs/, progressbar/,
and doc/ for real code review and issue tracking.
Complete function documentation. All 32 public functions now have full help text (H1 line,
description, inputs/outputs, See Also); 17 previously had none.

gsua_ia.m no longer dumps the nominal parameter vector to the console on every call (missing
semicolon).
Renamed dead-code ref.m → gsua_ref.m (namespaced, was an unused generic-name collision risk);
dropped the bundled suptitle.m in favor of MATLAB's built-in sgtitle.

Restored the toolbox packaging config (GSUA-UCI.prj), which had been overwritten with an empty
project file at some point — recovered from a .bak.
Corrected declared product dependencies via static analysis: adds Control System Toolbox, Image
Processing Toolbox (corr2, used by gsua_costf/gsua_covmetric), Global Optimization Toolbox
(ga/particleswarm/patternsearch/surrogateopt/simulannealbnd in gsua_pe), and Simulink
Design Optimization (sdo.scatterPlot in gsua_plot) — all previously undeclared.
Fixed the package exclude list: dev-only files (.gitignore, README.md, deploymentLog.html),
MATLAB Drive sync markers, the GitHub Pages docs/ HTML mirror, a duplicate images folder, and a
stray run-artifact .mat file no longer ship inside the .mltbx.
Added Functions/resources/functionSignatures.json (validated) for tab-completion support.

Install GSUA-CSB.mltbx from this release by double-clicking it in MATLAB, or:
```matlab
matlab.addons.install("GSUA-CSB.mltbx")
```