- Replace bare metadata["sample_rate"] access with .get() + clear
ValueError in threshold_qualifier, energy_detector, cusum_annotator,
parallel_signal_separator, and signal_isolation
- Add --sample-rate option to energy, threshold, cusum, and separate
CLI commands with a pre-flight error if sample rate is still absent
- Normalize namespaced metadata keys (e.g. BlockGenerator:Foo:sample_rate)
to standard keys on legacy .npy load
- Cap threshold_qualifier smoothing window at 1% of signal length to
prevent over-smoothing short recordings into a flat envelope
- Warn when threshold or energy detector returns 0 annotations due to
constant-envelope signal; point to cusum as the right tool
- Enforce --overwrite before any work begins; error fires before load
and detection, not after
- Fix qualify_slice off-by-one that silently dropped the last slice
- Surface split failures in parallel_signal_separator via warnings.warn
instead of swallowing them silently
- Add threshold annotation example image to getting_started docs
The OSS threshold_qualifier was last synced from utils on Feb 23 2026,
before the major robustness improvements landed in utils on Mar 19 2026.
This commit brings it fully up to date.
Changes ported from utils:
- Multi-pass detection (Pass 1 strong burst, Pass 2 weak residual,
Pass 3 sustained faint burst via macro-window averaging)
- Noise floor estimation via percentile instead of simple max*threshold
- Dynamic range ratio guard (early exit on low-contrast captures)
- Improved _find_ranges, _expand_and_filter_ranges, _merge_ranges helpers
- Spectral smoothing in _estimate_spectral_bounds for wideband bursts
- Minimum duration filter expressed in absolute time (5ms) not sample count
Also includes the Pass 2 hysteresis spillover fix:
- Pass 2 expansion now runs against residual_power (masked) instead of
smoothed_power, preventing it from walking into Pass 1 territory
- Pass 2 mask now has a window_size guard band around Pass 1 ranges,
matching the guard already used in Pass 3
Only change from utils: import swapped to ria_toolkit_oss.datatypes.