Face Image Quality

SDK.estimate_face_image_quality(self: tfsdk.SDK, aligned_face_image: tfsdk.TFFacechip) → Tuple[tfsdk.ERRORCODE, float]

Estimate the image quality for face recognition.

Parameters

tf_facechip - the tfsdk.TFFacechip returned by tfsdk.SDK.extract_aligned_face().

Returns

The ERRORCODE and face quality score, in that order. The quality score is between 0 and 1, 1 being perfect quality. We suggest using a threshold of 0.999 as a filter for enrollment images.

SDK.check_face_image_exposure(self: tfsdk.SDK, tf_image: tfsdk.TFImage, face_box_and_landmarks: tfsdk.FaceBoxAndLandmarks) → Tuple[tfsdk.ERRORCODE, tfsdk.FACEIMAGEQUALITY]

Determine if the image is over or under exposed, indicating suboptimal lighting conditions for face recognition.

Parameters

  • tf_image – the input image.

  • face_box_and_landmarks – the face to analyze.

Returns

The ERRORCODE, and the FACEIMAGEQUALITY indicating if the face is over or under exposed.

SDK.detect_face_image_blur(self: tfsdk.SDK, tf_facechip: tfsdk.TFFacechip) → Tuple[tfsdk.ERRORCODE, tfsdk.FACEIMAGEQUALITY]

Determine if the face image is blurry or is of good quality for face recognition.

Parameters

tf_facechip – the tfsdk.TFFacechip returned by tfsdk.SDK.extract_aligned_face().

Returns

The ERRORCODE, and the FACEIMAGEQUALITY indicating if the face is blurry or not.

class tfsdk.FACEIMAGEQUALITY

Describes the quality of a face image to be used for face recognition.

Members:

GOOD : The quality of the image is good for face recognition.

UNDER_EXPOSED : The image is under exposed.

OVER_EXPOSED : The image is over exposed.

BLURRY : The image is blurry.