VCloud.ai Motion Detection VCA

From Vcloud Documentation
Jump to navigation Jump to search

Motion Detection - Motion Detector Module

Main functionality:

   • Motion detection in the specified area 
• Detection of location rules violations
• Photo recording and notifications about rules violations sending
• Storing the data collected on mode violators in the database
• Ability to receive notifications about events in Telegram, SMS, or email

Product Description

The Motion Detection module is designed to notify about zone being rules violations. Notifications sending is performed depending on the time interval and set rule. Notifications are sent when movement is detected in the zone above the specified time period, if there is no movement in the zone above the specified period, or if the zone is moving within a certain time frame.
System Requirements
It is necessary to have the minimum system requirements for one video stream for the Motion Detection module installation on GPU as in the table below.

Parameter Recommended value
CPU Intel Core i5-5575 or higher
RAM 3 GB RAM
Places for archive up to 3 GB per day (~4.5 k detections)
Operating system Ubuntu 18.04.3 LTS (Bionic Beaver)

Analytics

In order to open Motion Detection analytics select Motion Detection in the left menu and pass to the Analytics section.

MD1.png

In the Analytics section, you can customize analytics. The page displays a list of analytics with the status and the ability to add, edit, view, or delete analytics. 
There is a search field at the top of the page. Here you can filter analytics by the following parameters:

Field name Description
Camera Analytics name or part of a name can be entered in this field
Status Select the Analytics status from the drop-down list - All, Active, or Stopped

To start the search click on the Search< button. To clear the fields click on the Reset button.

MD2.png

The list of analytics is shown in the table below.
Analytics Adding
To add a new Motion Detection analytics, click Add Analytics in the upper right corner of the page.

MD3.png

The Motion Detection analytics setup process consists of 3 Steps.
Step 1 - General

MD4.png

First of all, it is necessary to select a video stream. Click on the Video field and select the camera name from a list.

MD5.png

Rule Setting
In order to set up the motion detection rule, it is necessary to select the Rule Type and fill in the corresponding fields.

MD6.png

Different rule types setting is described further.
Line Сrossing
This type of rule will be triggered if the object crosses the set line.
  Add a line to the area of interest. This function allows detecting a movement in a specific direction.

Each line appears in the middle of the area by default.

Move the line markers to the desired place (as in the example) to set the line perpendicular to the intended objects' movement.

MD7.png

Then set the movement detection direction. For this purpose click on the Change Direction button. The arrow will change its direction after each click on the button.

MD8.png

You can also set the Time Frame, for which the analytics will be providing the motion detection with the Line Crossing rule type.

MD9.png

Loitering
This type of rule will work if the object moves in the zone for a certain time.
To set the detection area move the white and colored markers to line up the desired area.

MD10.png

There are two parameters for this type of rule.
The Time Frame parameter is required to set the time interval when notifications for this type of rule will be up-to-date.
To set this parameter, press on the field, set the period, and press Accept.

MD11.png

The Trigger parameter is necessary for setting the time (set in seconds) that the object can be located in a zone without detection. To set this parameter, click on the field with this parameter and set the required number of seconds.

MD12.png

Left Object
This type of rule is used to determine the left object. The object is considered left if it was not in the zone before analytics enabling. With this rule, objects that fall into the zone and remain motionless for a certain time are recorded.
To set the detection area move the white and colored markers to line up the desired area.

MD13.png

There are two parameters for this type of rule.
The Time Frame parameter is required to set the time interval when notifications for this type of rule will be up-to-date.
To set this parameter, press on the field with time periods, set the period, and press Accept.

MD14.png

The Trigger parameter is necessary for setting the time (set in seconds) that the object can be located in a zone without detection. To set this parameter, click on the field with this parameter and set the required number of seconds.

MD15.png

Intrusion Object
This type of rule is triggered whenever an object enters the detection zone. If the object was in the zone before the analysis started, there will be no notifications for such cases.
To set the detection area move the white and colored markers to line up the desired area.

MD16.png

The Time Frame parameter is required to set the time interval when notifications for this type of rule will be up-to-date.
To set this parameter, press on the field, set the period, and press Accept.

MD17.png

Disappeared Object

This type of rule is used for object fixation. This rule is triggered if the item has disappeared from the set zone.
To set the detection area move the white and colored markers to line up the desired area.

MD18.png

There are two parameters for this type of rule.
The Time Frame parameter is required to set the time interval when notifications for this type of rule will be up-to-date. To set this parameter, press on the field, set the period, and press Accept.

MD19.png

The Trigger parameter is necessary for setting the time (set in seconds) that the object can be missed in a zone without detection. To set this parameter, click on the field with this parameter and set the required number of seconds.

MD20.png

You can create multiple rules by pressing the Add Rule button.

MD21.png

In order to remove the Rule, click on the Delete Rule button.

MD22.png

To pass to the next step, click on the Next button in the upper right corner of the page.
Step 2 - Hardware

MD23.png

Now it is time to customize Hardware options. System users can change the following parameters:

Parameter Description
Hardware Select one of the technologies - CPU or GPU acceleration
Decoding Select the hardware decoder from the drop-down list - CPU, Intel, Nvidia
Optimization Select the optimization parameter from the drop-down list (for CPU - CPU (no optimization), Open VINO; for GPU - CUDA (no optimization), cuDNN Half (FP16), Tensor RT)
FPS Enter the desired number of frames per second in the field for detection. The recommended value is 25

When all necessary parameters are selected, go forward to the last step by clicking on the Next button in the upper right corner of the page.

Step 3 - Notifications
Finally, it is possible to customize Notifications.

MD24.png

For this purpose check the box next to Send events to Event Manager. The system will send all notifications to the Event Manager and then to external resources.

MD25.png

Then it is necessary to fill in the following fields:

Extra OptionsIf necessary, it is possible to add additional parameters for further use when event creating. Fill in the parameter and value fields.
Field name Description
Events Select the event for which notifications will be sent from the drop-down list.

To add more parameters, click on the Add Options button.

MD26.png

To remove parameters, click on the Delete icon.

MD27.png

If you want to make changes to previous steps, click on the Back button in the upper right corner of the page.

MD28.png

When the analytics setup is complete, click on the Save button in the upper right corner of the page to save changes and create the analytics.

MD29.png

Analytics Editing
To open the Motion Detection analytics editing window, click the Edit button on the right side of the analytics record.

MD30.png
It is possible to edit the analytics if it is not running.

If the analytics is Active at the moment, it is necessary to disable it by clicking on the Stop Analytics button in the upper right corner of the editor page.

MD31.png

When you click on the Stop Analytics button, the Confirmation window opens. Click Yes to confirm the analytics disable or click No to cancel the action.

MD32.png

Now when the analytics is disabled it is possible to make changes to it.
There are 3 tabs of parameters at the top of the page, similar to the steps in creating analytics - General, Hardware, and Notifications. The General tab opens first by default.

The current tab is always highlighted. You can switch among them by clicking on their names.
MD33.png

At the General tab it is possible to edit the following parameters:

Parameter Description
Rule Click on the field and select another rule type from the drop-down list
Trigger To set this parameter, click on the field with this parameter and set the required number of seconds (Available for Loitering, Left Object, and Disappeared Object rule type)
Time Frame To set this parameter, press on the field, set the period of time, and press Accept
Change Direction Click on the button to change the movement direction. The arrow will change its direction after each click on the button (Available for Line Crossing rule type)

Then it is possible to edit:

   • a Detection Area - for Loitering, Left Object, Intrusion Object, and Disappeared Object rule types;
• a Line for Line Crossing rule type.

Move the white and colored markers to line up the desired Detection Area.

MD34.png

Move the line markers to the desired place to set the Line perpendicular to the intended objects' movement.

MD35.png

You can create multiple rules by pressing the Add Rule button.

MD36.png

In order to remove the Rule, click on the Delete Rule button.

MD37.png

Hardware Tab At the Hardware tab it is possible to edit the following parameters:

Parameter Description
Hardware Select one of the technologies - CPU or GPU acceleration
Decoding Select the hardware decoder from the drop-down list - CPU, Intel, Nvidia
Optimization Select the optimization parameter from the drop-down list (for CPU - CPU (no optimization), Open VINO; for GPU - CUDA (no optimization), cuDNN Half (FP16), Tensor RT)
FPS Enter the desired number of frames per second in the field for detection. The recommended value is 25
MD38.png

Notifications Tab
At the Notifications tab it is possible to edit values in the following fields:

Field name Description
Events Select the event for which notifications will be sent from the drop-down list.
Extra Options If necessary, it is possible to add additional parameters for further use when event creating. Fill in the parameter and value fields. 

To add parameters, click on the Add Options button.

MD39.png

To remove parameters, click on the Delete icon.

MD40.png

When the analytics editing is complete, click on the Save button in the right upper corner of the editor page to save changes.

MD41.png

Analytics Viewing
  To view Motion Detection analytics, press the View icon on the right side of the Videostream field.

MD42.png
It is possible to view only active video streams.

In the opened window you can view the video from the camera in real-time.

MD43.png

There are records of motion detection in the table below, which includes Camera, Date and Time, and Dwell Time columns.

Column name Description
Camera Here you can look at the camera location and a frame of motion detection
Date and Time Exact date and time when the camera detected a motion
Dwell Time The time during which the camera was detecting a motion

Press on the Frame icon to look closer at the detected motion.

MD44.png

To download an image of the detected motion click on the Save Image button. 

MD45.png

Analytics Start and Stop
To start the analytics, click on the Start button on the right side of the record. To stop the analytics, click on the Stop button.

MD46.png

When you click on the Stop button, the confirmation window opens. Click Yes to confirm or click No to cancel the action.

MD47.png

Analytics Deletion
To delete the analytics, click on the Delete icon on the right side of the record.

MD48.png

In opened window press Yes to confirm the deletion or No to cancel the deletion.

MD49.png

Events

To view the Motion Detection Events notifications, select Motion Detection in the left menu and pass into the Events section.

MD50.png

Events Search
There is a search field at the top of the page.

MD51.png

Here you can filter motion detection events by the following parameters:

Title Recommendations
Time Frame Here you can filter motion detection events by the following parameters:
Camera Press on the field and select the camera you want to receive notifications for from the drop-down list.
Rule Type Press on the field and select the desired rule type.

Press Search to display the search results. Press Reset to clear the input fields.
Events View To go to the view in the table format, press the corresponding icon in the upper-right corner.

MD52.png

To return to the grid format, press the corresponding icon in the upper-right corner again.

MD53.png

Frame View
To take a closer look at the frame with an object, press the enlargement icon.

MD88.jpg

Press "+" to Zoom in or "-" to Zoom out the frame. Press "~" to return the frame to the default size.

MD99.jpg

To download the image, press the Save Image button.