Reject complex observation ensemble controls

[FlorianPfaff]

Summary

• reject complex-valued observation-ensemble weights, source temperatures, probability tolerances, and baseline-window endpoints at the public API boundary;
• cover native NumPy complex scalars and object-array containers;
• preserve existing real-valued controls and source-baseline-debiasing normalization;
• add focused regression coverage for every affected control.

Root cause

The observation-ensemble implementation converted several programmatic controls with np.asarray(..., dtype=float) or float(...). NumPy complex scalars are accepted by those conversions with a warning while their imaginary component is discarded. A configuration such as source_temperatures=(np.complex128(1 + 2j), 1.0) therefore ran as (1.0, 1.0) and recorded only the narrowed real values.

The same silent narrowing affected ensemble weights, probability-row tolerance, and baseline-window endpoints. This could execute a scientifically different configuration without a deterministic input error.

Impact

Malformed complex controls now fail before probability alignment or baseline computation. Ordinary Python/NumPy real scalars, arrays, tuples, and existing Boolean normalization retain their behavior.

Validation

• independently reproduced NumPy's complex-to-real narrowing for the affected conversions;
• syntax-checked the modified runtime patch and new regression module;
• exercised the validation wrapper in an isolated harness for all four controls plus valid real-valued controls;
• branch comparison: 2 files changed, 128 additions / 2 deletions, 2 commits ahead and 0 behind main;
• full repository validation is delegated to GitHub Actions because the execution environment has no GitHub CLI and cannot clone github.com through DNS.

[github-actions]

✅MegaLinter analysis: Success

Descriptor	Linter	Files	Fixed	Errors	Warnings	Elapsed time
✅ ACTION	actionlint	29		0	0	1.59s
✅ COPYPASTE	jscpd	yes		no	no	4.14s
✅ MARKDOWN	markdownlint	141	0	0	0	3.34s
✅ PYTHON	ruff	1559	0	0	0	0.87s
✅ REPOSITORY	git_diff	yes		no	no	0.25s
✅ YAML	prettier	70	0	0	0	3.06s
✅ YAML	v8r	70		0	0	11.03s
✅ YAML	yamllint	70		0	0	1.82s

Notices

📣 MegaLinter 9.5.0 is out! Discover the new features and security recommendations in the release announcement. (Skip this info by defining SECURITY_SUGGESTIONS: false)

See detailed reports in MegaLinter artifacts

Show us your support by starring ⭐ the repository

[github-actions]

Test Results

     4 files  ± 0       4 suites  ±0   5m 11s ⏱️ +28s
 6 870 tests + 5   6 832 ✅ +20   38 💤 ±0  0 ❌  - 15 
27 488 runs  +20  27 336 ✅ +80  152 💤 ±0  0 ❌  - 60 

Results for commit 5c910e2. ± Comparison against base commit 67e9a68.

♻️ This comment has been updated with latest results.