Детектор вхождения целей в зоны (Trace detector 1)

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

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

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

Зависимости

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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. Типы из параметров триггера spawn_alarm_types, spawn_event_types, trace_highest_types, trace_high_types, trace_normal_types, trace_low_types и trace_lowest_types объединяются в общий список отслеживаемых типов целей.
2. Bсе типы целей должны быть унаследованы от MoveableObject.
3. Выбираются все зоны из всех баз, подключенных к серверу.
4. Перебирает все зоны, у которых параметр trace_priority, установлен в значение, отличное от DEFAULT.
5. Далее для каждой полученной зоны:
   1. в памяти создается список идентификаторов целей, находящихся в этой зоне в данный момент;
   2. выполняет запрос на сервер getObjectsByPoligon с параметром зоны area, списком отслеживаемых типов целей и параметром триггера trace_timeout;
   3. полученный список идентификаторов целей в зоне сравнивается с сохраненным;
   4. вычисляются цели, вошедшие в зону и вышедшие из нее;
   5. по полученным спискам идентификаторов в базе трекинга находятся цели т.е. объекты типа MoveableObject;
   6. обновляется параметр цели trace_zones, т.е. список идентификаторов зон, в которых в данный момент находится цель;
   7. в соответствии с параметрами trace_highest_types, trace_high_types, trace_normal_types, trace_low_types и trace_lowest_types проставляется определенный приоритет цели в параметр trace_priority;
   8. в соответствии с параметрами spawn_alarm_types и spawn_event_types генерируются события ZoneAlarm или ZoneEvent, содержащие следующие параметры:
      1. owner - идентификатор зоны;
      2. server - идентификатор сервера трекинга;
      3. position - географическая позиция цели;
      4. detector - идентификатор триггера;
      5. action - действие: enter или exit;
      6. target - идентификатор цели;
      7. target_type - тип цели;
      8. target_info - краткая информация о цели.

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

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

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

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

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. Выбрать пункт главного меню "Файл". После этого выбрать "Импорт элементов".

3. В открывшемся окне выбрать импортированный скрипт "Trace detector 1.put".

Элемент появится на рабочей области.

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

После этого откроется окно для редактирования параметров.