ShiqiYu/libfacedetection

An open source library for face detection in images. The face detection speed can reach 1000FPS.


repo name	ShiqiYu/libfacedetection
repo link	https://github.com/ShiqiYu/libfacedetection
homepage
language	C++
size (curr.)	89209 kB
stars (curr.)	8410
created	2015-01-20
license	Other

libfacedetection

This is an open source library for CNN-based face detection in images. The CNN model has been converted to static variables in C source files. The source code does not depend on any other libraries. What you need is just a C++ compiler. You can compile the source code under Windows, Linux, ARM and any platform with a C++ compiler.

SIMD instructions are used to speed up the detection. You can enable AVX2 if you use Intel CPU or NEON for ARM.

The model file has also been provided in directory ./models/.

examples/detect-image.cpp and examples/detect-camera.cpp show how to use the library.

The library was trained by libfacedetection.train.

Examples

How to use the code

You can copy the files in directory src/ into your project, and compile them as the other files in your project. The source code is written in standard C/C++. It should be compiled at any platform which support C/C++.

Some tips:

Please add -O3 to turn on optimizations when you compile the source code using g++.
Please choose ‘Maximize Speed/-O2’ when you compile the source code using Microsoft Visual Studio.
You can enable OpenMP to speedup. But the best solution is to call the detection function in different threads.

You can also compile the source code to a static or dynamic library, and then use it in your project.

How to compile

CNN-based Face Detection on Windows

Method	Time	FPS	Time	FPS
	X64	X64	X64	X64
	Single-thread	Single-thread	Multi-thread	Multi-thread
cnn (CPU, 640x480)	58.03ms	17.23	13.85ms	72.20
cnn (CPU, 320x240)	14.18ms	70.51	3.38ms	296.21
cnn (CPU, 160x120)	3.25ms	308.15	0.82ms	1226.56
cnn (CPU, 128x96)	2.11ms	474.38	0.52ms	1929.60