View on GitHub

ADPM

Fast object detector - Active Deformable Part Models

Download this project as a .zip file Download this project as a tar.gz file

About

Active Deformable Part Models is an active approach for part-based object detection, which optimizes the order of part filter evaluations and the time at which to stop and make a prediction. During inference, a learned policy is used as a look-up table to choose the part order and the stopping time based on the observed filter responses.

If you are using the code, please cite the followings:

Active Deformable Part Models Inference, Menglong Zhu,
Nikolay Atanasov, George Pappas and Kostas Daniilidis,
European Conference on Computer Vision (ECCV) 2014.

Active Deformable Part Models, Menglong Zhu, Nikolay Atanasov, 
George Pappas and Kostas Daniilidis, arXiv:1404.0334 [cs.CV]

Demo

To run the demo, simply run the following in MATLAB:

>> demo_pca_policy

The code assumes mex is setup in the system. If not, the pre-compiled Linux 64-bit and MacOSX 64-bit mex binaries are already provided under ./bin folder.

Note: You can comment out pca_policy_compile; at line 21 in demo_pca_policy.m, if having trouble compiling the code on your Linux/Mac system.

The demo will show the top ADPM detection of person and car in the example images.

API

Standalone API for detecting a class of object is provided as the following function call:

>> ds = detect_object(image_file, object_class, display)

where the input/output arguments are

image_file:     image file path 
object_class:   object class name
display:        boolean flag of displaying top detection 

ds:             detection bounding boxes with scores

Source Code

Our implementation is based on the publicly available original DPM and Cascade-DPM code. Main detection code is in ./src and ./mex folder. The main detection process is implemented in

./mex/detect_pca_policy.cc

Files under ./external are a subset of publicly available DPM code, refer to ./external/README for copyright.

Models

Original VOC DPM models and learned policies are contained in ./models. Currently, person and car models are provided. More PASCAL VOC models will be available soon.

AUTHORIGHTS

Copyright (C) 2013-2014 Menglong Zhu, Nikolay Atanasov, Samarth Brahmbhatt

This file is part of the Active Deformable Part Models code (http://cis.upenn.edu/~menglong/adpm.html) and is available under the terms of an MIT-like license provided in COPYING. Please retain this notice and COPYING if you use this file (or a portion of it) in your project.

Contact

Please direct all questions to:

Menglong Zhu menglong@cis.upenn.edu

http://cis.upenn.edu/~menglong