People Tracking
The Reading People Tracker
This page is the Reading People Tracker's home page where you can download its
source code for free.
Introduction
The Reading People Tracker is a software for tracking people in camera images for visual surveillance purposes. It originates from research work on people tracking for automatic visual surveillance systems for crime detection and prevention. It was built within the context of two PhD theses (by AM Baumberg and NT Siebel) and contains state-of-the art image processing algorithms. It is easily maintainable and well documented. Therefore it can (and has already been) easily be adapted to new requirements and different projects.
The Reading People Tracker contains the necessary functionality to read video sequences from hard disk or a video camera (IEEE1394/DV), to manipulate the images with image filters and to analyse them with a number of detection and tracking modules.
The Reading People Tracker as it exists today was developed by
Nils T Siebel in the European Framework V research project
ADVISOR. It is based on the
Leeds People Tracker which was developed by
Adam Baumberg. Starting from there it took 3 years of work on software and algorithms to develop what is now called the "Reading People Tracker". This work was carried out while I was a part of The University of Reading's
Computational Vision Group. (Hence the little imaginative current name for this piece of software...)
Now that the ADVISOR project has finished the Reading People Tracker is still being maintained and available for download below. Recent code changes include better support for newer compilers and a number of bugfixes. There has also been some support by the community in the form of bugfixes and a few small additions. This has increased stability and ease of use. The tracking functionality itself has not changed significantly since release 1.25 in 2003. However, an update to the newest version is strongly recommended for all current users.
For information on the tracking algorithms that are part of the Reading People Tracker please have a look at this
people tracking page. Many more details can be found in my PhD thesis and a few more details in the ECCV2002 article. A must read for users is also the User's Manual. All of these references are available from my
publications page.
Source Code and Some Notes
The source code of the Reading People Tracker is available for download below. The terms of the license can be found in the file
COPYRIGHT which is part of the software package.
Important Notes
First of all, please do not expect this free piece of software to be in any way "plug and play" as you might from a $5,000 software. Although care has been taken to make the code as easy to understand and maintain as possible, my resources are limited. Nevertheless, the source code
is documented and a number of other sources of information is available. For most problems with the software, information can be found and should be searched for in the following places (depending on the nature of the problem):
- Installation/Compilation: See files README and the Makefile definitions in generic.mk.
- Configuration Options: See the help for the individual option in the GUI or its definition in the code.
- Functionality: The most comprehensive source is my PhD thesis. An overview is given in the ECCV2002 article and on my web page on people tracking.
- Do not forget to check the User's Manual in any case!
It should also be noted that unless you are a programmer you might not find it very easy to install and navigate the tracker. Inventing or improving algorithms is done by programming in C++, so unless you can work with C++ you should carefully consider whether to start working with the Reading People Tracker.
Copyright Notice
Although the source code is available for download it comes with its own terms of use and copyright restrictions. The software license which applies to the Reading People Tracker and all material that comes with it (unless otherwise stated) is a modified version of the
GNU GPL. The terms of the license can be found in the file
COPYRIGHT which is part of the software package. In effect it allows the use of the material under the GNU GPL with the exception that the software and all parts of it may NEVER BE USED FOR ANY MILITARY PURPOSE, whether it be research or not, commercial or otherwise.
The Source Code
Current Release: 1.28 of Tue Nov 29 2005.
Release Notes
Release 1.28 is a maintanance release and does not feature new tracking functionality. A few problems have been solved, e.g. when compiling with gcc version 4.x. One or two bugs have also been found and removed. A detailed change log can be found in the file CHANGES which is part of the software package.
Downloads
Necessary External Libraries
The Reading People Tracker uses external libraries for mathematics, XML and graphical display. They are available through these links:
You will most probably need to adjust the file generic.mk to reflect the location of the libraries in your system. Some of the libraries are also readily available as RPM packages for GNU/Linux systems, see e.g.
the RPM Find facility. In fact, most modern GNU/Linux distributions already ship with BLAS and LAPACK as optional system libraries.
Support (or rather, lack thereof)
Please note that due to the limited time available to me I am unable to provide support for the People Tracker. Should you have a general support query (e.g, how to use the tracker in a particular art project) you are welcome to write me an e-mail, even though it might take some time until I actually answer. Should you, on the other hand, have problem installing libraries under Linux or getting the tracker to read images from hard disk, I would advise you to ask your friend or colleague with Linux administration, programming and/or image processing background to give you a hand. However, if you have worked with the tracker and you have implemented an extension or found a fix for a bug (I am sure there are some, albeit I do not know of any) please consider contributing your improvements to the community by sending me your changed code. Naturally, I will credit you for your work (see the file CHANGES for examples).
Author of these pages:
Nils T Siebel.
Last modified on Wed May 26 2010.
This page and all files in these subdirectories are Copyright © 2004-2010 Nils T Siebel, Berlin, Germany.