radar_system/python_app/docs/module_reference.md

Module reference

python_app.gui

• main.py: GUI entrypoint.
• app_window.py: composition root.
• controllers/app_window_*_mixin.py: функциональные части окна.
• controllers/sections/*: построители UI-секций.
• plotting/bscan_math.py: математика B-scan.
• plotting/bscan_history.py: cache/signature для B-scan.
• runtime/history.py: сигнатуры run/history merge.
• runtime/constraints.py: режимные ограничения.

python_app.models

• dataset_model.py: dataclass-модели sweep/result данных.
• run_config_schema.py: dataclass-schema run config.
• run_config_codec.py: encode/decode/load.
• run_config_validation.py: payload checks/parsing helpers.
• run_config_model.py: фасадный экспорт.

python_app.orchestration

• config_writer.py: runtime config + bundle files.
• live_processing_config.py: live processing JSON writer.
• process_supervisor.py: управление процессами C++ pipeline.
• shm/*: shared-memory чтение и декодирование.
• shm_reader.py: фасадный экспорт.

python_app.storage

• store_api.py: абстракция хранилища.
• npz/store.py: NpzStore.
• npz/serialize.py: binary serializers.
• npz/snapshot_numpy.py: snapshot selection/writers.
• npz/paths.py: naming/path helpers.
• npz_store.py: фасадный экспорт.

python_app.hardware_full

• librevna_service.py: high-level service.
• librevna_backends.py: native/mock adapters.
• librevna_driver/*: USB/protocol/session/controller stack.
• switch_service.py: switch facade.
• switch_drivers/*: native/mock switch implementations.

python_app.workflows

• sequential_capture_workflow.py: последовательный capture session.
• calibration_workflow.py, reference_workflow.py: helper workflows.

python_app.scripts

• check_snapshot_numpy.py: snapshot validator + plots.
• manual_smoke_run.py: локальный smoke сценарий.
• hardware_raw_orchestrator_test.py: raw ring visualization utility.
• vna_only_raw_test.py: direct VNA check utility.