Go to documentation repository
Page History
...
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 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 | |||||||
Type | Face 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
| |||||||
Analyze face rotation angle | Yes | The 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)
| |||||
No | |||||||
Face detection 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] | |||||
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:
| |||||
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 detects a new face as soon as it appears in the selected area. The value must be in the range [1, 10 000]
| |||||
Number of frames without detections | 18 | Specify the number of frames without detections. If face detection isn't performed in the selected area, TrackEngine 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 parameter is disabled by default. If you want to send face images to Axxon PSIM, select the Yes value
| |||||
No | |||||||
Track 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 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, 60] | |||||
Basic settings | |||||||
Biometric data | Yes | The parameter is enabled by default. When you search for faces (see Face search), the search results display found faces that are similar with an attached photo or track, taking into account the specified minimal level of similarity (in percent). For the correct check-in lists of faces, you must enable this parameter. | |||||
No | |||||||
Detection mode | CPU | Select a processor for the detector operation—CPU or Nvidia GPU (see Selecting Nvidia GPU when configuring detectors)
| |||||
Nvidia GPU 0 | |||||||
Nvidia GPU 1 | |||||||
Nvidia GPU 2 | |||||||
Nvidia GPU 3 | |||||||
Huawei NPU | |||||||
Face attributes recognition βeta | Yes | The 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
| |||||
No | |||||||
Medical mask detection | Yes | The parameter is disabled by default. If you use mask detector, select the Yes value (see Mask detector VL) | |||||
No | |||||||
Minimum face size | 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 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] |
Note | ||
---|---|---|
| ||
You can enable the advanced logging for SDK using the VL_SDK_VERBOSE_LOGGING=1 system variable (see Appendix 9. Creating system variable). |
...