improved logging

python_app/workflows/kamil_adc_neutral_preprocess.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import logging
 import time
 
 import numpy as np
@@ -9,12 +10,19 @@ import numpy as np
 from python_app.models.dataset_model import ComboKey, SweepCollection, TraceData
 from python_app.models.run_config_model import ComboModel, RunConfigModel
 
+logger = logging.getLogger(__name__)
+
 
 def build_kamil_adc_neutral_s21_sets(
     config: RunConfigModel,
     point_count: int,
 ) -> tuple[SweepCollection, SweepCollection]:
-    """Build S21 calibration/reference collections that leave input S21 unchanged."""
+    """Build neutral S21 calibration/reference collections for the Kamil ADC radar.
+
+    The calibration uses unit S21 (1+0j) and the reference uses zero S21 across
+    every configured combo, so applying them in the preprocessing pipeline leaves
+    the input S21 unchanged. Returns the ``(calibration, reference)`` collections.
+    """
     if not config.is_kamil_adc:
         raise ValueError("Neutral Kamil ADC sets require radar.model='kamil_adc'")
 
@@ -47,6 +55,7 @@ def build_kamil_adc_neutral_s21_sets(
         s21_value=np.complex64(0.0 + 0.0j),
         monotonic_ns=now_ns,
     )
+    logger.info("Built neutral Kamil ADC S21 sets: combos=%d points=%d", len(combos), points)
     return calibration, reference