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_predictive_zoom
Ярослав Карташов 3b92c16bef Document byte-exact patch checks on Windows 2 weeks ago
..
README.md Document byte-exact patch checks on Windows 2 weeks ago
pins.json Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago
plot_episode.py Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago
run_local_replay.py Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago
server.patch Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago
test_zoom_controller.py Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago
track_integration.py Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago
zoom_controller.py Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago

README.md

Предсказательный зум Chameleon-C

Кандидат поверх установленного PR №7. Точки интеграции находятся в TRACK, обработчике ISAPI-статуса и обработчике подтверждённых команд транспорта. Контрольные суммы исходных и изменённых файлов приведены в pins.json. server.patch применяется к точной серверной копии трёх файлов, а zoom_controller.py размещается рядом с ними в пакете PTZ.

Для локальной проверки на Windows используйте git -c core.autocrlf=false apply --check server.patch. Для прямого и обратного применения используйте тот же параметр, чтобы сохранить LF и совпадение SHA-256.

Профиль камеры

Ускоренный путь включается индивидуально через ключ predictive_zoom в CAMERA_CONFIG. Его значения передаются в ZoomConfig. Требуются nominal_gain и upper_gain для native10, измеренные на этой камере. Коэффициенты масштабируют логарифмический темп изменения фокусного расстояния. Паспортные 5,5 с для 6–252 мм задают единицу отсчёта. Для верхней границы используют измеренный максимальный отклик с запасом. Числа из тестов относятся к виртуальному приводу. Камера без настроенного профиля использует политику PR №7.

Первый импульс использует три последовательных кадра OSTrack с согласованной траекторией и последний принятый YOLO-матч того же объекта в пределах 650 мс. На 59° допуск составляет до 30% полуширины кадра, сужаясь до штатной зелёной зоны при 35°. Контроллер отдельно проверяет остаточное угловое движение и прогнозирует запас до обеих границ кадра. Целевой размер по умолчанию 48 × 48 px относится к остановке приближения. Качество распознавания зависит от изображения и модели.

Статус корректирует оценку HFOV асинхронно. После подтверждённого STOP уже подтверждённый оптический шаг может дать следующий импульс на ближайшем свежем кадре. Это снимает ожидание дополнительного опроса после STOP. Если подтверждение оптики задерживается, продолжение остаётся за действующим учётом доставки и оптики. Предсказанный HFOV используется для запаса кадра и компенсации Pan/Tilt. Подтверждение оптики поступает из ISAPI.

Длительность от 340 мс при HFOV от 25° до 120 мс при HFOV до 15°. У каждого импульса собственный неизменяемый дедлайн с верхним пределом watchdog 400 мс. Ранний STOP использует действующий приоритетный канал. Он сохраняет свежий доворот там, где аппаратная политика разрешает раздельную остановку осей. Требуемый полный STOP сохраняется. Весовые файлы, YOLO, OSTrack и тревоги используют прежние пути.

Телеметрия и проверки

Укажите PREDICTIVE_ZOOM_TELEMETRY_DIR для записи JSONL отдельно по каждому TRACK. Первый импульс содержит времена до отправки PUT и до успешного ответа. Строки кадров содержат причину решения, ширину и высоту bbox, исходный YOLO confidence, OSTrack score, измеренный и оценочный HFOV, время измерения и нижнюю границу HFOV. Запись идёт в отдельном потоке через ограниченную очередь.

  • Тесты контроллера и логирования: python -m unittest discover -s integration/ptz_predictive_zoom -v
  • График эпизода: python integration/ptz_predictive_zoom/plot_episode.py episode.jsonl episode.svg
  • Повтор полных путей TRACK и транспорта: run_local_replay.py принимает каталог снимков Codex, каталог этого пакета, корень Electro-pribory и вариант before или after. Для after рядом со снимками нужна пропатченная копия ptz_predictive_zoom_candidate_20261111. Повтор использует локальные fixtures PR №7, файлы телеметрии и имитацию сети и камеры.

В одном синтетическом пролёте за 3,6 с получено 7 принятых импульсов вместо 4. Пять повторов запущены до нового статуса после STOP. При исходном смещении 26% полуширины кандидат запустил первый импульс, а исходный контроллер за этот пролёт до зума не дошёл. Линза, кадры и валидация в этом сравнении моделировались.