# phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries architecture

> Architecture diagram of the GitHub repository phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries
- Repository: https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries

## Overview

Beyond Pixels is a web command center for Sentinel-2 super-resolution mapping. A user targets an area and submits a scan; the API queues and tracks the job, acquires and prepares imagery, runs dual-model super-resolution with spectral constraints, and returns geospatial results, indices, and uncertainty for inspection and reporting. The README documents broader exports and evaluation capabilities; sampled source confirms the main inference and index stages but does not expose every API-to-pipeline call or export implementation, so uncertain wiring is omitted.

Main entry points: [`run_pipeline.py`](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/run_pipeline.py) (Pipeline runner), [`srm_api/main.py`](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm_api/main.py) (HTTP API), [`frontend/src/utils/api.ts`](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/utils/api.ts) (API client), [`frontend/src/app/page.tsx`](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/app/page.tsx) (Scan workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Command Center"]
  node_home["Scan workspace<br/>[page.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_result_page["Job results page<br/>[page.tsx]"]
  node_results_panel["Results viewer<br/>[ResultsPanel.tsx]"]
end

subgraph group_service["Job Service"]
  node_api["HTTP API<br/>[main.py]"]
  node_job_queue["GPU job queue<br/>[main.py]"]
  node_scan_db[("Mission history<br/>[db.py]")]
end

subgraph group_mapping["Mapping Pipeline"]
  node_runner["Pipeline runner<br/>[run_pipeline.py]"]
  node_ingestion["STAC ingestion<br/>[ingestion.py]"]
  node_preprocessing["Image preparation<br/>[preprocessing.py]"]
  node_sr_pipeline["SR orchestration<br/>[sr_pipeline.py]"]
  node_able_model["Able network<br/>[__init__.py]"]
  node_sen2_model["SEN2SRLite model<br/>[sr_pipeline.py]"]
  node_postprocessing["Geospatial export<br/>[postprocessing.py]"]
end

subgraph group_analysis["Analysis Outputs"]
  node_uncertainty["Uncertainty estimates<br/>[uncertainty.py]"]
  node_explainability["Model explanations<br/>[explainability.py]"]
  node_applications["Spectral indices<br/>[applications.py]"]
  node_validation["Quality evaluation<br/>[validation.py]"]
end

node_user(("Map analyst"))
node_stac["Planetary Computer STAC"]

node_user -->|"selects area"| node_home
node_home -->|"submits job"| node_api_client
node_home -->|"polls status"| node_api_client
node_api_client -->|"HTTP requests"| node_api
node_api -->|"enqueues job"| node_job_queue
node_job_queue -->|"dispatches job"| node_runner
node_api -->|"records scans"| node_scan_db
node_runner -->|"requests imagery"| node_ingestion
node_ingestion -->|"queries scenes"| node_stac
node_ingestion -->|"supplies imagery"| node_preprocessing
node_runner -->|"prepares input"| node_preprocessing
node_runner -->|"runs inference"| node_sr_pipeline
node_sr_pipeline -->|"runs four-band SR"| node_able_model
node_sr_pipeline -->|"runs ten-band SR"| node_sen2_model
node_runner -->|"exports products"| node_postprocessing
node_runner -->|"estimates uncertainty"| node_uncertainty
node_runner -.->|"requests explanations"| node_explainability
node_runner -->|"computes indices"| node_applications
node_runner -.->|"evaluates output"| node_validation
node_api -->|"serves job status"| node_result_page
node_result_page -->|"fetches results"| node_api_client
node_api_client -->|"requests results"| node_api
node_result_page -->|"renders result"| node_results_panel
node_api -->|"reads history"| node_scan_db

click node_home "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/app/page.tsx"
click node_api_client "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/utils/api.ts"
click node_result_page "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/app/results/%5BjobId%5D/page.tsx"
click node_results_panel "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/components/ResultsPanel.tsx"
click node_api "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm_api/main.py"
click node_job_queue "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm_api/main.py"
click node_scan_db "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm_api/db.py"
click node_runner "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/run_pipeline.py"
click node_ingestion "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/ingestion.py"
click node_preprocessing "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/preprocessing.py"
click node_sr_pipeline "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/sr_pipeline.py"
click node_able_model "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/able/__init__.py"
click node_sen2_model "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/sr_pipeline.py"
click node_postprocessing "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/postprocessing.py"
click node_uncertainty "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/uncertainty.py"
click node_explainability "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/explainability.py"
click node_applications "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/applications.py"
click node_validation "https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/validation.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_home,node_api_client,node_result_page,node_results_panel toneBlue
class node_api,node_job_queue,node_scan_db toneAmber
class node_runner,node_ingestion,node_preprocessing,node_sr_pipeline,node_able_model,node_sen2_model,node_postprocessing toneMint
class node_uncertainty,node_explainability,node_applications,node_validation toneRose
class node_user,node_stac toneIndigo
```

## Components

### Command Center

- [Scan workspace](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [API client](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/utils/api.ts): `frontend/src/utils/api.ts`
- [Job results page](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/app/results/%5BjobId%5D/page.tsx): `frontend/src/app/results/[jobId]/page.tsx`
- [Results viewer](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/frontend/src/components/ResultsPanel.tsx): `frontend/src/components/ResultsPanel.tsx`

### Job Service

- [HTTP API](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm_api/main.py): `srm_api/main.py`
- [GPU job queue](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm_api/main.py): `srm_api/main.py`
- [Mission history](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm_api/db.py): `srm_api/db.py`

### Mapping Pipeline

- [Pipeline runner](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/run_pipeline.py): `run_pipeline.py`
- [STAC ingestion](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/ingestion.py): `srm/ingestion.py`
- [Image preparation](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/preprocessing.py): `srm/preprocessing.py`
- [SR orchestration](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/sr_pipeline.py): `srm/sr_pipeline.py`
- [Able network](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/able/__init__.py): `srm/able/__init__.py`
- [SEN2SRLite model](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/sr_pipeline.py): `srm/sr_pipeline.py`
- [Geospatial export](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/postprocessing.py): `srm/postprocessing.py`

### Analysis Outputs

- [Uncertainty estimates](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/uncertainty.py): `srm/uncertainty.py`
- [Model explanations](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/explainability.py): `srm/explainability.py`
- [Spectral indices](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/applications.py): `srm/applications.py`
- [Quality evaluation](https://github.com/phonicxxxx24/deep-learning-based-super-resolution-mapping-srm-from-medium-resolution-satellite-imageries/blob/stage-task-3/srm/validation.py): `srm/validation.py`

### Other components

- **Map analyst**
- **Planetary Computer STAC**

## Connections

- Map analyst → Scan workspace: selects area
- Scan workspace → API client: submits job
- Scan workspace → API client: polls status
- API client → HTTP API: HTTP requests
- HTTP API → GPU job queue: enqueues job
- GPU job queue → Pipeline runner: dispatches job
- HTTP API → Mission history: records scans
- Pipeline runner → STAC ingestion: requests imagery
- STAC ingestion → Planetary Computer STAC: queries scenes
- STAC ingestion → Image preparation: supplies imagery
- Pipeline runner → Image preparation: prepares input
- Pipeline runner → SR orchestration: runs inference
- SR orchestration → Able network: runs four-band SR
- SR orchestration → SEN2SRLite model: runs ten-band SR
- Pipeline runner → Geospatial export: exports products
- Pipeline runner → Uncertainty estimates: estimates uncertainty
- Pipeline runner → Model explanations: requests explanations
- Pipeline runner → Spectral indices: computes indices
- Pipeline runner → Quality evaluation: evaluates output
- HTTP API → Job results page: serves job status
- Job results page → API client: fetches results
- API client → HTTP API: requests results
- Job results page → Results viewer: renders result
- HTTP API → Mission history: reads history