README.md

Vehicle Detection

1. Description.
2. Features
3. Technologies used
4. Installation
5. Screen shots
6. License

1. Description

A cross-platform application made as part of the project from software engineering on AGH University of Science and Technology.

2. Features and functionality

• Detection
• Categorization
• Possibility to run on different models
• Frame skipping & interpolation

3. Technologies used

• Python Language - application logic
• OpenCV - object detecion framwork
• PyQt - user inteface framework
• FFmpeg - video processing

3. Installation

PowerShell is highly recommended. No other legacy environments are supported Linux is also not supported.
Project developed under Python 3.8.6

For dummies

Just run build.ps1
If you are not allowed to run scripts type the following command Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Activate virtual enviroment .\<envName>\Scripts\activate.
Run app by typing python .\src\main.py (path must be relative).

For geeks

Virtualenv

1. Get virtualenv using pip3 install virtualenv
2. cd <project-directory>
3. virtualenv <envName>
4. .\<envName>\Scripts\activate
5. Install all required modules using pip3 install -r requirements.txt
6. Run app by typing python .\src\main.py

Here you go -> make sure to always run venv when doing the project
Hint: Set the Python interpreter in VSCode or PyCharm

---

Pipenv - Python packaging tool - an alternative to virtualenv

1. Activate Pipenv environment: pipenv shell
2. Install packages: pipenv install
3. Run app by typing python ./src/main.py

---

Weights - download and place in the "model" directory

YOLOv4

YOLOv3-tiny

YOLOv3

---

Configure libVLC and FFmpeg

libVLC is required for internal video player. FFmpeg is required for interpolating video.

1. Download latest VLC 3.0.11.
2. Extract libvlc.dll and copy it into the dlls folder. dlls folder must be in main directory.
3. Install FFmpeg choco install ffmpeg
   3.1 Alternatively download latest build from here and add ffmpeg.exe and ffprobe.exe to the $Path
$env:Path += ";<path_to_ffmpeg>".

4. Screen shots

5. Creators

Smendowski Mateusz, Śladowski Piotr, Twardosz Adam

6. License