========================================================
             Active Deformable Part Models
========================================================

AUTORIGHTS
-------------------------------------------------------
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.

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 J. 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 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:             detecting bounding boxes with scores


------- 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.

------- Source Code -----------------------------------
Our implementation is based on the publicly available 
original DPM and Cascade-DPM code.

Main source 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.


------- Contact --------------------------------------
Please direct all questions to:

Menglong Zhu <menglong@cis.upenn.edu>
http://cis.upenn.edu/~menglong