The LIRIS human activities dataset - Actreader

Main page | download | database structure | annotations in XML | camera calibration | annotation tools | evaluation tools

You need to cite the following journal paper in all publications including results for which you used the LIRIS dataset:.

C Wolf, J. Mille, E. Lombardi, O. Celiktutan, M. Jiu, E. Dogan, G. Eren, M. Baccouche, E. Dellandrea, C.-E. Bichot, C. Garcia, B. Sankur, Evaluation of video activity localizations integrating quality and quantity measurements, In Computer Vision and Image Understanding (127):14-30, 2014.

Installation

The reader is available at our download page. It runs under Windows, Mac OS and Linux. It is written in python therefore needs the following things to be installed:

Usage

The following examples are illustrated with screenshots taken on Mac OS. However, the tool behaves in the same way on Windows and Linux.

The actreader tool must be started from the command line. It requires two options: (1) a string consisting of the path to the .jpg files to annotate + a prefix of the filenames, (2) the name (and eventual path) of the .xml file with the annotations:

actreader.py D1-compressed/vid0042/gray D1-annotation/vid0042.xml

As usual, the two directories are relativ to the current working directory. To shorten the arguments to pass to the program, we therefore recommend to cd to the directory of the data before starting the program, e.g.:

The command given above will search all frame files in the folder D1-compressed/vid0043 (the frames of video number 43 in this example) and whose name begins with "gray". This name prefix is necessary in order to ignore the depth frames, which might be in the same directory.

The main window of the apllication is shown in the figure below.

Navigation from one frame to the next (or previous) frame is done with the cursor keys (LEFT, RIGHT). Quickly jumping 50 frames forward or backward can be done by PAGE UP and PAGE DOWN.

The listbox at the right displays the list of all actions together with the action class. ATTENTION: the number shown on the left upper corner of each rectangle is the running ID of the action, NOT ITS CLASS!

Modifying annotations

If you want to edit XML annotations, you might be interested in the Actanno tool.

Credits

Actreader was written by Christian Wolf, Eric Lombardi and Julien Mille.

Send questions to christian.wolf (at) liris.cnrs.fr

You need to cite the following journal paper in all publications including results for which you used the LIRIS dataset:.

C Wolf, J. Mille, E. Lombardi, O. Celiktutan, M. Jiu, E. Dogan, G. Eren, M. Baccouche, E. Dellandrea, C.-E. Bichot, C. Garcia, B. Sankur, Evaluation of video activity localizations integrating quality and quantity measurements, In Computer Vision and Image Understanding (127):14-30, 2014.