Skip to main content

A Unity Traffic Simulation

Project description


layout: default title: "ReplicantDriveSim" permalink: /

Workflow Status

ReplicantDriveSim

ReplicantDriveSim is an advanced traffic simulation project designed for autonomous driving research. It leverages reinforcement learning, imitation learning, and computer vision to create realistic traffic scenarios and synthetic driving data. The simulation environment is built using Pygame for visualization and Miniforge for Python package management, ensuring a seamless development and deployment experience. This Docker image provides a fully configured environment with all necessary dependencies, enabling efficient experimentation and development of autonomous driving algorithms.

Traffic Simulation Documentation

Doxygen Documentation

AI Page

GitHub Page

Read the Docs

Nissan GTR

Accessing ReplicantDriveSim Library via PyPI

The ReplicantDriveSim library is available on the Python Package Index (PyPI). You can find it at https://pypi.org/project/ReplicantDriveSim/.

Installation

To install the latest version of ReplicantDriveSim, use the following pip command:

pip install ReplicantDriveSim

This command will download and install the package along with its dependencies. After installation, you can import the library in your Python scripts:

import replicantdrivesim

For more detailed usage instructions, please refer to the documentation in the repository.

Project Setup

Required Unity Version

This project was developed using Unity 2022.3.39f1 (LTS). To ensure compatibility, please use this version or later Long-Term Support (LTS) versions of Unity. You can download the specific version from the Unity Hub or the Unity Archive.

Installation:

  1. Clone the repository:
    git clone git@github.com:chrisjcc/ReplicantDriveSim.git
    
  2. Open the project in Unity Hub and select Unity version 2022.3.39f1.
  3. Let Unity install any necessary packages and dependencies.

Generate Doxygen Documentation

To generate the documentation for this project using Doxygen, follow these steps:

Building the Unity Project from Command Line

To generate an executable for this Unity project without opening the Unity Editor, you can use the following command in your terminal:

/Applications/Unity/Hub/Editor/2022.3.33f1/Unity.app/Contents/MacOS/Unity \
-quit \
-batchmode \
-nographics \
-projectPath "/Users/christiancontrerascampana/Desktop/project/unity_traffic_simulation/reduce_git_lfs/UnityDriveSimulation" \
-executeMethod UnityDriveSimulation.BuildTools.BuildScript.PerformMacOSBuild \
-logFile "Logs/logfile.log"
Command Breakdown

Let's break down what each part of this command does:

  1. /Applications/Unity/Hub/Editor/2022.3.33f1/Unity.app/Contents/MacOS/Unity

    • This is the path to the Unity executable on macOS. Adjust this path if your Unity installation is in a different location or if you're using a different version.
  2. -quit

    • This parameter tells Unity to quit after executing the build process. It ensures that Unity doesn't stay open after the build is complete.
  3. -batchmode

    • This runs Unity in batch mode, which means it operates without launching the graphical user interface. This is essential for automated builds and running Unity from the command line.
  4. -projectPath "/Users/christiancontrerascampana/Desktop/project/unity_traffic_simulation/reduce_git_lfs/UnityDriveSimulation"

    • This specifies the path to your Unity project. Replace this with the actual path to your project on your machine.
  5. -executeMethod UnityDriveSimulation.BuildTools.BuildScript.PerformMacOSBuild

    • This tells Unity which method to execute to perform the build. In this case, it's calling the PerformMacOSBuild method from the BuildScript class in the UnityDriveSimulation.BuildTools namespace.
  6. -logFile "Logs/logfile.log"

    • This specifies where Unity should output its log file. This is useful for debugging if something goes wrong during the build process.
Usage

To use this command:

  1. Open a terminal window.
  2. Navigate to the directory containing your Unity project.
  3. Copy and paste the above command, making sure to adjust the Unity executable path and project path as necessary for your system.
  4. Press Enter to run the command.

The build process will start, and Unity will generate the executable based on your project settings and the build script you've defined in UnityDriveSimulation.BuildTools.BuildScript.PerformMacOSBuild.

Note

Ensure that the build script (BuildScript.cs) is properly set up in your Unity project and that the PerformMacOSBuild method is correctly implemented to build your project for macOS.

Prerequisites

Make sure Doxygen is installed on your local machine. You can install it using the following commands:

  • Ubuntu:
    sudo apt-get install doxygen
    sudo apt-get install graphviz
    
  • macOS:
    brew install doxygen
    brew install graphviz
    

Generate Documentation

  1. Navigate to the root directory of your project where the Doxyfile is located.
  2. Run the Doxygen command with your Doxyfile to generate the documentation:
    doxygen Doxyfile
    
  3. The generated HTML files can be found in the directory specified by the OUTPUT_DIRECTORY setting in the Doxyfile (typically docs/html).

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

ReplicantDriveSim-0.3.5.tar.gz (20.1 kB view details)

Uploaded Source

Built Distribution

ReplicantDriveSim-0.3.5-py3-none-any.whl (169.4 kB view details)

Uploaded Python 3

File details

Details for the file ReplicantDriveSim-0.3.5.tar.gz.

File metadata

  • Download URL: ReplicantDriveSim-0.3.5.tar.gz
  • Upload date:
  • Size: 20.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.10

File hashes

Hashes for ReplicantDriveSim-0.3.5.tar.gz
Algorithm Hash digest
SHA256 b66e868ea03f60de12a029001bf52842221e8ef1bf89fa48b1980e419485185e
MD5 1f8d7692a699506be1d01e53b7de710a
BLAKE2b-256 a0cc5841f473f6e8673a723377de8ebcad4bc02186d0e94322ff1646c87312c0

See more details on using hashes here.

File details

Details for the file ReplicantDriveSim-0.3.5-py3-none-any.whl.

File metadata

File hashes

Hashes for ReplicantDriveSim-0.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 e0754c776f7fd85ca6c8dba0c8f691507cc64b8f76957f326463b1b3b75d7b68
MD5 8604f38794bc1619a72f72ef379f6058
BLAKE2b-256 fd595cdbc83f0fc5809fc574d5ce3e6beafd0aa6dd86e202e1c07ce8c03abdca

See more details on using hashes here.

Supported by

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