Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.

Previous page Next page

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Attention!

To start and correctly operate the Face Detection VA on GPU, you must create cache beforehand (see Optimizing the operation of the Face Detection VA on GPU).

To configure the Face Detection VA, do the following:

  1. Go to the Detection Tools tab.

  2. Below the required camera, click Create…Category: FaceFace Detection VA.

By default, the detection tool is enabled and set to detect faces.

If necessary, you can change the detection tool parameters. The list of parameters is given in the table:

ParameterValueDescription
Object features
Check in listsYesThe Check in lists parameter is disabled by default. If you want to use this detection tool to check in lists of faces, select the Yes value (see Configuring face recognition based on the created lists)
No
Record objects trackingYes

The metadata of the video stream is recorded to the database by default. To disable the parameter, select the No value

No
Video streamMain stream

If the camera supports multistreaming, select the stream for which detection is needed. For the correct operation of the Face Detection VA, we recommend using a high-quality video stream

Second stream
Other
EnableYesThe detection tool is enabled by default. To disable the detection tool, select the No value
No
NameFace Detection VAEnter the detection tool name or leave the default name

Decoder mode

Auto

Select a processor for decoding video. When you select:

  • Auto: GPU takes priority (decoding with NVIDIA NVDEC chips). If there is no appropriate GPU, the decoding will use the Intel Quick Sync Video technology. Otherwise, CPU resources will be used for decoding;
  • CPU: CPU is used for decoding;
  • GPU: GPU is used for decoding (decoding with NVIDIA NVDEC chips);
  • HuaweiNPU: HuaweiNPU is used for decoding
CPU
GPU
HuaweiNPU
Liveness detectionYes

The Liveness detection parameter is disabled by default. Liveness detection is used when there is a photo of a face instead of an alive person. If you want to save to the database the information about whether each captured face is a photo (Yes/No), select the Yes value

No
Liveness threshold30

Specify the threshold value in percent at which a face is defined as "not alive". The higher the value, the fewer captured faces will be detected as a photo. At the same time, the quality of recognizing whether the captured face is a photo (Yes/No) will be higher. You must select the required value empirically. The value must be in the range [1, 100]

TypeFace Detection VA

Name of the detection tool type (non-editable field)

Use camera transformYesThe Use camera transform parameter is disabled by default. If you use a XingYun bispherical lens (see Configuring fisheye cameras), by default the detection tool receives the image of two spheres of 180° each to analyze. In this case, the recognition quality can deteriorate. To send the dewarped image to the detection tool, select the Yes value. This parameter is also valid for other transformations
No

Advanced settings

Attention!

Advanced configuration of the detection tool must be performed only with the assistance of AxxonSoft technical experts.

Analyze face rotation angleYes

The Analyze face rotation angle parameter is disabled by default. If you want to detect the face rotation angle, select the Yes value. This parameter allows you to filter out results that have a rotation and tilt angle greater than the specified values in a search for a specific face (see Search for similar face)

Note

The Analyze face rotation angle parameter affects the filtering of face detection events in the Event Board (see Configuring an Event BoardWorking with Event Boards).

When you use the following filters:

  • Triggered detection—all detected faces are displayed regardless of the face angle settings, even if the Analyze face rotation angle parameter is enabled.
  • Triggered specified detection—only faces that are within allowable rotation angles specified in the settings of the detection tool are displayed.
No
Face detection algorithmALG1 (high speed, low accuracy)

Select the face detection algorithm:

  • Algorithm 1 is the fastest, reduced accuracy. Recognition speed depends on the number of faces in the frame. Optimal for many scenes.
  • Algorithm 2recognition speed depends on the background and the number of faces in the frame.
  • Algorithm 3 is the most accurate, reduced speed. Recognition speed depends on the image resolution
ALG2 (medium speed, medium accuracy)
ALG3 (low speed, high accuracy)
Face detection period (msec)250

Specify the time in milliseconds between face search operations in a frame. The larger the value, the less load on the Server, but some faces may not be recognized. The value must be in the range [1, 10 000]

Face rotation pitch ( ° )

45

Specify the allowable face pitch angle in degrees. You must select the required value empirically. The value must be in the range [0, 90]

Face rotation roll ( ° )45

Specify the allowable face roll angle in degrees. You must select the required value empirically. The value must be in the range [0, 90]

Face rotation yaw from ( ° )

-45

Specify the minimum allowable angle of face rotation to the right or left. You must select the required value empirically. The value must be in the range [-90, 90]

Face rotation yaw to ( ° )

45

Specify the maximum allowable angle of face rotation to the right or left. You must select the required value empirically. The value must be in the range [-90, 90]

False mask detections filtering

Yes

The False mask detections filtering parameter is enabled by default. Additional algorithm considers that the track is a face of a person with a mask. If algorithm considers that the track is a face with a mask with a lower probability, this track is disregarded (see the Minimum filtering threshold for face mask detection). If you don’t need to use the parameter, select the No value

No
Filter false alarmsYes

In some cases, the detection tool may mistake other objects for a face. The Filter false alarms parameter is enabled by default. If the parameter is enabled, false results of the face recognition will appear in the detection feed (see Face recognition and search), but they will be ignored when searching for faces in the archive. This parameter filters out objects that are not faces at the stage of face vector construction and its recording to the metadata database. If you don’t need to use this parameter, select the No value

No
Frame size change1920

The analyzed frames are scaled down to a specified resolution (1920 pixels on the longer side) by default. The value must be in the range [640, 10 000]. The following algorithm is used:

  • If the longer side of the source image exceeds the value specified in the Frame size change field, it is divided by two.
  • If the resulting resolution falls below the specified value, the algorithm stops and this resolution will be used further.
  • If the resulting resolution still exceeds the specified value, it is divided by two until it is less than the specified resolution.

Note

For example, the source image resolution is 2048*1536, and the specified value is set to 1000. In this case, the source resolution will be halved two times (512*384), as after the first division, the number of pixels on the longer side exceeds the specified value (1024 > 1000). If detection is performed on a higher resolution stream and detection errors occur, we recommend reducing the compression.

Ignore repeated recognitionsYes

The Ignore repeated recognitions parameter is disabled by default. If you want to ignore repeated recognitions of the same face, select the Yes value

No
Minimum face masking threshold70Specify the minimum threshold for recognizing the mask on the face. You must select the required value empirically. We recommend specifying the value of not less than 70. The value must be in the range [1, 100]
Minimum face quality for face mask detection30

Specify the minimum quality of the face image when recognizing masks (see Masks Detection). You must select the required value empirically. We recommend specifying the value of not less than 30. The value must be in the range [1, 100]

Minimum face recognition quality50

Specify the minimum quality of the face image when recognizing faces without masks. You must select the required value empirically. We recommend specifying the value of not less than 50. The value must be in the range [1, 100]

Minimum filtering threshold50

If you enable the Filter false alarms parameter, specify the minimum percentage at which the additional algorithm considers the track to be a person's face. If the algorithm considers the track to be a face with a lower probability, this track will be disregarded. You must select the required value empirically. We recommend specifying the value of not less than 50. The value must be in the range [1, 100]

Minimum filtering threshold for face mask detection30

If you enabled the False mask detections filtering parameter, specify the minimum percentage at which the additional algorithm considers the track to be a person's face with a mask. If the algorithm considers the track to be a face with a mask with a lower probability, this track is disregarded. You must select the required value empirically. We recommend specifying the value of not less than 30. The value must be in the range [1, 100]

Period of ignoring repeated recognitions

2

Specify the period in minutes during which new recognized faces will be compared with the previous ones to detect similarities. To adjust this parameter, you must enable the Ignore repeated recognitions parameter. The value must be in the range [2, 30]

Process color framesYes

A black and white frame is processed by default. If you want the detection tool to use a color frame for processing, select the Yes value

No

Repeated recognitions similarity threshold

85

Specify the similarity threshold of the face to the previously recognized faces in percent. If the similarity threshold is lower than the specified value, the face will be recognized as a new one. To adjust this parameter, you must enable the Ignore repeated recognitions parameter. The value must be in the range [1, 100]

Send face imagesYes

The Send face images parameter is disabled by default. If you want to send face images to Axxon PSIM, select the Yes value

No
Track loss time500

Specify the time in milliseconds after which the track of the captured face is considered to be lost. This parameter applies when a captured face moves in the frame and gets hidden behind an obstacle for some time. If this time is less than the specified value, the face will be recognized as the same. The value must be in the range [1, 10 000]

Basic settings
Age and genderYes

The Age and gender parameter is disabled by default. If you need to save age and gender information for each captured face in the database, select the Yes value

Note

The average error in age recognition is 5 years.

No
Biometric dataYes

The Biometric data parameter is enabled by default. When searching for faces (see Face search), the search results will contain found faces that are similar to the attached photo or a track based on the specified minimum similarity level (percentage). If you want to keep the biometric data confidential, select the No value. When searching for faces (see Face search) by an attached photo or a track, there will be no results

No
Face mask detectionYes

The Face mask detection parameter is disabled by default. If you use mask detection, select the Yes value (see Masks Detection)

No

Maximum face height

100

Specify the maximum height of the captured faces as a percentage of the frame size. You must select the required value empirically. The value must be in the range [1, 100]

Maximum face width100

Specify the maximum width of the captured faces as a percentage of the frame size. You must select the required value empirically. The value must be in the range [1, 100]

Minimum face height5Specify the minimum height of the captured faces as a percentage of the frame size. You must select the required value empirically. The value must be in the range [1, 100]

Minimum face width

5

Specify the minimum width of the captured faces as a percentage of the frame size. You must select the required value empirically. The value must be in the range [1, 100]

Minimum threshold of face authenticity90

Specify the minimum level of face recognition accuracy for the creation of a track. You must select the required value empirically. We recommend specifying the value of not less than 90. The higher the value, the fewer faces are detected, while the recognition accuracy increases. The value must be in the range [1, 100]

ModeCPU

Select a processor for the detection tool operation—CPU or Nvidia GPU (see Selecting Nvidia GPU when configuring detection tools).

Attention!

It may take several minutes to launch the algorithm on Nvidia GPU after you apply the settings.


Nvidia GPU 0
Nvidia GPU 1
Nvidia GPU 2
Nvidia GPU 3
Huawei NPU

If necessary, in the preview window, set the rectangular area of the frame, in which you want to detect faces. You can specify the area by moving the anchor points .

Note

For convenience of configuration, you can "freeze" the frame. Click the  button. To cancel the action, click this button again.

The detection area is displayed by default. To hide it, click the  button. To cancel the action, click this button again.

To save the parameters of the detection tool, click the Apply  button. To cancel the changes, click the Cancel  button.

If necessary, you can create and configure detection sub-tools on the basis of the Face Detection VA based on metadata (see General information on metadata):

  1. Line Crossing—detection tool generates an event when a person moves across a line in the specified area of the frame and their face is detected.
  2. Entrance In Area—detection tool generates an event when a person appears in the specified area of the frame and their face is detected.
  3. Loitering In Area—detection tool generates an event when a person stays in the specified area of the frame for a long time and their face is detected.
  4. Masks Detection—detection tool generates an event when it captures a face with or without a mask.
  • No labels