You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chameleon/integration/ptz_field_calibration/README.md

29 lines
4.4 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Офлайн-калибровка native10 по JSONL PR №10
Передайте файлы JSONL или каталоги с выгрузкой эпизодов из `logs/ptz_zoom`. Утилита работает на Python 3.10+ со стандартной библиотекой. В команде укажите пути к данным и отдельному каталогу для отчёта.
```powershell
python integration/ptz_field_calibration/calibrate_tele_profile.py D:/telemetry/ptz_zoom --output-dir D:/telemetry/field_report
```
- `field_report.md` показывает сводку по эпизодам, первые подтверждённые PUT, минимальный фактический HFOV, блокировки и таблицу отклика.
- `field_report.json` содержит оценки по отдельным импульсам, причины исключения, распределения RTT и сводки по камере, native и исходному диапазону HFOV.
- `native10_calibrated.json` содержит коэффициенты с покрытием измерений. Следующий тестовый предел HFOV появляется при достаточном покрытии у текущего порога, с учётом худшей наблюдаемой скобки STOP и прогнозируемого запаса до края. Максимальный шаг за один анализ составляет 0,5°. Значение `production_enable` равно `false`.
Без `--profile` сравнение использует коэффициенты стенда PR №10 для PTZ19 и PTZ21. Чтобы сравнить с другим профилем, передайте JSON с объектом `cameras`, где ключи — внешние номера камер, а значения — параметры профиля напрямую или внутри `predictive_zoom` либо `replay_settings`. Окна свежести статуса доступны в `--help`.
Оценка скорости оптики использует разницу замеров ISAPI. Изменение от первого статуса после STOP до стабилизации показывает наблюдаемый минимум выбега. Изменение от последнего свежего статуса до STOP до стабилизации даёт верхнюю наблюдаемую оценку при монотонном движении. Интервалы между статусами ограничивают точность обеих оценок.
Для доли времени у центра и доставленных защитных расширений передайте `--observations` с отдельным JSONL независимых наблюдений. `cam`, `generation`, `track_start_utc` берутся из эпизода PR №10. Время — Unix UTC в секундах. Смещения центра нормированы по полной ширине и высоте кадра. Оценка доли использует сопоставленные кадры с отклонением не более 0,10 по каждой оси и свежим HFOV ниже 18°. Поле `measured_edge_margin` необязательно.
```jsonl
{"cam":8,"generation":3,"track_start_utc":1000.0,"event":"frame_observation","seq":76,"frame_utc":1004.0,"dx_norm":0.04,"dy_norm":-0.03,"measured_edge_margin":0.36,"source":"aligned_frame_annotation"}
{"cam":8,"generation":3,"track_start_utc":1000.0,"event":"safety_step_back_ack","command_seq":12,"utc":1004.1,"native":-5,"reason":"tele_step_back","source":"transport_ack"}
```
В исходном JSONL PR №10 есть прогноз запаса и выборочные измерения у блокировок. Доля времени у центра и число подтверждённых расширений остаются неизвестными при отсутствии соответствующих независимых наблюдений. Количество подтверждений из дополнительного файла относится к покрытым им событиям.
```powershell
python -m unittest discover -s integration/ptz_field_calibration -v
```