RoboSim Overview

• How it Works
  • Grid
  • Robots
  • Renderer
  • Summarizer
• Creating a Custom Simulation Config
  • Config
  • SensorRobotConfig

RoboSim

---

Project Status

---

Getting Started

Ensure that you have the package installed and configured in your environment.

1. Clone the robo-sim repository to your machine.

2. Navigate to the root directory of the project.

3. Install the package using pip.

pip install -e .

Running Examples with CLI

RoboSim comes with a set of predefined example configurations located in the configs directory. To run an example simulation, use the following CLI command structure.

robo_sim example <example_name> <algorithm>

Example Command

To run the sensor_robot example using the A* algorithm, execute:

robo_sim example sensor_robot AStar

Running Custom Simulations

1. To create a YAML configuration file for your simulation, refer to the Config model descriptions in the documentation for the required structure.

2. Run your simulation with the below script. To see the the rest of supported algorithms, refer to robo_sim/algorithms/enums.py.

from pathlib import Path

from robo_sim import Sim

config_path = Path("my_custom_config.yaml")
sim = Sim(config_path, algorithm="AStar")
sim.run()