Go to documentation repository
Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.
Previous page
Next page
To configure the Face detector VL, do the following:
Go to the Detectors tab.
- 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:
| Parameter | Value | Description |
|---|---|---|
| Object features | ||
| Check in lists | Yes | The Check in lists parameter is disabled by default. If you want to use this detector to check in lists of faces, select the Yes value (see Checking in lists of faces) |
| No | ||
| Record objects tracking | Yes | The metadata of the video stream is recorded to the database by default. To disable the parameter, select the No value |
| No | ||
| Video stream | Main 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 | ||
| Enable | Yes | The detector is enabled by default. To disable the detector, select the No value |
| No | ||
| Name | Face detector VL | Enter the detector name or leave the default name |
Decoder mode | Auto | Select a processor for decoding video. When you select:
|
| CPU | ||
| GPU | ||
| HuaweiNPU | ||
| 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:
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. |
| Type | Face detector VL | Name of the detector type (non-editable field) |
Advanced settings Attention! Advanced configuration of the detector must be performed only with the assistance of AxxonSoft technical experts. | ||
| Analyze face rotation angle | Yes | 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 Board, Working with Event Boards). When you use the following filters:
|
| No | ||
| Face recognition algorithm | Algorithm 1 | Select the face recognition algorithm:
|
| Algorithm 2 | ||
| Algorithm 3 | ||
Face rotation pitch ( ° ) | 45 | Specify the allowable angle of face pitch 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 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] |
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 a new face as soon as it appears in the selected area. The value must be in the range [1, 10 000] Note 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 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 | 2 | Specify the maximum time period in seconds after which an event is sent. You must select the required value empirically. The value must be in the range [1, 10 000] |
| Basic settings | ||
| Biometric data | Yes | The Biometric data parameter is disabled by default. When you search for faces (see Face search) by an attached photo or track, as well as when you check in lists of faces, there will be no results If you want to keep biometric data, select the Yes value. In this case, when you search for faces (see Face search), the search results will contain faces that are similar to the attached photo or track based on a specified minimum similarity level (percentage). For the correct check in lists of faces, this parameter must also be enabled |
| No | ||
| Face attributes recognition | Yes | The 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 Note The average error in age recognition is 5 years. |
| No | ||
| Medical mask detection | Yes | The Medical mask detection parameter is disabled by default. If you use mask detector, select the Yes value (see Mask detector VL) |
| No | ||
| Minimum face size | 10 | 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 authenticity | 60 | 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] |
| Mode | CPU | Select a processor for the detector operation—CPU or Nvidia GPU (see Selecting Nvidia GPU when configuring detectors) Attention! It can 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 | ||
Attention!
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 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 detector, click the Apply 
button. To cancel the changes, click the Cancel 
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):
- Line crossing—detector generates an event when a person moves across a line in the specified area of the frame and their face is detected.
- Entrance in area—detector generates an event when a person appears in the specified area of the frame and their face is detected.
- Loitering 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.
- Mask detector VL—detector generates an event when it captures a face with or without a mask.
Overview
Content Tools