Human head pose estimation using Keras over TensorFlow

Work by Rafael Berral-Soler, directed by Manuel J. Marin-Jimenez and Francisco J. Madrid-Cuevas. The pose estimator models developed on this project are based on the architectures on the following article:

M. Patacchiola y A. Cangelosi. Head pose estimation in the wild using convolutional neural networks and adaptive gradient methods. Pattern Recognition, 71, June 2017.

Code for this project can be downloaded here.

Notes

In order to use this model, you MUST import models/keras_ssd512.py, bounding_box_utils and keras_layers from the Keras implementation of Single-Shot Multibox Detector by Pierluigi Ferrari found here. These files must be placed in the root of the cloned repository directory.
The original MatConvNet head detector model can be obtained here, work by Pablo Medina-Suarez and Manuel J. Marin-Jimenez. It must be placed on the models/ directory on the root of the cloned repository directory, and converted by running the script convert_ssd_512.py.
SSD model converter can also be obtained as a standalone software here.
In order to use the model and code included in this repository, it may be useful to update your PYTHONPATH. Provided you cloned this repository at ~/libs/headpose_final:
```
export PYTHONPATH=$PYTHONPATH:~/libs/headpose_final/:~/libs/headpose_final/models/
```

Quick Start guide

Clone this repository to a directory of your choice.

git clone https://github.com/rafabs97/headpose_final <directory>

Place models/keras_ssd512.py, bounding_box_utils and keras_layers from here at the root of the cloned repository directory.
Place models/head-detector.mat from here on the models/ directory on the root of the cloned repository directory.
Run the script convert_ssd_512.py.
Run the script demo_image.py. The output should match the demo output at the top of this page.

Software requirements

OS: Ubuntu 16.04 or later (and derivatives), Windows 7 or later, macOS 10.12.6 or later (no GPU support).
Python: Version 3.6.
NVIDIA Software: GPU Drivers (410.x or later), CUDA (10.0) and cuDNN (7.4.1 or later for CUDA 10.0).
TensorFlow: with or without GPU support, versión 1.14.0.
Keras: Version 2.2.4.
OpenCV: Version 4.1.0.25.
Other Python libraries: glob2 (0.7), numpy (1.17.1), pandas (0.25.1), pillow (6.1.0), scikit-learn (0.21.3).

Video demo

A video processed with this software can be found here.

Acknowledgements

Picture used in demo by Ross Broadstock. Licensed under CC BY 2.0 license.

Original video used in demo by Bailey Fisher.

kekonaut/headpose_final