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/ptz17_hold_capture/README.md

10 lines
3.8 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.

# PTZ17 · сбор входов геометрического HOLD
Кандидат диагностики для полевой версии `postprocess.py` из `pins.json`. Патч включает телеметрию HOLD из PR №14 и расширяет её. Он не включает изменения восстановления из PR №15, чтобы получить входы на текущем контроллере. При подготовке патч проверен на локальной копии с точной контрольной суммой и обратным применением.
Когда PTZ17 отклоняет рамку по геометрии, в существующий асинхронный журнал `logs/ptz_zoom/ptz-6-<generation>-<track_start>.jsonl` поступают события `hold_capture_input`. Окно работает до трёх секунд после последнего геометрического HOLD или заканчивается вместе с TRACK. Рамки пишутся в пикселях исходного изображения контроллера, `[x1, y1, x2, y2]`, от верхнего левого угла. В записи есть исходная рамка OSTrack с причиной отказа, последняя принятая рамка, использованные списки кандидатов YOLO с классами и уверенностью, подтверждения восстановления до решения, номера кадров, размер кадра, время обработки и доступная метка захвата. События различают визуальное управление, самостоятельный YOLO и сопоставленный с кадром OSTrack результат YOLO. Для самостоятельного YOLO используется время входа в контроллер, когда метка захвата отсутствует.
После разрешённого включения сборщика выберите один файл эпизода и запустите локально `python summarize_capture.py <episode.jsonl>`. Код выхода 0 означает, что все найденные окна завершились и прошли проверки наличия кадров, порядка записей и полноты списков. Код 2 означает отсутствие окон или неполные данные. Пропуски в очереди и усечение списков видны в отчёте. Списки ограничены 64 записями каждый. Отчёт показывает, были ли отклонённая рамка OSTrack и кандидаты YOLO на одном кадре, и выводит зарегистрированные времена до восстановления и решения о зуме. Для повтора нужны сами записи `hold_capture_input` в порядке `input_idx`, с сохранением канала обработки и времени. Восстановление OSTrack и физический отклик камеры требуют дополнительных входов и полевых измерений.
Тесты проверяют запись в настоящую очередь JSONL, совпадение команд привода, STOP и входов тревоги с полевой базой, работу парного и самостоятельного YOLO и обнаружение неполных окон. Сборщик ничего не включает на объекте. Модель, правила тревоги и STOP не меняются.