Merge branch 'main' of https://github.com/JDAI-CV/FaceX-Zoo into main

README.md

@@ -27,16 +27,17 @@ See [README.md](addition_module/face_mask_adding/FMA-3D/README.md) in [FMA-3D](a
 # License
 FaceX-Zoo is released under the [Apache License, Version 2.0](LICENSE).
 
-# References
-This repo is mainly inspired by [InsightFace](https://github.com/deepinsight/insightface), [InsightFace_Pytorch](https://github.com/TreB1eN/InsightFace_Pytorch), [face.evoLVe](https://github.com/ZhaoJ9014/face.evoLVe.PyTorch/blob/master/README.md).
+# Acknowledgements
+This repo is mainly inspired by [InsightFace](https://github.com/deepinsight/insightface), [InsightFace_Pytorch](https://github.com/TreB1eN/InsightFace_Pytorch), [face.evoLVe](https://github.com/ZhaoJ9014/face.evoLVe.PyTorch/blob/master/README.md). We thank the authors a lot for their valuable efforts.
 
-# Citing FaceX-Zoo
-If you use FaceX-Zoo in your research or wish to refer to the baseline results published by this project, please use the following BibTeX entry.
+# Citation
+Please consider citing our paper in your publications if the project helps your research. BibTeX reference is as follows.
 ```BibTeX
 @article{wang2021facex-zoo,
   title={FaceX-Zoo: A PyTorch Toolbox for Face Recognition},
   author={Wang, Jun and Liu, Yinglu and Hu, Yibo and Shi, Hailin and Mei, Tao},
   journal={arXix preprint arXiv:2101.04407},
   year={2021}
 }
-```
+```
+If you have any questions, please contact with Jun Wang ([email protected]), Yinglu Liu ([email protected]), [Yibo Hu](https://aberhu.github.io/) ([email protected]) or [Hailin Shi](https://sites.google.com/view/hailin-shi) ([email protected]).

addition_module/face_mask_adding/FMA-3D/README.md

@@ -1,5 +1,5 @@
 # FMA-3D
-A method for adding a mask on a non-masked face image. Given a real masked face image (a) and a non-masked face image (d), we synthesizea photo-realistic masked face image with the mask from (a) and the facial area from (d). 
+A method for adding a mask on a non-masked face image. Given a real masked face image (a) and a non-masked face image (d), we synthesize a photo-realistic masked face image with the mask from (a) and the facial area from (d). 
 ![image](Data/images/FMA-3D.jpg)
 
 # Some Results by FMA-3D
@@ -10,21 +10,20 @@ A method for adding a mask on a non-masked face image. Given a real masked face
 * pytorch >= 1.1.0
 
 # Usage
-* Get the 106 landmarks for the given face images.
-You can get the  106 landmarks by our [face sdk](../../../face_sdk) or any other methods.
-* Add mask to the image.
-Refer to [add_mask_one.py](add_mask_one.py) as a example.
+* Extract the landmarks.
+You can extract the 106 landmarks by our [face sdk](../../../face_sdk) or any other methods.
+* Add a mask on a face image.
+You can refer to [add_mask_one.py](add_mask_one.py) as an example.
 ```sh
 python add_mask_one.py
 ```
 
 # Note
-If you will change the python version, you should rebuild the mesh_core_cython.so as descriped in [face3d](https://github.com/YadiraF/face3d), 
+If you use a different version of Python, you should rebuild the mesh_core_cython.so as descriped in [face3d](https://github.com/YadiraF/face3d), 
 ```sh
 cd utils/mesh/cython
 python setup.py build_ext -i 
 ```
-then replace mesh_core_cython.so by the generated one.
 
 # Reference  
-This project is mainly inspired by [PRNet](https://github.com/YadiraF/PRNet), [face3d](https://github.com/YadiraF/face3d), [pytorch-prnet](https://github.com/liguohao96/pytorch-prnet)
+This project is mainly inspired by [PRNet](https://github.com/YadiraF/PRNet), [face3d](https://github.com/YadiraF/face3d) and [pytorch-prnet](https://github.com/liguohao96/pytorch-prnet)

face_sdk/api_usage/face_feature.py

@@ -1,6 +1,6 @@
 """
 @author: JiXuan Xu, Jun Wang
-@date: 20201015
+@date: 20201016
 @contact: [email protected] 
 """
 import sys