Skip to content

Hazardous Area Detection

Hazardous Area is a query that detects people entering a zone. The query can be configured with an optional condition, to alert only if an additional object - such as a vehicle - is also present in the observed area.

Tip

Make sure to draw a zone of interest (ROI) on the video frame - otherwise, the enire video frame will be considered as a hazardous area.

Prerequisites

Setup

  1. Select a video from your workspace Click +Set up New Query.

  2. Select Hazardous Area Detection from the list of query types.

1. Query Name

Give your query a name to better identify it. A description can also be added (optional).

2. Object Detection Filter

Videos

The thumbnail image of the previously chosen video is displayed here.

Time interval

Time interval

Select a time frame for the analytics to run, depending on the type of video selected:

  • Earliest: Run the query from the time shown (set during video registration as the beginning timestamp of the video).
  • Latest: Run the query until the time shown (set during video registration as the end timestamp of the video).
  • Given Date: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Live: Analysis is run live, continously.
  • Interval: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Set interval to: Choose from the presets below to run the query on a given time inmterval.
  • Minimum confidence (0.5 by default): The minimum confidence level required for an object to be detected. The higher the confidence level, the more certain the system is that the object is of the selected type. The confidence level ranges from 0 to 1, with 1 being the highest confidence level.

ROI (Region of Interest)

Draw a region of interest (ROI) on the video frame. The query will trigger an alert if a person enters the zone, otherwise the entire video frame will be considered as a hazardous area.

Left-click on the video frame to draw a polygon. Left-click again on the video frame to keep adding points to the polygon; double-click to finish drawing.

  • Minimum track duration(in milliseconds): The minimum time objects need to be in the zone to trigger an alert. If the time duration of the track is less than the min track duration parameter, the query will not trigger an alert. If set to 0, the query will trigger an alert immediately once the object enters the area.

  • After out of zone fire again: If ticked, the query will trigger an additional alert if the person leaves the area.

  • Use bottom reference point: Choose either the center or the bottom of the bounding box as a reference point to determine whether the object is within the ROI.

  • Maximum number of parallel tracks at the same time (50 by default): The maximum number of tracks that can be processed simultaneously. Increasing this number may improve the accuracy of the results but also the processing time.

3. Optional Condition

If enabled, Hazardous area will trigger an alert only if an additional object (either Airplane, Boat, Bus, Car, Motorcicyle, Train or Truck by default) is also present in the observed area.

Object types

Object types

Select one or multiple object types you want to search for - Airplane, Boat, Bus, Car, Motorcicyle, Train and Truck are selected by default. Click the dropdown menu to see the list of available object types for the selected object category.

  • Minimum confidence (0.5 by default): The minimum confidence level required for an object to be detected. The higher the confidence level, the more certain the system is that the object is of the selected type. The confidence level ranges from 0 to 1, with 1 being the highest confidence level.

ROI (Region of Interest)

Draw a polygon on the video frame to define the area where the objects will be detected. The polygon can be drawn by clicking on the video frame to create points, then clicking the first point to close the polygon.

  • Sampling interval (in seconds, 5 by default): The rate at which the video frames are sampled for analysis. The higher the sampling rate, the more frames are analyzed, which may increase the accuracy of the results but also the processing time.

  • Maximum number of parallel tracks at the same time (50 by default): The maximum number of tracks that can be processed simultaneously. Increasing this number may improve the accuracy of the results but also the processing time.

Space join

  • Max time difference (in milliseconds, 1000 by default): The maximum time difference between two objects entering the zone. If the time difference between the two objects is less than the value set here, the query will trigger an alert.

  • Join order: The order in which objects need to enter the zone to trigger an alert.

4. Alarm Integrations (optional)

The query can optionally be integrated with third-party systems, such as Milestone XProtect or a webhook to trigger alarms.

  • Cooldown (in seconds, 10 by default): The minimum time between two alerts sent to the chosen integration.

Milestone XProtect Analytics Event Integration

The query can be configured to send detections to Milestone XProtect, appearing as Analytics Events.

  • Milestone XProtect host address: The IP address of the Milestone XProtect server.
  • Analytics event name: The name of the Milestone XProtect Analytics Event that triggers the query.
  • Event display name: The display name of the event that will be shown in the event list.
  • Description: The description of the event that will be shown in the event list.
  • Timestamp offset (in seconds): The time offset between the Milestone XProtect Analytics Event and the query trigger.

Webhook

The query can be configured to send detections to a Webhook URL.

  • URL: The URL of the Webhook.
  • Custom header key: The key of the custom header.
  • Custom header value: The value of the custom header.

Results

All done - Clicking Save & Run will immediately start the analysis and opens the Result screen of this query. Alternatively, clicking Save & Exit saves the query without running it.