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

53 lines
14 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 и повторного захвата
Событие `recovery_frame` в очереди JSONL PTZ17 связывает причину отказа или восстановления с поколением трека, номером кадра, временем наблюдения и размером изображения обработки. Координаты `xyxy` отсчитываются от левого верхнего угла. Для промежуточного OSTrack и привязанного к нему YOLO время наблюдения соответствует получению декодированного кадра. Для отдельного детекторного прохода оно соответствует входу в обработчик. Поле `input_kind` различает эти источники. Номера кадров OSTrack и управляющего прохода записываются отдельно.
Телеметрия содержит последнюю принятую рамку, опору сопоставления, рамку и оценку OSTrack, кандидатов YOLO с оценками и классами, результат сопоставления, выбранную рамку и результат переинициализации. Записываются счётчики голосов повторного захвата и разрешения зума. При геометрическом HOLD журнал различает отсутствие сопоставления, отбрасывание по площади относительно принятой рамки, ожидание подтверждения и отказ переинициализации. При позднем YOLO событие отмечает, что кадр использован для верификации или привёл к штатному STOP из-за конфликта.
Списки содержат до 12 рамок, которые дошли до соответствующих проверок контроллера. Общие количества и выбранная рамка записываются отдельно. Сырые результаты YOLO до фильтрации представлены счётчиком. Для событий, ожидающих подтверждения, `yolo_match` показывает возможное совпадение, а `yolo_selected` остаётся пустым. Писатель использует существующую ограниченную очередь. Переполнение увеличивает `dropped_before` у следующих событий.
Для офлайн-проверки `test_recovery_telemetry.py` укажите пути `PTZ17_TEST_RUNTIME`, `PTZ17_TEST_BASELINE` и `PTZ17_TEST_CANDIDATE`. Базовая версия для этих тестов — предыдущий коммит PR №14. Тесты сравнивают команды Pan/Tilt/Zoom, защитные STOP, вызовы тревог и состояние контроллера на одинаковых входах со смоделированными детекциями. Полевое время от HOLD до повторного разрешения зума остаётся измерить после сбора новых событий.
Локальный кандидат поверх установленного PR №13. Прямое и обратное применение патча проверены побайтно. SHA-256 базовой и кандидатной версий в `pins.json`.
На широком угле кандидат проверяет, может ли уже разрешённый первый обычный импульс native 10 начаться с длительностью до 340 мс и жёстким пределом 400 мс. Для этого нужны текущий кадр OSTrack, свежее подтверждение YOLO, свежая оптика, допустимая скорость в кадре и полная штатная проекция рамки. Повторное разрешение допускает только исходный запрос того же владельца. При запрете базового контроллера запрос остаётся нулевым. Функции модели, тревог и транспорт STOP сохранены.
При HFOV до 18° на PTZ17 оценка резкости проверяет область самой цели. Для решения о паузе подходят рамки с короткой стороной от 20 px. Штатный порог размера для автофокуса остаётся 24 px. Низкая резкость или неоцениваемый кадр удерживают текущее увеличение. Для выхода нужны два свежих резких кадра того же владельца с интервалом не более 250 мс. Один резкий отсчёт, дубликат и большой разрыв паузу не снимают. Пауза относится к новым положительным импульсам, поэтому Pan/Tilt и защитное расширение FOV сохраняют штатные пути.
При непрерывных 600 мс неоцениваемой резкости после остановки линзы, свежем подтверждении цели и устойчивом положении рамки кандидат может поставить один восстановительный запрос в штатную очередь автофокуса на владельца трека. Повторный запрос требует смены владельца и соблюдения штатного cooldown. ACK фокуса сам по себе зум не возобновляет.
Повторная проверка на пролёте 14:28 показала, что расширенная область низкоконтрастна и для размытого, и для различимого самолёта. Теперь при непригодной расширенной области проверяется ядро рамки с более строгим порогом. Для этого кандидата задан восьмикратный множитель относительно исходного порога дисперсии лапласиана. Множитель проверен на этой ограниченной выборке и остаётся параметром калибровки.
На записи пролёта 14:12:02 измерение рамки на PTS 95 возвращает `unassessable` и устанавливает паузу. На PTS 116 свежая резкая рамка снимает её. У трёх сохранённых кадров нет покадровой привязки к UTC. Замеры AIM разрежены. Первый записанный полный безопасный запас от края появился на +9,869 с, после первой полевой команды на +6,041 с. Ускорение первого оптического приближения на данном пролёте по доступным данным не подтверждено.
Проверки охватывают свежесть, владельца импульса, отказ при малом запасе от края, превышении угловой зоны и скорости, сохранение нулевого запроса, паузу по размытому кадру и снятие паузы по свежему резкому кадру. Реакция привода и время до распознаваемого кадра требуют дополнительных данных. Кандидат не установлен.
## Два дополнительных пролёта на PR №13
Время местное, UTC+7. Тайминги отсчитаны от входа в TRACK. Проекция берётся из разреженных строк AIM, поэтому её первое появление даёт только верхнюю границу времени появления в журнале.
| Начало TRACK | Первый физический старт | Первое подтверждение оптики | Первая записанная безопасная проекция | До 2× / 4× / 8× |
| --- | ---: | ---: | ---: | --- |
| 14:24:57,917 | +8,118 с | +17,020 с | +11,230 с | 28,163 / 47,218 / 76,182 с |
| 14:28:06,389 | +4,294 с | +16,985 с | +13,713 с | 45,665 / 70,481 / 97,097 с |
В первом пролёте два коротких импульса 100 и 220 мс не получили отдельного подтверждения оптики. Во втором исходный обычный импульс снят после PUT на фоне `image_motion`, два пробных импульса по 100 мс также остались без оптического подтверждения. Первое подтверждение получено на обычных запросах №3 и №5 соответственно. Первые записанные безопасные проекции в обоих случаях позже первого движения, поэтому изменение длительности из PR №14 ещё не подтверждает выигрыш на этих пролётах. Защитные остановки сохраняются.
На кадрах второго пролёта PTS 94 и 114 расширенная область вернула `None`. Энергия в ядре рамки составила 142 и 8994 соответственно. При пороге 280 первый кадр удерживает паузу, второй её снимает. Два различимых кадра из пролёта 14:24 проходят проверку. Сопоставление PTS с UTC на уровне отдельных кадров не выполнено. В окнах обоих пролётов журнал не показывает отправку тревоги по WebSocket.
## Воспроизводимый эталон первых 20 секунд
Для полевого сравнения PR №14 пишет `decision_frame` только для PTZ17 через существующую ограниченную асинхронную очередь. Событие связывает номер и время кадра с состоянием проверки, полем зрения, оценкой резкости, запросом зума, длительностью и итоговой командой. Ненулевые команды и идентификаторы проверяются по журналу доставки и замерам оптики. Для первого резкого кадра учитывается только измерение с текущего кадра и размер рамки от 20 px. Эталон предыдущей версии располагает лишь редкими строками оценки резкости и выборочными JPEG.
`replay_ptz17_reference.py` читает зафиксированные команды, завершения запросов и выборки свежего HFOV из `reference_fixture.json`. Запуск `python replay_ptz17_reference.py` восстанавливает `reference_replay.json`. В журнале время подтверждения и первое наблюдаемое изменение HFOV могут отличаться из-за округления меток и порядка записи. Время измеримого сужения определяется отдельно от подтверждения конкретного запроса.
| TRACK, UTC+7 | Первый старт → первое подтверждение | Первый подтверждённый запрос | Свежие замеры HFOV за 20 с |
| --- | ---: | --- | ---: |
| 14:12:02 | 4,512 с | №3, 340 мс | 257 |
| 14:24:57 | 8,902 с | №3, 340 мс | 259 |
| 14:28:06 | 12,691 с | №5, 220 мс | 253 |
Во всех трёх эпизодах поле зрения оставалось 59° до первого успешного запроса и затем сузилось до 54,12°. Это указывает на отсутствие измеримого сужения на ранних попытках. Из разреженных AIM нельзя восстановить разрешение более длинного первого импульса в момент решения или пересчитать физический контрфактический результат. Данные пригодны для сравнения по номеру запроса, времени первого оптического подтверждения и дальнейшим отметкам 2×/4×/8×. Для сравнения по времени до первого различимого резкого кадра нужна привязка PTS к UTC и покадровая проверка.