Social Distance Detector
A Real-Time Social Distance Monitoring Tool
Table of Contents
- Motivation
- YOLO Theory
- Detection Output
- Tech Stack
- Functionalities
- To Do and Further Improvements
- Requriements
- Run Locally
- License
- Contributors
Motivation
The current COVID-19 pandemic is showing negative effects on human health as well as on social and economic life. It is a critical and challenging task to revive public life while minimizing the risk of infection. Reducing interactions between people by social distancing is an effective and prevalent measure to reduce the risk of infection and spread of the virus within a community. And so, this project will help to monitor that.
YOLO Theory
YOLO or You Only Look Once is an algorithm that uses neural networks to provide real-time object detection. Object detection in YOLO is done as a regression problem and provides the class probabilities of the detected images. As the name suggests, the algorithm requires only a single forward propagation through a neural network to detect objects.
Detection Output
A single frame from Video 1
A single frame from Video 2
Tech Stack
- Python
Functionalities
- Detect people who are practicing social distancing and those who are not.
- Draw a green coloured box around those who are practicing social distancing and red for those who are not.
- Display the following information :
- The threshold values used for detection.
- Number of people recognized.
- Number of people who are practicing social distancing.
- Number of people who are not practicing social distancing.
To Do and Further Improvements
- Using YOLO for Image Detection
- Calculate the distance between people and categorise them as safe and unsafe
- Draw green coloured boxes for those who follow social distancing and red for those who don't.
- Detect and draw boxes for image, video and live stream.
- Adding Birds-Eye View for the Video
- Work on the minimum pixel distance for different media.
- Assign a score at the end of the video/stream for every person based on the time they were not socially distanced.
Requirements
The following dependencies and modules(python) are required, to run this locally
- os, sys, argparse
- math
- mimetypes
- numpy==1.21.2
- opencv-python==4.5.3.56
To install the requirements run:
$ pip install -r requirements.txt
Run Locally
- Clone the GitHub repository
$ git clone git@github.com:Pranav1007/Social-Distance-Detector.git
- Move to the Project Directory
$ cd Social-Distance-Detector
-
Create a Virtual Environment (Optional)
- Install Virtualenv using pip (If it is not installed)
$ pip install virtualenv
- Create the Virtual Environment
$ virtualenv sdd
-
Activate the Virtual Environment
- In MAC OS/Linux
$ source sdd/bin/activate
- In Windows
$ source sdd\Scripts\activate
-
Install the requirements
(sdd) $ pip install -r requirements.txt
- Run the python script run.py along with the appropriate arguements
(sdd) $ python3 run.py -m v -p media/test.mp4
- Usage
"""
Usage:
usage: run.py [-h] [-m MEDIA] [-p PATH]
optional arguements:
-h --help Show this screen and exit.
-m MEDIA --media MEDIA Media Type (image(or i), video(or v), webcam(or w))
-p PATH --path PATH Path of the Media File (For webcam enter any character)
"""
- Other options to Edit
"""
You can go to the utilities/config.py and change the threshold values based on the video and system requirements.
"""
# If you want to use GPU:
Set USE_GPU = True
# If you want to increase or decrease the minimum threshold distance
Modify the DIST_THRES value
# If you want to change the Non Maximum Supression Threshold or Confidence Threshold
Modify the NMS_THRESH or CONF_THRESH values respectively
- Dectivate the Virtual Environment (after you are done)
(sdd) $ deactivate
License
This project is under the Apache-2.0 License License. See LICENSE for Details.
Contributors
 Pranav B Kashyap
|
 Prakhar Singh
|
 Avi Tewari
|
1 Dec 18, 2021
16 Dec 30, 2022
1.9k Jan 6, 2023
40 Sep 14, 2022
576 Dec 29, 2022
962 Dec 23, 2022
13.1k Jan 2, 2023
53 Nov 9, 2022
1 Feb 15, 2022
1 Dec 14, 2021
2 Mar 24, 2022
507 Dec 4, 2022
360 Dec 10, 2022
48 Nov 27, 2022
1 Oct 27, 2021
168 Dec 27, 2022
2 Oct 20, 2022