Simple object detection for Menpo images
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
conda
docs
menpodetect
.gitattributes first dlib-based version of face detection Sep 11, 2014
.gitignore
.travis.yml
AUTHORS.txt
LICENSE.txt
MANIFEST.in
README.md
appveyor.yml
menpodetect-logo.png
readthedocs.yml
setup.cfg
setup.py
versioneer.py

README.md

menpodetect

Coverage Status PyPI Release BSD License
Python 2.7 Support Python 3.4 Support Python 3.5 Support

menpodetect - Simple object detection

Simple object detection within the Menpo Project. We do not attempt to implement novel techniques, but instead wrap existing projects so that they integrate nicely with Menpo. At the moment the current libraries are wrapped:

  • dlib (Boost Software License - Version 1.0)
    Frontal face detection, arbitrary dlib models and training code is all wrapped.
  • opencv (BSD) Frontal face detection, profile face detection, eye detection and arbitrary OpenCV cascade files (via loading from disk) are all provided.
  • pico (Academic Only) Frontal face detection and arbitrary pico models are provided. Loading arbitrary Pico models is likely to be very difficult, however.
  • ffld2 (GNU AGPL) Frontal face detection using the DPM Baseline model provided by Mathias et. al.. Training code is also wrapped, but requires explicit negative samples.
  • bob.ip.facedetect (GPL v3) Frontal face detection based on the PhD thesis of Cosmin Atanasoaei of EPFL based on an ensemble of weak LBP classifiers. Not currently shipped using conda and therefore must be installed independently.

Important

This project aims to wrap existing object detection libraries for easy integration with Menpo. The core project is under a BSD license, but since other projects are wrapped, they may not be compatible with this BSD license. Therefore, we urge caution be taken when interacting with this library for non-academic purposes.

Installation

Here in the Menpo team, we are firm believers in making installation as simple as possible. Unfortunately, we are a complex project that relies on satisfying a number of complex 3rd party library dependencies. The default Python packing environment does not make this an easy task. Therefore, we evangelise the use of the conda ecosystem, provided by Anaconda. In order to make things as simple as possible, we suggest that you use conda too! To try and persuade you, go to the Menpo website to find installation instructions for all major platforms.

If you want to try pip installing this package, note that you will need to satisfy the dependencies as specified in the meta.yaml BEFORE install.

Build Status

CI Host OS Build Status
Travis Ubuntu 12.04 (x64) Travis Build Status
Jenkins OSX 10.10 (x64) and Windows 10 (x86, x64) Jenkins Build Status

Documentation

See our documentation on ReadTheDocs