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

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

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

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

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

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:

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

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

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)

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:

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

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