Go to documentation repository
Page History
To configure face detection tools, do as follows:
- Set the general Facial Recognition parameters.
- Configure a particular detection tool.
To configure shared Facial Recognition parameters, do as followsthe basic Face detection tool, do the following:
- Select the Facial Recognition Face detection object.
If you require using need to use this detection tool for real-time facial face recognition, set the corresponding parameter to Yes (1).If you want to use this facial recognition tool in real time in parallel with FaceCube Recognition Server (see Configuring FaceCube integration), set Yes for Real-time recognition on external Service (4, seeConfiguring real-time face recognition).
- If you need to enable recording of record metadata, select Yes from the Record Objects objects tracking list (32).
- If a the camera supports multistreaming, select the stream for which detection is needed (43). Selecting a low For the correct operation of the Face detection, it is recommended to use a High-quality video stream allows reducing the load on the Server.
- If you need to use this face detection tool in real-time together with FaceCube Recognition Server (see Configuring FaceCube integration), set Yes for the Real-time recognition on external service parameter (4).
If you need to save age and gender information for each recognized captured face in the database, select Yes in the corresponding field (1, see Facial recognition and search).
).
Info title Note The average error in age recognition is 5 years.
- If you use a bi-spherical XingYun lens, the detector will analyze two 180° spherical images by default (see Configuring fish-eye cameras). This may decrease recognition quality. To dewarp the image before detection, select Yes for the Camera transform parameter (2). This parameter is relevant for other types of image transformation as well.
- Select a processing resource for decoding video streams (23). When you select a GPU, a stand-alone graphics card takes priority (when decoding with NVidia NVIDIA NVDEC chips). If there 's is no appropriate GPU, the decoding will use the Intel Quick Sync Video technology. Otherwise, CPU resources will be used for decoding.
- Set the time (in milliseconds) between face search operations in a video frame in the Face detection period (msec) field (4). Acceptable values range is [1; 10000]. Increasing this value decreases the Server load, but can result in some faces being undetected.
- If you plan to apply the masks detection tool, set Yes for the Face mask detection parameter (35, see Configuring masks detectionMasks Detection).
- In some cases, the detection tool may take mistake other object for a face. To Select Yes in the Filter false alarms field (6) to filter out non-facial face objects, select Yes in the False Detection Filtering field while calculating the vector model of a face and its recording into the metadata DB (4). If the filtering is on, false results will appear in the detection feed (see Face recognition and search), but will be ignored during searches in Archive.Set the time (in milliseconds) between face search operations in a video frame in the Period of face search field (5). Acceptable values range: [1, 10000]. Increasing this value decreases the Server load, but can result in some faces being missed. the archive.
Analyzed framed are scaled down to a specified resolution (67, 1280 1920 pixels on the longer side). This is how it works:
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, it is used further.
If the resulting resolution still exceeds the specified limit, it is divided by two, etc.
Info title Note For example, the source image resolution is 2048*1536, and the limit specified value is set to1000.
In this case, the source resolution will be divided halved two times (down to 512*384): , as after the first division, the number of pixels on the longer side exceeds the limit (1024 > 1000).
Info title Note If detection is performed on a higher resolution stream and detection errors occur, it is recommended to reduce the compression.
Specify the minimum and maximum sizes of detectable faces in % the captured faces as a percentage of the frame size (78).
In the Minimum threshold of face authenticity field, set the minimum level of face recognition accuracy for the creation of a track (89). You can set any value by trial-and-error; no . No less than 90 is recommended. The higher the value is, the fewer faces are detected, while the recognition accuracy increases.
Select the processor for the face detection - − CPU or NVIDIA GPU (910, see General Information on Configuring Detection).
Note title Attention! It may take several minutes to launch the algorithm on an NVIDIA GPU after you apply the settings. You can You should use caching to speed up future launches (see Configuring Optimizing the acceleration operation of Face detection on GPU-based neuroanalytics).
If you use FaceCube integration (see Configuring FaceCube integration), activate the Send face imageimages parameter (1011).
Enter the time in milliseconds after which the face track is considered to be lost in the Track loss time field (1112). Acceptable values range : is [1, ; 10000]. This parameter applies when a face moves in a frame and gets obscured by hidden behind an obstacle for some time. If this time is less than the set value, the face will be recognized as the same.
When using wide angle dual lens XingYun devices, the detector will analyze two 180° spherical images by default (see Configuring fisheye cameras). This may decrease recognition quality. To de-warp the image before detection, select Yes for the Use Camera Transform parameter (12). This parameter works as well for other types of image transformation.
- If necessary, fine-tune the detection tool (see Fine-tuning the Face detection tool).
In the preview window, set the rectangular area of the frame in which you want to perform face detectionSelect a rectangular area to be searched for faces in the preview window. To select the area, move the intersection anchor points .
- Click the Apply button.
Configuration of general parameters for Facial Recognition The basic Face detection tool is now completeconfigured.