How malakabdelkhalek/marsouine-martian-map works
Marsouine is a Martian EVA route-planning and terrain-awareness system for the Mount Sharp boxwork region. The principal workflow combines terrain/elevation layers and stop-level assessments into a GO/NO-GO map, then lets an astronaut plan a route, scout uncertain stretches, and follow the route on a helmet/phone view. The repository also contains a simulated drone and a web map/3D-walk branch. Several subsystem links are documented in the README; unsampled implementation details are represented only where the tree or documentation supports them.
Main entry points: Tablet.jsx Tablet planner · 50_combined_routes.py Combined routes · Helmet.jsx Helmet guidance · mission.js Stop and mission rules
Components 23
Terrain map data
- Elevation and slope
Map_layer/Layer2_Elevation/scripts
GIS and route layers
- Map assembly
Map_layer/martian_map/pipeline/00_assemble_workspace.py - GO/NO-GO layers
Map_layer/martian_map/pipeline/40_gonogo_layers.py - Combined routes
Map_layer/martian_map/pipeline/50_combined_routes.py - Web map export
Map_layer/martian_map/pipeline/60_web_export.py - GIS shared utilities
Map_layer/martian_map/pipeline/common.py - Stops and POIs
Map_layer/martian_map/pipeline/build_history/L5_poi/10_build_poi.py
Scout simulation
- Drone flight planning
Drone/sim/scripts/02_route_flights.py - Drone hazard layer
Drone/sim/scripts/05_hazard_layer.js - Drone simulator
Drone/sim
Tablet mission planning
- App view routing
Application/fg-app/src/App.jsx - Tablet planner
Application/fg-app/src/components/Tablet.jsx - Route planner
Application/fg-app/src/components/Planner.jsx - Geo layer loading
Application/fg-app/src/lib/geo.js - Stop and mission rules
Application/fg-app/src/lib/mission.js - Route options
Application/fg-app/src/lib/routes.js - Safety and oxygen
Application/fg-app/src/lib/safety.js - Mission exports
Application/fg-app/src/lib/exportMission.js
Helmet and 3D walk
- Helmet guidance
Application/fg-app/src/components/Helmet.jsx - Mission assistant
Application/fg-app/src/components/Assistant.jsx - Phone walk portal
Map_layer/martian_map/web/walk/portal.js - 3D terrain sections
Map_layer/martian_map/web/lib/sections.js
Other components
- Astronaut
Connections 24
- Elevation and slope → Map assembly: supplies terrain
README.md - Map assembly → GO/NO-GO layers: builds layers
README.md - GO/NO-GO layers → Combined routes: combines hazards
Map_layer/martian_map/pipeline/50_combined_routes.py - Combined routes → GIS shared utilities: uses utilities
Map_layer/martian_map/pipeline/50_combined_routes.py - Combined routes → Stops and POIs: uses stop locations
README.md - Combined routes → Web map export: exports web layers
README.md - Drone flight planning → Drone hazard layer: produces hazards
README.md - Drone hazard layer → Tablet planner: informs scouting
README.md - Astronaut → Tablet planner: plans EVA
README.md - App view routing → Tablet planner: selects tablet view
Application/fg-app/src/App.jsx - App view routing → Helmet guidance: selects helmet view
Application/fg-app/src/App.jsx - Tablet planner → Geo layer loading: loads map data
Application/fg-app/src/components/Tablet.jsx - Tablet planner → Route planner: renders planner
Application/fg-app/src/components/Tablet.jsx - Tablet planner → Route options: requests scout needs
Application/fg-app/src/components/Tablet.jsx - Tablet planner → Mission exports: exports mission
- Stop and mission rules → Geo layer loading: loads elevation context
Application/fg-app/src/lib/mission.js - Route options → Stop and mission rules: uses distance
Application/fg-app/src/lib/routes.js - Tablet planner → Stop and mission rules: loads stops
Application/fg-app/src/components/Tablet.jsx - Helmet guidance → Stop and mission rules: loads stops
Application/fg-app/src/components/Helmet.jsx - Helmet guidance → Safety and oxygen: checks EVA safety
Application/fg-app/src/components/Helmet.jsx - Helmet guidance → Mission assistant: renders assistant
Application/fg-app/src/components/Helmet.jsx - Astronaut → Phone walk portal: follows walk route
README.md - Web map export → Phone walk portal: provides web terrain
README.md - 3D terrain sections → Phone walk portal: supports 3D walk view
README.md