Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

Hardware requirements for the Face detector VL and its sub-detectors

Hardware requirements for neural analytics operation

Video stream and scene requirements for the Face detector VL and its sub-detectors

Image requirements for the Face detector VL and its sub-detectors

Checking in lists of faces

Examples of macros used when working with lists of faces

To configure the Face detector VL, do the following:

  1. Go to the Detectors tab.

  2. Below the required camera, click Create… → Category: Face → Face detector VL.

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

If necessary, you can change the detector 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 detector to check in lists of faces, select
the
the Yes value (see Checking in lists of faces)
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 detector VL, we recommend using a high-quality video stream

Second stream
Other
EnableYesThe detector is enabled by default. To disable the detector, select the No value
No
NameFace detector VLEnter the detector 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
  • useы the Intel Quick Sync Video technology. Otherwise, CPU resources
will be TypeFace detector VL

Name of the detector type (non-editable field)

  • are 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
Frame size change640

The analyzed frames are scaled down to a specified resolution (640 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.
Info
titleNote
For example, the source image resolution is 2048*1536, and the specified value is set to1000. 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.
TypeFace detector VL

Name of the detector type (non-editable field)

Use camera transform

Yes

The parameter is disabled by default. If you use a XingYun bispherical lens (see Configuring fisheye cameras), by default the detector 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 detector, select the Yes value. This parameter is also valid for other transformations

No

Advanced settings

Note
titleAttention!
Advanced

You must perform the advanced configuration of the detector

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

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 

see Search for similar face)

Info
titleNote

The Analyze face rotation angle parameter affects the filtering of face detection events in the Event Board (see Configuring an Event Board, Working 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 detector are displayed.
No
Face
recognition
detection algorithmAlgorithm 1

Select the face recognition algorithm:

  • Algorithm 1—the recognition speed depends on the background and the number of faces in the frame. Works slower than Algorithm 3.
  • Algorithm 2—high speed, low accuracy. The recognition speed depends on the number of faces in the frame.
  • Algorithm 3—medium speed, high accuracy. The recognition speed depends on the resolution of the image. Optimal for most scenes
Algorithm 2
Algorithm 3

Face rotation pitch ( ° )

45Specify the allowable angle of 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 angle of 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]

Frame size change

640

The analyzed frames are scaled down to a specified resolution (640 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 is used further.
  • If the resulting resolution still exceeds the specified value, it is divided by two until it is less than the specified resolution
Info
titleNote

For example, the source image resolution is 2048*1536, and the specified value is set to1000. In this case, the source resolution is 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.

Minimum image quality

30

Specify the minimum image quality for face detection. You must select the required value empirically. The value must be in the range [1, 100]

Minimum number of detections

1

Specify the minimum number of detections after which a track is considered a detected face. You must select the required value empirically. The value must be in the range [1, 10 000]

Number of frames between detections

3

Specify the number of frames between detections. The lower the value, the higher the probability that TrackEngine

will detect

detects a new face as soon as it appears in the selected area. The value must be in the range [1, 10 000]

Info
titleNote

TrackEngine doesn't perform face recognition. It tracks the position of one person's face in a sequence of frames, choosing the best frame and preparing the necessary data for external systems. TrackEngine is based on face detection and analysis methods provided by the FaceEngine library.

Number of frames without detections

18

Specify the number of frames without detections. If face detection isn't performed in the selected area, TrackEngine

will continue

continues processing the specified number of frames before it considers the track lost. You must select the required value empirically. The value must be in the range [1, 10 000]

Send face images

Yes

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

timeout

lifespan (starting with Detector Pack 3.14)

Yes

By default, the parameter is disabled. If it is necessary to display track lifespan for an object in seconds, select the Yes value

No

Track retention time (sec)

2

Specify the

maximum time period in seconds after which the event will be sent. You must select the required value empirically

minimum track's lifetime in seconds. After the specified time, the face detection result appears. If a track ends earlier, the result also appears. The value must be in the range [1,

10 000

60]

Basic settings
Biometric dataYes

The

Biometric data

parameter is

disabled

enabled by default

, meaning that when searching

. When you search for faces (see Face search)

by

, the search results display found faces that are similar to an attached photo or

a track, as well as when checking

track, taking into account the specified minimum level of similarity (in percent). For the correct check in lists of faces,

there will be no results

you must also enable this parameter.
If you want to

use face search and check in lists of faces ability, select the Yes

keep the biometric data private, select the No value. In this case, when

searching

you search for faces (

see 

see Face search)

, the search results will contain found faces that are similar to the

using an attached photo or

a track based on the specified minimum similarity level (percentage). Accurate

track as well as check in lists of faces

will be performed as well.

, the search doesn't return any result

No
Detection mode





CPU

Select a processor for the detector operation—CPU or Nvidia GPU (see Selecting Nvidia GPU when configuring detectors)

Note
titleAttention!

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

 

 

 

 

 

 

Nvidia GPU 0
Nvidia GPU 1
Nvidia GPU 2
Nvidia GPU 3
Huawei NPU
Face attributes recognition βeta


Yes

The

NoFace attributes recognition 
YesThe Face attributes recognition 

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

Info
titleNote

The average error in age recognition is 5 years.

No
Medical mask detectionYes

The

Medical mask detection

parameter is disabled by default. If you use mask

detection

detector, select the Yes value (

see Masks Detection

see Mask detector VL)

No
Minimum face size
10
20

Specify the minimum size 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 authenticity60

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]

ModeCPUSelect a processor for the detector operation—CPU or Nvidia GPU (see Selecting Nvidia GPU when configuring detectors)

Note
titleAttention!

...

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

...

Note
titleAttention!

You can enable the advanced logging for SDK using the VL_SDK_VERBOSE_LOGGING=1 system variable (see Appendix 9. Creating system variable).

If necessary, in 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 points Image Modified.

Image Modified

Info
titleNote
  • For convenience of configuration, you can "freeze" the frame. Click the Image Modified button. To cancel the action, click this button again.
  • The detection area is displayed by default. To hide it, click the Image Modified button. To cancel the action, click this button again.

To save the parameters of the detector, click the Apply Image Modified button. To cancel the changes, click the Cancel Image Modified button.

Configuration of the Face detector VL is complete. If necessary, you can create and configure sub-detectors on the basis of the Face detector VL based on metadata (see Metadata database):

  1. Line
  2. Crossing
  3. crossing—detector generates an event when a person moves across a line in the specified area of the frame and their face is detected.
  4. Entrance In Area
  5. Entrance in area—detector generates an event when a person appears in the specified area of the frame and their face is detected.
  6. Loitering
  7. In Area
  8. in area—detector generates an event when a person stays in the specified area of the frame for a long time and their face is detected.
  9. Masks Detection
  10. Mask detector VL—detector generates an event when it captures a face with or without a mask.