How nicoc144/ml-robot-navigation works
This repository is a maze-robot simulation and experimentation project. Its main workflow is to launch a simulation, load or generate a maze, plan a route, and drive a simulated robot using waypoint control; it also supports keyboard operation, autonomous ML-based control, and CSV data collection. The graph includes the documented ML experiments and batch tools. Some links are limited to README or SOURCE INDEX evidence because their implementation files were not excerpted.
Main entry points: simulation.py Simulation · utils.py Runtime setup · planner.py Planner base · controller.py Motion controllers
Components 20
Entry and orchestration
- CLI entry
maze_project/main.py - Runtime setup
maze_project/simulation/utils.py - Batch collection
maze_project/tools/run_all.py - Maze generation tool
maze_project/tools/generate_maze.py
Maze and planning
- Maze model
maze_project/maze_generator/maze_data.py - Maze generator
maze_project/maze_generator/generator.py - Planner base
maze_project/planning/planner.py - A* planner
maze_project/planning/astar.py - BFS planner
maze_project/planning/bfs.py - DFS planner
maze_project/planning/dfs.py
Robot simulation and control
- Simulation
maze_project/simulation/simulation.py - Physics maze
maze_project/simulation/maze.py - Differential robot
maze_project/simulation/robot.py - Raycast sensors
maze_project/simulation/sensors.py - Motion controllers
maze_project/control/controller.py
Learning and data collection
- CSV logger
maze_project/logger/sim_logger.py - Supervised experiments
maze_project/learning/supervised_non-rl.ipynb - Unsupervised experiments
maze_project/learning/unsupervised.ipynb
Other components
- User
- PyBullet
Connections 25
- User → CLI entry: runs
README.md - CLI entry → Simulation: starts
maze_project/main.py - CLI entry → Runtime setup: configures
maze_project/main.py - Runtime setup → Maze model: loads
maze_project/simulation/utils.py - Runtime setup → Planner base: selects
maze_project/simulation/utils.py - Runtime setup → Motion controllers: builds
maze_project/simulation/utils.py - Runtime setup → CSV logger: configures
maze_project/simulation/utils.py - Batch collection → Maze generator: uses
maze_project/tools/run_all.py - Batch collection → Simulation: runs
maze_project/tools/run_all.py - Batch collection → CSV logger: uses
maze_project/tools/run_all.py - Maze generation tool → Maze generator: generates
maze_project/tools/generate_maze.py - Maze generator → Maze model: creates
maze_project/maze_generator/generator.py - Planner base → Maze model: reads
maze_project/planning/planner.py - A* planner → Planner base: extends
maze_project/planning/astar.py - BFS planner → Planner base: extends
maze_project/planning/bfs.py - DFS planner → Planner base: extends
maze_project/planning/dfs.py - Simulation → Physics maze: builds
maze_project/simulation/simulation.py - Simulation → Differential robot: spawns
maze_project/simulation/simulation.py - Simulation → Raycast sensors: attaches
maze_project/simulation/simulation.py - Physics maze → Maze model: reads
maze_project/simulation/maze.py - Differential robot → Raycast sensors: collects readings
maze_project/simulation/robot.py - Motion controllers → Differential robot: commands
maze_project/control/controller.py - Simulation → PyBullet: steps physics
maze_project/simulation/simulation.py - Supervised experiments → Motion controllers: informs autonomous control
README.md - Unsupervised experiments → Motion controllers: informs autonomous control
README.md