****************************************************************************
Tracking in Unstructured Crowded Scenes
Rodriguez, Ali, Kanade. ICCV 2009.
http://www.di.ens.fr/~rodrigue/crowd_tracking.html
****************************************************************************
I. Description
    This standalone application implements the algorithm described in “Tracking in Unstructured Crowded Scenes”, ICCV 2009.  The application supports the following features:
    o   Learning crowd motion patterns
    o   Target tracking by manually selecting the initial target location in a frame
    o   Target tracking by specifying  the initial target location via a comma separated text file (x,y)
    o   Outputs .mat files containing the tracker position at each frame 

	
II. File List
	-ctm_crowd_tracker 
	-run_ctm_crowd_tracker.sh (shell script run to
                             temporarily set environment variables
                             and execute the application)
	-MCRInstaller.bin
	-blank.jpg
	-busy.jpg
	-sample_video/
	-sample_target_file.txt
	-This readme file 


III. Requirements
	MATLAB Compiler Runtime (MCR) version 7.11  (installer included)
	Add the MCR directory to the system path  specified by the target system's environment variable. 


IV. How to Use
	1)	In a terminal window run: chmod  +x run_ctm_crowd_tracker.sh
	2)	Execute the shell script file run_ctm_crowd_tracker.sh  <MCR directory location>
	3)	Click on “Load Video”
	4)	Find a directory containing video frames. The frame files must have the following format: frame####.jpg
	5)	Once the video has been loaded wait for processing to finish
	6)	Select a target to track. This can be done by clicking on “Select target” and subsequently clicking on the subject to track within the frame. Alternately, a target can be specified via a comma separated file that contains the x and y target coordinates within the first frame.
	7)	Targets are tracked for 100 frames. Click "Stop" to interrupt the tracker.
	

VI. History
	Version 1.1.1001 - First release


VII. Compatibility
    This application has been tested under the following platforms:
    Ubuntu 9.10 (Karmic Koala)

	
VIII. Additional Resources
   For more information  please visit:
   http://www.di.ens.fr/~rodrigue/crowd_tracking.html

