How binamira/ros-rl-terrain works
This repository is a configuration-driven procedural terrain generator for robotics training, with Gazebo export, runtime terrain queries, curriculum/reset utilities, and a browser preview. Its principal workflow configures and generates terrain cells, merges them into a world mesh, then exports simulator assets and metadata; the metadata also supports runtime spawn and height queries. The README documents the generation/export stages, while excerpts confirm several implementation calls. Some subsystem details are documented but unsampled, so those connections are shown only where the README supports them.
Main entry points: exporter.py Gazebo exporter · generator.py Grid generator · generate_terrain.py Generation CLI · controls.js Configurator controls
Components 22
Terrain generation
- Generation CLI
scripts/generate_terrain.py - Terrain config
terrain/config.py - Grid generator
terrain/generator.py - Terrain families
terrain/generators - Isaac terrain replicas
terrain/generators/isaac.py - Cell features
terrain/features.py - Cell and world geometry
terrain/geometry.py - Mesh merger
terrain/merger.py
Simulator export
- Gazebo exporter
simulators/gazebo/exporter.py - Collada mesh writer
simulators/gazebo/mesh_writer.py - SDF model writer
simulators/gazebo/sdf_writer.py - Cell collision models
simulators/gazebo/cell_collision.py
Training runtime
- Terrain metadata IO
terrain/metadata_io.py - Terrain registry
terrain/registry.py - Curriculum manager
managers/curriculum_manager.py - Reset manager
managers/reset_manager.py
Web preview
- Configurator controls
web/static/controls.js - Preview API
web/server.py - Terrain viewer
web/static/terrain.js
Other components
- Operator
- Terrain YAML
config/terrain_go2_isaac_training_1col.yaml - Preview user
Connections 23
- Operator → Terrain YAML: sets parameters
README.md - Terrain YAML → Generation CLI: configures
README.md - Generation CLI → Grid generator: starts generation
README.md - Terrain config → Grid generator: configures
README.md - Grid generator → Terrain families: generates cells
README.md - Grid generator → Mesh merger: passes cell meshes
README.md - Mesh merger → Cell and world geometry: produces terrain geometry
README.md - Terrain families → Cell features: measures cell properties
- Isaac terrain replicas → Grid generator: supplies terrain types
- Generation CLI → Gazebo exporter: exports terrain
README.md - Gazebo exporter → Collada mesh writer: writes mesh
simulators/gazebo/exporter.py - Gazebo exporter → SDF model writer: writes model files
simulators/gazebo/exporter.py - Gazebo exporter → Cell and world geometry: exports geometry
README.md - Gazebo exporter → Terrain metadata IO: writes metadata
README.md - Terrain metadata IO → Terrain registry: loads query data
README.md - Curriculum manager → Reset manager: selects cell for
managers/reset_manager.py - Reset manager → Terrain registry: gets spawn origins
managers/reset_manager.py - Preview user → Configurator controls: configures preview
- Configurator controls → Preview API: requests generation
web/static/controls.js - Preview API → Grid generator: generates terrain
web/server.py - Configurator controls → Terrain viewer: updates display
- Preview API → Terrain viewer: serves preview UI
web/server.py - Gazebo exporter → Cell collision models: supports collision export