|
--- |
|
license: other |
|
license_name: model-distribution-disclaimer-license |
|
license_link: https://huggingface.co/spaces/deepghs/RDLicence |
|
pipeline_tag: feature-extraction |
|
tags: |
|
- onnx |
|
- face |
|
--- |
|
|
|
ONNX models from [insightface project](https://github.com/deepinsight/insightface). |
|
|
|
# How To Use |
|
|
|
```shell |
|
pip install dghs-realutils>=0.1.0 |
|
``` |
|
|
|
```python |
|
from realutils.face.insightface import isf_face_batch_similarity, isf_analysis_faces, isf_faces_visualize |
|
|
|
image_path = "/your/image/file" |
|
# get the analysis all the faces |
|
faces = isf_analysis_faces(image_path) |
|
print(faces) |
|
|
|
# compare them |
|
print(isf_face_batch_similarity([face.embedding for face in faces])) |
|
|
|
# visualize it |
|
isf_faces_visualize(image_path, faces).show() |
|
|
|
``` |
|
|
|
# Available Models |
|
|
|
We evaluated all these models with some evaluation datasets on face recognition. |
|
|
|
* CFPW (500 ids/7K images/7K pairs)[1] |
|
* LFW (5749 ids/13233 images/6K pairs)[2] |
|
* CALFW (5749 ids/13233 images/6K pairs)[3] |
|
* CPLFW (5749 ids/13233 images/6K pairs)[4] |
|
|
|
Below are the complete results and recommended thresholds. |
|
|
|
* Det: Success rate of face detection and landmark localization. |
|
* Rec-F1: Maximum F1 score achieved in face recognition. |
|
* Rec-Thresh: Optimal threshold determined by the maximum F1 score. |
|
|
|
| Model | Eval ALL (Det/Rec-F1/Rec-Thresh) | Eval CALFW (Det/Rec-F1/Rec-Thresh) | Eval CFPW (Det/Rec-F1/Rec-Thresh) | Eval CPLFW (Det/Rec-F1/Rec-Thresh) | Eval LFW (Det/Rec-F1/Rec-Thresh) | |
|
|:----------|:-----------------------------------|:-------------------------------------|:------------------------------------|:-------------------------------------|:-----------------------------------| |
|
| buffalo_l | 99.88% / 98.34% / 0.2203 | 100.00% / 95.75% / 0.2273 | 99.99% / 99.66% / 0.1866 | 99.48% / 96.41% / 0.2207 | 100.00% / 99.85% / 0.2469 | |
|
| buffalo_s | 99.49% / 96.87% / 0.1994 | 99.99% / 94.45% / 0.2124 | 99.65% / 98.64% / 0.1845 | 98.04% / 92.61% / 0.2019 | 100.00% / 99.68% / 0.2314 | |
|
|
|
[1] Sengupta Soumyadip, Chen Jun-Cheng, Castillo Carlos, Patel Vishal M, Chellappa Rama, Jacobs David W, Frontal to profile face verification in the wild, WACV, 2016. |
|
|
|
[2] Gary B. Huang, Manu Ramesh, Tamara Berg, and Erik Learned-Miller. Labeled Faces in the Wild: A Database for Studying Face Recognition in Unconstrained Environments, 2007. |
|
|
|
[3] Zheng Tianyue, Deng Weihong, Hu Jiani, Cross-age lfw: A database for studying cross-age face recognition in unconstrained environments, arXiv:1708.08197, 2017. |
|
|
|
[4] Zheng, Tianyue, and Weihong Deng. Cross-Pose LFW: A Database for Studying Cross-Pose Face Recognition in Unconstrained Environments, 2018. |
|
|
|
|
