mahmodkhaled / simple-perception-stack-for-self-driving-cars

Object and lane detection project based on image processing.

Simple Perception Stack for Self-Driving Cars

In this project we are going to create a simple perception stack for self-driving cars (SDCs.) Although a typical perception stack for a self-driving car may contain different data sources from different sensors (ex.: cameras, lidar, radar, etc…), we’re only going to be focusing on video streams from cameras for simplicity. We’re mainly going to be analyzing the road ahead, detecting the lane lines, detecting other cars/agents on the road, and estimating some useful information that may help other SDCs stacks. The project is split into two phases. We’ll be going into each of them in the following parts.

Phase 1 - Lane Line detection 🌌

In this first phase, our goal is to write a software pipeline to identify the lane boundaries in a video from a front-facing camera on a car

Expected Output from Phase 1

Phase 2 - Objects detection 🚗

In this stage we are locating and identifying the cars on the road

Expected output from phase 2

Notes

in this phase object detecion doesn't work with Debugging Mode

Installation Guidelines ⚙️

The jupyter Notebook contains the code and Presentaion , we have written the actual codes plus some comments explaining what we were doing through out the project

the .py file contains the file that will run in the CMD

Files are : 📁

test_image_detection.ipynb this is the notebook

test_image_detection.py this is the python script that will run through CMD

Parameters List : 📝

1. Input (Video or Image) path
2. Output (Video or Image) path
3. Flag that indicates , the input whether it was an image or video
4. Flag that indicates the Debugging Mode

Third Parameter has only two values

1 that indicates the input is Video

0 that indicates the input is Image

Fourth Parameter has only two values

1 that indicates Debugging Mode Activated

0 tha indicates Debugging Mode Deactivated

Parameters to the CMD Syntax : 📜

python test_image_detection.py #First_Parameter #Second_parameter #Third_parameter #Fourth_parameter

Sample Example:

python test_image_detection.py test_images/test1.jpg test_images 0 1

Contributers 🤝

Name	ID
Shereen Reda Sayed Mohamed	1804990
Mahmoud Khaled Abdelaal Aly	1801004
Maram Nabil Ibrahim Ali	1803746