The Detect Incidents tool evaluates features against a set of opening conditions and optional closing conditions and creates a unique incident for each continuous set of observations that satisfy the conditions.
- Each vehicle in a fleet sends its location and current speed at regular intervals. If a vehicle's reported speed exceeds the posted speed limit for the location indicated, Detect Incidents opens an incident. For each subsequent observation reported by the vehicle, if its current speed continues to exceed the speed limit, the incident is maintained in an open state. When the vehicle reports its speed within the posted speed limit, the incident is closed.
- A pressure sensor on a pipeline reporting the current measured pressure at a valve indicates a pressure out of normal operating range. Detect Incident opens an incident and continues to report an open incident each time the sensor indicates the pressure is out of normal range. When the pressure returns to normal, the incident is closed.
- A convoy of trucks is approaching a tunnel where vehicles carrying hazardous materials are prohibited. Each vehicle reports its location and ArcGIS Analytics for IoT enriches the incoming information for each vehicles based on the current manifest of its cargo. One of the trucks is carrying oxidizers which are considered hazardous. Detect Incidents opens an incident based on the truck's proximity to the tunnel and its current cargo attributes. When the truck detours away from the tunnel the incident is closed.
- An Open Condition is required, however a Close Condition is optional. If a closing condition is not explicitly set, the logical NOT of the opening condition is implicitly used as the closing condition.
- The tool has two inputs, however the Join Layer is only required if utilizing spatial relationships for the opening or closing conditions.
- Open Condition and Close Condition are specified using Arcade expressions. For an overview of Arcade expressions and functions supported, see the ArcGIS Arcade documentation.
The features for which incidents will be detected using open and close conditions.
Join Layer (optional)
You can optionally choose which dataset to process a spatial relationship with as part of an opening or closing condition.
The set of conditions that define the start of an incident. This can include a spatial condition, a time range, and a set of attribute expressions.
Close Condition (optional)
The set of conditions that define the end of an incident. Like Open Condition, this can include a spatial condition, a time range, and a set of attribute expressions.
Return Incidents Only
Whether to return only observations that relate to an incident (Yes) or all observations (No).
Choose the field(s) to uniquely identify features that will be processed. This parameter will be auto-populated if a TRACK_ID key field is set on the input layer.
The output layer will have the schema of the incoming features and will be enriched with the fields below.
|Field Name||Description||Field Type|
The unique identifier for the incident.
The current status of the incident including Started and Ended.
The number of seconds the incident was open.