Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bertoldi-collab/tracking-markers
A humble image tracking code
https://github.com/bertoldi-collab/tracking-markers
computer-vision digital-image-correlation image-processing image-processing-python image-tracking opencv
Last synced: 4 months ago
JSON representation
A humble image tracking code
- Host: GitHub
- URL: https://github.com/bertoldi-collab/tracking-markers
- Owner: bertoldi-collab
- License: mit
- Created: 2023-11-02T21:10:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-08T14:46:32.000Z (4 months ago)
- Last Synced: 2024-10-13T07:46:03.776Z (4 months ago)
- Topics: computer-vision, digital-image-correlation, image-processing, image-processing-python, image-tracking, opencv
- Language: Python
- Homepage:
- Size: 4.85 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# A humble image tracking code


[](https://pypi.org/project/tracking-markers "Go to PyPI")

[](https://github.com/bertoldi-collab/tracking-markers/blob/main/LICENSE)
[](https://hits.seeyoufarm.com)This is a humble image tracking code.
It is humble because it does what it can.
![]()
## Installation
Intall latest version directly from PyPI with
```bash
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
```bash
pip install git+ssh://[email protected]/bertoldi-collab/tracking-markers.git@main
```Or clone the repository and install with
```bash
git clone [email protected]:bertoldi-collab/tracking-markers.git
cd tracking-markers
pip install -e .
```## How to use
### CLI
Run in a terminal
```bash
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`](tracking_markers/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`](tracking_markers/tracking_points.py) can also be used as a script.## Some info
- It is based on the [OpenCV](https://opencv.org/) 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.