Android Recognition Preferences
Use Recognition Preferences to configure a variety of settings that determine whether or not SAFR detects, tracks, and recognizes faces and identities. Only the basic preferences are configurable by default; you can expose and configure the advanced preferences by clicking on the
icon in the upper right corner and selecting Show Advanced Preferences.
These are the default configurable preferences.
- Detect Identity: Select to enable identity detection.
- Detect Gender: Select to enable gender detection.
- Detect Age: Select to enable age detection.
- Detect Mask: Enables the detection of masks.
- Detect Occlusion: Obstructing the full view of the face by using, for example, a mask, glasses, or using a hand to block a part of the face.
- Detect Sentiment: Select to enable sentiment detection.
- Detect RGB Liveness Action: Enables RGB liveness detection. Note that the RGB Liveness Detector on the Detection Preferences menu must be enabled for RGB liveness detection to work.
- Detect Smile Action: Enables smile authorization.
- Minimum Recognition Face Size (pixels): Defines the minimum required face size in pixels to attempt recognition. It includes a 25% margin around the face.
- Minimum Learning Face Size (pixels): Defines the minimum required face size in pixels to enable SAFR to store a reference image for a new identity. It includes a 25% margin around the face.
The advanced preferences can be exposed and configured by clicking on the
icon in the upper right corner and selecting Show Advanced Preferences.
- Detect Identity: Enables identity detection.
- Detect Gender: Enables gender detection.
- Detect Age: Enables age detection.
- Detect Mask: Enables the detection of masks.
- Detect Occlusion: Obstructing the full view of the face by using, for example, a mask, glasses, or using a hand to block a part of the face.
- Detect Sentiment: Enables sentiment detection.
- Detect RGB Liveness Action: Enables RGB liveness detection. Note that the RGB Liveness Detector on the Detection Preferences menu must be enabled for RGB liveness detection to work.
- Consecutive Recognitions for Live: Number of consecutive recognition attempts that must be successful for a LIVENESS_CONFIRMED event.
- Consecutive Recognitions for Fake: Number of consecutive recognition attempts that must be successful for a NOTLIVE_CONFIRMED event.
- Identity Recognition Threshold Boost: The amount to temporarily boost identity recognition attempts during RGB liveness actions.
- Detect Smile Action: Enables smile authorization.
- Pre-smile Delay (seconds): The amount of time, in seconds, that there should be no smile.
- Smile Duration (seconds): The amount of time, in seconds, that the smile should last.
- Identity Threshold Boost: The smile threshold to boost temporarily during the smile action.
- Transition Thresholds: Specifies what range of sentiment values are classified as happy, neutral, and unhappy.
- RGB liveness validation: Enables RGB liveness validation during smile authorization checks. Note that the RGB Liveness Detector on the Detection Preferences menu must be enabled for RGB liveness detection to work.
- Consecutive Recognitions for Live: Number of consecutive recognition attempts that must be successful for a LIVENESS_CONFIRMED event.
- Consecutive Recognitions for Fake: Number of consecutive recognition attempts that must be successful for a NOTLIVE_CONFIRMED event.
- Minimum Recognition Face Size (pixels): Defines the minimum required face size in pixels to attempt recognition. It includes a 25% margin around the face.
- Minimum Learning Face Size (pixels): Defines the minimum required face size in pixels to enable SAFR to store a reference image for a new identity. It includes a 25% margin around the face.
- Re-recognition Delay (seconds): The number of seconds that must pass before SAFR attempts to reconfirm a tracked person.
- Lingering Timeout (frames): Specifies the number of additional frames that SAFR keeps a tracked face in active memory after SAFR has failed to detect it in the most recent frame. Increasing this value makes the tracker resilient against intermittent loss of face, but consumes system processing power.
- Identity Recognition Threshold: Determines the strictness of the face recognition when declaring identity matches between a face and stored identity image. You can independently set the Identity Recognition Thresholds for the following:
- Camera: Sets the threshold for images. (e.g. photos)
- Similar: Sets the threshold for Similar comparisons when running the Similar operator mode.
- Masked Face Threshold Offset: Sets the threshold when attempting to recognize faces that are wearing masks.
- Proximity Threshold Allowance: A boost value that is added to the Identity Recognition Threshold.
For detailed information about Identity Recognition Threshold and Proximity Threshold Allowance, see Identity Recognition Thresholds.
- Minimum Learning Pose Centeredness: Specifies the minimum center pose quality that a face must have for it to be enrolled in SAFR's Person Directory.
- Minimum Learning Contrast: Specifies the minimum contrast a facial image must have for it to be enrolled in SAFR's Person Directory.
- Minimum Learning Sharpness: Specifies the minimum sharpness that a facial image must have for it to be enrolled in SAFR's Person Directory.