The Face recognition analytics type

The Face recognition analytics type is engineered to detect and recognize faces that match the images added to the analytics resource group. Analytics resources for Face recognition are added during the creation of an analytics case.

The Face recognition analytics type allows for the following analytics events:

Face recognized. The image obtained from the camera's video stream matches reference images.
Face unrecognized. The image obtained from the camera's video stream doesn’t match any reference image.

Step 1. Name and type

Enter the name of the analytics case.
Select the Face recognition analytics type from the list.
Select Next to proceed to step 2.

Step 2. Events and reactions

Here, you set an appropriate analytics event and reactions to these events.

Further, on step 5 (Set up Analytics), you’ll use this list to select events and reactions when setting up each camera.

Select an event:

Face recognized
Face unrecognized

If required, enable the Receiving events without reaction option. Once this option is enabled and included in the reaction list in step 5, the user won’t receive any notifications when the event occurs. At the same time, the event will still be recorded and displayed in the event list for this analytics case.
Select Manage reactions to choose and modify a reaction for the selected event. On the opened panel, manage the relevant reaction types.

Under Events, the following types of the event reactions are available:

Open the camera
Closing dry contact
Opening dry contact
Telegram message
Show camera in sidebar
Send sound notification

See the detailed description of reactions in this guide.

Manage the selected reaction type. The specific reaction can be added from the existing list (if there is one) or add a new one. For this, select the Plus icon of a relevant event reaction type to call out the context menu and pick an option Add new reaction or Select from existing.

If Add new reaction is selected, complete the fields on the opened panel:

Enter a name of the reaction.
Select the users who will receive the even reaction.
Schedule the reaction period (mandatory). If you select the specific days, the default time is from 00:00 till 23:59. The time can be edited.
Optionally, you can set up the reaction period outside the working hours. This period must be within the set above reaction period.
When the form is completed, select Save reaction.

image 34 (1).png — Adding a new reaction

As a result, the added reaction is displayed in the list of reactions of the selected reaction type. To further use this reaction, when setting up cameras, select Add reactions.

image 34 (2).png — Adding a reaction to a case

As a result, this reaction will be displayed in the list of Added reactions of the current analytics type. Further, this reaction can be disabled or deleted on step 5 when adding or editing of the case.

If Select from existing is chosen, the list with the existing reactions to the selected type will open.

On the opened panel, select the checkboxes of the reactions you would like to add. Next, select Add reactions.

Group 22 (3).png — Selecting reactions to add

As a result, the added reaction is displayed in the list of reactions of the selected reaction type. To further use this reaction, when setting up cameras, select Add reactions.

As a result, this reaction will be displayed in the list of Added reactions of the current analytics type. Further, this reaction can be disabled or deleted on step 5 when editing the case.

image 36 (2).png — The list of added reactions of the analytics case

Another way to create and add a new reaction is via the Analytics section of the web interface from the Events and reactions tab. Further, the added reaction can be used when creating or editing an analytics case. For details on how to add a new reaction from the Analytics section, see this guide.

If required, add reactions to another analytics event. The count associated with each analytics event indicates the number of reactions.

image 37 (1).png — The number of added reactions

When all the settings are completed, select Next to proceed to step 3 (Analytics resources).

Step 3. Analytics resources

image 38.png — Step 3. Analytics resources.

On this page, perform the following actions:

Specify resource groups. You can do this by selecting previously added groups or adding new ones. For details, see this documentation page.
To view the selected groups, select View selection. From the opened list of groups, select the relevant one to view and edit the group's resources.
When ready, select Next to proceed to step 4.

To proceed to step 4, select at least one resource group.

Step 4. Select cameras

To add a camera, follow the steps:

Select Add cameras and, from the opened drop-down list, select the checkboxes of the relevant cameras.
Select Add.

If the contract for the chosen camera has expired under your agreement with the operator, a notification stating that the camera is inaccessible will appear.

For each camera, you configure one or more areas where facial recognition will be performed. The maximum number of areas is 6. To do this:

Select the camera name to open it. On the opened camera image, left-click to draw the lines of the area. The lines of the areas should not intersect. Connect the last and first points to create the recognition area. The area will be highlighted green when ready.
For each area that is created, a row is added below the image. This row includes the name of the area, the Rename area button, and the Delete button. Choose an area by selecting the corresponding row. If necessary, specify a name for each area.
To delete an area, select the relevant line and Delete.

Step 4. Camera selection. Areas configuration

Repeat the process for each camera.

Select Next to proceed to step 5.

Step 5. Set up Analytics

At this stage, you should specify the settings for each added camera. Select the camera name to manage the settings.

The Use as default for all cameras option toggle is used to enable or disable all the setting of the current camera to all the cameras.
Under Sensitivity, specify the minimum match percentage to trigger a reaction. The value must be ranged from 1 to 100.
Under Camera reactions, all the added reaction on step 2 to the current analytics case will be enabled by default. Edit the settings if required:
- Enable or disable a reaction by dragging the Enable the reaction toggle. By default, each reaction is enabled.
- Edit the resources and groups of resources. For this, select Groups of a relevant reaction and edit the resources. Only the added on step 3 resources will be available for editing.
- Add more reactions. For this, select Add reactions. On the opened panel, you’ll see a list of reactions that were added in step 2. Select the checkboxes of the relevant reactions and Add reactions.

Delete a reaction for the current camera. For this, select the Delete icon of a relevant reaction.

Group 22 (4).png — The Delete icon of a reaction

If a list of reactions includes the Without reaction reaction, along with other enabled reactions, all these reactions will be triggered according to their respective settings when an event occurs.

Select Save to save all the introduced changes.

When multiple cameras are added to a case, there may be instances where some are not added due to an error during the case creation process. In such scenarios, an error message will be displayed. Despite this, the case creation will continue. The case will appear in the list with an icon indicating that there was an error in adding the camera. This icon will remain visible until the next update of the case.

If an error occurs while adding all the specified cameras:

An error message will be displayed.
The case creation won’t proceed.