Directional Zone

This security zone type is available on the QbProtect product.

The directional security zone uses detected objects and specific object attributes (size, movement direction) at the zone’s separation plane to generate an alarm.

Application

Protected area entrance monitoring

This zone can be used to generate alarms only when objects are moving in an inbound direction. Objects moving in the opposite direction are ignored (e.g., leaving the protected area will never raise an alarm).

Parameters

See configuration API definition.

Intrusion conditions

Alarm sizes (default: LARGE, MEDIUM)

Filter objects based on size. Only objects of a selected size category can raise an alarm. The selection of multiple object size categories is allowed.

  • LARGE: Cars, groups of people or large animals (e.g., deer).

  • MEDIUM: Non-occluded individual humans, standing or crawling.

  • SMALL: Crouching humans, partially occluded persons or small animals (e.g., rabbits).

    The size category boundaries are configurable and can be adjusted.

Output options

Hold duration (default: 0, unit: \(s\))

Minimum hold time for the alarm when active. A value of 0 (default) will disable the alarm as soon as the conditions for raising the alarm are no longer met.

Algorithm

The algorithm uses the tracked objects from object tracking as input data. It operates in two stages:

Filter objects

This step finds the subset of all tracked objects which are currently in the vicinity of the zone. The objects are then filtered based on the parameter configured for the alarm sizes.

Detect direction

The path of the remaining objects is analyzed to detect if the most recent path segment is crosses the zones XZ-center-plane in the positive Y-axis direction of the zone’s cuboid. All objects which satisfy this condition are listed as intruders, and the zone alarm is set to \(true\).

The alarm will remain active while any intruding object is tracked in the scene. Only when the object disappears or moves through the zone in the opposite direction the alarm is set to \(false\) again.

Output data

See output API definition.

State

alarm (\(true,false\))

The current alarm. A \(true\) value indicates an alarm.

intrusion

Unfiltered pre-alarm state from the zone’s internal alarm logic.

objects

List of objects currently traversing the zone in the inbound direction. Each entry also contains a discretized representation of the track history and a snapshot of the current point cloud.