How saiaravind19/gazebo_terrain_generator works
The product is a browser-based generator for real-world Gazebo terrain. Users configure a map area and spawn point, request generation, then download a ZIP containing a runnable world and its assets. The graph preserves terrain and imagery acquisition, optional building meshes, world assembly, and shared geospatial helpers. Some server orchestration is supported by the SOURCE INDEX rather than complete excerpts, so those edges cite the server file; undocumented links are omitted.
Main entry points: server.py HTTP generation API · gazebo_world_generator.py Terrain world assembly · maptile_utils.py Tile and bounds math · dem_tiles_downloader.py Elevation tile downloader
Components 18
Map UI
- Map and settings UI
scripts/frontend/js/main.js
Generation Service
- HTTP generation API
scripts/server.py - Generated world and ZIP
Terrain Assets
- Elevation tile downloader
scripts/utils/dem_tiles_downloader.py - Building data downloader
scripts/utils/building_downloader.py - Terrain world assembly
scripts/utils/gazebo_world_generator.py - Heightmap generation
scripts/utils/height_map_generator.py - Aerial texture stitching
scripts/utils/gazebo_world_generator.py - Building mesh generation
scripts/utils/buildings_generator.py - World file writer
scripts/utils/file_writer.py - SDF and model templates
templates
Shared Geospatial
- Tile and bounds math
scripts/utils/maptile_utils.py - Tile image stitching
scripts/utils/utils.py - Raster tile fetching
scripts/utils/utils.py - Generation parameters
scripts/utils/param.py
Other components
- Terrain designer
- Mapbox data services
- Satellite tile source
Connections 23
- Terrain designer → Map and settings UI: configures area
README.md - Map and settings UI → HTTP generation API: requests generation
README.md - HTTP generation API → Elevation tile downloader: downloads elevation
scripts/server.py - HTTP generation API → Building data downloader: downloads buildings
scripts/server.py - HTTP generation API → Terrain world assembly: starts assembly
scripts/server.py - HTTP generation API → Tile and bounds math: calculates bounds
scripts/server.py - HTTP generation API → Raster tile fetching: fetches tiles
scripts/server.py - HTTP generation API → Generated world and ZIP: packages download
scripts/server.py - Elevation tile downloader → Tile and bounds math: converts coordinates
scripts/utils/dem_tiles_downloader.py - Elevation tile downloader → Mapbox data services: fetches elevation
scripts/utils/dem_tiles_downloader.py - Building data downloader → Tile and bounds math: uses tile bounds
scripts/utils/building_downloader.py - Terrain world assembly → Heightmap generation: inherits generation
scripts/utils/gazebo_world_generator.py - Terrain world assembly → Aerial texture stitching: stitches imagery
scripts/utils/gazebo_world_generator.py - Terrain world assembly → Building mesh generation: creates building mesh
scripts/utils/gazebo_world_generator.py - Terrain world assembly → World file writer: writes world files
scripts/utils/gazebo_world_generator.py - Terrain world assembly → Tile and bounds math: uses tile bounds
scripts/utils/gazebo_world_generator.py - Terrain world assembly → Generation parameters: reads parameters
scripts/utils/gazebo_world_generator.py - Heightmap generation → Tile and bounds math: maps coordinates
scripts/utils/height_map_generator.py - Heightmap generation → Tile image stitching: stitches DEM tiles
scripts/utils/height_map_generator.py - World file writer → SDF and model templates: loads templates
scripts/utils/file_writer.py - World file writer → Generation parameters: reads template path
scripts/utils/file_writer.py - Raster tile fetching → Satellite tile source: fetches imagery
- Generated world and ZIP → Terrain designer: downloads ZIP
README.md