# Retinaface Face Detection (Pytorch)

Authors: wxywb

## Overview

This opertator detects faces in the images by using RetinaFace Detector[1]. It will returns the locations, five keypoints and the cropped face images from origin images. This repo is a adopataion from [2].

## Interface

```python
__call__(self, image: 'towhee.types.Image')
```

**Args:**

- image:
  - the image to detect faces.
  - supported types: towhee.types.Image

**Returns:**

The Operator returns a tupe Tuple[('boxes', numpy.ndarray), ('keypoints', numpy.ndarray), ('cropped_imgs', numpy.ndarray)])] containing following fields:

- boxes: 
  - boxes of human faces.
  - data type: `numpy.ndarray`
  - shape: (num_faces, 4)
- keypoints:
  - keypoints of human faces.
  - data type: `numpy.ndarray`
  - shape: (10)
- cropped_imgs:
  - cropped face images.
  - data type: `numpy.ndarray`
  - shape: (h, w, 3)

## Requirements

You can get the required python package by [requirements.txt](./requirements.txt).

## How it works
The `towhee/retinaface-face-detection` Operators implents the function of face detection. The example pipeline can be found in [face-embedding-retinaface-inceptionresnetv1](https://towhee.io/towhee/face-embedding-retinaface-inceptionresnetv1)

## Reference

[1]. https://arxiv.org/abs/1905.00641  
[2]. https://github.com/biubug6/Pytorch_Retinaface


# More Resources

- [CLIP Object Detection: Merging AI Vision with Language Understanding - Zilliz blog](https://zilliz.com/learn/CLIP-object-detection-merge-AI-vision-with-language-understanding): CLIP Object Detection combines CLIP's text-image understanding with object detection tasks, allowing CLIP to locate and identify objects in images using texts.
- [Hugging Face Inference Endpoints & Zilliz Cloud](https://zilliz.com/product/integrations/hugging-face): nan
- [What is a Convolutional Neural Network? An Engineer's Guide](https://zilliz.com/glossary/convolutional-neural-network): Convolutional Neural Network is a type of deep neural network that processes images, speeches, and videos. Let's find out more about CNN.
- [Effortless AI Workflows: A Beginner's Guide to Hugging Face and PyMilvus - Zilliz blog](https://zilliz.com/learn/effortless-ai-workflows-a-beginners-guide-to-hugging-face-and-pymilvus): In this comprehensive guide, you will learn how to utilize PyMilvus and Hugging Face datasets to supercharge your machine-learning projects.
- [Using Vector Search to Better Understand Computer Vision Data - Zilliz blog](https://zilliz.com/blog/use-vector-search-to-better-understand-computer-vision-data): How Vector Search improves your understanding of Computer Vision Data
- [What is Detection Transformers (DETR)?  - Zilliz blog](https://zilliz.com/learn/detection-transformers-detr-end-to-end-object-detection-with-transformers): DETR (DEtection TRansformer) is a deep learning model for end-to-end object detection using transformers.
- [Zilliz partnership with PyTorch - View image search solution tutorial](https://zilliz.com/partners/pytorch): Zilliz partnership with PyTorch