Skip to main content

A comprehensive CARLA client for autonomous driving simulation, featuring scenario-based testing, real-time visualization, and customizable vehicle control

Project description

CARLA Driving Simulator Client

CI codecov Documentation Status License: MIT Python 3.7+ Code style: black PyPI version GitHub release (latest by date) GitHub issues GitHub pull requests Run tests and upload coverage A personal project for experimenting with CARLA client, featuring vehicle control, sensor management, and visualization capabilities.

Features

  • Realistic vehicle physics and control
  • Multiple sensor types (Camera, GNSS, Collision, Lane Invasion)
  • Dynamic weather system
  • Traffic and pedestrian simulation
  • Real-time visualization with HUD and minimap
  • Comprehensive logging and data collection
  • Support for both manual and autopilot modes
  • Configurable simulation parameters

Requirements

  • Python 3.7+
  • CARLA Simulator 0.10.0
  • Pygame
  • NumPy
  • Matplotlib
  • Tabulate
  • PyYAML

Installation

From PyPI

pip install carla-driving-simulator-client

From Source

  1. Clone the repository:
git clone https://github.com/akshaychikhalkar/carla-driving-simulator-client.git
cd carla-driving-simulator-client
  1. Install in development mode:
pip install -e .
  1. Install CARLA:
  • Download CARLA 0.10.0 from CARLA's website
  • Extract the package and set the CARLA_ROOT environment variable
  • Add CARLA Python API to your PYTHONPATH:
# For Windows
set PYTHONPATH=%PYTHONPATH%;C:\path\to\carla\PythonAPI\carla\dist\carla-0.10.0-py3.7-win-amd64.egg

# For Linux
export PYTHONPATH=$PYTHONPATH:/path/to/carla/PythonAPI/carla/dist/carla-0.10.0-py3.7-linux-x86_64.egg

Usage

  1. Start the CARLA server:
./CarlaUE4.sh -carla-rpc-port=2000
  1. Run the simulator client:
# If installed from PyPI
carla-simulator-client

# If installed from source
python src/main.py

Configuration

The simulator client can be configured through the config/simulation_config.yaml file. Key parameters include:

  • Target distance
  • Maximum speed
  • Simulation duration
  • Vehicle model
  • Sensor settings
  • Weather conditions

Project Structure

carla-driving-simulator-client/
├── src/
│   ├── core/
│   │   ├── world.py
│   │   ├── vehicle.py
│   │   └── sensors.py
│   ├── visualization/
│   │   ├── hud.py
│   │   ├── minimap.py
│   │   └── camera.py
│   ├── control/
│   │   ├── keyboard.py
│   │   └── autopilot.py
│   └── utils/
│       ├── config.py
│       └── logging.py
├── tests/
├── config/
├── docs/
├── requirements.txt
└── README.md

Contributing

  1. Fork the repository
  2. Create your feature branch:
git checkout -b feature/amazing-feature
  1. Commit your changes:
git commit -m 'Add some amazing feature'
  1. Push to the branch:
git push origin feature/amazing-feature
  1. Open a Pull Request

Note: I cannot guarantee response times or implementation of suggested features as this project is maintained in my free time.

Support

If you need help, please check our Support Guide for various ways to get assistance.

Security

Please report any security issues to our Security Policy.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • CARLA Simulator Team
  • TH OWL for initial development

Roadmap

Check our Roadmap for planned features and improvements.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

carla_driving_simulator_client-1.0.4.tar.gz (21.6 kB view details)

Uploaded Source

File details

Details for the file carla_driving_simulator_client-1.0.4.tar.gz.

File metadata

File hashes

Hashes for carla_driving_simulator_client-1.0.4.tar.gz
Algorithm Hash digest
SHA256 9c228c68f0b64a13b919c0269836fa9207ff43ad3f662028f0b043f6b390d8b3
MD5 569a6be1ed08be3daf9846e1d4910b74
BLAKE2b-256 702282c6e5471a8df76492a4789cde7ee64abad72ec79e780fc658623495afb1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page