Детектор вхождения целей в зоны (Trace detector 1) — различия между версиями

Материал из Integra-S Wiki
Перейти к: навигация, поиск
(→‎Алгоритм работы)
(→‎Алгоритм работы)
Строка 126: Строка 126:
 
##по полученным спискам идентификаторов в базе трекинга находятся цели т.е. объекты типа '''MoveableObject''';
 
##по полученным спискам идентификаторов в базе трекинга находятся цели т.е. объекты типа '''MoveableObject''';
 
##обновляется параметр цели '''trace_zones''', т.е. список идентификаторов зон, в которых в данный момент находится цель;
 
##обновляется параметр цели '''trace_zones''', т.е. список идентификаторов зон, в которых в данный момент находится цель;
−
 
 
Дальнейшее выполняется только для целей, приоритет которых отличен от '''ignore'''.
 
Дальнейшее выполняется только для целей, приоритет которых отличен от '''ignore'''.
 
##в соответствии с параметрами '''trace_highest_types''', '''trace_high_types''', '''trace_normal_types''', '''trace_low_types''' и '''trace_lowest_types''' проставляется определенный приоритет цели в параметр '''trace_priority''', в том случае если приоритет еще не был проставлен, т.е. в данный момент равен '''DEFAULT'''. Автоматическое определение приоритета цели происходит в два этапа: сначала приоритет выбирается при условии точного соответствия типа, а затем с учетом наследования;
 
##в соответствии с параметрами '''trace_highest_types''', '''trace_high_types''', '''trace_normal_types''', '''trace_low_types''' и '''trace_lowest_types''' проставляется определенный приоритет цели в параметр '''trace_priority''', в том случае если приоритет еще не был проставлен, т.е. в данный момент равен '''DEFAULT'''. Автоматическое определение приоритета цели происходит в два этапа: сначала приоритет выбирается при условии точного соответствия типа, а затем с учетом наследования;
Строка 138: Строка 137:
 
###'''target_type''' - тип цели;
 
###'''target_type''' - тип цели;
 
###'''target_info''' - краткая информация о цели.
 
###'''target_info''' - краткая информация о цели.
−
 
 
#На следующем этапе выбираются все цели с приоритетом отличным от '''ignore''' и '''DEFAULT'''.
 
#На следующем этапе выбираются все цели с приоритетом отличным от '''ignore''' и '''DEFAULT'''.
 
##По приоритету цели выбирается соответствующий таймаут из параметров '''trace_highest_timeout''', '''trace_high_timeout''', '''trace_normal_timeout''', '''trace_low_timeout''' и '''trace_lowest_timeout'''.
 
##По приоритету цели выбирается соответствующий таймаут из параметров '''trace_highest_timeout''', '''trace_high_timeout''', '''trace_normal_timeout''', '''trace_low_timeout''' и '''trace_lowest_timeout'''.
 
##Если с момента последнего изменения параметра '''position''' прошло больше секунд, чем указано в выбранном таймауте, то приоритет этой цели сбрасывается в '''DEFAULT'''.
 
##Если с момента последнего изменения параметра '''position''' прошло больше секунд, чем указано в выбранном таймауте, то приоритет этой цели сбрасывается в '''DEFAULT'''.
−
 
 
#На последнем этапе выбираются все цели входящие в какие-либо охраняемые зоны и имеющие приоритет отличный от '''ignore'''.
 
#На последнем этапе выбираются все цели входящие в какие-либо охраняемые зоны и имеющие приоритет отличный от '''ignore'''.
 
##Если модуль скорости цели (параметр '''speed''') меньше, чем '''stop_threshold''' и цель находится в движении, то генерируется событие '''ZoneEvent''' (с параметром '''alarm = stop_alarm''') с параметром '''action''' равным '''stop'''.
 
##Если модуль скорости цели (параметр '''speed''') меньше, чем '''stop_threshold''' и цель находится в движении, то генерируется событие '''ZoneEvent''' (с параметром '''alarm = stop_alarm''') с параметром '''action''' равным '''stop'''.

Версия 17:27, 24 декабря 2018

Данный скрипт предназначен для:

  1. определения вхождения целей в охраняемые зоны;
  2. генерирования событий о входе цели в зону и выходе цели из зоны;
  3. расчета и сохранения списка зон, в которые входит цель, и приоритета слежения за целью;
  4. генерирования событий о резком изменении скорости и направления цели;
  5. генерирования событий об остановке и начале движения после остановки;
  6. генерирования событий об превышении скорости и возврате к нормальной скорости;
  7. генерирования событий об начале и окончании опасного сближения.

Обычно данный скрипт работает в паре с другим скриптом PTZ Tracer.

Зависимости

Скрипт зависит от какого-либо другого модуля поставляющего географические координаты движущихся объектов базе трекинга, т.е. меняющего параметр position у объектов наследников типа MoveableObject.

Построение схемы

Для построения схемы требуется:

1. Добавить триггер EgsScheduled.

Для этого необходимо:
1. Перейти на вкладку "Типы элементов" и выбрать в списке элемент EgsScheduled.
Scheduled com 4.png
2. Дважды нажать на выбранный элемент, после чего появится окно для добавления элемента.
Scheduled com 5.png
3. Нажать кнопку "Добавить". Элемент появится на рабочей области.
Scheduled com 3.png
Также все элементы можно добавлять путем захвата и перетаскивания на рабочую область левой кнопкой мыши.

2. Аналогично пункту 1 добавить элементы Egs Модуль EgsModule', менеджер устройств AcuarioManager, Компьютер, Зону и объект TraceDetectorSettings, содержащий настройки скрипта для данной зоны и указанных типов (либо идентификаторов) целей.

TraceDetector 9.png

3. Настроить сетевой адрес компьютера.

Для этого необходимо выделить на схеме компьютер и нажать на кнопку вызова свойств элемента.

В окне свойств элемента указать ip адрес используемого компьютера в строке "Сетевой адрес".

Scheduled com 7.PNG

4. Связать EgsScheduled и Egs Модуль, подключив пины «Egs вход: EgsInput» у EgsScheduled и «Egs выход: EgsOutput» у Egs Модуля.

TraceDetector 2.PNG

5. Привязать пин "Привязка к менеджеру: ManagingContent" из Egs Модуля к пину "Менеджер устройств: ManagingContainer" из Менеджера устройств.

Scheduled com 9.PNG

6. Подключить пин "ПО: SoftwareContent" из Менеджера устройств с пином "Установленное ПО: SoftwareContainer" из Компьютера.

TraceDetector 3.PNG

7. Подключить пин "Логический вход: LogicInput" из Зоны с пином "Логический выход: LogicOutput" из TraceDetectorSettings.

TraceDetector 10.png

8. Настроить следующие параметры триггера:

  1. текст скрипта (script) http://maps.integra-s.com:5434/resources/typedef2017/jsonpath.php?url=/egs/Trace%20detector%202.put&path=0/params/script/value;
  2. единица измерения (period_unit), например: секунда;
  3. интервал в единицах измерения (period_count), например: 1;
  4. точное время внутри интервала (period_time), например: 00:00:00, 14:30:00;
  5. повторять через интервал или выполнить один раз в указанное время (repeat), например: 0 (бесконечно), 1 (один раз), 100;
  6. задействовать триггер (enabled), например: true;
  7. типы целей, для которых следует генерировать тревожное событие (spawn_alarm_types), например: UndefinedSeaTarget;
  8. типы целей с высшим приоритетом (trace_highest_types), например: ExtraLargeShip, UndefinedSeaTarget;
  9. типы целей с высоким приоритетом (trace_high_types), например: LargeShip;
  10. типы целей с нормальным приоритетом (trace_normal_types), например: SmallShip;
  11. типы целей с низким приоритетом (trace_low_types), например: TinyShip;
  12. типы целей с низшим приоритетом (trace_lowest_types), например: Boat;
  13. максимальное количество секунд с последнего обновления цели (trace_timeout), например: 500;
  14. таймаут на сброс приоритета для целей с наивысшим приоритетом (trace_highest_timeout), например: 300;
  15. таймаут на сброс приоритета для целей с высоким приоритетом (trace_high_timeout), например: 240;
  16. таймаут на сброс приоритета для целей с нормальным приоритетом (trace_normal_timeout), например: 180;
  17. таймаут на сброс приоритета для целей с низким приоритетом (trace_low_timeout), например: 60;
  18. таймаут на сброс приоритета для целей с наинизшим приоритетом (trace_lowest_timeout), например: 20.

Настройку параметров триггера можно выполнить, открыв свойства элемента.

TraceDetector 6.PNG

9. У каждой охраняемой зоны настроить следующие параметры:

  1. географический полигон зоны (area), например: POLYGON((50.22190511 53.2362532,50.22222154 53.23630881,50.22224243 53.23622371,50.2218933105469 53.2361679077148,50.22190511 53.2362532)). Первая и последняя точка в полигоне должны быть идентичными;
  2. высота области (area_heights), например: 121.9 121.6 121.5 121.4. Массив чисел должен быть разделен, используя клавишу Enter, а количество точек должно быть на 1 меньше, чем в полигоне;
  3. приоритет зоны (trace_priority), например: normal.

10. У каждого объекта TraceDetectorSettings настроить следующие параметры:

  1. список типов целей, на которые распространяются данные настройки (types), например: WarShip;
  2. список идентификаторов целей, на которые распространяются данные настройки (guids), например: 385352c9-e5b2-4c92-af47-c2679806a742;
  3. максимальная допустимая скорость (speed_limit), например: 7;
  4. генерировать тревожное или обычное событие по превышению скорости скорости (speed_limit_alarm), например: true;
  5. порог изменения скорости (speed_change_threshold), например: 20;
  6. генерировать тревожное или обычное событие по резкому изменению скорости (speed_change_alarm), например: true;
  7. порог изменения направления (heading_change_threshold), например: 40;
  8. генерировать тревожное или обычное событие по резкому изменению направления (heading_change_alarm), например: true;
  9. порог отсутствия движения (stop_threshold), например: 0.6;
  10. генерировать тревожное или обычное событие по началу или окончанию движения (stop_alarm), например: false;
  11. минимальное допустимое расстояние между целями (approach_threshold), например: 20;
  12. генерировать тревожное или обычное событие по опасному сближению (approach_alarm), например: false.

Если types и guids не содержат элементов, то считается, что данный объект хранит настройки по умолчанию.

Проверка

После запуска скрипта в параметре "Хеш" появится хеш текста скрипта, который должен быть равен тексту по следующей ссылке http://maps.integra-s.com:5434/resources/typedef2017/jsonpath.php?url=/egs/Trace%20detector%202.put&path=0/params/hash/value

Хэш-сумма будет совпадать только в том случае, если скрипт не был изменен.

Алгоритм работы

  1. Типы из параметров триггера trace_highest_types, trace_high_types, trace_normal_types, trace_low_types и trace_lowest_types объединяются в общий список отслеживаемых типов целей.
  2. Bсе типы целей должны быть унаследованы от MoveableObject.
  3. Выбираются все зоны из всех баз, подключенных к серверу.
  4. Перебирает все зоны, у которых параметр trace_priority, установлен в значение, отличное от ignore.
  5. Далее для каждой полученной зоны:
    1. в памяти создается список идентификаторов целей, находящихся в этой зоне в данный момент;
    2. выполняет запрос на сервер getObjectsByPoligon с параметром зоны area, списком отслеживаемых типов целей и параметром триггера trace_timeout;
    3. полученный список идентификаторов целей в зоне сравнивается с сохраненным;
    4. вычисляются цели, вошедшие в зону и вышедшие из нее;
    5. по полученным спискам идентификаторов в базе трекинга находятся цели т.е. объекты типа MoveableObject;
    6. обновляется параметр цели trace_zones, т.е. список идентификаторов зон, в которых в данный момент находится цель;

Дальнейшее выполняется только для целей, приоритет которых отличен от ignore.

    1. в соответствии с параметрами trace_highest_types, trace_high_types, trace_normal_types, trace_low_types и trace_lowest_types проставляется определенный приоритет цели в параметр trace_priority, в том случае если приоритет еще не был проставлен, т.е. в данный момент равен DEFAULT. Автоматическое определение приоритета цели происходит в два этапа: сначала приоритет выбирается при условии точного соответствия типа, а затем с учетом наследования;
    2. генерируются события ZoneEvent, содержащие следующие параметры:
      1. owner - идентификатор зоны;
      2. server - идентификатор сервера трекинга;
      3. position - географическая позиция цели;
      4. detector - идентификатор триггера;
      5. action - действие: enter или exit;
      6. target - идентификатор цели;
      7. target_type - тип цели;
      8. target_info - краткая информация о цели.
  2. На следующем этапе выбираются все цели с приоритетом отличным от ignore и DEFAULT.
    1. По приоритету цели выбирается соответствующий таймаут из параметров trace_highest_timeout, trace_high_timeout, trace_normal_timeout, trace_low_timeout и trace_lowest_timeout.
    2. Если с момента последнего изменения параметра position прошло больше секунд, чем указано в выбранном таймауте, то приоритет этой цели сбрасывается в DEFAULT.
  3. На последнем этапе выбираются все цели входящие в какие-либо охраняемые зоны и имеющие приоритет отличный от ignore.
    1. Если модуль скорости цели (параметр speed) меньше, чем stop_threshold и цель находится в движении, то генерируется событие ZoneEvent (с параметром alarm = stop_alarm) с параметром action равным stop.
    2. Если модуль скорости цели (параметр speed) больше, чем stop_threshold и цель не находится в движении, то генерируется событие ZoneEvent (с параметром alarm = stop_alarm) с параметром action равным start.
    3. Если скорость цели (параметр speed) больше чем speed_limit, то генерируется событие ZoneEvent (с параметром alarm = speed_limit_alarm) с параметром action равным too_fast. В случае прекращения превышения скорости генерируется событие с параметром action равным not_too_fast.
    4. Если разница между скоростью цели (параметр speed) и ее предыдущим значением больше, чем speed_change_threshold, то генерируется событие ZoneEvent (с параметром alarm = speed_change_alarm) с параметром action равным severe_speed_change.
    5. Если разница между направлением цели (параметр heading) и ее предыдущим значением больше, чем heading_change_threshold, то генерируется событие ZoneEvent (с параметром alarm = heading_change_alarm) с параметром action равным severe_heading_change.
    6. Если расстояние между выбранной целью и какой-либо другой целью в той же зоне меньше approach_threshold, то генерируется событие ZoneEvent (с параметром alarm = approach_alarm) с параметром action равным dangerous_approach и параметром participants, содержащим список идентификаторов, целей находящихся в опасной близости. В случае прекращения опасного сближения генерируется событие с параметром action равным no_dangerous_approach.

Пример работы

Для построения схемы необходимо:

1. Создать схему по выше описанному алгоритму (см. Построение схемы).

TraceDetector 3.PNG

2. Добавить элементы Зона и Мужчина.

TraceDetector 7.PNG

3. Настроить параметр "Сетевой адрес" компьютера.

4. Настроить следующие параметры триггера:

  1. единица измерения (period_unit): секунда;
  2. интервал в единицах измерения (period_count): 1;
  3. повторять через интервал или выполнить один раз в указанное время (repeat): 0;
  4. задействовать триггер (enabled): true;
  5. в настройках:
    1. типы целей, для которых следует генерировать тревожное событие ZoneAlarm (spawn_alarm_types): UndefinedSeaTarget;
    2. типы целей, для которых следует генерировать нормальное событие ZoneEvent (spawn_event_types): ExtraLargeShip;
    3. типы целей с высшим приоритетом (trace_highest_types): ExtraLargeShip;
    4. типы целей с высоким приоритетом (trace_high_types): LargeShip;
    5. типы целей с нормальным приоритетом (trace_normal_types): Human;
    6. типы целей с низким приоритетом (trace_low_types): TinyShip;
    7. типы целей с низшим приоритетом (trace_lowest_types): Boat;
    8. максимальное количество секунд с последнего обновления цели (trace_timeout): 500;

5. Настроить следующие параметры Зоны:

  1. область (area): POLYGON((50.22228403 53.2363014,50.2224350 53.23636588,50.2224236 53.2362976,50.22228403 53.2363014));
  2. приоритет зоны (trace_priority), например: normal.

Далее необходимо запустить скрипт "Симулятор движения (Position Simulator 1)", описание которого приведено на странице Симулятор движения (Position simulator 1), и настроить в свойствах триггера параметр: данные о движении объекта (settings.input): 50.22196217,53.23618268,0 50.22209225,53.23620757,0 50.22223978,53.23623004,0 50.22231622,53.23626456,0 50.22236718,53.23632315,0 50.22231085,53.23636007,0 50.22219015,53.23638496,0 50.22204666,53.23636007,0 50.22187902,53.23633359,0 50.22184013,53.23623807,0. Элемент в Position Simulator 1 и в Trace detector 1 должен быть одним и тем же.

Результат:

У объекта Мужчина в параметр зона слежения (trace_zones) будет установлена зона, в которой в данный момент находится цель.

Дополнения

1. В пункте 1 раздела Построение схемы добавление триггера EgsScheduledTraceDetector можно осуществить по ссылке.

Для этого необходимо:

1. Импортировать скрипт по следующей ссылке: http://maps.integra-s.com:5434/resources/typedef2017/egs/Trace%20detector%202.put.
2. Выбрать пункт главного меню "Файл". После этого выбрать "Импорт элементов".
Scheduled com 1.png
3. В открывшемся окне выбрать импортированный скрипт "Trace detector 1.put".
TraceDetector 1.PNG
Элемент появится на рабочей области.
Scheduled com 3.png

2. В пункте 7 раздела Построение схемы редактирование параметров элемента можно осуществить, выделив элемент правой кнопкой мыши и в контекстном меню выбрав пункт "Редактировать параметры".

TraceDetector 4.png
После этого откроется окно для редактирования параметров.
TraceDetector 5.PNG
Источник — «http://wiki.integra-s.com:11111/index.php?title=Детектор_вхождения_целей_в_зоны_(Trace_detector_1)&oldid=7605»