Skip to content

TejaGollapudi/Face-Detection-Keras

Repository files navigation

Face Detection Keras (Fast Multi-scale Face Detection ConvNet)

Teja Gollapudi


Examples from validation set
The images in the above gif are obtained from running the model on the validation set of the Wider Faces dataset.

Table of contents

  1. Overview
  2. Download Weights
  3. Environment Setup
  4. Running The Detector
  5. To Do

1. Overview

A fast multi scale multi face detector based on SSD 512 model. The model has been trained on the Wider Faces Dataset.

The best performing versions of the model have attained Average Precision of 72% on the easy validation set and 63% on the medium validation set.

Paper Link.

Link to Original SSD object detector

SSD Object Detector Paper

2. Download Weights

Download the model weights from Google drive links for weights and place them in the ssd_512 folder.

3. Environment setup

Creating a new conda virtual enivronment for the project is recommended.

conda create -n yourenvname python=3.5

If you have cuda compatable gpu with cuda version==9.0 or 9.1 install packages from requirements-gpu.txt.

conda activate yourenvname
pip install -r requirements-gpu.txt

Else install packages from requirements.txt to run the model on cpu.

conda activate yourenvname
pip install -r requirements.txt

4. Running the detector

To run the face detector on webcam's input stream : live_demo.py.

python live_demo.py

To run the detector on a video of choice, provide path to the video file as command line argument.

python demo.py ./path/to/video/file.avi

5. To Do

ipython notebooks for training various model versions will be uploaded soon. Currently the plain SSD_512 version of the model has been uploaded.

Acknowledgement

The keras code for SSD and its utilities have been based on GitHub - pierluigiferrari/ssd_keras: A Keras port of Single Shot MultiBox Detector.

Releases

No releases published

Packages

No packages published

Languages