检测事件

实时和大数据分析中的可用。

检测事件工具 将使用一组开启条件和可选的关闭条件来评估要素，并为满足条件的每组连续观测值创建唯一事件。

工作流示意图

示例

以下是检测事件工具的用例：

• 车队中的每辆车均会定期发送其位置和速度。 如果车辆的报告速度超出指示位置的已提交速度限值，则检测事件工具将打开一个事件。 对于车辆报告的每个后续观测值，如果其速度继续超出速度限值，则事件将保持为进行中状态。 当车辆报告的速度位于提交的速度限制范围内时，该事件随即关闭。
• 管道上的压力传感器可报告当前在阀处测量的压力，从而指示压力超出正常工作范围。 “检测事件”在传感器指示压力超出正常范围时开启一个事件，并且该事件会保持为进行中状态，直到压力恢复正常。 当压力恢复正常时，事件随即关闭。
• 卡车车队正在接近禁止运送危险材料的车辆通行的隧道。 每辆车均会报告其位置，并且 ArcGIS Velocity 会根据货物的当前清单更新每辆车的传入信息。 其中一辆卡车装载有被视为危险品的氧化剂。 将根据卡车与隧道的接近度及其货物属性来打开一个事件。 当卡车绕开隧道行驶时，事件将会关闭。
• 分配给指定路径区域的配送车辆在一段时间中行驶至该区域之外。 当车辆退出指定区域时，将打开一个事件；当车辆重新进入该区域时，将关闭该事件。

用法说明

使用检测事件工具时，请谨记以下信息：

• 开启条件参数为必填项；而关闭条件参数为可选项。 如果未明确设置关闭条件，则将使用开启条件的 NOT 逻辑运算符作为关闭条件。
  • 如果空间关系选项设置为相交，则隐式关闭条件为不相交。
  • 如果空间关系选项设置为进入或退出，则隐式关闭条件值分别为退出或进入。
• 在实时分析中，当进入或退出被用作开启条件或关闭条件的空间关系时，工具会以有状态方式操作。 在有状态模式下，工具可以比较连续观测点，检测观测点之间状态的变化。 当使用其他空间关系选项时，工具将以无状态模式运行，因为不需要比较当前观测点和前一个观测点。 无状态模式消耗的资源要少得多。
• 当以全状态方式运行时，检测事件工具将为每个追踪 ID 保留当前观测点的状态存储。 当接收到新的观测点时，将会对其与相同追踪 ID（如果存在）的当前观测点进行比较。 如果新观测点的时间戳比状态存储中当前观测点的时间戳更新，则将替换当前观测点。 如果新观测点的时间戳与相同追踪 ID 的当前观测点的时间戳相同，则该工具无法区分这两个观测点。 这意味着该工具不会将状态存储中的当前观测点替换为新观测点，也不会将新观测点添加至状态存储，并且将对此追踪 ID 的未来观测点与保留在状态存储中的当前观测点进行比较，直到具有较晚时间戳的新观测点到达为止。 当发生这种情况时，工具会记录警告。
• 该工具具有两个输入；但是，仅当针对开启条件或关闭条件参数选择空间关系时，才可用连接数据参数。
• 可以为开启条件或关闭条件参数配置 Arcade 表达式。
• 在实时分析中，如果将到期时关闭参数设置为是，则当针对目标时间窗设置的时间到期时，将关闭所有打开事件。 如果设置为否，任何已开启的事件将保持开启状态。 如果设置的目标时间窗过期，如果开启条件参数中的空间关系或属性表达式符合要求，则会创建一个新事件。
• 对于开启条件参数，如果选择空间关系并使用进入或退出空间运算符，则当选中初次观测可以触发进入或初次观测可以触发退出复选框时，对于进入，当针对每个追踪 ID 接收或处理的第一个目标要素位于连接要素内时，可以打开事件；对于退出，当针对每个追踪 ID 接收或处理的第一个目标要素位于所有连接要素外时，可以打开事件（无论是否存在可以与当前目标要素的位置进行比较的先前目标要素）。 默认情况下取消选中该项。
• 在实时分析中，目标时间窗参数应设置为事件应保持开启的最长时间，或者更长。 将从内存中删除早于此持续时间的观测点来管理资源。 建议将该值设置为比最长预期事件持续时间更长。 例如，如果事件的最长预计持续时间为 20 小时，则可以将该值设置为 24 小时，确保事件不会过早关闭。
• 为输出事件计算的 IncidentDuration 值以毫秒为单位。
• 如果源连接到连接端口，则系统将根据目标源和连接源中不断变化的要素进行事件检测。
• 如果执行动态地理围栏，则必须设置连接时间窗参数。 如果连接源没有为结束时间选项指定关键字段，并且连接要素的最后已知观测点早于此窗口，则该观测点会从工具的内存中删除并排除在分析之外。 如果连接源为结束时间选项指定了关键字段，则该要素会根据字段中的结束时间或在连接时间窗结束时过期，以先到者为准。
• 如果正在执行动态地理围栏，Arcade 表达式仅适用于目标要素。
• 以下表格列出了根据输入和连接几何类型，支持的空间关系方法包括：

输入和连接几何类型	包含	交叉	Disjoint	Enter	Equals	退出	相交	邻近测地线	邻近平面	重叠	Touches	位于
点和点
点和折线
点和面
折线和点
折线和折线
折线和面
面和点
面和折线
面和面

参数

以下是检测事件工具的参数：

参数	描述	数据类型
目标数据	用于根据开启条件和关闭条件参数检测事件的数据。	要素
连接数据（可选）	用于与开启条件或关闭条件参数中的空间关系结合的数据。	要素
开启条件	一组用于定义事件开始的条件。 该参数可以包括空间条件、时间范围和一组属性表达式。 时间范围（仅适用于大数据分析）- 指定用于检测事件的时间范围。 空间关系 - 指定用于空间检测事件的条件。 仅当数据集已连接到 join 端口时，才会显示此选项。 空间运算符包括： 不相交：如果一个几何与另一个几何不相交。 进入：如果一个几何进入另一个几何的空间。 相等：如果基础几何和比较几何的形状类型相同。 退出：如果一个几何移出另一个几何占据的空间。 邻近测地线：如果一个几何与另一个几何的某个折点或边缘在给定的地理距离内接近。 邻近平面：如果一个几何与另一个几何的某个折点或边缘在给定的平面距离内接近。 接触：如果一个几何触及另一个几何，它们有交叉的折点，但几何没有重叠。 包含：如果一个几何包含另一个几何。 交叉：如果两个几何相交于较小形状类型的几何。 相交：如果一个几何与另一个几何相交。 重叠：如果一个几何与另一个几何重叠。 无：如果两个几何之间没有空间关系。 范围内：如果一个几何完全位于另一个几何内。 初次观测可以触发进入/退出 - 此选项仅在选择了进入或退出作为空间关系时可用。 这表示，即使没有之前的目标要素用于比较当前目标要素的位置，接收到的第一个目标要素仍然可以触发事件。 对于进入，如果目标要素位于任何连接要素内，事件将被触发。 对于退出，如果目标要素位于任何连接要素外，事件将被触发。 默认情况下，此选项未勾选。 连接字段（可选）（仅适用于实时分析）- 在连接要素中指定要添加到目标要素的字段。 选择作为连接字段的字段会出现在输出方案中。 如果使用不相交空间关系，则字段值设置为 null。 Arcade 表达式 - 一个属性表达式，用于设置检测事件的条件。 匹配所有开启条件 - 如果选择是，则必须同时满足空间、时间和属性条件才能开启事件。 如果选择否，则满足任何一个条件即可开启事件。 注： 当使用不相交或退出作为开启条件参数的空间关系时，目标要素必须与来自连接数据参数源的任何要素完全不相交，才能开启事件。 对于其他所有空间关系选项，只要目标要素与来自连接数据参数源的任何一个要素满足空间关系，即可开启事件。	参数
关闭条件（可选）	一组用于定义事件结束的条件。 与开启条件参数类似，该参数可以包括空间条件、时间范围和一组属性表达式。 时间范围（仅适用于大数据分析）- 指定用于检测事件的时间范围。 空间关系 - 定义用于对目标要素进行空间过滤的条件。 仅当数据集已连接到 join 端口时，才会显示此参数。 空间运算符包括 不相交：如果一个几何与另一个几何不相交。 进入：如果一个几何进入另一个几何的空间。 相等：如果基础几何和比较几何的形状类型相同。 退出：如果一个几何移出另一个几何占据的空间。 邻近测地线：如果一个几何与另一个几何的某个折点或边缘在给定的地理距离内接近。 邻近平面：如果一个几何与另一个几何的某个折点或边缘在给定的平面距离内接近。 接触：如果一个几何触及另一个几何，它们有交叉的折点，但几何没有重叠。 包含：如果一个几何包含另一个几何。 交叉：如果两个几何相交于较小形状类型的几何。 相交：如果一个几何与另一个几何相交。 重叠：如果一个几何与另一个几何重叠。 无：如果两个几何之间没有空间关系。 范围内：如果一个几何完全位于另一个几何内。 Arcade 表达式 - 用于评估属性表达式，检测事件。 匹配所有关闭条件 - 如果选择是，则必须同时满足空间、时间和属性条件才能关闭事件。 如果选择否，则满足任何一个条件即可关闭事件。 注： 当使用不相交或退出作为关闭条件参数的空间关系时，目标要素必须与来自连接数据参数源的任何要素完全不相交，才能开启事件。 对于其他所有空间关系选项，只要目标要素与来自连接数据参数源的任何一个要素满足空间关系，即可开启事件。	参数
仅返回事件	如果选择是，则返回仅与事件相关的观测点。 如果选择否，则返回所有观测点。	布尔
追踪	用于唯一标识将要处理的要素的字段。 如果目标要素图层指定了追踪 ID 字段，则会自动设置追踪 ID 值。	字段
目标时间窗（仅限实时分析）	将从内存中删除早于此持续时间的观测点来管理资源。 该值应设置为事件应保持开启的最长持续时间或更长。 建议将该值设置为比最长预期事件持续时间更长。	字符串
连接时间窗（仅限实时分析）	连接源的时间窗（动态地理围栏）。 如果连接要素的最后一个已知观测点早于指定的时间窗，则其将被删除并且不会包含在分析中。 如果连接源中指定了结束时间选项的关键字段，则此参数为可选。 注： 此参数仅在目标和连接图层均为数据源时可用。	字符串
到期时关闭（仅限实时分析）	如果选择是，则当目标时间窗值到期时，将关闭所有打开事件。 如果选择否，则当目标时间窗值到期时，打开的事件仍将保持开启状态。 当目标时间窗值过期时，如果空间关系或属性表达式满足条件，将创建一个新的事件。	布尔

输出图层

输出图层包含输入要素的方案，以及以下字段：

字段名	描述	字段类型
IncidentId	事件的唯一标识符。	字符串
IncidentStatus	事件的当前状态。 状态为已开始、进行中或已结束。	字符串
IncidentDuration	事件已处于打开状态的毫秒数。	整型