Skip to content

Commit d9cd6a4

Browse files
author
TNFR AI Agent
committed
Correct the misleading deprecation note in utils/numeric.py
The blanket 'DEPRECATED: use unified_numerical instead' header was inaccurate: angle_diff and angle_diff_array are DEFINED in utils/numeric.py (not in unified_numerical) and are the canonical public phase-difference API, re-exported via tnfr.utils. Only the scalar wrappers (clamp, clamp01, ...) delegate to unified_numerical. Clarify the header so it no longer points developers to the wrong module for angle_diff. Docstring only; angle_diff resolves to the same object via tnfr.utils and tnfr.utils.numeric, delta-NFR tests pass.
1 parent ec489dd commit d9cd6a4

1 file changed

Lines changed: 6 additions & 1 deletion

File tree

src/tnfr/utils/numeric.py

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
11
"""Numeric helper functions and compensated summation utilities.
22
3-
DEPRECATED: Use src/tnfr/mathematics/unified_numerical.py instead.
3+
The scalar wrappers here (``clamp``, ``clamp01``, ``within_range``,
4+
``kahan_sum_nd``, …) are thin compatibility shims that delegate to the canonical
5+
:mod:`tnfr.mathematics.unified_numerical`. The phase-difference helpers
6+
``angle_diff`` and ``angle_diff_array`` are **defined here** (they are not part
7+
of ``unified_numerical``) and are re-exported as the canonical public API via
8+
:mod:`tnfr.utils` — prefer ``from tnfr.utils import angle_diff``.
49
"""
510

611
from __future__ import annotations

0 commit comments

Comments
 (0)