对称差集创建器处理器用于从两个几何的并集中裁剪或移除事件记录几何与地理围栏的相交部分。 两个几何的对称差集实质上是一种排他式的 OR 语句。
示例
使用对称差集创建器处理器来合并和裁剪龙卷风和感兴趣区域的相交区域。 当龙卷风在整个区域中移动时，可以将其直接影响的区域剪掉并从区域中移出。 该区域的其余部分可用于显示不受龙卷风直接影响的区域。
用法说明
使用对称差集创建器处理器时，请记住以下事项：
- 对称差创建器处理器需要指定两个离散几何。 例如，无法使用正则表达式指定若干个不同的地理围栏以获得几何集合的对称差集。
- 该处理器要求这些几何为同一类型。 例如，无法将点和折线的对称差集计算成两个几何的并集。
- 处理器需要指定包含事件记录几何的字段。 可以指定几何字段名称，也可以使用 GeoEvent 定义中标记了 GEOMETRY 标签的字段识别几何字段。
- 几何字段参数将显示具有几何数据类型的每个 GeoEvent 定义中每个字段的名称。 按名称选择几何字段时，请选择与事件记录的 GeoEvent 定义相对应的正确几何字段的名称。
- 可以对处理器进行配置以将事件记录的几何替换为计算的对称差集，或者使用替换几何参数将计算的对称差集放入新几何字段中。 向事件记录添加新字段将更改事件记录的方案，这需要 GeoEvent Server 创建一个新的 GeoEvent 定义。 新的 GeoEvent 定义将由 GeoEvent Server 管理，并且如果处理器或者使用该处理器的 GeoEvent 服务发生改变，则该定义将被删除。
- 对于将新几何字段标记为几何参数，选择是将明确告知 GeoEvent Server 应视为事件记录已实现几何的几何字段，以用于后续处理或输出。
参数
以下是对称差集创建器处理器的参数：
| 参数 | 描述 |
|---|---|
|
名称 |
用于在 GeoEvent Manager 中引用的处理器的描述性名称。 |
|
处理器 |
指定所选的处理器。 |
| 几何字段 | 几何字段的名称或入站事件记录中标记 GEOMETRY 标签的字段，处理器将使用这些字段计算与相交地理围栏的对称差集。 |
| 替换几何 | 用于指定是否将当前事件记录几何替换为事件记录和地理围栏几何的对称差集。 默认为是。
|
| 新几何字段名称 （条件分析） | 将存储计算的对称差集几何的新几何字段的名称。 此参数在替换几何设置为否时显示，设置为是时隐藏。 |
| 将新几何字段标记为几何 （条件分析） | 指定是否将处理器创建的新几何字段使用 GEOMETRY 标签标记。 如果存在多个几何字段，则 GeoEvent Server 将使用 GEOMETRY 标签来标识事件记录的已实现几何。 默认为否。 此参数在替换几何设置为否时显示，设置为是时隐藏。 |
| 新建 GeoEvent 定义名称 （条件分析） | 分配给新 GeoEvent 定义的名称。 新 GeoEvent 定义将对入站事件记录的方案和新几何字段进行组合。 此参数在替换几何设置为否时显示，设置为是时隐藏。 |
| 地理围栏 | 注册到 GeoEvent Server 的地理围栏的类别和名称 处理器将使用地理围栏来计算具有相交事件记录几何的对称差集。 生成的几何图形是相交区域外的部分（其中相交部分已裁剪掉或移除）。 所需格式为 category/name，以一对正则表达式模式指定。 例如，Pavilions/Alpha 使用在 Pavilions 类别中具有事件记录几何的地理围栏 Alpha。 注：不能将多个地理围栏 category/name 表达式指定为逗号分隔列表。 例如，指定 Countries/France, Countries/Germany 不能用于指定地理围栏 France 或 Germany。 注：类别和名称均使用正则表达式。 由于该表达式 .*/.* 包括所有类别中的所有地理围栏，并且该处理器仅适用于两个地理围栏，因此不太可能使用此模式。 请注意，正则表达式模式匹配区分大小写。 |
注意事项和限制
将事件数据发送到要素服务之前，请考虑将现有事件记录几何替换为表示对称差集的几何。 要素服务仅支持一个几何类型字段，因此，将对未标记 GEOMETRY 标签的字段进行转换并将其保存为字符串。