Smart VA: Analytics

This page comprises the Analytics item overview and options to customize analytics. The item displays a list of analytics including status and the ability to manage analytics.

Overview

To open the Analytics item, in the main menu:

  1. Select the Smart VA section
  2. Choose the Analytics item
  3. See analytics

Use and Functionality

The Smart VA Analytics functional menu allows to:

  • Fill in the Camera field with:
    • Camera name or characters in the name
    • Analytics ID
    • Video stream ID
  • Select the required analytics status
  • Click the Reset button to clear the filters
The status options comprise All, Active, and Stopped.

See the list of analytics in the table below. It contains:

  • Analytics and folders ID
  • Camera comprises:
    • Folders' and separate video streams' names
    • Copy Name icon to copy the video stream name
    • Video source type
    • Additional hardware parameters
  • Video stream or video file playback status. For the Active and Offline statuses, the system also displays:
    • Countdown since analytics launch
    • Last server connection to analytics (seconds ago)
  • Toolbox comprises:
    • Start/Stop
    • Edit
    • Events
    • View
    • Delete
  • To learn more about grouping video streams into folders and making the appropriate changes in the Video Streams item, read Video Streams.
  • To find out the ID of the CPU/GPU and the server running the video stream, hover the mouse over the circle next to the status of the running analytics.

Create Analytics

To create new analytics, click the Create Analytics button:

The Create Smart VA Analytics navigation menu allows to:

  • Click the Back to All Analytics button to return to the main Analytics item
  • See the title and serial number of the current tab
  • Click the Back or Next button to move among tabs:
    • General
    • Hardware
    • Notifications
    • Permissions

General Tab

The General tab provides the ability to set a video stream and customize analytics parameters.

To set a video stream:

  1. Click the Video field
  2. See the Set Video Stream pop-up window
  3. Fill in the Search field with:
    • Camera name or characters in the name
    • Video stream ID
  4. Select the required camera from the filtered list
  5. Click the Set Video Stream button to confirm the intention
To refresh the video preview, upon selecting the Set Video Stream button, click the Update Video Frame button above the frame. This button is available upon adding the video stream.

Once the video stream is selected, two possible analytics configuration scenarios are available:

  1. Proceed with the analytics configuration without a specific rule:

    • In this scenario, the analytics will operate in a general mode. 
    • If no rules are set, all analytics results (detections) will be stored in the Search item.

  2. Create a specific rule:

    • In this scenario, the analytics will operate according to specific criteria.
    • If rules are configured for more specific recognition, all analytics results (detections) will still appear in Search. Additionally, results (events) matching the specific rules will be sent to the Events item.
Analytics can be configured for general recognition without specific rules. In this case, click the Next button to proceed to the settings in other tabs.

Recognition Options

To perform the recognition by a specific rule, click the Create Rule button:

Create as many different rules for one analytics as required.

Depending on the desired rule type, apply these recognition options:

  • In Zone trigger type executes if an object of the selected type entered the empty detection zone (or initially occupied it) and was within it for the specified time.
  • Out of Zone trigger type executes if all objects of all selected types leave the detection zone and stay outside for at least the specified time. The trigger does not execute if at least one object is still in the detection zone. The trigger executes only when the detection zone is completely empty.
  • Object Counter trigger type calculates the number of simultaneously detected objects in the detection zone. It triggers provided that the number of objects in the detection zone is greater than or equal to the specified parameter.
  • Presence Control trigger type is executed with the In Zone tag for each object that enters the detection zone (or initially occupies it) and remains within it for the specified dwell time. The trigger is then executed again with the Out of Zone tag when the same object leaves the detection zone and stays outside for the specified dwell time. This scenario is applied separately to each detected object.
  • Intrusion trigger type executes if an object entered the detection zone and was inside it for the specified time.
  • Crowd trigger type calculates the number of simultaneously detected Person objects within a detection zone over a set duration. The trigger considers the distance between Person objects to identify people gatherings and executes when the specified crowd density threshold is met or exceeded.

  

To learn more about triggers and view the examples of their use, read Triggers.

For the Zone rule type:

  1. Set the notification parameters:
    • Enter the rule name
    • Select the Zone rule type
    • Select the color of the detection zone
    • Select the required checkboxes to set objects
    • Select the required time frame to specify the analytics working hours by this rule
    • Set the detection time in seconds for the Dwell Time, sec parameter
    • Set the amount of the required objects for the Counter parameter
    • Select the notification trigger type:
      • In Zone
      • Out of Zone
      • Object Counter
      • Presence Control
      • Intrusion
      • Crowd
    • Select days of the week to receive the specified notifications
    • Click the Add Notification button to create multiple sets of notification parameters
    • Click the white Delete icon to delete the set of notification parameters
  2. Modify the detection zone:
    • Click and drag the handles with LMB to set the zone borders
    • Click and drag the area inside the zone with LMB to move the whole zone
    • Click the handle with RMB to delete it
    • Click the Reset Zone button to return the detection zone borders to their original position
  3. Modify the exclusion zone:
    • Click the Add Exclusion Zone button to add up to 3 exclusion zones in each rule
    • Click and drag the handles with LMB to set the exclusion zone borders
    • Click and drag the area inside the zone with LMB to move the whole exclusion zone
    • Click the handle with RMB to delete it
    • Click the Close button next to the required exclusion zone name to remove it
  4. Select the red Delete icon to delete the required rule section
  • All days of the week are selected by default. Buttons become grey when deselected.
  • The Counter parameter becomes available only for the Object Counter and Crowd trigger types.
  • The detection and exclusion zones are based on at least 3 handles.
  • Sets of notification parameters within one rule differ only by Time Frame and days of the week. Counter, Dwell Time, and Trigger parameters duplicate in all sets and can be changed only in the very first set, which leads to similar changes in all further sets.

For the Line rule type:

  1. Set the parameters:
    • Enter the rule name
    • Select the Line rule type
    • Select the line color
    • Redirect the object movement by clicking the Change Direction button
    • Select the required checkboxes to set objects
    • Select the required time frame to specify the analytics working hours by this rule
    • Select days of the week to receive the specified notifications
    • Click the Add Notification button to create multiple sets of notification parameters
    • Click the white Delete icon to delete the set of notification parameters
  2. Modify the line:
    • Click and drag the handles with LMB to set the line size and location
    • Click and drag the line with LMB to move the whole line
    • Click the Reset Line button to return the line to its original position
  3. Select the red Delete icon to delete the required rule section
All days of the week are selected by default. Buttons become grey when deselected.

For the Path rule type:

  1. Set the parameters:
    • Enter the rule name
    • Select the Path rule type
    • Select the path line color
    • Set the trajectory accuracy in percentage by moving the slider
    • Select the required checkboxes to set objects
    • Select the required time frame to specify the analytics working hours by this rule
    • Select days of the week to receive the specified notifications
    • Click the Add Notification button to create multiple sets of notification parameters
    • Click the white Delete icon to delete the set of notification parameters
  2. Modify the path:
    • Draw the path on the frame by clicking and holding down the LMB
    • Click the Reset Path button to reset the drawn path
  3. Select the red Delete icon to delete the required rule section 
  • The Trajectory Accuracy parameter determines how precisely an object must follow a specified path in the frame for its movement to be counted as an event according to the rule. The higher the percentage, the more accurately the object must move along the path.
  • All days of the week are selected by default. Buttons become grey when deselected.
The Zone with Direction rule enables the analytics to track the movement direction of each object entering the detection zone. To determine if the object is moving in the specified direction within the zone, the analytics uses an internal rectangular box that encloses the detection zone by its most protruding points. An event is triggered if the object moves inside the detection zone a distance of at least 30% of the shortest side of this box in pixels in the specified direction.

For the Zone with Direction rule type:

  1. Set the notification parameters:
    • Enter the rule name
    • Select the Zone with Direction rule type
    • Select the color of the detection zone
    • Set the zone direction angle in percentage by moving the slider
    • Select the required checkboxes to set objects
    • Select the required time frame to specify the analytics working hours by this rule
    • Select days of the week to receive the specified notifications
    • Click the Add Notification button to create multiple sets of notification parameters
    • Click the white Delete icon to delete the set of notification parameters
  2. Modify the detection zone:
    • Click and drag the handles with LMB to set the zone borders
    • Click and drag the area inside the zone with LMB to move the whole zone
    • Hold and drag the direction arrow inside the zone to change the zone direction angle manually
    • Click the handle with RMB to delete it
    • Click the Reset Zone button to return the detection zone borders to their original position
  3. Modify the exclusion zone:
    • Click the Add Exclusion Zone button to add up to 3 exclusion zones in each rule
    • Click and drag the handles with LMB to set the exclusion zone borders
    • Click and drag the area inside the zone with LMB to move the whole exclusion zone
    • Click the handle with RMB to delete it
    • Click the Close button next to the required exclusion zone name to remove it
  4. Select the red Delete icon to delete the required rule section
  • All days of the week are selected by default. Buttons become grey when deselected.
  • The detection zone is based on at least 3 handles.

Hardware Tab

The Hardware tab provides the ability to customize hardware parameters:

  • Analytics functions exclusively on GPU resources
  • Select the hardware decoder from the drop-down list:
    • CPU
    • Intel
    • NVDEC
  • Select the FPS frame processing mode to set the desired number of frames per second
  • The recommended value for the FPS mode is 25.
  • The Key Frame and Once Every X Seconds options are disabled for the Smart VA analytics.
  • The default parameters allow the production of analytics. To customize the analytics, set parameters as required.
  • To learn more about hardware settings, read How to Сonfigure the Hardware Tab Settings.

Notifications Tab

The Notifications tab allows managing the event notifications. Select the Send Events to Event Manager checkbox to allow the system to send all notifications to the Event Manager and then to external resources:

The default parameters allow the production of analytics. To customize the analytics, set parameters as required.

Once the analytics is created and enabled, the Notification icon signals about each new event notification. Click the Notification icon to open the Notification Panel. It comprises:

  1. Plugin name box to:
    • Collapse/expand the list of event notifications by clicking the plugin name
    • Clear all plugin event notifications at once from the Notification Panel by clicking the Close button (this action doesn't affect events in the Events item)
  2. Event notification box to:
    • View short event information and frame preview for up to 3 last notifications
    • Open the event pop-up window by clicking the required notification
    • Clear the desired event notification from the notification list by clicking the Close button inside the box (this action doesn't affect the event in the Events item)
  3. Show More button with the total events number to open the Events item and view all events

Permissions Tab

The Permissions tab provides the ability to:

  • Assign analytics access rights for Roles:
    1. Select the required role from the drop-down list
    2. Click the Add Role button
    3. Select the checkboxes for the required access rights
    4. Click the Delete icon to remove the unnecessary role
  • Assign analytics access rights for Users:
    1. Select the required user from the drop-down list
    2. Click the Add User button
    3. Select the checkboxes for the required access rights
    4. Click the Delete icon to remove the unnecessary user
  • Select the checkboxes for the required analytics access rights by default
  • Select the Save button to confirm the intention in the navigation menu
  • The default parameters are active only if no Roles or Users are added.
  • The quantity of added Roles and Users is not limited.

Once saved, the Smart VA Analytics editor opens to allow the users to:

  • Modify parameters
  • Set parameters
  • Run the created analytics
  • Proceed to live view mode

Edit Analytics

To edit settings in the selected analytics, click the Edit icon on the toolbox:

The Edit Smart VA Analytics navigation menu allows to:

  • Click the Back to All Analytics button to return to the main Analytics item
  • See the setting tabs and move among them by clicking their titles:
    • General
    • Hardware
    • Notifications
    • Advanced Settings
    • Permissions
  • Select the Stop button to disable the analytics:
    • Yes to confirm the analytics disabling
    • No to cancel the intention or close the pop-up window
  • Select the Start button to enable the analytics
  • Click the Live View button to see the selected analytics process in real-time
  • Select the Save button to apply the changes to the selected analytics
  • The current tab is always highlighted.
  • Analytics editing is available only when selected analytics is disabled.
  • The Stop button is available only when the current analytics is active.
  • The Start button is available only when the current analytics is stopped.
  • The Live View button is available only when the current analytics is active.

To view editing parameters for the General, Hardware, Notifications, and Permissions tabs, read Create Analytics.

Advanced Settings Tab

The Advanced Settings tab allows the users to:

  • Move the slider to the left (to increase) or to the right (to decrease) the detector accuracy
  • Select a server from the drop-down list to run the analytics
  • Select the tracker type:
    • Tracker with normal accuracy
    • Tracker with increased accuracy
  • Select an analytics model:
    • Quality
    • Performance
    • Head Recognition
  • Enter the recognized object storage time in the buffer (in seconds)
  • Set the minimum height of an object for recognition (in pixels)
  • Set the minimum width of an object for recognition (in pixels)
  • The Detector Accuracy setting is determined by the parameters of the original image. A High value is recommended for a low-quality image to increase the detection probability, and a Low value is better for a high-quality image to avoid false detection. The possible range is from 2 to 8, the value is 5 by default.
  • The tracker with increased accuracy consumes more resources compared to a normal one. However, in scenarios where objects briefly overlap each other, it increases the chances of preventing the recognition of the same objects as new ones.
  • The Quality model provides exceptional detection quality at the expense of analytics performance.
  • The Performance model provides exceptional analytics performance at the expense of detection quality.
  • The Head Recognition model uses the head detector, as opposed to the Quality and Performance models which use the body detector.
  • The minimum value for the Tracker Buffer Time parameter is 10 sec. The default value is 20 sec.
  • The minimum value for the Min Object Height is 25 pixels. The default value is 25 pixels. The maximum value is limited by the frame height.
  • The minimum value for the Min Object Width is 25 pixels. The default value is 25 pixels. The maximum value is limited by the frame width.
  • Default parameters allow the production of analytics. To customize the analytics, set parameters as required.

  

To learn more about the analytics advanced settings and view examples of their usage, read Advanced Settings.

Analytics Status

To enable or disable the analytics and view the change in the analytics status:

  1. Select the Start button to enable the analytics
  2. Click the Stop button to disable the analytics process
  3. Confirm the intention

To enable or disable multiple analytics at once, click the Select Analytics button:

The Select Analytics functional menu allows to:

  1. Check the boxes next to the required folders or separate analytics to select them
  2. Click the Start Analytics button and confirm the intention in the pop-up window to enable all selected analytics
  3. Click the Stop Analytics button and confirm the intention in the pop-up window to disable all selected analytics
  4. Click the Cancel button to quit the analytics selection

View Analytics

To see the selected analytics in real-time, click the View icon on the toolbox:

The View icon becomes available only when selected analytics is active.

Live view analytics mode allows to:

 

  1. View the video from the camera in real-time mode. At the bottom of the block:
    • Hover the mouse over the Settings icon to:
      • Select the desired video format
      • Click the Update Video Stream button to manually update the video
    • Click the Enlargement icon to expand the video to full screen
  2. View the recent event frame preview with detected objects
  3. Click the Edit Analytics button to make changes to the current analytics settings
  4. Click the View All Analytics Events button to see all events from the selected analytics

To view the required event:

 

  1. Click the View icon in the table below
  2. See the event's pop-up window
  3. Use frame view tools:
    • Zoom Out icon (-) to zoom out from a specific area of the frame
    • Zoom In icon (+) to zoom in on a specific area of the frame
    • Reset View icon (~) to reset the frame to its original size and position
    • Target icon to zoom in on the detected object in the frame (available for the Presence Control and Intrusion trigger types)
    • Enlargement icon to open the frame in full-screen (in the full-screen press the Esc button to return to default view)
  4. Check the required boxes to enable or disable the display elements in the frame:
    • Bounding Box
    • Trigger (for the Zone rule type only)
    • Object Type
    • Zone (for the Zone and Zone with Direction rule types only)
    • Path (for the Path rule type only)
    • Line (for the Line rule type only)
  5. Hover the mouse over the Extra Options icon. In the drop-down menu:
    • Click the Edit Analytics button to make changes to the settings of the analytics which is related to the selected event
    • Click the Save Image button to download the event frame in full size
  • Hover the mouse over the bounding box in the frame to see its width and height parameters in pixels and analytics sensitivity value.
  • Click and drag the image across the zoomed-in frame in order to view different parts of it.

View Events

To view selected analytics events in the Analytics item, click the Events icon on the toolbox:

Delete Analytics

To delete the analytics:

  1. Select the Delete icon on the toolbox
  2. Confirm the intention