OAT Object Annotation Tool

Andrea Pennisi

Object Annotation Tool (OAT) is an open source tool for easily annotating videos and sets of images. OAT has been developed in C++ and it exploits OpenCV 2 functions, Boost functions and QT4 functions.



OAT is an open source tool able to annotate videos or images in PETS format.

The XML files generated by OAT has the following format:

 <frame number="0">
   <object id="0">
    <box h="36" w="38" xc="207" yc="197" />
    <object id="1">
    <box h="46" w="34" xc="245" yc="188" />
   <object id="2">
    <box h="38" w="28" xc="294" yc="172" />

If you use OAT, please cite this webpage




OAT is provided without any warranty about its usability. It is for educational purposes and should be regarded as such.



OAT Prerequisites



Build OAT

OAT is provided with a CMakeLists.txt file and can be compiled by using CMake.


  1. Clone the repository annotationtool
  2. $cd annotationtool/
  3. $mkdir build
  4. $cd build
  5. $cmake ..
  6. $make



OAT has a GUI for selecting videos and images to annotate.


$cd annotationtool/bin


By clicking on "Open Video or Open Images", you can select a video file or a folder containing a set of images.

By clicking on "Load XML", you can select an XML file in (PETS format) and load a previous annotation in order to extend it. Instead, by clicking on "Save", you can save an XML file in PETS format

You can use your mouse for drawing rectangles around objects.

You can select a rectangle by clicking inside the rectangle with your mouse...

...or by using the specific menu.

Moreover, when a rectangle is selected, you can:

  • Hide the rectangle, if the object disappears from the scene
  • Delete the rectangle
  • Resize the rectangle by clicking the top left corner or the bottom right corner
  • By clicking the right button, a menu that contains "Associate", "Hide" and "Remove" button, appears
  • By using Up, Down, Left, Right keys, you can move your rectangle
  • By holding the left button of your mouse on the selected rectangle, you can move the rectangle

Furthermore, by using the "Next" and "Prev" buttons, the rectangle are automatically reprojected into the next/previous frames.



OAT has been written by Andrea Pennisi.