File	Date	Author	Commit
3rdparty	2013-05-10	Manuel Martos	[918efd] Merge branch 'master' of ssh://git.code.sf.net/...
bin	2013-05-13	Manuel Martos	[fc0542] Haar object detection
data	2013-05-08	Manuel Martos	[82fac7] Initial commit
lib	2013-05-08	Manuel Martos	[82fac7] Initial commit
samples	2013-05-10	Manuel Martos	[aa78cf] eval procedure
src	2013-05-17	Manuel Martos	[ca4ae3] license copy
test	2013-05-10	Manuel Martos	[7a6fb1] update
LICENSE.txt	2013-05-17	Manuel Martos	[2a983f] license copy
README.txt	2013-05-13	Manuel Martos	[50bf73] Deleting resources

Read Me

objectMaps: Java application for content-based Video Summarization with still image
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Manuel Martos Asensio
Horst Eidenberger
Xavier Giro-i-Nieto

Vienna University of Technology (TUWien)
Technical University of Catalonia. BARCELONATECH (UPC)


This software implements a customized content-based video summarization system

Contents of the package:
========================
- bin - the executable jar file
- data
  - haarcascades - contains haar cascade samples for object detection
  - partmodels - contains object model samples for deformable part object recognition
- 3rdparty - contains 3rd party source codes used in the application
- lib - contains source libraries
	- include - contains libraries that must be included if the source code is used.
	- opencvlib - contains OpenCV v 2.4.3 and Ffmpeg libraries used by the application.
	- partsdetector - contains the parts-based detector executable (Win 32bin) and its libraries.
- samples - contains image samples to run 3rd party object detectors
- test - contains all the data used for the user-based evaluation process
	- imdb - contains the manually generated image collection extracted from IMDb site (http://www.imdb.com/) of each video
	- objectmap - contains summaries generated with the application
	- uniform - contains uniform sampled summaries
	- video_URLs.txt - contains all the videos used in the user evaluation process
	- procedure.txt - contains the information showed to the participants of the user-based evaluation process

Requirements:
=============
This software has been tested on Windows 7 with Java Runtime Environment 6 (32 bits) with the following libraries:
 - javacv - v0.3 (required)
 - opencv - v2.4.3 (required)
 - ffmpeg - 2012-10-29 git-11d695d (required)
 - HDF5 - v1.8.10   (optional; used for part-based object detector on Windows)

All the required libraries and codes are already included in the package.

Quick start:
============
A) Testing the application
	1. Unpack in <objectMaps_directory>
	2. cd <objectMaps_directory>
	3. java -jar bin/objectMaps.jar <input_video> [ -h <help> -d <debug> -v<verbose> <cascade_file> <model_file> <image_file> ]
	Examples:
		> java -jar bin/objectMaps.jar samples/fast_and_furious.mp4 -d -v
		> java -jar bin/objectMaps.jar samples/fast_and_furious.mp4 data/haarcascades/haarcascade_frontalcar.xml
		> java -jar bin/objectMaps.jar samples/fast_and_furious.mp4 -v data/partmodels/car_v6.mat
	
If the program has finished correctly, you will find a ".objectMaps" directory in your "user.home" directory.
Inside <objectmaps_result> directory, you will find the saved libraries, executables, and a <video_name> directory containing the resulting image and a description file with the following structure:

<video_frame_rate>
<frame_number_i> <x_i> <y_i> <width_i> <height_i>
where <x_i> <y_i> <width_i> <height_i> are the origin coordinates of the i-th tile and its width and height
and <frame_number_i> the painted frame number of the source video in the i-th tile

Tip: use "java -jar bin/objectmaps.jar --help" to see the application usage message.
Tip 2: included libraries are compiled using 32bits. objectMaps.jar application can only be executed using a 32bit JRE.

Compiling and running the Object Maps source code with Eclipse:
===============================================================
1)	Creating a new Eclipse Java Project
	1.1)	Create a new project using the New Project Wizard
	1.2)	Include all the contents of the <objectMaps_directory>/src directory to the project
	1.3)	Add references to the libraries located in <objectMaps_directory>/lib/include with Properties > Java Build Path > Add external JARs

	Your project is already created. 

Notes:
- 	OpenCV - compiled libraries are Windows 32-bits version. Visit their site to download other OS versions: http://opencv.org/
- 	Libpabod - Generated executable file runs on Windows. If you want to run parts-based object recognition executable into another OS (it will be saved to "user.home"/.objectMaps/bin after the first execution of ObjectMaps project along with compiled libraries), you may compile it from its sources. 
	Please, read <objectMaps_directory>/libpabod_v0.2.4_lite/INSTALL files or visit authors' site for more information and updates: http://www.uco.es/~in1majim/proyectos/libpabod/
	The executable should be located at <objectMaps_directory>/src/libLoader with the same name: detectobj2.exe
	
2)	Compile the code using Eclipse Export option
	2.1) 	Select the project and Export > Runnable JAR file
	2.2)	Click "Next" and browse the destination location
	2.3)	the option "Package required libraries into generated JAR"
	2.4)	Click "Finish"
	
	Your executable JAR file is already created. Run your executable ObjectMaps application and enjoy summarizing your videos.
	
Citation:
=========
If you use this library for your publications, please cite it as:
@misc{objectMaps,
 author = {Martos Asensio, Manuel. Eidenberger, Horst and Giro-i-Nieto, Xavier},
 title = {{ObjectMaps}: Content-based Video Summarization to Object Maps {Java}},
 year = {2013},
 note =	 {Software available at \url{http://sourceforge.net/p/objectmaps}}
}

Contact the authors:
====================
Manuel Martos Asensio (developer) - manuel.martos@estudiant.upc.edu / mmartos.asensio@gmail.com
Horst Eidenberger (advisor) - eidenberger@tuwien.ac.at
Xavier Giro-i-Nieto (advisor) - xavier.giro@upc.edu