Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cj-mills/byte-track-eigen
ByteTrack-Eigen is a C++ implementation of the ByteTrack object tracking method, leveraging the Eigen library for high-performance matrix and vector operations.
https://github.com/cj-mills/byte-track-eigen
bytetrack eigen-library object-tracking
Last synced: 3 days ago
JSON representation
ByteTrack-Eigen is a C++ implementation of the ByteTrack object tracking method, leveraging the Eigen library for high-performance matrix and vector operations.
- Host: GitHub
- URL: https://github.com/cj-mills/byte-track-eigen
- Owner: cj-mills
- License: mit
- Created: 2023-11-16T00:39:39.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-16T21:53:24.000Z (11 months ago)
- Last Synced: 2023-12-16T22:43:28.790Z (11 months ago)
- Topics: bytetrack, eigen-library, object-tracking
- Language: C++
- Homepage:
- Size: 61.5 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ByteTrack-Eigen
## Introduction
ByteTrack-Eigen is a C++ implementation of the [ByteTrack](https://arxiv.org/abs/2110.06864) object tracking method, leveraging the Eigen library for high-performance matrix and vector operations. This library is designed for tracking objects in video frames using Kalman Filters and the Hungarian algorithm.
## Demo Video
https://github.com/cj-mills/byte-track-eigen/assets/9126128/1f3b0fa4-676c-4050-83e4-c8c7d118be56
> Source Video by RDNE Stock project from Pexels: ([link](https://www.pexels.com/video/a-woman-giving-a-thumbs-up-10373924/))
## Features
- Object tracking using Kalman Filters and Hungarian algorithm.
- Handling of occlusions and re-identifying lost objects.
- Utilization of the Eigen library for optimized matrix and vector operations.
## Components
- `BaseTrack`: Foundational class for object tracking.
- `BoundingBoxTrackUtils`: Utility functions for track operations.
- `BYTETracker`: Main class for the BYTE tracking algorithm.
- `HungarianAlgorithmEigen`: Hungarian Algorithm implementation with Eigen.
- `KalmanBBoxTrack`: Kalman filter-based bounding box tracking.
- `KalmanFilter`: Kalman filter implementation for tracking bounding boxes in image space.
- `LinearAssignment`: Solves linear assignment problems using the Hungarian Algorithm.
- `BoundingBoxIoUMatching`: Utility functions for bounding box operations.
## Requirements
- CMake 3.20 or higher.
- C++17 or higher.
- [Eigen library](http://eigen.tuxfamily.org) (automatically downloaded by CMake).
## Building the Library
1. Clone the repository:
```bash
git clone https://github.com/cj-mills/byte-track-eigen.git
```
2. Navigate to the project directory:
```bash
cd byte-track-eigen
```
3. Build the project using CMake:
```bash
mkdir build && cd build
```
```bash
cmake ..
```
## Usage
Here is an example of how to use ByteTrack-Eigen in your project:
```cpp
// Example usage of ByteTrack-Eigen
#include "BYTETracker.h"
int main() {
float track_thresh = 0.23f;
int track_buffer = 30;
float match_thresh = 0.8;
int frame_rate = 30;
BYTETracker tracker(track_thresh, track_buffer, match_thresh, frame_rate);
}
```
## Demo Projects
* [yolox-bytetrack-onnx-demo](https://github.com/cj-mills/yolox-bytetrack-onnx-demo): A Visual Studio project demonstrating how to perform object tracking across video frames with YOLOX, ONNX Runtime, and the ByteTrack-Eigen library.
* [unity-bytetrack-plugin](https://github.com/cj-mills/unity-bytetrack-plugin): A simple native plugin for the Unity game engine, built in Visual Studio, that leverages the ByteTrack-Eigen library to perform real-time object tracking.
## License
This project is licensed under the [MIT License](LICENSE).
## Acknowledgments
Special thanks to the Eigen library [team](https://gitlab.com/libeigen/eigen/-/project_members) and [authors](https://arxiv.org/abs/2110.06864) of the ByteTrack algorithm.