Управление поворотными устройствами (PTZ Controller)

Назначение

1. Поворот устройства PTZDevice в расположение(position) наблюдаемой точки, в указанные Панорамирование(pan), Наклон датчика(tilt) и Зум(zoom) либо по номеру Предустановки(preset).
2. Поворот устройства PTZDevice в расположение(position) датчика.
3. Поворот устройства PTZDevice за подвижной целью MoveableObject, находящейся в зоне.
4. Создание фотоснимка цели после позиционирования на ней и запись его в trace_snapshot.

Настройка

1. У компьютера/сервера должен быть настроен параметр сетевой адрес (ip).
2. Параметры PTZController:
   1. Включен (enabled) - задействовать триггер.
   2. Настройки (settings) - настройки скрипта имеют следующие параметры:
      1. url - адрес веб-сервиса IntegraVideo7, например: http://localhost:1986/axis2/services/Iv7Server;
      2. tracer - настройки слежения:
         1. iterations - количество итераций алгоритма расcчитывающего положение движущейся цели в будущем, например: 10.
         2. enabled - задействовать автоматическое слежение;
         3. update_trace_time - обновление времени на позиционирование.
      3. snapshot - настройки фотоснимка:
         1. width - ширина фотоснимка в пикселях, например: 320;
         2. height - высота фотоснимка в пикселях, например: 240.
      4. update - настройки обновления параметров:
         1. trace_time - обновлять параметр Время на позиционирование, сек (trace_time) поворотной камеры;
         2. point_ptz - обновлять параметры Панорамирование(pan), Наклон датчика(tilt) и Зум(zoom) поворотной точки;
         3. device_ptz - обновлять параметры pan, tilt и zoom поворотной камеры.
         4. zone_weight - вес зоны.
         5. interval - интервал опроса PTZ поворотных камер.
      5. trace_disabled_timeout - включение параметра Слежение включено(trace_enabled) PTZ устройства если не было изменений за указанный таймаут.
      6. target_position_timeout - выставление статуса Устаревший(outofdate) параметру расположение у движущегося объекта, если не было изменений за указанный таймаут.
      7. undefined_position_timeout - сброс параметра расположение у не определенной цели если не было изменений за указанный таймаут.
      8. alarm_timeout - интервал в течении которого датчик подключенный к зоне считается тревожным, даже если тревожное состояние уже сброшено.
      9. logon - вкл\выкл вызова функции ИВ7 logon перед выполнением команды.
      10. analytics - специальный пресет включающий аналитику на камере:
          1. pause - пауза после команды на поворот перед включением аналитики.
          2. enabled - включать аналитику на поворотной камере путем отправки спец пресета.

Замечания

1. Для поворота камеры необходимо чтобы был запущен клиент Интегра-Видео и acuariomanager на одной физической машине.
2. Камера должна быть подключена к корректно настроенной зоне Zone:
   1. area - область обслуживания;
   2. area_heights - высота области;
   3. trace_factor - дополнительный делитель числового приоритета для зоны.
3. У поворотного устройства PTZDevice должны быть корректно настроены следующие параметры:
   1. trace_enabled - флаг выключения автоматики оператором;
   2. geo_position - географические координаты;
   3. geo_height - географическая высота;
   4. calibrationMatrix - калибровочная матрица;
   5. url - сетевой адрес камеры в формате IntegraVideo7;
   6. min_zoom_distance - дистанция до цели, менее которой приближение камеры будет всегда минимальным;
   7. min_zoom_limit_factor - коэффициент ограничивающий минимальное приближение камеры, от 0.0 (0%) до 1.0 (100%);
   8. max_zoom_distance - дистанция до цели, более которой приближение камеры будет всегда максимальным;
   9. max_zoom_limit_factor - коэффициент ограничивающий максимальное приближение камеры, от 0.0 (0%) до 1.0 (100%);
   10. focus_time - время необходимое на фокусировку в секундах;
   11. zoom_time - время необходимое на полное приближение в секундах;
   12. pan_speed - скорость горизонтального поворота в градусах в секунду;
   13. tilt_speed - скорость вертикального поворота в градусах в секунду;
   14. parallel_ptz - флаг указывающий на возможность одновременного поворота, приближения и фокусировки;
   15. pan_error - максимальная допустимая разница между параметрами pan камеры и точки;
   16. tilt_error - максимальная допустимая разница между параметрами tilt камеры и точки;
   17. zoom_error - максимальная допустимая разница между параметрами zoom камеры и точки;
   18. trace_types - список типов целей на которые данному устройству разрешено поворачиваться (пустой список означает, что разрешены все типы целей);
   19. trace_time - среднее время на позиционирование в секундах, начальное значение необходимо указать пользователю, затем если в настройках включено update_trace_time, то скрипт будет пересчитывать данное значение.
4. У самой же цели MoveableObject должны быть корректно настроены следующие параметры:
   1. position - расположение;
   2. trace_zones - список идентификаторов зон, в которые входит цель в данный момент;
   3. trace_order - числовой приоритет цели, чем меньше тем выше, но отрицательные значения исключают цель из слежения.
5. У наблюдаемой точки(ObservablePoint) должен быть корректно настроен параметр расположение(position).
6. Наблюдаемая точка должна быть подключена к поворотной камере.
7. Если preset больше или равно 0, то выполняется поворот по пресету. Калибровка не нужна. pan, tilt и zoom не заполняются.
8. Если preset меньше 0, а pan, tilt и zoom не равно 0, то выполняется поворот по pan, tilt и zoom.
9. Если preset меньше 0, а pan, tilt и zoom равно 0, но точка имеет position и altitude и камера откалибрована (т.е. имеет calibrationMatrix), то выполняется расчет и запись pan, tilt и zoom по позиции точки.
10. При изменении параметров pan, tilt, zoom поворотной камеры проставляется флаг observed той ее поворотной точке, которая указывает приблизительно в тоже место с допусками указанными в pan_error, tilt_error и zoom_error поворотной камеры.

Базовая схема

В редакторе СКАДА необходимо добавить элементы, для этого необходимо:

1. Перейти на вкладку "Типы элементов" и выбрать в списке элемент Компьютер (Computer).

2. Дважды нажать на элемент Компьютер, после чего появится окно для добавления элемента.

3. Нажать кнопку "Добавить". Элемент появится на рабочей области.

4. Аналогично пункту 2 добавить элементы: Менеджер устройств (AcuarioManager), EGS Модуль (EGSModule).

5. PTZ Controller (Скрипт необходимо импортировать отсюда PTZ Controller).

1 Для того, чтобы импортировать скрипт необходимо сначала скопировать и вставить вышеуказанную ссылку в адресную строку браузера, нажать на клавиатуре Enter, в окне браузера нажать правой кнопкой мыши, в появившемся контекстном меню нажать на сохранить как и выбрать удобное для Вас местоположения сохранив скрипт с расширением .put. В редакторе СКАДА нажать на меню Действия > Импорт элементов > выбрать сохраненный скрипт.

Необходимо добавить следующие связи:

1. PTZ Controller: EGS вход:EGSInput + EGS Модуль: EGS Выход: EGSOutput.
   
2. EGS Модуль: Привязка к менеджеру: ManagingContent + Менеджер устройств: Менеджер устройств: ManagingContainer.
   
3. Менеджер устройств: ПО:SoftwareContent + Компьютер или Сервер: Установленное ПО:SoftwareContainer.