# gkm2004/spaceapps architecture

> Architecture diagram of the GitHub repository gkm2004/spaceapps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gkm2004/spaceapps
- Repository: https://github.com/gkm2004/spaceapps

## Overview

Mars Map is a Mars surface-planning application: users choose a site, inspect terrain and hazards, plan a route, rehearse it at ground level, and inspect rover stops and camera views. The frontend combines Cesium visualization with API-backed route, waypoint, and hazard data; the backend provides route computation and serves site data. Data scripts prepare local terrain and rover datasets. Several backend and data-preparation details are documented but not excerpted, so those links are shown only where the README or source index supports them.

Main entry points: [`data/scripts/crop_dem.py`](https://github.com/gkm2004/spaceapps/blob/main/data/scripts/crop_dem.py) (DEM cropping), [`frontend/src/api.js`](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/api.js) (Data client), [`frontend/src/waypoints.js`](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/waypoints.js) (Rover stops), [`backend/main.py`](https://github.com/gkm2004/spaceapps/blob/main/backend/main.py) (HTTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Map experience"]
  node_app["App coordinator<br/>[main.js]"]
  node_globe["Mars globe<br/>[globe.js]"]
  node_search["Place search<br/>[search.js]"]
  node_camera["Map camera<br/>[camera.js]"]
end

subgraph group_navigation["Route planning"]
  node_routing["Route engine<br/>[routing.py]"]
  node_directions["Route planner<br/>[directions.js]"]
end

subgraph group_surface["Surface exploration"]
  node_terrain["Local terrain<br/>[terrain.js]"]
  node_heights["Terrain heights<br/>[heights.js]"]
  node_ground["Ground view<br/>[ground.js]"]
  node_layers["Hazard layers<br/>[layers.js]"]
  node_waypoints["Rover stops<br/>[waypoints.js]"]
  node_pov["Mars view<br/>[pov.js]"]
end

subgraph group_service["Data services"]
  node_api["Data client<br/>[api.js]"]
  node_backend["HTTP API<br/>[main.py]"]
end

subgraph group_preparation["Data preparation"]
  node_crop["DEM cropping<br/>[crop_dem.py]"]
  node_slope["Slope grids<br/>[slope.py]"]
  node_danger["Hazard tiles<br/>[danger_tiles.py]"]
  node_mesh["Terrain mesh<br/>[terrain_mesh.py]"]
  node_waypointdata["Waypoint data<br/>[waypoints.py]"]
end

node_astronaut(("Crew / planner"))
node_marsdata["Mars source data"]
node_cesium["Cesium Mars assets"]

node_astronaut -->|"uses"| node_app
node_app -.->|"sets up"| node_globe
node_app -->|"loads data"| node_api
node_app -->|"initializes"| node_waypoints
node_search -->|"flies to"| node_globe
node_directions -->|"requests route"| node_api
node_directions -->|"samples terrain"| node_ground
node_directions -->|"places markers"| node_heights
node_api -.->|"requests API"| node_backend
node_backend -->|"uses"| node_routing
node_terrain -->|"samples terrain"| node_ground
node_terrain -->|"loads heightmap"| node_heights
node_terrain -->|"registers layer"| node_layers
node_ground -->|"loads hazard info"| node_api
node_ground -->|"reads heights"| node_heights
node_layers -->|"loads tile info"| node_api
node_waypoints -->|"loads stops"| node_api
node_waypoints -->|"places markers"| node_heights
node_waypoints -->|"adds toggle"| node_layers
node_waypoints -->|"opens viewer"| node_pov
node_marsdata -.->|"provides DEM"| node_crop
node_crop -.->|"prepares grids"| node_slope
node_crop -->|"supplies DEM"| node_danger
node_crop -->|"supplies site data"| node_waypointdata
node_slope -.->|"produces hazards"| node_danger
node_crop -.->|"builds terrain"| node_mesh
node_crop -->|"feeds route grids"| node_routing
node_danger -.->|"serves tiles"| node_backend
node_mesh -.->|"serves terrain"| node_backend
node_waypointdata -.->|"serves stops"| node_backend
node_cesium -->|"renders Mars"| node_globe

click node_app "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/main.js"
click node_globe "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/globe.js"
click node_search "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/search.js"
click node_camera "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/camera.js"
click node_api "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/api.js"
click node_backend "https://github.com/gkm2004/spaceapps/blob/main/backend/main.py"
click node_routing "https://github.com/gkm2004/spaceapps/blob/main/backend/routing.py"
click node_directions "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/directions.js"
click node_terrain "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/terrain.js"
click node_heights "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/heights.js"
click node_ground "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/ground.js"
click node_layers "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/layers.js"
click node_waypoints "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/waypoints.js"
click node_pov "https://github.com/gkm2004/spaceapps/blob/main/frontend/src/pov.js"
click node_crop "https://github.com/gkm2004/spaceapps/blob/main/data/scripts/crop_dem.py"
click node_slope "https://github.com/gkm2004/spaceapps/blob/main/data/scripts/slope.py"
click node_danger "https://github.com/gkm2004/spaceapps/blob/main/data/scripts/danger_tiles.py"
click node_mesh "https://github.com/gkm2004/spaceapps/blob/main/data/scripts/terrain_mesh.py"
click node_waypointdata "https://github.com/gkm2004/spaceapps/blob/main/data/scripts/waypoints.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_globe,node_search,node_camera toneBlue
class node_routing,node_directions toneAmber
class node_terrain,node_heights,node_ground,node_layers,node_waypoints,node_pov toneMint
class node_api,node_backend toneRose
class node_crop,node_slope,node_danger,node_mesh,node_waypointdata,node_astronaut,node_marsdata,node_cesium toneIndigo
```

## Components

### Map experience

- [App coordinator](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/main.js): `frontend/src/main.js`
- [Mars globe](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/globe.js): `frontend/src/globe.js`
- [Place search](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/search.js): `frontend/src/search.js`
- [Map camera](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/camera.js): `frontend/src/camera.js`

### Route planning

- [Route engine](https://github.com/gkm2004/spaceapps/blob/main/backend/routing.py): `backend/routing.py`
- [Route planner](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/directions.js): `frontend/src/directions.js`

### Surface exploration

- [Local terrain](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/terrain.js): `frontend/src/terrain.js`
- [Terrain heights](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/heights.js): `frontend/src/heights.js`
- [Ground view](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/ground.js): `frontend/src/ground.js`
- [Hazard layers](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/layers.js): `frontend/src/layers.js`
- [Rover stops](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/waypoints.js): `frontend/src/waypoints.js`
- [Mars view](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/pov.js): `frontend/src/pov.js`

### Data services

- [Data client](https://github.com/gkm2004/spaceapps/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [HTTP API](https://github.com/gkm2004/spaceapps/blob/main/backend/main.py): `backend/main.py`

### Data preparation

- [DEM cropping](https://github.com/gkm2004/spaceapps/blob/main/data/scripts/crop_dem.py): `data/scripts/crop_dem.py`
- [Slope grids](https://github.com/gkm2004/spaceapps/blob/main/data/scripts/slope.py): `data/scripts/slope.py`
- [Hazard tiles](https://github.com/gkm2004/spaceapps/blob/main/data/scripts/danger_tiles.py): `data/scripts/danger_tiles.py`
- [Terrain mesh](https://github.com/gkm2004/spaceapps/blob/main/data/scripts/terrain_mesh.py): `data/scripts/terrain_mesh.py`
- [Waypoint data](https://github.com/gkm2004/spaceapps/blob/main/data/scripts/waypoints.py): `data/scripts/waypoints.py`

### Other components

- **Crew / planner**
- **Mars source data**
- **Cesium Mars assets**

## Connections

- Crew / planner → App coordinator: uses (evidence: `README.md`)
- App coordinator → Mars globe: sets up (evidence: `frontend/src/main.js`)
- App coordinator → Data client: loads data (evidence: `frontend/src/main.js`)
- App coordinator → Rover stops: initializes (evidence: `frontend/src/main.js`)
- Place search → Mars globe: flies to (evidence: `frontend/src/search.js`)
- Route planner → Data client: requests route (evidence: `frontend/src/directions.js`)
- Route planner → Ground view: samples terrain (evidence: `frontend/src/directions.js`)
- Route planner → Terrain heights: places markers (evidence: `frontend/src/directions.js`)
- Data client → HTTP API: requests API
- HTTP API → Route engine: uses (evidence: `backend/main.py`)
- Local terrain → Ground view: samples terrain (evidence: `frontend/src/terrain.js`)
- Local terrain → Terrain heights: loads heightmap (evidence: `frontend/src/terrain.js`)
- Local terrain → Hazard layers: registers layer (evidence: `frontend/src/terrain.js`)
- Ground view → Data client: loads hazard info (evidence: `frontend/src/ground.js`)
- Ground view → Terrain heights: reads heights (evidence: `frontend/src/ground.js`)
- Hazard layers → Data client: loads tile info (evidence: `frontend/src/layers.js`)
- Rover stops → Data client: loads stops (evidence: `frontend/src/waypoints.js`)
- Rover stops → Terrain heights: places markers (evidence: `frontend/src/waypoints.js`)
- Rover stops → Hazard layers: adds toggle (evidence: `frontend/src/waypoints.js`)
- Rover stops → Mars view: opens viewer (evidence: `frontend/src/waypoints.js`)
- Mars source data → DEM cropping: provides DEM
- DEM cropping → Slope grids: prepares grids
- DEM cropping → Hazard tiles: supplies DEM (evidence: `data/scripts/danger_tiles.py`)
- DEM cropping → Waypoint data: supplies site data (evidence: `data/scripts/waypoints.py`)
- Slope grids → Hazard tiles: produces hazards
- DEM cropping → Terrain mesh: builds terrain (evidence: `README.md`)
- DEM cropping → Route engine: feeds route grids (evidence: `README.md`)
- Hazard tiles → HTTP API: serves tiles (evidence: `README.md`)
- Terrain mesh → HTTP API: serves terrain (evidence: `README.md`)
- Waypoint data → HTTP API: serves stops (evidence: `README.md`)
- Cesium Mars assets → Mars globe: renders Mars (evidence: `frontend/src/globe.js`)
