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
Ярослав Карташов 5cc610a92a Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
..
README.md Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
broad_tele_replay_results.json Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
field_replay_profiles.json Include delayed ISAPI PUT replay results 2 weeks ago
fit_tele_profile.py Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
pins.json Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
plot_episode.py Add predictive TRACK zoom for calibrated PTZ cameras 2 weeks ago
replay_broad_tele.py Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
run_local_replay.py Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
server.patch Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
test_broad_tele.py Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
test_zoom_controller.py Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
track_integration.py Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 2 weeks ago
zoom_controller.py Add broad-to-tele zoom safety, latency-aware steering and calibration telemetry 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 и тревоги используют прежние пути.

Управление широким углом и телеуглом

Профили PR №8 с двумя коэффициентами по-прежнему загружаются. Дополнительные параметры задаются в том же predictive_zoom для камеры.

Параметр По умолчанию Назначение
initial_gate_relax_factor 1,45 Расширяет допуск начального захвата только на широком угле при сходящейся траектории.
tele_edge_margin_ratio 0,32 Буфер до края на HFOV 12° и ниже. Плавно растёт от 0,16 при 25°.
min_allowed_hfov_deg 10,0° Нижний предел прогноза для непрерывного положительного зума. Проверяется перед отправкой PUT.
latency_horizon_ms 245 Горизонт от захвата кадра до действия доворота.
tele_pan_native10_deg_s, tele_tilt_native10_deg_s 0,65 и 0,85 Калибровка преобразования угловой скорости в команду.
tele_position_gain, tele_rate_gain 2,7 и 0,85 Угловая коррекция и упреждение.
tele_calibration_enabled true На HFOV ниже 15° между положительными импульсами допускает ожидание стабилизации статуса до 1,2 с.

Ускоренный вход разрешается при последовательных достоверных кадрах, допустимой текущей рамке и безопасном прогнозе. Неподтверждённые кадры, конфликт владельца и транспортные запреты продолжают блокировать движение. На телеугле профиль уменьшает вес старого PID по мере сужения поля и подмешивает угловую коррекцию с учётом задержки и синхронизированной скорости приводов. При угрозе краю выполняется отдельный короткий импульс расширения с действующими ограничителями отрицательного зума. Полный STOP остаётся приоритетным.

Предел 10° относится к прогнозу разрешённых импульсов. Настоящая линза и задержки могут отличаться от профиля, поэтому первую полевую серию проверяют по свежему статусу. Абсолютные переходы к пресету обслуживаются прежним кодом.

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

По умолчанию сводка zoom_block_summary записывается в JSONL в logs/ptz_zoom через ограниченную очередь. Параметр PREDICTIVE_ZOOM_TELEMETRY_DIR задаёт путь или отключает запись значением None. Сводка включает накопленные centering, bbox_check, angle_tol, edge_margin, min_hfov_limit и put_inflight с последними значениями. Снимок появляется не чаще раза в секунду и при завершении TRACK. Камера, время начала и поколение команд идентифицируют эпизод.

Событие native10_pulse_calibration связывает окно команды, монотонные RTT PUT и STOP, статус до импульса, первый статус после STOP и установившийся HFOV. Поле post_stop_tail_deg показывает наблюдённое сужение между двумя статусами после STOP. Если известен свежий замер до STOP, stop_bracket_narrowing_deg дополнительно показывает изменение между ним и установившимся статусом. Оба измерения ограничены частотой опроса. Отменённые, пересекающиеся и незавершённые окна помечаются. Команда python fit_tele_profile.py episode.jsonl собирает предварительный профиль из допустимых окон для отдельной проверки. Автоматического применения нет.

  • Unit-тесты: python -m unittest discover -s integration/ptz_predictive_zoom -v
  • Полный повтор TRACK и транспорта: run_local_replay.py принимает каталог снимков Codex, каталог пакета, корень Electro-pribory, вариант before или after и необязательный путь к материализованной серверной копии.
  • Парный стенд: replay_broad_tele.py запускается с --camera 19 и --camera 21, дополнительно с --edge-stress, --put-rtt и --problem. Каталог с candidate и pins.json задаёт PTZ_BROAD_TELE_REPLAY_DIR. Нужны сохранённые записи AIM и стенд предыдущего PR в соседних каталогах снимков.
  • График одного эпизода: python plot_episode.py episode.jsonl episode.svg