Face Detection
==============================

.. autoclass:: tfsdk.TFFacechip

.. automethod:: tfsdk.TFFacechip.save_image

.. automethod:: tfsdk.TFFacechip.load_image

.. automethod:: tfsdk.TFFacechip.get_height

.. automethod:: tfsdk.TFFacechip.get_width

.. automethod:: tfsdk.SDK.detect_faces

The recall and precision of the face detection algorithm on the WIDER FACE dataset:

.. image:: ../../shared/images/face_detection_roc.png
   :width: 300pt

The effect of face height on similarity score:

.. image:: ../../shared/images/face_height_match_score_FULL_model.png
   :width: 300pt

.. image:: ../../shared/images/face_height_match_score_LITE_model.png
   :width: 300pt


.. automethod:: tfsdk.SDK.detect_largest_face

.. automethod:: tfsdk.SDK.get_face_landmarks

The order of the face landmarks:

.. image:: ../../shared/images/landmarks.png
   :width: 300pt


.. automethod:: tfsdk.SDK.extract_aligned_face

.. automethod:: tfsdk.SDK.save_face_image

.. automethod:: tfsdk.SDK.estimate_head_orientation

The accuracy of this method is estimated using 1920x1080 pixel test images. A test image:

.. image:: ../../shared/images/yaw_positive_20.jpg
   :width: 300pt

The accuracy of the head orientation estimation:

.. image:: ../../shared/images/yaw_estimation_accuracy.png
   :width: 300pt

The effect of the face yaw angle on match similarity can be seen in the following figure:

.. image:: ../../shared/images/yaw_vs_sim_score.png
   :width: 300pt

The effect of the face pitch angle on match similarity can be seen in the following figure:

.. image:: ../../shared/images/pitch_vs_sim_score.png
   :width: 300pt

.. autoclass:: tfsdk.Point
   :members:
   :undoc-members:

.. autoclass:: tfsdk.FaceBoxAndLandmarks
   :members:
   :undoc-members:

The order of the face landmarks:

.. image:: ../../shared/images/landmarks2.jpg
   :width: 300pt