Skip to content

Tottowich/carla-synthetic-data

Repository files navigation

Carla - Adopticum 🔬 / Magna 🚀

Summer Project 2023 🌞

This summer, Adopticum and Magna will collaborate on a development project to explore the utilization of simulation engines in conjunction with game engines to detect and classify unknown objects on the ground. 🤝🔍

Project Overview 🌍

The Carla - Adopticum / Magna project aims to explore the integration of simulation engines and game engines to detect and classify unknown objects on the ground. By utilizing the CARLA simulator, we seek to generate simulated and realistic data that can be used to train machine/deep learning models effectively. The project focuses on emulating optical measurement techniques employed by Adopticum and Magna, reducing the dependency on manual data collection.

Installation 🔧📥

Requirements 📋

The major installations are:

Carla Environment 🚗

We recommend that you install the Carla environment in a virtual environment and install the Carla Python API via pip. Make sure that you add the root path to your carla installation to CARLA_ROOT. This can be done by adding the following line to your .bashrc file:

export CARLA_ROOT=<path-to-carla>

Make sure to replace the <path-to-carla> with the path to your Carla installation and restart all your terminals.

👉 command details Install the Carla Python API via pip using the following command:
pip install <path-to-carla>/PythonAPI/carla/dist/carla-<version>-cp<python-version>-cp<python-version>-<os>.whl

Make sure to replace the <path-to-carla> with the path to your Carla installation, <version> with the version of your Carla installation, <python-version> with the version of Python you are using, and <os> with your operating system. For example, if you are using Python 3.8 on Linux and have installed Carla 0.9.14, you should run the following command:

pip install ~/carla/PythonAPI/carla/dist/carla-0.9.14-cp38-cp38-linux_x86_64.whl

Python Environment 🐍

To install the required Python packages, run the following command in the root directory of the project:

pip install -r requirements.txt

Usage 📚

Explain how to use the project, including instructions for running simulations, configuring parameters, and accessing the generated data.

Features 💎

  • Simulated and realistic data generation using the CARLA simulator. 🚗🌍
  • Training machine/deep learning models to efficiently detect and classify unknown objects. 🤖🦾
  • Emulation of optical measurement techniques for accurate representation. 🔫
  • Reduction in manual data collection efforts. 📉⏳
  • Cost and time savings for data collection processes. 💰

Roadmap 🚧🗺️

Outline the future plans and potential enhancements for the project. Include upcoming features, improvements, or research areas that will be explored.

Contributors 👥

Code Contributors 🖥️

Assets Contributors 🎨

Project Management 📊

License 🔏

The Carla - Adopticum / Magna project is released under the MIT License.

Changelog 📜📅🔄

All the major changes can be found in the pages/CHANGELOG.md file. Below you can find examples per described category. Along with some examples of changelogs.

[Date]📅

Category Example description
Added 📥 Added new feature X
Changed 🔄 Updated function Y to improve performance
Removed 🗑️ Removed deprecated API Z
Fixed 🔧 Fixed bug causing application crash
Security 🔒 Implemented enhanced encryption for user data
Deprecated 📛 Marked method A as deprecated, use method B instead
Breaking Changes 🚨 Renamed class C, update references accordingly
Documentation 📚 Updated API documentation for better clarity
Maintenance 🧹 Cleaned up codebase, removed unused variables
Performance 🚀 Optimized database queries for faster response time
Refactoring 📦 Extracted reusable components from module D
Style 🎨 Applied consistent coding style across the project
Tests 🧪 Added unit tests for module E
Other 📦 Miscellaneous updates and improvements
👉 Example of a changelog

[2023-06-01]📅

  • Added 📥: Implemented data generation using CARLA simulator
  • Fixed 🔧: Fixed bug causing application crash

Summary of changes made in this version.

[2023-06-10]📅

  • Changed 🔄: Updated function Y to improve performance
  • Removed 🗑️: Removed deprecated API Z

Summary of changes made in this version.

Acknowledgements 🙏

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages