- Introduction
- Project Description
- Dataset - CamBeV
- Team Members
- Network Architecture
- Result
- Generated Outputs
- Blind Spot Functionality
- Usage
- Configurations
- Dependencies
- Installation
- Running the Project
- Contributing
Welcome to the Bird'sEye View Project using Deep Learning and the CamBeV dataset. This project aims to generate Bird's Eye View outputs from a given dataset of images captured from a camera mounted on a vehicle. The Bird's Eye View provides a top-down view of the surroundings, which can benefit various applications, such as autonomous driving, parking assistance, and obstacle detection.
The Bird'sEye View Project utilizes deep learning techniques to transform images captured by a vehicle-mounted camera into a top-down perspective. The generated Bird's Eye View output enhances the understanding of the vehicle's surroundings and aids in making better decisions during driving. The model learns the spacial features and transforms the image into a different plane by learning a Homography Matrix.
The CamBeV dataset is a collection of images captured by a vehicle-mounted camera. It serves as the primary dataset for training our deep learning model. The dataset contains various scenes and scenarios, including urban environments, highways, and rural areas. By using CamBeV, our model can learn to generalize well across different driving conditions.
This project was executed by a team of 4 dedicated individuals, each contributing their expertise and skills to bring the Bird'sEye View Project to life. The team members are:
- Tejas Pankaj Kalsait (Myself) - kalsaittejas10@gmail.com
- Athindra Bandi - athindra@buffalo.edu
- Lakshmi Ramaswamy Vishwanath - lramaswa@buffalo.edu
- Samarth Gangwal - samarthg@buffalo.edu
The generated Bird's Eye View outputs from our trained model are available in the 'predictions' directory. These output images showcase the transformation of the original camera-captured images into top-down views. The generated outputs demonstrate the effectiveness of our deep learning approach in creating Bird's Eye View representations.
As a significant extension to the project, we have added blind spot functionality using the generated Bird's Eye View output. The blind spot feature helps the driver identify potential blind spots around the vehicle and assists in avoiding collisions with nearby objects. The outputs from the blind spot detection feature are located in/model/lane_change directory.
The Bird's Eye View Project is intended for developers, researchers, or anyone interested in exploring the application of deep learning for transforming camera images into Bird's Eye Views. The project provides a foundation for building advanced driver assistance systems (ADAS) and autonomous vehicle technologies.
The project is highly configurable to suit various scenarios and hardware setups. All configuration options can be found in the 'config.yml' file present inside the /model directory. Users can modify parameters such as model architecture, training hyperparameters, and blind spot functionality settings to achieve the desired results.
The project relies on the following dependencies:
- Python >= 3.8
- Pytorch
- Torchvision
- NumPy
- OpenCV
- Matplotlib
- FastProgress
To set up the Bird's Eye View Project, follow these steps:
- Clone the repository to your local machine:
git clone https://github.com/your-username/BirdsEyeViewProject.git
cd BirdsEyeViewProject
- Create a virtual environment (optional but recommended):
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- Install the project dependencies:
pip install -r requirements.txt
To run the project, execute the 'main.py' script along with the available configuration options. Make sure the necessary dataset and pretrained model weights (if any) are in place before running.
python main.py --config model/config(choice).yml
We welcome contributions to the Bird'sEye View Project. If you find any issues or have ideas for improvements, please open an issue or submit a pull request.
We hope you find the Bird's Eye View Project helpful and insightful. If you have any questions or need assistance, don't hesitate to reach out to any of our team members mentioned above. Happy coding!