Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gaborvecsei/Color-Tracker
Color tracking with OpenCV
https://github.com/gaborvecsei/Color-Tracker
color-detection color-tracker computer-vision hacktoberfest hactoberfest2020 hsv image-processing machine-learning multi-object-tracking numpy object-detection object-tracking opencv opencv-python python tracker
Last synced: 26 days ago
JSON representation
Color tracking with OpenCV
- Host: GitHub
- URL: https://github.com/gaborvecsei/Color-Tracker
- Owner: gaborvecsei
- License: mit
- Created: 2017-08-29T17:07:04.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-10-22T18:29:50.000Z (about 4 years ago)
- Last Synced: 2024-11-17T12:09:31.231Z (about 1 month ago)
- Topics: color-detection, color-tracker, computer-vision, hacktoberfest, hactoberfest2020, hsv, image-processing, machine-learning, multi-object-tracking, numpy, object-detection, object-tracking, opencv, opencv-python, python, tracker
- Language: Python
- Homepage:
- Size: 65.2 MB
- Stars: 167
- Watchers: 6
- Forks: 35
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.codacy.com/app/vecseigabor.x/Color-Tracker?utm_source=github.com&utm_medium=referral&utm_content=gaborvecsei/Color-Tracker&utm_campaign=Badge_Grade)
[](https://badge.fury.io/py/color-tracker)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://zenodo.org/badge/latestdoi/101786270)
# Color Tracker - Multi Object Tracker
Easy to use **multi object tracking** package based on colors :art:
## Install
```
pip install color-tracker
```
```
pip install git+https://github.com/gaborvecsei/Color-Tracker.git
```
## Object Tracker
- Check out the **[examples folder](examples)**, or go straight to the **[sample tracking app](examples/tracking.py)** which is an extended version of the script below.
This script tracks the red-ish objects, if you'd like to track another color, then start with the `hsv_color_detector.py` script
``` python
$ python examples/tracking.py --help
usage: tracking.py [-h] [-low LOW LOW LOW] [-high HIGH HIGH HIGH]
[-c CONTOUR_AREA] [-v]
optional arguments:
-h, --help show this help message and exit
-low LOW LOW LOW, --low LOW LOW LOW
Lower value for the HSV range. Default = 155, 103, 82
-high HIGH HIGH HIGH, --high HIGH HIGH HIGH
Higher value for the HSV range. Default = 178, 255,
255
-c CONTOUR_AREA, --contour-area CONTOUR_AREA
Minimum object contour area. This controls how small
objects should be detected. Default = 2500
-v, --verbose
```
- Simple script:
``` python
import cv2
import color_tracker
def tracker_callback(t: color_tracker.ColorTracker):
cv2.imshow("debug", t.debug_frame)
cv2.waitKey(1)
tracker = color_tracker.ColorTracker(max_nb_of_objects=1, max_nb_of_points=20, debug=True)
tracker.set_tracking_callback(tracker_callback)
with color_tracker.WebCamera() as cam:
# Define your custom Lower and Upper HSV values
tracker.track(cam, [155, 103, 82], [178, 255, 255], max_skipped_frames=24)
```
## Color Range Detection
This is a tool which you can use to easily determine the necessary *HSV* color values and kernel sizes for you app
You can find **[the HSV Color Detector code here](examples/hsv_color_detector.py)**
``` python
python examples/hsv_color_detector.py
```
## Donate :coffee:
If you feel like it is a **useful package** and it **saved you time and effor**, then you can donate a coffe for me, so I can keep on staying awake for days :smiley:
## About
Gábor Vecsei
- [Website](https://gaborvecsei.com)
- [Personal Blog](https://gaborvecsei.com)
- [LinkedIn](https://www.linkedin.com/in/gaborvecsei)
- [Twitter](https://twitter.com/GAwesomeBE)
- [Github](https://github.com/gaborvecsei)
```
@misc{vecsei2018colortracker,
doi = {10.5281/ZENODO.4097717},
howpublished={\url{https://github.com/gaborvecsei/Color-Tracker}},
author = {Gabor Vecsei},
title = {Color Tracker - Multi Object Tracker},
year = {2018},
copyright = {MIT License}
}
```