检测事件

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

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

工作流示意图

示例

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

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

用法说明

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

• 开启条件参数为必填项；但是，关闭条件参数为可选项。 如果未显式设置关闭条件，则开启条件的逻辑非 (NOT) 将隐式用作关闭条件。 但上述情况有一个例外，即如果空间关系的值设置为进入或退出，则隐式关闭条件值分别为退出或进入。
• 在实时分析中，如果空间关系的值设置为进入或退出，则对于开启条件或关闭条件参数，该工具将以全状态方式运行。 由此能够将连续观测点相互比较以检测状态变化；例如，当前条件是否与上一观测点不同。 通过实时分析中的其他空间关系，该工具无需将任何观测点与先前的观测点进行比较，因此它可以以无状态方式运行，从而减少资源消耗。
• 当以全状态方式运行时，“检测事件”工具将为每个追踪 ID 保留当前观测点的状态存储。 当接收到新的观测点时，将会对其与相同追踪 ID（如果存在）的当前观测点进行比较。 如果新观测点的时间戳比状态存储中当前观测点的时间戳更新，则将替换当前观测点。 如果新观测点的时间戳与相同追踪 ID 的当前观测点的时间戳相同，则该工具无法区分这两个观测点。 这意味着该工具不会将状态存储中的当前观测点替换为新观测点，也不会将新观测点添加至状态存储，并且将对此追踪 ID 的未来观测点与保留在状态存储中的当前观测点进行比较，直到具有较晚时间戳的新观测点到达为止。 当出现这种情况时，该工具将记录警告。
• 该工具具有两个输入；但是，仅当针对开启条件或关闭条件参数选择空间关系时，才需要连接图层参数。
• 可以使用 Arcade 表达式指定开启条件和关闭条件参数。 有关 Arcade 表达式和受支持函数的概览，请参阅 ArcGIS Arcade 文档。
• 在实时分析中，如果将到期时关闭参数设置为是，则当针对目标时间窗设置的时间到期时，将关闭所有打开事件。 如果设置为否，则将丢弃所有打开事件。
• 对于开启条件参数，如果选择空间关系并使用进入或退出空间运算符，则当选中初次观测可以触发进入或初次观测可以触发退出复选框时，对于进入，当针对每个追踪 ID 接收或处理的第一个目标要素位于连接要素内时，可以打开事件；对于退出，当针对每个追踪 ID 接收或处理的第一个目标要素位于所有连接要素外时，可以打开事件（无论是否存在可以与当前目标要素的位置进行比较的先前目标要素）。 默认情况下取消选中该项。
• 在实时分析中，目标时间窗参数值至少应与给定追踪的观测点之间的最长预期间隔相同。 将从内存中移除早于此持续时间的观测点以管理资源。
• 为输出事件计算的 IncidentDuration 值以毫秒为单位。
• 如果源连接到连接端口，则系统将根据目标源和连接源中不断变化的要素动态完成事件检测。
• 如果执行动态地理围栏，则必须设置连接时间窗参数。 如果连接源没有标记为 End Time 关键字段的字段，并且连接要素的最后已知观测点早于此时间窗，则系统会将其从工具的内存中清除，且不会将其包含在分析中。 如果连接源具有标记为 End Time 关键字段的字段，则该要素将根据标记为 End Time 的字段中的值或在连接时间窗关闭时（以先到的时间为准）从地理围栏存储中老化。
• 如果正在执行动态地理围栏，Arcade 表达式仅适用于目标要素。

参数

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

参数	描述	数据类型
输入图层	使用开启和关闭条件检测事件的要素。	要素
连接图层（可选）	可以选择将空间关系作为开启或关闭条件的一部分处理的数据集。	要素
开启条件	一组用于定义事件开始的条件。 该参数可以包括空间条件、时间范围和一组属性表达式。 空间关系 - 指定用于对目标要素进行空间过滤的条件。 仅当数据集已连接到 join 端口时，才会显示此参数。 空间运算符包括不相交、进入、等于、退出、邻近测地线、邻近平面、接触和位于。 初次观测可以触发进入和初次观测可以触发退出 - 如果选择进入或退出作为空间关系，则将被启用，表示对于进入，当接收的第一个目标要素位于连接要素内时，可以打开事件；对于退出，当接收的第一个目标要素位于所有连接要素外时，可以打开事件（无论是否存在可以与当前目标要素的位置进行比较的先前目标要素）。 默认值为 false（未选中）。 连接字段（仅适用于实时分析）- 在连接图层中指定要添加到目标要素的字段。 例如，如果选择 TUNNEL_ID 字段作为连接字段，则输出方案将包含 TUNNEL_ID 字段及其值。 如果在隧道处检测到的事件 TUNNEL_ID 值为 10，则此值会添加到目标要素中的字段。 如果指定了具有相关空间要素的关闭条件，则字段和值也会连接到目标要素。 如果指定了任何连接字段来使用不相交空间关系从相关空间要素丰富数据，则字段值将设置为空。 表达式 - 将进行评估以过滤传入数据的属性表达式。 可以使用 Arcade 表达式指定属性表达式。 匹配所有开启条件 - 是否必须同时满足空间、时间和属性条件才能打开事件。 如果选择否，则满足任何一个条件即可打开事件。 注： 如果已指定不相交或出口且存在多个连接要素，则目标要素必须满足其与所有连接要素的空间关系。 对于任何其他空间关系，如果存在多个连接要素，则目标要素可以满足其与任一连接要素的空间关系。	参数
关闭条件（可选）	一组用于定义事件结束的条件。 与开启条件类似，该参数可以包括空间条件、时间范围和一组属性表达式。 空间关系 - 定义用于对目标要素进行空间过滤的条件。 仅当数据集已连接到 join 端口时，才会显示此参数。 空间运算符包括不相交、进入、等于、退出、邻近测地线、邻近平面、接触和位于。 表达式 - 将进行评估以过滤传入数据的属性表达式。 可以使用 Arcade 表达式指定属性表达式。 匹配所有开启条件 - 是否必须同时满足空间、时间和属性条件才能打开事件。 如果选择否，则满足任何一个条件即可打开事件。 注： 如果已指定不相交或出口且存在多个连接要素，则目标要素必须满足其与所有连接要素的空间关系。 对于任何其他空间关系，如果存在多个连接要素，则目标要素可以满足其与任一连接要素的空间关系。	参数
仅返回事件	仅返回与一个事件相关的观测点（是）或返回所有观测点（否）。	布尔
TRACK_ID 字段（仅限大数据分析）	选择字段以唯一标识将要处理的要素。 如果在输入图层上设置 Track ID 关键字段，则将自动填充此参数。	字段
目标时间窗（仅限实时分析）	将时间窗设置为至少与任意给定轨迹两次观测之间的最长预期间隔相同。 将从内存中移除早于此持续时间的观测点以管理资源。	字符串
连接时间窗（仅限实时分析）	连接源的时间窗（动态地理围栏）。 如果连接要素的最后一个已知观察值早于指定的时间窗，它将被清除并且不会包含在分析中。 如果连接源具有标记为 End Time 的字段，则此参数为可选参数。	字符串
到期时关闭（仅限实时分析）	如果设置为是，则当为目标时间窗设置的时间到期时，将关闭所有打开事件。 如果设置为否，则将丢弃所有打开事件。	布尔

输出图层

输出图层将具有传入要素的方案，并将使用以下字段进行丰富。

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