some fixes and improvements

python_app/models/gui_profile_codec.py

@@ -377,6 +377,14 @@ def gui_profile_from_dict(payload: dict[str, Any]) -> GuiProfileModel:
                 gui.processing.legacy_gpr.ignore_socket_speed_enabled,
             ),
             look_angle_deg=legacy_float("look_angle_deg", gui.processing.legacy_gpr.look_angle_deg),
+            apply_freq_phase_correction=legacy_bool(
+                "apply_freq_phase_correction",
+                gui.processing.legacy_gpr.apply_freq_phase_correction,
+            ),
+            reference_mode=legacy_string(
+                "reference_mode",
+                gui.processing.legacy_gpr.reference_mode,
+            ),
             snr_thresh=legacy_float("snr_thresh", gui.processing.legacy_gpr.snr_thresh),
             snr_comp_max=legacy_float("snr_comp_max", gui.processing.legacy_gpr.snr_comp_max),
             background_subtract_enabled=legacy_bool(
@@ -410,6 +418,10 @@ def gui_profile_from_dict(payload: dict[str, Any]) -> GuiProfileModel:
         raise ValueError("gui.processing.legacy_gpr.mode must be one of: point, extended")
     if gui.processing.legacy_gpr.render_mode not in {"heatmap", "objects_only"}:
         raise ValueError("gui.processing.legacy_gpr.render_mode must be one of: heatmap, objects_only")
+    if gui.processing.legacy_gpr.reference_mode not in {"frame_center", "first_tx_event"}:
+        raise ValueError(
+            "gui.processing.legacy_gpr.reference_mode must be one of: frame_center, first_tx_event"
+        )
     if gui.processing.gpr.range_comp_power < 0.0:
         raise ValueError("gui.processing.gpr.range_comp_power must be >= 0")
     if gui.processing.gpr.angle_comp_power < 0.0:
@@ -552,6 +564,8 @@ def gui_profile_to_dict(model: GuiProfileModel) -> dict[str, Any]:
                 "speed_m_s": gui.processing.legacy_gpr.speed_m_s,
                 "ignore_socket_speed_enabled": gui.processing.legacy_gpr.ignore_socket_speed_enabled,
                 "look_angle_deg": gui.processing.legacy_gpr.look_angle_deg,
+                "apply_freq_phase_correction": gui.processing.legacy_gpr.apply_freq_phase_correction,
+                "reference_mode": gui.processing.legacy_gpr.reference_mode,
                 "snr_thresh": gui.processing.legacy_gpr.snr_thresh,
                 "snr_comp_max": gui.processing.legacy_gpr.snr_comp_max,
                 "background_subtract_enabled": gui.processing.legacy_gpr.background_subtract_enabled,

python_app/models/gui_profile_schema.py

@@ -88,6 +88,8 @@ class GuiLegacyGprStateModel:
     speed_m_s: float = 0.0
     ignore_socket_speed_enabled: bool = False
     look_angle_deg: float = 0.0
+    apply_freq_phase_correction: bool = True
+    reference_mode: str = "frame_center"
     snr_thresh: float = 4.5
     snr_comp_max: float = 25.0
     background_subtract_enabled: bool = True

python_app/models/run_config_codec.py

@@ -24,10 +24,22 @@ def _as_dict(value: Any, context: str) -> dict[str, Any]:
     return value
 
 
+def _read_str(payload: dict[str, Any], key: str, default: str) -> str:
+    """Return payload string, treating an explicit JSON `null` as missing.
+
+    `payload.get(key, default)` returns `None` when the key exists with value
+    `null`, which is then coerced into the literal string `"None"` by `str()`.
+    """
+    value = payload.get(key, default)
+    if value is None:
+        return default
+    return str(value)
+
+
 def _load_preprocess_asset(payload: dict[str, Any], target: PreprocessAssetModel) -> None:
     """Load preprocess asset fields into target model."""
-    target.set_name = str(payload.get("set_name", target.set_name))
-    target.bundle_path = str(payload.get("bundle_path", target.bundle_path))
+    target.set_name = _read_str(payload, "set_name", target.set_name)
+    target.bundle_path = _read_str(payload, "bundle_path", target.bundle_path)
 
 
 def _load_string_list(payload: dict[str, Any], key: str, context: str) -> list[str]: