Welcome to the home of Python Tracking Framework (PTF) - a collection of registration based trackers (like IC, ESM, NN, PF, RKLT and L1) along with related (and unrelated) utilities implemented in Python and Cython. Supporting Matlab scripts, mostly for analysis, visualization and evaluation of tracking performance, are also included.

Prerequisites:

• OpenCV
• Numpy
• Scipy
• Matplotlib
• FLANN (optional)
• Cython (optional)
• MTF (optional)
• Xvision (optional)

Installation

Python packages

wget https://bootstrap.pypa.io/get-pip.py
python2 get-pip.py
python3 get-pip.py
pip3 install six numpy scipy pillow scikit-image matplotlib imutils keyboard mouse psutil
pip3 install opencv-python==3.4.5.20 opencv-contrib-python==3.4.5.20

Windows @ Python_packages

pip3 install win32gui pywin32

C Modules

All optional Cython and C modules used by PTF can be compiled and installed by simply calling make from the root folder. This in turn calls the make commands in the following sub folders: CModules, cython_trackers, l1.

• It also executes the command to compile and install the Python interface to the Modular Tracking Framework called pyMTF. This requires the source code of this library to be present in ~/mtf folder. Change the variable MTF_DIR in the makefile if the source code is present elsewhere.

• If Xvision is not installed, either remove xv from the all target of the makefile before calling the make command or call the following separate commands instead:

  • make dl
  • make cython
  • make l1
  • make mtf

• If make does not work on your system (e.g. if it has Windows OS), run python setup_cython.py build_ext --inplace to compile the Cython modules.

Basic Usage

Setting parameters:

Set db_root_path in main.py if running on a dataset sequence otherwise select usb camera for source and adjust camera_id in main.py. All other parameters can be adjusted either from the GUI or in config.py.

Running with GUI:

python main.py

Running without GUI with default parameter settings in config.py:

python main.py 0