color-tracker 0.0.3

Easy to use color tracking package for object tracking based on colors

[](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)
# Color Tracker

Easy to use color tracking package for object tracking based on colors :art:.

## Samples


<img width="400" src="art/ball_tracking.gif" />

## Install

- Python3
- OpenCV>=3
- NumPy

```
pip install color-tracker
```

## Basic Usage

- Testing if it got installed
```shell
>>> import color_tracker
>>> color_tracker.__version__
```

There is one **callback**:

- **tracking callback**: called at every frame of the tracking

You can find sample scripts at the `examples` folder

```python
import cv2
import color_tracker


def tracking_callback():
frame = tracker.get_frame()
debug_frame = tracker.get_debug_image()
object_center = tracker.get_last_object_center()

cv2.imshow("original frame", frame)
cv2.imshow("debug frame", debug_frame)
key = cv2.waitKey(1)
if key == 27:
tracker.stop_tracking()
print("Object center: {0}".format(object_center))


webcam = color_tracker.WebCamera(video_src=0)
webcam.start_camera()

tracker = color_tracker.ColorTracker(camera=webcam, max_nb_of_points=20, debug=True)
tracker.set_tracking_callback(tracking_callback=tracking_callback)
tracker.track(hsv_lower_value=(0, 100, 100),
hsv_upper_value=(10, 255, 255),
min_contour_area=1000)

webcam.release()
```

## Color Range Detection

With this tool you can easily determine the necessary *HSV* color values and kernel sizes for you app

(You can find this also in the `examples` folder)

```python
import color_tracker

cam = color_tracker.WebCamera(video_src=0)
cam.start_camera()

detector = color_tracker.HSVColorRangeDetector(camera=cam)
lower, upper, kernel = detector.detect()

print("Lower HSV color is: {0}".format(lower))
print("Upper HSV color is: {0}".format(upper))
print("Kernel shape is: {0}".format(kernel.shape))
```

## About

Gábor Vecsei

- [Website](https://gaborvecsei.com)
- [Personal Blog](https://gaborvecsei.wordpress.com/)
- [LinkedIn](https://www.linkedin.com/in/gaborvecsei)
- [Twitter](https://twitter.com/GAwesomeBE)
- [Github](https://github.com/gaborvecsei)