Gun Detection: 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 left menu:

  1. Select the Gun Detection section
  2. Choose the Analytics item
  3. See analytics

Use and Functionality

The Gun Detection 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 Gun Detection 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.

Recognition Options

To perform the recognition, apply these recognition options:

  1. Select the Create Rule button to create a new rule
  2. Set the notification parameters:
    • Enter the rule name
    • Select the color of the detection zone
    • Select the required checkboxes to set weapon types (pistols, rifles, knives)
    • Select the required time frame
    • Select days of the week to receive the specified notifications
    • Click the Add Notification button to create multiple rule notifications
    • Click the Delete icon to delete the notification
  3. 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 recognition area borders to their original position
  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:

  • Choose the CPU or GPU hardware acceleration
  • Select the hardware decoder from the drop-down list:
    • CPU
    • Intel
    • NVDEC
  • Select the frame processing mode:
    • FPS to set the desired number of frames per second
    • Key Frame to set the frame processing only by keyframes
    • Once Every X Seconds to set intervals in seconds between frame processing
  • The recommended value for the FPS mode is 25.
  • 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 events notifications. Check the Send Events to Event Manager box 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 Gun Detection 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 Gun Detection 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 chosen 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
  • 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 2 to 8, the value is 5 by default.
  • The minimum value for the Tracker Buffer Time parameter is 10 sec. The default value is 20 sec.
  • The minimum value for the Min Height Limit is 25 pixels. The default value is 25 pixels. The maximum value is limited by the frame height.
  • The minimum value for the Min Width Limit 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.

Analytics Status

To enable or disable the analytics and view the change of 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 frame preview with detected weapons
  3. Select the View icon in the table below to open the image and see the event information. In the pop-up window:
    • 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
      • Enlargement icon to open the frame in full-screen (in the full-screen press the Esc button to return to default view)
    • Check the required boxes to enable or disable the display elements on the frame:
      • Bounding Box
      • Object Type
      • Zone
    • Hover the mouse over the Extra Options icon and click the Save Image button to download the event frame in full size
  4. Click the Edit Analytics button to make changes to the current analytics settings
  5. Click the View All Analytics Events button to see all events from the selected analytics
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