Python API Documentation (Experimental)

FaceVerifier class

class face_verification_library.FaceVerifier(model_file, max_concurrency=0)

The Face Verifier class

__init__(self, model_file, max_concurrency=0)

FaceVerifier constructor: loads model file, sets up the processing.

Parameters:
  • model_file (str) – path for the used model

  • max_concurrency (int) – maximum allowed concurrency, 0 means automatic (using all cores), default: 0

detect_faces(self, image)

Detects the faces on an image.

Parameters:

image (numpy.ndarray) – image of the face(s)

Return type:

list[Face]

embed_face(self, face)

Returns the embedding of the detected face.

Parameters:

face (Face) – face to embed.

Return type:

list[float]

compare_faces(self, embedding1, embedding2)
Parameters:
  • embedding1 (list[float]) – embedding of the 1th face

  • embedding2 (list[float]) – embedding of the 2nd face

Return type:

Match

get_model_name(self)

Returns the name (version etc) of the loaded model.

Return type:

str

Result classes

Face

class face_verification_library.Face
__init__(self, image, landmarks, bbox=BoundingBox(x=0, y=0, width=0, height=0), confidence=0.0)

Face constructor to use a 3rd party face detector as face source

Parameters:
  • image (numpy.ndarray) – image of the face

  • landmarks (list[Point2d]) – landmarks of the face, see landmarks specification

  • bbox (BoundingBox) – bounding box of the face

  • confidence (float) – confidence value of the detected face

bounding_box: BoundingBox

Returns the bounding box of the detected face.

confidence: float

Returns the confidence value of the detected face.

landmarks: list[Point2d]

Returns the detected landmarks of the face.

See also: landmarks specification.

Point2d

class face_verification_library.Point2d

Point2d class for the landmarks

x: float

x coordinate of landmark.

y: float

y coordinate of landmark.

BoundingBox

class face_verification_library.BoundingBox

Bounding Box class for the faces

x: float

X coordinate of the top-left corner.

y: float

Y coordinate of the top-left corner.

width: float

Width of the bounding box in pixels.

height: float

Height of the bounding box in pixels.

Match

class face_verification_library.Match
similarity: float

Similarity of the faces