Skip to content

Line crossing detection

Line crossing detection is a query that detects objects crossing a line in a video stream. It can be used to monitor traffic, people, or any other objects crossing a threshold from any or from a specific direction.


  • Go to Video Search Advanced Search to set up a Search for line crossing events.

  • Go to Live Rules New Rule to set up a real-time detection of line crossing events with alarm integration.

Select Source

Select the video you want to run the Search on from the left sidebar. The thumbnail image of the chosen video is displayed here.

Time interval Advanced Search only

Time interval

Select a time frame for the analytics to run.

  • Entire video: Run the Search on the entire video duration, from the start timestamp to the end timestamp (set during video registration).
  • Custom range: You can select a custom start and end date and time to run the Search on. Type the desired date and time or select them by clicking the calendar icon.

Object filter

Object filter

Select one or multiple object types you want to search for.

  • Sensitivity (Medium by default): The sensitivity level of the Search. The higher the sensitivity, the more likely it is to detect line crossings, but it may also result in more false positives.
Expert Settings

Ticking the Expert Settings box will open additional configuration options for the Search, such as more object types to choose from. Additional parameters:

  • Sensitivity (Medium by default): The sensitivity level of the Search. The higher the sensitivity, the more likely it is to detect line crossings, but it may also result in more false positives.

  • Personalized AI: Some object types may have additional attributes available for filtering, such as color and type for Vehicle objects. You can select any number of them to further filter your results; For instance, adding the red attribute to Vehicle objects will filter detections so that only red vehicles will show up in the Search results.

  • Combination mode: Select whether the Search will return results that match all or any of the attributes chosen above.

Algorithm

  • Line definition: Draw a line on the canvas to define the area where objects crossing the line will be detected. The line can be drawn in any direction, and it will be used to determine whether an object has crossed it.

    Left-click on the camera thumbnail to begin drawing the line; left-click again to finish drawing. Select from the options below the canvas to select the facing direction.

Expert Settings
  • Ignore repeat crossings for same object (in seconds, 1 by default): The minimum amount of time that must pass before the same object crossing the lines again will be counted as a new crossing. Adjusting this setting can help prevent multiple counts for the same object if it crosses the lines multiple times in a short period.

  • Use bottom reference point (on by default): By default, the Search uses the bottom center of the detected bounding box as a reference point to determine whether an object has crossed the line. Toggling this option will use the middle center of the bounding box instead.

Alarm integration Live Rules only

You can choose to integrate the Search with an alarm system.; whenever a stopped object is detected, an alarm will be triggered in the integrated system.

Results

All done - Clicking Search will immediately start the analysis and opens the Search Results screen.

Live Rules will produce real-time detections , and the results will be displayed in the Alarms screen. If an alarm integration is set up, an alarm will also be triggered in the integrated system.