File size: 2,267 Bytes
bf10ae7 c8cb30c 89e6001 1ad7c2a bf10ae7 e91c7ba c8cb30c e91c7ba 1ad7c2a e91c7ba 1ad7c2a e91c7ba bf10ae7 74c3356 bf10ae7 c8cb30c 8f6a140 bf10ae7 ee5526e bf10ae7 c8cb30c e91c7ba 8f6a140 ee5526e bf10ae7 c8cb30c |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 |
# SFace
SFace: Sigmoid-Constrained Hypersphere Loss for Robust Face Recognition
Note:
- SFace is contributed by [Yaoyao Zhong](https://github.com/zhongyy).
- Model files encode MobileFaceNet instances trained on the SFace loss function, see the [SFace paper](https://arxiv.org/abs/2205.12010) for reference.
- ONNX file conversions from [original code base](https://github.com/zhongyy/SFace) thanks to [Chengrui Wang](https://github.com/crywang).
- (As of Sep 2021) Supporting 5-landmark warping for now, see below for details.
- `face_recognition_sface_2021dec_int8bq.onnx` represents the block-quantized version in int8 precision and is generated using [block_quantize.py](../../tools/quantize/block_quantize.py) with `block_size=64`.
Results of accuracy evaluation with [tools/eval](../../tools/eval).
| Models | Accuracy |
| ----------- | -------- |
| SFace | 0.9940 |
| SFace block | 0.9942 |
| SFace quant | 0.9932 |
\*: 'quant' stands for 'quantized'.
\*\*: 'block' stands for 'blockwise quantized'.
## Demo
***NOTE***: This demo uses [../face_detection_yunet](../face_detection_yunet) as face detector, which supports 5-landmark detection for now (2021sep).
Run the following command to try the demo:
### Python
```shell
# recognize on images
python demo.py --target /path/to/image1 --query /path/to/image2
# get help regarding various parameters
python demo.py --help
```
### C++
Install latest OpenCV and CMake >= 3.24.0 to get started with:
```shell
# A typical and default installation path of OpenCV is /usr/local
cmake -B build -D OPENCV_INSTALLATION_PATH=/path/to/opencv/installation .
cmake --build build
# detect on camera input
./build/demo -t=/path/to/target_face
# detect on an image
./build/demo -t=/path/to/target_face -q=/path/to/query_face -v
# get help messages
./build/demo -h
```
### Example outputs
Note: Left part of the image is the target identity, the right part is the query. Green boxes are the same identity, red boxes are different identities compared to the left.
## License
All files in this directory are licensed under [Apache 2.0 License](./LICENSE).
## Reference
- https://ieeexplore.ieee.org/document/9318547
- https://github.com/zhongyy/SFace
|