A humble image tracking code

This is a humble image tracking code. It is humble because it does what it can.

Installation

Intall latest version directly from PyPI with

pip install tracking-markers

Or install from this repository (assuming you have access to the repo and ssh keys are set up in your GitHub account) with

pip install git+ssh://git@github.com/bertoldi-collab/tracking-markers.git@main

Or clone the repository and install with

git clone git@github.com:bertoldi-collab/tracking-markers.git
cd tracking-markers
pip install -e .

How to use

CLI

Run in a terminal

tracking-markers path/to/video.mp4

See tracking-markers --help for more info on all the options.

Python

The main module is tracking_points.py defining the track_points(...) function that actually does the tracking of a given video and the function select_markers(...) that allows the manual selection of markers. These functions can be used independently. The file tracking_points.py can also be used as a script.

Some info

• It is based on the OpenCV library.
• Allows for markers to be manually selected or an np.ndarray of markers can be loaded from a file.
• Works best on high-contrast videos.