Ivy

Ivy is an open source video-based vehicle counting system which employs several computer vision techniques to detect, track and count vehicles in a traffic scene.

Requirements

• Python 3

Setup

• Clone this repo [email protected]:nicholaskajoh/ivy.git.
• Create and/or use a virtual environment (optional but recommended).
• Install the dependencies in requirements.txt pip install -r requirements.txt.
• Choose a detector and install its dependencies where necessary (if you're not sure what to pick, we recommend you start with yolo).

Run

• Create a .env file (based on .env.example) in the project's root directory and edit as appropriate.
• Run python -m main.

Demo

Download ivy_demo_data.zip and unzip its contents in the data directory. It contains detection models and a sample video of a traffic scene.

Test

python -m pytest

Debug

By default, Ivy runs in "debug mode" which provides you a window to monitor the vehicle counting process. You can:

• press the p key to pause/play the counting process
• press the s key to capture a screenshot
• press the q key to quit the program
• click any point on the window to log the coordinates of the pixel in that position

Community

Got questions, contributions, suggestions, concerns? Join our community on Spectrum!

Donate

Love this project? You can buy me a coffee or two to support its continued development. 😊