radar_system/python_app/docs/preprocessing_and_capture_workflow.md

Preprocessing and capture workflow

1. Назначение

До запуска live-pipeline необходимо выбрать calibration/reference set, покрывающие целевые run combos.

2. Процесс в GUI

1. Открыть Preprocessing Panel.
2. Выбрать или создать имя набора (set_name).
3. Запустить Start Calibration Sequence или Start Reference Sequence.
4. Для каждого combo нажимать Capture Current Combo.
5. По завершении данные сохраняются в NpzStore.

3. Internal flow

• AppWindowPreprocessMixin создает SequentialCaptureSession.
• Session управляет:
  • LibreVnaService
  • input/output SwitchService
  • последовательным обходом full combo matrix.
• После полной матрицы вызывается finalize(store).

4. Связь с live run

_start_run() проверяет:

• выбраны ли calibration/reference sets,
• покрывают ли выбранные sets все run combos (has_combo_coverage),
• доступны ли bundle-файлы для preprocessor.

5. Диагностика

Типовые ошибки:

• set already exists,
• incomplete capture sequence,
• hardware not available,
• mismatch requested combos vs stored combos.