jekkos / dense-trajectories Goto Github PK

### Compiling ###

In order to compile the dense trajectories code, you need to have the following libraries installed in your system:
* OpenCV library (tested with OpenCV-2.4.2)
* ffmpeg library (tested with ffmpeg-0.11.1)

Currently, the libraries are the latest versions. In case they will be out of date, you can also find them on our website: http://lear.inrialpes.fr/people/wang/dense_trajectories

If these libraries are installed correctly, simply type 'make' to compile the code. The executable will be in the directory './release/'.

### test video decoding  ###

The most complicated part of compiling is to install opencv and ffmpeg. To make sure your video is decoded properly, we have a simple code (named 'Video.cpp') for visualization:

./release/Video your_video.avi

If your video plays smoothly, congratulations! You are just one step before getting the features.

If there is a bug and the video can't be decoded, you need first fix your bug. You can find plenty of instructions about how to install opencv and ffmpeg on the web.

### compute features on a test video ###

Once you are able to decode the video, computing our features is simple:

./release/DenseTrack ./test_sequences/person01_boxing_d1_uncomp.avi | gzip > out.features.gz

Now you want to compare your file out.features.gz with the file that we have computed to verify that everything is working correctly. To do so, type:

vimdiff out.features.gz ./test_sequences/person01_boxing_d1.gz 

Note that due to different versions of codecs, your features may be slightly different with ours. But the major part should be the same.

There are more explanations about our features on the website, and also a list of FAQ.

### History ###

* May 2011: dense_trajectory_release.tar.gz

* September 2012: dense_trajectory_release_v1.1.tar.gz 
  With the latest libraries and bugs fixed, thanks Nguyen Chi Dat for bug reporting.

* September 2013: dense_trajectory_release_v1.2.tar.gz
  Much cleaner code, improved speed (2x as before), add 3 more dimensions for spatio-temporal pyramid.

### Bugs and extensions ###

If you find bugs, etc., feel free to drop me a line. Also if you developed some extension to the program, let me know and I can include it in the code. You can find my contact data on my webpage, as well.

http://lear.inrialpes.fr/people/wang/

### LICENSE CONDITIONS ###

Copyright (C) 2011 Heng Wang 

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.