setup_linux.md

Setting up the Temporal Annotation Tool (TaTo) - Linux

Dependencies

The TaTo tool has been tested using the following system configuration:

OS: Ubuntu 18.04, Windows 10
Dependencies: Python 3.8, OpenCV-Python 4.2.0, VCD 4.3.0. Add: FFMPEG and ffmpeg-python for DExTool.

Environment for Ubuntu

• Please make sure you have Python 3 installed in your system
• Verify pip is installed, if not install:

  sudo apt-get install python3 python3-pip

  pip3 install --upgrade pip

• (Optional) It is recommended to create a virtual environment in Python 3 (more info here):
  • Configure a new virtual environment:

    mkdir anntool_py

    python3 -m venv anntool_py

  • Activate the virtual environment:

    source anntool_py/bin/activate

• Install the dependencies

  pip3 install opencv-python numpy vcd

• For DExTool, install the dependecies:

  pip3 install --upgrade setuptools
  sudo apt update
  sudo apt install ffmpeg
  pip3 install ffmpeg-python

• Go to directory that contains the tool scripts.

Launching TaTo

In a terminal window within the folder annotation_tool run:

python TaTo.py

The tool will ask you to input the path of the video you want to annotate. Please insert the path following the DMD file structure.

The annotation tool TaTo opens with three windows.

Launching DEx

In a terminal window, within the folder exploreMaterial-tool run

python DExTool.py

The tool will ask you to input the task you wish to perform.