Overview
Axis Object Analytics (AOA) is a suite of analytics for certain enabled cameras from Axis Communications that supports detecting people and vehicles, as well as supporting different scenarios to trigger alerts. This article will cover the use of Scenarios and how to use that to enhance the Arcules experience with Rules and with Status Displays.
Compatible Cameras
The best resource for determining if your camera is compatible is to reference the Axis website: https://www.axis.com/products/axis-object-analytics#compatible-products
Installation of Axis Object Analytics
Prerequisites
The Axis camera you are trying to enable Axis Object Analytics on, must have a firmware of 10.2.x or 10.3.x or higher.
Enablement
Log into the camera's web interface
Under the Apps section, locate the AXIS Object Analytics app
Click the slider to turn on AXIS Object Analytics
Click on Open to begin the configuration of the AXIS Object Analytics on the camera
Configuration
Now that the AXIS Object Analytics App is running on the camera, Scenarios must be created for the events you want Arcules Rules to trigger on.
Scenarios
This is a list of currently supported Axis Object Analytics Scenarios
Object In Area
When you set up an Object in area scenario, the application detects objects that move inside a defined area. The defined area is called an include area.
Line Crossing
When you set up a Line crossing scenario, the application detects objects that cross a virtually defined line.
Time In Area
With the scenario Time in area, you can set a time limit for how long an object is allowed to stay inside the include area before the application triggers an action. When an object enters the include area, the time counter starts. If the object leaves the include area before the set time limit is reached, the counter resets. It’s the object’s point of detection that must be inside the include area for the counter to keep counting. The time in area feature is suitable for areas where humans or vehicles are only supposed to stay for a short while, like tunnels or school yards after hours.
Crossline Counting
With the Crossline counting scenario, the application detects and counts the objects that cross the virtual line, and you can see the accumulated count in a table.
Occupancy In Area
When you set up an Occupancy in area scenario, the application estimates how many objects that are inside the include area at any given time. An object counter displays the estimated number of objects currently in the include area. When an object enters or leaves the area, the object counter adjusts. Occupancy in area is suitable for areas where you would want to get an estimated count of one or several object types, such as parking lots.
Motion In Area
When you select a Motion in area scenario, the application doesn’t classify objects. Instead, it detects any object that moves in the scene. It can, for example, be animals, swaying foliage, flags, or shadows. To ignore small objects, swaying objects, or objects that only appear for a short time, you can use filters
Motion Line Crossing
When you select a Motion line crossing scenario, the application doesn’t classify objects. Instead, it detects any object that crosses the virtual line. To ignore small objects or objects that only appear for a short time, you can use filters.
Best Practices in Configuring Scenarios
Axis has provided documentation for best practices in configuring each of the above documented Scenarios here: https://help.axis.com/en-us/axis-object-analytics#get-started
Configuring Arcules for Axis Object Analytics Scenarios
If the camera has not been added in Arcules, please refer to this guide for step-by-step instructions on adding a camera.
Once the camera is added, click on the device and navigate to the ANALYTICS tab. Then, click + ADD ANALYTIC.
Select AXIS Object Analytics and click SAVE.
Once this operation is complete you will see the scenarios you configured in the camera webpage reflected in the Camera Analytics section.
Configuring Rules for Scenarios
For an overview of the general Rules setup for Arcules, please review this article:
You can either use the shortcut on the Analytics tab to generate the rule for he specific Scenario result as shown below
or, you can go to the Rules page in the portal and manually create the rule per the article referenced above.
There are generally two types of triggers you can use, each applies to different scenario outputs.
Sensor Alarm
This trigger type is used by the Scenario types that perform detection as listed below:
Object in Area
Line Crossing
Time in Area
Motion in Area
Motion Line Crossing
This supports triggering on the following values for the sensor
In the below shown example, this is a rule set to trigger on the AOA Object Detect Scenario (Object in Area) where the specified object type(s) have been detected within the region configured on the camera.
Counter
This trigger type is used by the Scenario types that perform counting as listed below:
Crossline Counting
Occupancy in Area
This supports the following operators for evaluation of the current count
In the below shown example, this is a rule set to trigger on the AOA Down the Block Scenario (Crossline Counting) where there are more than 5 people detected
Analytics Status Viewing
You can view the current values for the configured Scenarios from the Devices tab. Once you select the desired camera, you can click on the Status tab, and see the current status for the scenario sensors/counts.