Line crossing (face recognition)¶
This Use Case detects when entities matching a given watchlist cross a line within a specified time interval. It is primarily intended to be used for identifying specific individuals entering or exiting an area.
Drawing lines is only supported on videos with a fixed camera angle (i.e. not on moving cameras). PTZ cameras are supported only in fixed position.
Prerequisites¶
- At least one watchlist has been created.
-
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¶

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.
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.
-
Watchlist: Select an watchlist from the dropdown menu to use as a watchlist for face recognition. The query will search for faces in the video that match any of the faces in the selected watchlist.
-
Face match strictness (Strict by default): The strictness level of the Search. The higher the strictness, the more likely it is to detect faces that match the watchlist, but it may also result in more false positives.
-
Alert when: Select whether to trigger a detection when the person crossing the line is in the watchlist, or when the person is not in the watchlist.
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.
-
Alarm cooldown: (in seconds, 10 by default) The minimum amount of time that must pass between two detections before an alarm can be triggered again.
-
Alarm integration: Choose from the list of available integrations. The following integrations are available to be created in Integrations:
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.