Процессор Построитель симметричной разницы используется для обрезания или удаления пересекающейся части геометрии записи события и геозоны из объединения двух геометрий. Симметричной разницей двух геометрий является по существу эксклюзивное выражение OR.
Пример
Используйте процессор Построитель симметричной разницы для объединения и вырезания области торнадо и области интереса. Когда торнадо перемещается по области интереса, районы, непосредственно затронутые им, могут быть вырезаны и удалены. Оставшиеся части могут использоваться для отображения районов, не затронутых торнадо напрямую.
Примечания по использованию
При работе с процессором Построитель симметричной разницы имейте в виду следующее:
- Для процессора Построитель симметричной разницы необходимо задать две дискретные геометрии. Например, нельзя использовать регулярные выражения для задания нескольких различных геозон, чтобы получить симметричную разницу для набора геометрий.
- Процессору требуется геометрия одного типа. Например, симметричная разница между точкой и полилинией, как объединением двух, не может быть вычислена.
- Этот процессор требует поле, содержащее заданную геометрию записи события. Для идентификации поля геометрии можно задать имя поля геометрии или поле с тегом GEOMETRY в определении GeoEvent.
- Параметр Поле геометрии отображает имена всех полей из каждого определения GeoEvent, в которых содержится тип данных геометрии. При выборе поля геометрии по имени выберите имя правильного поля геометрии, которое соответствует определению GeoEvent записи события.
- Процессор может быть настроен на замену геометрии записи события вычисленной симметричной разницей или на размещение геометрии симметричной разницы в новом поле геометрии с помощью параметра Заменить геометрию. Добавление нового поля в запись события изменяет схему записи события, что требует от GeoEvent Server создания нового определения GeoEvent. Новое определение GeoEvent будет управляться GeoEvent Server и будет удалено, если изменения вносятся в процессор или в сервис GeoEvent, в котором используется процессор.
- Выбор значения Да для параметра Пометить новое поле геометрии как Geometry явно указывает GeoEvent Server, какое поле геометрии следует рассматривать как реализованную геометрию записи события для последующей обработки или выхода.
Параметры
Ниже приведены параметры процессора Построитель симметричной разницы:
| Параметр | Описание |
|---|---|
|
Имя |
Описательное имя процессора, используемое для справочной информации в GeoEvent Manager. |
|
Процессор |
Указывает выбранный процессор. |
| Поле геометрии | Имя поля геометрии или поля с тегом GEOMETRY из записи входящего события, которое процессор использует для вычисления симметричной разности с пересекающейся геозоной. |
| Заменить геометрию | Указывает, следует ли заменить текущую геометрию записи события симметричной разностью записи события и геометрией геозоны. По умолчанию – Да.
|
| Новое имя поля геометрии (Условия) | Имя нового поля геометрии, в котором будет сохранена геометрия вычисленной симметричной разности. Этот параметр отображается, если для параметра Заменить геометрию задано значение Нет, и скрывается, если задано значение Да. |
| Пометить поле новой геометрии как Geometry (Условия) | Определяет, будет ли новое поле геометрии, созданное процессором, помечено тегом GEOMETRY. Тег GEOMETRY используется GeoEvent Server для идентификации действительной геометрии записи события при наличии нескольких полей геометрии. По умолчанию Нет. Этот параметр отображается, если для параметра Заменить геометрию задано значение Нет, и скрывается, если задано значение Да. |
| Имя нового определения GeoEvent (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Новое Определение GeoEvent будет сочетать в себе схему записи входного события и поле новой геометрии. Этот параметр отображается, если для параметра Заменить геометрию задано значение Нет, и скрывается, если задано значение Да. |
| Геозона | Категория и название геозоны, зарегистрированной в GeoEvent Server. Процессор использует геозону для вычисления симметричной разности с геометрией записи пересекающегося события. Результирующая геометрия представляет собой участок за пределами пересечения с обрезанной (или удаленной) пересекающейся областью. Требуется формат category/name, заданный в виде пары образцов регулярных выражений. Например, Pavilions/Alpha использует геозону Alpha в категории Pavilions с геометрией записи события. Примечание:Несколько выражений геозоны category/name не могут быть объединены в список при помощи запятых. Например, задание Countries/France, Countries/Germany не может использоваться для указания геозон France или Germany. Примечание:Для категорий и для названий используются регулярные выражения. Поскольку выражение .*/.* включает все геозоны во всех категориях, а этот процессор работает только с двумя геозонами, этот шаблон вряд ли будет использоваться. Помните, что совпадения с шаблоном регулярных выражений чувствительны к регистру. |
Советы и ограничения
Перед отправкой данных события в сервис объектов рекомендуется заменить существующую геометрию записи события геометрией, представляющей симметричную разность. Сервисы объектов поддерживают только одно поле типа геометрии, поэтому любое поле, не помеченное как GEOMETRY, будет преобразовано и сохранено в виде строки.