radar_system/python_app/docs/operations_runbook.md

Operations runbook

1. Подготовка

• Собрать C++ binaries (make).
• Проверить run_config.json и доступность hardware.
• Для native режима убедиться в правах на USB/GPIO.

2. Запуск GUI

python3 -m python_app.gui.main

3. Базовый сценарий live run

1. Проверить Radar/Switches config.
2. Выбрать calibration/reference sets.
3. Нажать Start.
4. Проверить обновление history и графика.
5. Нажать Stop.

4. Сохранение snapshot

1. Указать Path, Name, Last N.
2. Нажать Save Numpy Snapshot.
3. Проверить manifest.json и каталоги raw/preprocessed/results.

5. Проверка snapshot

python3 python_app/scripts/check_snapshot_numpy.py <snapshot_dir>

6. Конвертация snapshot для vna_system

python3 python_app/scripts/convert_snapshot_to_vna_history.py \
  <snapshot_dir> \
  -o <output_json> \
  --input 0 \
  --output-index 0

Полученный JSON содержит sweep_history и загружается в vna_system через кнопку загрузки истории у B-scan графика.

7. Типовые проблемы

• Пустой график: проверить processing mode и наличие trace payloads.
• Нет запуска в B-scan: проверить ограничение combo для native switches.
• Ошибки лимитов радара: проверить соединение с устройством и serial.
• Процессы не стартуют: смотреть crash reports в GUI log.

8. Безопасная остановка

• Использовать Stop в UI.
• При закрытии окна вызывается стоп всех процессов и закрытие dialogs/readers.