# hadtool/lunar-navigator architecture

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

- Interactive diagram: https://gitdiagram.com/hadtool/lunar-navigator
- Repository: https://github.com/hadtool/lunar-navigator

## Overview

Lunar Landing Site Navigator is a Streamlit engineering tool for assessing lunar south-pole landing sites. Users choose a site, dates, mast height, and lander assumptions, then inspect terrain and Sun/Earth visibility, simulate power survival, compare mast trade-offs, and search landing windows. The app reads precomputed horizons and ephemeris data; an offline pipeline prepares those artifacts. The graph includes the documented comparison and methods views. Some view routing and unsampled subsystem internals are not shown, so only evidenced relationships are connected.

Main entry points: [`app/common.py`](https://github.com/hadtool/lunar-navigator/blob/main/app/common.py) (Shared state), [`app/views/site.py`](https://github.com/hadtool/lunar-navigator/blob/main/app/views/site.py) (Site view), [`app/views/compare.py`](https://github.com/hadtool/lunar-navigator/blob/main/app/views/compare.py) (Compare view), [`src/lunarnav/comms.py`](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/comms.py) (Earth link)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Navigator app"]
  node_streamlit["App entry<br/>[streamlit_app.py]"]
  node_shared["Shared state<br/>[common.py]"]
  node_siteview["Site view<br/>[site.py]"]
  node_powerview["Power view<br/>[power.py]"]
  node_mastview["Mast view<br/>[mast.py]"]
  node_landingview["Landing view<br/>[landing.py]"]
  node_compareview["Compare view<br/>[compare.py]"]
  node_methodsview["Methods view<br/>[methods.py]"]
end

subgraph group_analysis["Mission analysis"]
  node_inputs["Engineering inputs<br/>[inputs.py]"]
  node_ephemeris["Sky positions<br/>[ephemeris.py]"]
  node_horizon["Terrain horizon<br/>[horizon.py]"]
  node_visibility["Disc visibility<br/>[visibility.py]"]
  node_power["Power simulation<br/>[power.py]"]
  node_comms["Earth link<br/>[comms.py]"]
  node_mast["Mast trade-off<br/>[mast.py]"]
  node_windows["Landing windows<br/>[windows.py]"]
end

subgraph group_data["Precomputed data"]
  node_store["Data access<br/>[store.py]"]
  node_processed[("Processed data")]
end

subgraph group_prep["Offline preparation"]
  node_build["Data builder<br/>[build.py]"]
  node_horizonbuild["Horizon builder<br/>[build_horizons.py]"]
  node_basemapbuild["Basemap builder<br/>[build_basemap.py]"]
  node_windowbuild["Window analysis<br/>[landing_windows.py]"]
  node_mastbuild["Mast analysis<br/>[mast_tradeoff.py]"]
end

node_engineer(("Engineer"))

node_engineer -->|"uses"| node_streamlit
node_streamlit -->|"initializes"| node_shared
node_siteview -->|"uses"| node_shared
node_powerview -->|"uses"| node_shared
node_mastview -->|"uses"| node_shared
node_landingview -->|"uses"| node_shared
node_compareview -->|"uses"| node_shared
node_methodsview -->|"uses"| node_shared
node_shared -->|"loads cached data"| node_store
node_shared -->|"computes link"| node_comms
node_shared -->|"uses positions"| node_ephemeris
node_shared -->|"uses horizons"| node_horizon
node_shared -->|"loads assumptions"| node_inputs
node_shared -->|"computes trade-offs"| node_mast
node_shared -->|"simulates power"| node_power
node_shared -->|"uses visibility"| node_visibility
node_siteview -->|"uses positions"| node_ephemeris
node_siteview -->|"uses link"| node_comms
node_siteview -->|"uses visibility"| node_visibility
node_powerview -->|"simulates"| node_power
node_mastview -->|"computes trade-offs"| node_mast
node_landingview -->|"searches dates"| node_windows
node_landingview -->|"uses link"| node_comms
node_compareview -->|"compares power"| node_power
node_compareview -->|"compares link"| node_comms
node_compareview -->|"compares visibility"| node_visibility
node_store -->|"reads"| node_processed
node_build -->|"invokes"| node_horizonbuild
node_build -->|"writes artifacts"| node_processed
node_horizonbuild -->|"computes horizons"| node_horizon
node_horizonbuild -->|"writes profiles"| node_processed
node_basemapbuild -.->|"prepares basemap"| node_processed
node_windowbuild -->|"analyzes dates"| node_windows
node_mastbuild -->|"analyzes heights"| node_mast

click node_streamlit "https://github.com/hadtool/lunar-navigator/blob/main/app/streamlit_app.py"
click node_shared "https://github.com/hadtool/lunar-navigator/blob/main/app/common.py"
click node_siteview "https://github.com/hadtool/lunar-navigator/blob/main/app/views/site.py"
click node_powerview "https://github.com/hadtool/lunar-navigator/blob/main/app/views/power.py"
click node_mastview "https://github.com/hadtool/lunar-navigator/blob/main/app/views/mast.py"
click node_landingview "https://github.com/hadtool/lunar-navigator/blob/main/app/views/landing.py"
click node_compareview "https://github.com/hadtool/lunar-navigator/blob/main/app/views/compare.py"
click node_methodsview "https://github.com/hadtool/lunar-navigator/blob/main/app/views/methods.py"
click node_inputs "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/inputs.py"
click node_ephemeris "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/ephemeris.py"
click node_horizon "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/horizon.py"
click node_visibility "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/visibility.py"
click node_power "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/power.py"
click node_comms "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/comms.py"
click node_mast "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/mast.py"
click node_windows "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/windows.py"
click node_store "https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/store.py"
click node_processed "https://github.com/hadtool/lunar-navigator/tree/main/data/processed"
click node_build "https://github.com/hadtool/lunar-navigator/blob/main/pipeline/build.py"
click node_horizonbuild "https://github.com/hadtool/lunar-navigator/blob/main/pipeline/build_horizons.py"
click node_basemapbuild "https://github.com/hadtool/lunar-navigator/blob/main/pipeline/build_basemap.py"
click node_windowbuild "https://github.com/hadtool/lunar-navigator/blob/main/pipeline/landing_windows.py"
click node_mastbuild "https://github.com/hadtool/lunar-navigator/blob/main/pipeline/mast_tradeoff.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_streamlit,node_shared,node_siteview,node_powerview,node_mastview,node_landingview,node_compareview,node_methodsview toneBlue
class node_inputs,node_ephemeris,node_horizon,node_visibility,node_power,node_comms,node_mast,node_windows toneAmber
class node_store,node_processed toneMint
class node_build,node_horizonbuild,node_basemapbuild,node_windowbuild,node_mastbuild toneRose
class node_engineer toneIndigo
```

## Components

### Navigator app

- [App entry](https://github.com/hadtool/lunar-navigator/blob/main/app/streamlit_app.py): `app/streamlit_app.py`
- [Shared state](https://github.com/hadtool/lunar-navigator/blob/main/app/common.py): `app/common.py`
- [Site view](https://github.com/hadtool/lunar-navigator/blob/main/app/views/site.py): `app/views/site.py`
- [Power view](https://github.com/hadtool/lunar-navigator/blob/main/app/views/power.py): `app/views/power.py`
- [Mast view](https://github.com/hadtool/lunar-navigator/blob/main/app/views/mast.py): `app/views/mast.py`
- [Landing view](https://github.com/hadtool/lunar-navigator/blob/main/app/views/landing.py): `app/views/landing.py`
- [Compare view](https://github.com/hadtool/lunar-navigator/blob/main/app/views/compare.py): `app/views/compare.py`
- [Methods view](https://github.com/hadtool/lunar-navigator/blob/main/app/views/methods.py): `app/views/methods.py`

### Mission analysis

- [Engineering inputs](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/inputs.py): `src/lunarnav/inputs.py`
- [Sky positions](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/ephemeris.py): `src/lunarnav/ephemeris.py`
- [Terrain horizon](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/horizon.py): `src/lunarnav/horizon.py`
- [Disc visibility](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/visibility.py): `src/lunarnav/visibility.py`
- [Power simulation](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/power.py): `src/lunarnav/power.py`
- [Earth link](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/comms.py): `src/lunarnav/comms.py`
- [Mast trade-off](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/mast.py): `src/lunarnav/mast.py`
- [Landing windows](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/windows.py): `src/lunarnav/windows.py`

### Precomputed data

- [Data access](https://github.com/hadtool/lunar-navigator/blob/main/src/lunarnav/store.py): `src/lunarnav/store.py`
- [Processed data](https://github.com/hadtool/lunar-navigator/tree/main/data/processed): `data/processed`

### Offline preparation

- [Data builder](https://github.com/hadtool/lunar-navigator/blob/main/pipeline/build.py): `pipeline/build.py`
- [Horizon builder](https://github.com/hadtool/lunar-navigator/blob/main/pipeline/build_horizons.py): `pipeline/build_horizons.py`
- [Basemap builder](https://github.com/hadtool/lunar-navigator/blob/main/pipeline/build_basemap.py): `pipeline/build_basemap.py`
- [Window analysis](https://github.com/hadtool/lunar-navigator/blob/main/pipeline/landing_windows.py): `pipeline/landing_windows.py`
- [Mast analysis](https://github.com/hadtool/lunar-navigator/blob/main/pipeline/mast_tradeoff.py): `pipeline/mast_tradeoff.py`

### Other components

- **Engineer**

## Connections

- Engineer → App entry: uses (evidence: `README.md`)
- App entry → Shared state: initializes (evidence: `app/streamlit_app.py`)
- Site view → Shared state: uses (evidence: `app/views/site.py`)
- Power view → Shared state: uses (evidence: `app/views/power.py`)
- Mast view → Shared state: uses (evidence: `app/views/mast.py`)
- Landing view → Shared state: uses (evidence: `app/views/landing.py`)
- Compare view → Shared state: uses (evidence: `app/views/compare.py`)
- Methods view → Shared state: uses (evidence: `app/views/methods.py`)
- Shared state → Data access: loads cached data (evidence: `app/common.py`)
- Shared state → Earth link: computes link (evidence: `app/common.py`)
- Shared state → Sky positions: uses positions (evidence: `app/common.py`)
- Shared state → Terrain horizon: uses horizons (evidence: `app/common.py`)
- Shared state → Engineering inputs: loads assumptions (evidence: `app/common.py`)
- Shared state → Mast trade-off: computes trade-offs (evidence: `app/common.py`)
- Shared state → Power simulation: simulates power (evidence: `app/common.py`)
- Shared state → Disc visibility: uses visibility (evidence: `app/common.py`)
- Site view → Sky positions: uses positions (evidence: `app/views/site.py`)
- Site view → Earth link: uses link (evidence: `app/views/site.py`)
- Site view → Disc visibility: uses visibility (evidence: `app/views/site.py`)
- Power view → Power simulation: simulates (evidence: `app/views/power.py`)
- Mast view → Mast trade-off: computes trade-offs (evidence: `app/views/mast.py`)
- Landing view → Landing windows: searches dates (evidence: `app/views/landing.py`)
- Landing view → Earth link: uses link (evidence: `app/views/landing.py`)
- Compare view → Power simulation: compares power (evidence: `app/views/compare.py`)
- Compare view → Earth link: compares link (evidence: `app/views/compare.py`)
- Compare view → Disc visibility: compares visibility (evidence: `app/views/compare.py`)
- Data access → Processed data: reads (evidence: `src/lunarnav/store.py`)
- Data builder → Horizon builder: invokes (evidence: `pipeline/build.py`)
- Data builder → Processed data: writes artifacts (evidence: `pipeline/build.py`)
- Horizon builder → Terrain horizon: computes horizons (evidence: `pipeline/build_horizons.py`)
- Horizon builder → Processed data: writes profiles (evidence: `pipeline/build_horizons.py`)
- Basemap builder → Processed data: prepares basemap
- Window analysis → Landing windows: analyzes dates (evidence: `pipeline/landing_windows.py`)
- Mast analysis → Mast trade-off: analyzes heights (evidence: `pipeline/mast_tradeoff.py`)
