commkit 3.6.0__tar.gz → 3.6.1__tar.gz

{commkit-3.6.0 → commkit-3.6.1}/CHANGELOG.md

@@ -4,6 +4,12 @@ Notable changes to CommKit, newest first. Performance figures are from the refer
 
 ## [Unreleased]
 
+## [3.6.1] - 2026-11-05
+
+### Added
+
+- `plot_frequency_noise_psd` shades the white-FM plateau: the fit bins where the fitted model stays within 10 % of the floor `Δν/π`, where white FM dominates and pins the linewidth down. It is a visual check only; `Δν` still comes from the model fitted over every bin in `used`, not from an average over the plateau.
+
 ## [3.6.0] - 2026-11-05
 
 Chromatic dispersion for real captures. The compensation takes the link's accumulated dispersion and works as a receiver does, an FIR filter (or overlap-save blocks for backpropagation) in bounded memory, with the exact whole-record path as an option that is valid on captures too; three estimators measure an unknown dispersion, blind or from known symbols. The laser-characterization chain and its notebooks were corrected wherever a plot or a number did not mean what it said, method names that were generic now say what they do, and plot axes carry their SI prefix in the label.
@@ -461,7 +467,8 @@ See the [GitHub release](https://github.com/lokgar/commkit/releases/tag/v1.1.0)
 
 First release. See the [GitHub release](https://github.com/lokgar/commkit/releases/tag/v1.0.0).
 
-[Unreleased]: https://github.com/lokgar/commkit/compare/v3.6.0...HEAD
+[Unreleased]: https://github.com/lokgar/commkit/compare/v3.6.1...HEAD
+[3.6.1]: https://github.com/lokgar/commkit/compare/v3.6.0...v3.6.1
 [3.6.0]: https://github.com/lokgar/commkit/compare/v3.5.0...v3.6.0
 [3.5.0]: https://github.com/lokgar/commkit/compare/v3.4.0...v3.5.0
 [3.4.0]: https://github.com/lokgar/commkit/compare/v3.3.0...v3.4.0

{commkit-3.6.0 → commkit-3.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: commkit
-Version: 3.6.0
+Version: 3.6.1
 Summary: A Python library for high-performance digital communications research.
 Project-URL: Homepage, https://github.com/lokgar/commkit
 Project-URL: Repository, https://github.com/lokgar/commkit

{commkit-3.6.0 → commkit-3.6.1}/commkit/__init__.py

@@ -31,7 +31,7 @@ Matplotlib, change warning filters, or touch the GPU.
 import importlib
 from typing import Any
 
-__version__ = "3.6.0"
+__version__ = "3.6.1"
 
 from .backend import PrecisionWarning
 from .core import (

{commkit-3.6.0 → commkit-3.6.1}/commkit/plotting/analysis.py

@@ -251,7 +251,11 @@ def plot_frequency_noise_psd(
       masks (400 bins or fewer) are drawn as markers on the PSD, dense ones
       as a highlighted log-binned median curve.
     * ``fm_psd_model``: the fitted model of white FM, flicker FM and
-      detection noise, drawn over the PSD.
+      detection noise, drawn over the PSD.  The white-FM plateau, the fit
+      bins where the model stays within 10 % of ``Δν/π``, is shaded.  It
+      shows where the floor is pinned down; ``Δν`` itself comes from the
+      model fitted over all of ``used``, not from an average over the
+      plateau.
 
     Dense spectra are drawn faint with a log-binned median trace on top, and
     the model through the same reduction (a model divided by the response
@@ -346,6 +350,7 @@ def plot_frequency_noise_psd(
             )
 
         model = getattr(estimate, "fm_psd_model", None)
+        m_i = None
         if model is not None:
             m_c = _as_channels(model)
             m_i = m_c[0, pos]
@@ -385,6 +390,24 @@ def plot_frequency_noise_psd(
                 ls=":",
                 label=r"White-FM floor  $\Delta\nu/\pi$",
             )
+            if m_i is not None:
+                # Δν is the white term of a model fitted over the whole fit
+                # region, not a plateau average.  Shade where the model stays
+                # within 10 % of that term (flicker and the angle-noise tail
+                # negligible): the plateau that pins the floor down.
+                white = float(floors[0]) / np.pi
+                dom = np.isfinite(m_i) & (m_i <= 1.1 * white)
+                if used is not None:
+                    dom &= u_c[pos]
+                if dom.any():
+                    axi.axvspan(
+                        float(fp[dom].min()),
+                        float(fp[dom].max()),
+                        color="#ffd166",
+                        alpha=0.18,
+                        lw=0,
+                        label="Plateau (model within 10 % of floor)",
+                    )
 
         if band is not None:
             lo = max(float(band[0]), float(fp[0])) if fp.size else float(band[0])

{commkit-3.6.0 → commkit-3.6.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "commkit"
-version = "3.6.0"
+version = "3.6.1"
 description = "A Python library for high-performance digital communications research."
 readme = "README.md"
 authors = [{ name = "Denis Fatkhiev" }]
@@ -88,7 +88,7 @@ markers = [
 ]
 
 [tool.bumpversion]
-current_version = "3.6.0"
+current_version = "3.6.1"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

{commkit-3.6.0 → commkit-3.6.1}/tests/plotting/test_plot_analysis.py

@@ -19,6 +19,7 @@ from commkit.analysis import (
     IncrementSlope,
     IncrementSubtract,
 )
+from commkit.backend import to_device
 from commkit.plotting.analysis import (
     plot_allan_deviation,
     plot_carrier_phase_characterization,
@@ -113,6 +114,16 @@ class TestPlotAnalysis:
         fig, ax = plot_frequency_noise_psd(est, title="DSH")
         floor = [ln for ln in ax.lines if "White-FM" in ln.get_label()][0]
         assert floor.get_ydata()[0] == pytest.approx(est.value / np.pi)
+        # The plateau span covers fit bins where the model is within 10 %
+        # of the floor, and none where it is not.
+        span = [p for p in ax.patches if "Plateau" in p.get_label()][0]
+        x0, x1 = span.get_x(), span.get_x() + span.get_width()
+        f = np.asarray(to_device(est.frequencies, "cpu"))
+        model = np.asarray(to_device(est.fm_psd_model, "cpu"))
+        used = np.asarray(to_device(est.used, "cpu"))
+        flat = used & (f > 0) & (model <= 1.1 * est.value / np.pi)
+        assert x0 == pytest.approx(f[flat].min())
+        assert x1 == pytest.approx(f[flat].max())
 
     @pytest.mark.parametrize("dsh", [False, True])
     def test_increment_variance(self, xp: Any, dsh: bool) -> None:

{commkit-3.6.0 → commkit-3.6.1}/uv.lock

@@ -418,7 +418,7 @@ wheels = [
 
 [[package]]
 name = "commkit"
-version = "3.6.0"
+version = "3.6.1"
 source = { editable = "." }
 dependencies = [
     { name = "matplotlib" },