VCloud.ai Heat Map VCA

From vCloud.ai Documentation
Jump to navigation Jump to search

Module of Heat Map

Main functionality

Build the heat map of traffic density in a chosen video stream for a certain period.

Product Description

The Heat Map module is intended for a visual display of traffic density in the chosen video stream. The module provides reports on hours, days, weeks, months.

System Requirements
It is necessary to have the minimum system requirements for one video stream for Heat Map module installation on GPU as in the table below.

Parameter Recommended value
CPU Intel Core i5-5575 or higher
RAM 3 GB RAM
GPU NVIDIA 1030
Places for Archive Up to 3 GB per day (~ 4.5k detections)
Operating System Ubuntu 20.04

Analytics

To open the Heat Map analytics select Heat Map in the left menu and pass into the Analytics section.

HM1.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, 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.
The list of analytics is shown in the table below. Analytics Adding
In order to add new Heat Map analytics, press Add Analytics in the upper right corner of the page.

HM2.png

The Heat Map analytics setup process consists of 2 Steps.
Step 1 - General

HM3.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.

HM4.png

You can also enter the part of the camera name in the Search field to find the necessary video stream faster.

HM5.png

On the right side of the window, you can see the video stream preview and information about Camera name and Address, Time Zone, Resolution, Codec, and Type.

HM6.png

When the video stream is selected press the Set Video Stream button.
By pressing the Update Video Frame button you can see a frame in real-time in the field of frame addition. To add analytics it is necessary to set up the following parameter:

Field name Input values
Time Frame Select the time period for which the system will make a traffic fixation

Then it is necessary to place a traffic fixation area.
Move the white and red markers to line up the desired area.

HM7.png

The analytics will be performed only within the boundaries of the selected area.
In order to remove the area, click on the Delete Rule button.

HM8.png

To create a new area from the beginning, click somewhere inside the frame. Then move the mouse cursor. It will be moved with a red line. Put as many points as is necessary to create the borders of the desired area. The last point should be placed at the same place as the first one.

HM9.png

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

HM10.png

Step 2 - Hardware

HM11.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 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.

HM12.png

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

HM13.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.

HM14.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.

HM15.png

Now when the analytics is disabled it is possible to make changes to it.
There are 2 tabs of parameters at the top of the page, similar to the steps in creating analytics - General and Hardware. The General tab opens first by default. The current tab is always highlighted. You can switch among them by clicking on their names.

HM16.png

Genetal Tab
At the General tab it is possible to edit the following parameter:

Field name Input values
Time Frame Select the time period for which the system will make a traffic fixation

Then it is possible to edit a traffic fixation area.
Move the white and red markers to line up the desired area.

HM17.png

The analytics will be performed only within the boundaries of the selected area.
In order to remove the area, click on the Delete Rule button.

HM18.png

To create a new area from the beginning, click somewhere inside the frame. Then move the mouse cursor. It will be moved with a red line. Put as many points as is necessary to create the borders of the desired area.

HM19.png

The last point should be placed at the same place as the first one.
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
HM20.png

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

HM21.png

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

HM22.png

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

HM23.png

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

HM24.png

In the following window, click Yes to confirm the deletion or No to cancel the deletion.

HM26.png

Statistics

In order to view the Heat Map statistics select the Heat Map in the left menu and pass to the Statistics section.

HM27.png

Statistics Filters
To filter statistics it is necessary to set up statistics filters:

HM28.png

The first filter allows defining the statistics for a Day, Week, Month, or desired Time Frame.
In the second field, it is necessary to select a day for which it is necessary to receive the frames. In case the first field Day is selected, frames by hours of this day will be shown. In case Week is selected, a calendar week will be shown, which includes the selected day. In case the Month is selected, the calendar month including the selected day will be shown.
In a third field, it is necessary to select the camera. Frames from the selected camera will be shown.
Day
If Day is selected, frames that are made for a certain day by hours will be shown.

HM29.png

Week
If Week is selected, frames that are made for a certain week by days will be shown.

HM30.png

To view a certain frame in Day filter (by hours) click on the Pic.png icon over a frame.
Month
If Month is selected, frames made for a certain month by days will be shown.

HM31.png

To view a certain frame in Day filter (by hours) click on the Pic.png icon over a frame.
Time Frame
When selecting Time Frame, one frame for a certain period will be shown. For period determination it is necessary to designate the period for which the traffic density analysis will be made for the chosen camera in the second field.

HM32.png

For filtration by camera, time period, and frame time it is necessary to press the Report button.

Camera Compatibility

The solution is compatible with all cameras, that return the RTSP stream.

Camera Installation Requirements

• Static background
• The camera should be well fixed and not shaking
• Avoid refocusing and image sharpness changes
• There should be no overexposures and glare in the frame