# mayankverma341/fire-atlas architecture

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

- Interactive diagram: https://gitdiagram.com/mayankverma341/fire-atlas
- Repository: https://github.com/mayankverma341/fire-atlas

## Overview

Fire Atlas pairs a scientific data-production pipeline with a static React explorer. Users select an area and period to inspect harmonised historical cell-day activity, compare years, view raw recent FIRMS detections separately, and download results; separate pages expose the 2012 sensor transition, validation, and methodology. Pipeline stages and web links are grounded in the README and supplied source excerpts/index; unsampled subsystem links are omitted where no caller evidence is available.

Main entry points: [`web/src/pages/Explore.jsx`](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Explore.jsx) (Explore workflow), [`web/src/App.jsx`](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/App.jsx) (App navigation), [`pipeline/fire_atlas/ingest.py`](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/ingest.py) (Ingest and filter), [`pipeline/fire_atlas/counts.py`](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/counts.py) (Cell-day counts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Historical pipeline"]
  node_adapter["FIRMS adapter<br/>[firms_csv.py]"]
  node_ingest["Ingest and filter<br/>[ingest.py]"]
  node_staticmask["Static-source mask<br/>[static_mask.py]"]
  node_counts["Cell-day counts<br/>[counts.py]"]
  node_coverage["Satellite coverage<br/>[coverage.py]"]
  node_factors["Calibration factors<br/>[factors.py]"]
  node_harmonise["Record harmonisation<br/>[harmonise.py]"]
  node_export["Site-data export<br/>[export.py]"]
  node_settings["Scientific settings<br/>[config.py]"]
end

subgraph group_web["Explorer"]
  node_app["App navigation<br/>[App.jsx]"]
  node_explore["Explore workflow<br/>[Explore.jsx]"]
  node_search["Area search<br/>[SearchBar.jsx]"]
  node_area["Area calculations<br/>[area.js]"]
  node_data["Historical data engine<br/>[data.js]"]
  node_geo["Geographic decoding<br/>[geo.js]"]
  node_analysis["Period analysis<br/>[analysis.js]"]
  node_map["Map display<br/>[MapView.jsx]"]
  node_downloads["Result downloads<br/>[downloads.js]"]
  node_switch["2012 comparison<br/>[Switch2012.jsx]"]
  node_method["Method and limits<br/>[Method.jsx]"]
end

subgraph group_assurance["Data assurance"]
  node_validation["Validation view<br/>[Validation.jsx]"]
  node_checks["Pipeline checks<br/>[checks.py]"]
  node_worldwide["Worldwide tests<br/>[tiles.py]"]
end

subgraph group_recent["Recent detections"]
  node_recentfetch["Recent FIRMS fetch<br/>[fetch_firms.py]"]
  node_snapshot["Recent snapshot<br/>[snapshot.py]"]
  node_recentdata["Recent-layer data<br/>[recent.js]"]
  node_recentpanel["Recent map panel<br/>[RecentPanel.jsx]"]
end

subgraph group_context["Context data"]
  node_weather["Weather context<br/>[fetch_power.py]"]
end

node_firms(("NASA FIRMS"))
node_user(("Explorer user"))

node_firms -->|"provides archives"| node_adapter
node_adapter -->|"converts rows"| node_ingest
node_ingest -->|"filters unknown types"| node_staticmask
node_ingest -.->|"stages detections"| node_counts
node_coverage -->|"excludes outage days"| node_factors
node_counts -->|"supplies cell-days"| node_factors
node_factors -->|"provides factors"| node_harmonise
node_counts -->|"supplies counts"| node_harmonise
node_harmonise -.->|"exports record"| node_export
node_settings -.->|"configures"| node_ingest
node_settings -->|"configures"| node_counts
node_settings -->|"configures"| node_factors
node_user -->|"opens explorer"| node_app
node_app -->|"routes to"| node_explore
node_app -->|"routes to"| node_validation
node_app -.->|"routes to"| node_switch
node_app -->|"routes to"| node_method
node_explore -->|"renders"| node_search
node_search -->|"creates area"| node_area
node_explore -->|"loads record"| node_data
node_data -->|"decodes status"| node_geo
node_explore -->|"computes summaries"| node_analysis
node_explore -->|"renders activity"| node_map
node_explore -.->|"offers downloads"| node_downloads
node_export -->|"provides site files"| node_data
node_validation -->|"loads record"| node_data
node_checks -->|"uses coverage"| node_coverage
node_worldwide -->|"checks outage days"| node_coverage
node_firms -->|"serves live detections"| node_recentfetch
node_recentfetch -->|"checks snapshot"| node_snapshot
node_snapshot -.->|"publishes recent data"| node_recentdata
node_explore -.->|"loads recent layer"| node_recentdata
node_explore -->|"renders selection"| node_recentpanel
node_weather -.->|"adds context"| node_explore

click node_adapter "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/adapters/firms_csv.py"
click node_ingest "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/ingest.py"
click node_staticmask "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/static_mask.py"
click node_counts "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/counts.py"
click node_coverage "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/coverage.py"
click node_factors "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/factors.py"
click node_harmonise "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/harmonise.py"
click node_export "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/export.py"
click node_settings "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/config.py"
click node_app "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/App.jsx"
click node_explore "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Explore.jsx"
click node_search "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/components/SearchBar.jsx"
click node_area "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/area.js"
click node_data "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/data.js"
click node_geo "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/geo.js"
click node_analysis "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/analysis.js"
click node_map "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/components/MapView.jsx"
click node_downloads "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/downloads.js"
click node_switch "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Switch2012.jsx"
click node_validation "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Validation.jsx"
click node_checks "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/checks.py"
click node_worldwide "https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/tiles.py"
click node_recentfetch "https://github.com/mayankverma341/fire-atlas/blob/main/recent/fetch_firms.py"
click node_snapshot "https://github.com/mayankverma341/fire-atlas/blob/main/recent/snapshot.py"
click node_recentdata "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/recent.js"
click node_recentpanel "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/components/RecentPanel.jsx"
click node_weather "https://github.com/mayankverma341/fire-atlas/blob/main/context/fetch_power.py"
click node_method "https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Method.jsx"

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_adapter,node_ingest,node_staticmask,node_counts,node_coverage,node_factors,node_harmonise,node_export,node_settings,node_user toneBlue
class node_app,node_explore,node_search,node_area,node_data,node_geo,node_analysis,node_map,node_downloads,node_switch,node_method toneAmber
class node_validation,node_checks,node_worldwide toneMint
class node_recentfetch,node_snapshot,node_recentdata,node_recentpanel toneRose
class node_weather,node_firms toneIndigo
```

## Components

### Historical pipeline

- [FIRMS adapter](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/adapters/firms_csv.py): `pipeline/fire_atlas/adapters/firms_csv.py`
- [Ingest and filter](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/ingest.py): `pipeline/fire_atlas/ingest.py`
- [Static-source mask](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/static_mask.py): `pipeline/fire_atlas/static_mask.py`
- [Cell-day counts](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/counts.py): `pipeline/fire_atlas/counts.py`
- [Satellite coverage](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/coverage.py): `pipeline/fire_atlas/coverage.py`
- [Calibration factors](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/factors.py): `pipeline/fire_atlas/factors.py`
- [Record harmonisation](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/harmonise.py): `pipeline/fire_atlas/harmonise.py`
- [Site-data export](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/export.py): `pipeline/fire_atlas/export.py`
- [Scientific settings](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/config.py): `pipeline/fire_atlas/config.py`

### Explorer

- [App navigation](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/App.jsx): `web/src/App.jsx`
- [Explore workflow](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Explore.jsx): `web/src/pages/Explore.jsx`
- [Area search](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/components/SearchBar.jsx): `web/src/components/SearchBar.jsx`
- [Area calculations](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/area.js): `web/src/lib/area.js`
- [Historical data engine](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/data.js): `web/src/lib/data.js`
- [Geographic decoding](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/geo.js): `web/src/lib/geo.js`
- [Period analysis](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/analysis.js): `web/src/lib/analysis.js`
- [Map display](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/components/MapView.jsx): `web/src/components/MapView.jsx`
- [Result downloads](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/downloads.js): `web/src/lib/downloads.js`
- [2012 comparison](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Switch2012.jsx): `web/src/pages/Switch2012.jsx`
- [Method and limits](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Method.jsx): `web/src/pages/Method.jsx`

### Data assurance

- [Validation view](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/pages/Validation.jsx): `web/src/pages/Validation.jsx`
- [Pipeline checks](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/checks.py): `pipeline/fire_atlas/checks.py`
- [Worldwide tests](https://github.com/mayankverma341/fire-atlas/blob/main/pipeline/fire_atlas/tiles.py): `pipeline/fire_atlas/tiles.py`

### Recent detections

- [Recent FIRMS fetch](https://github.com/mayankverma341/fire-atlas/blob/main/recent/fetch_firms.py): `recent/fetch_firms.py`
- [Recent snapshot](https://github.com/mayankverma341/fire-atlas/blob/main/recent/snapshot.py): `recent/snapshot.py`
- [Recent-layer data](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/lib/recent.js): `web/src/lib/recent.js`
- [Recent map panel](https://github.com/mayankverma341/fire-atlas/blob/main/web/src/components/RecentPanel.jsx): `web/src/components/RecentPanel.jsx`

### Context data

- [Weather context](https://github.com/mayankverma341/fire-atlas/blob/main/context/fetch_power.py): `context/fetch_power.py`

### Other components

- **NASA FIRMS**
- **Explorer user**

## Connections

- NASA FIRMS → FIRMS adapter: provides archives
- FIRMS adapter → Ingest and filter: converts rows (evidence: `pipeline/fire_atlas/ingest.py`)
- Ingest and filter → Static-source mask: filters unknown types (evidence: `pipeline/fire_atlas/ingest.py`)
- Ingest and filter → Cell-day counts: stages detections
- Satellite coverage → Calibration factors: excludes outage days (evidence: `pipeline/fire_atlas/factors.py`)
- Cell-day counts → Calibration factors: supplies cell-days (evidence: `pipeline/fire_atlas/factors.py`)
- Calibration factors → Record harmonisation: provides factors (evidence: `pipeline/fire_atlas/harmonise.py`)
- Cell-day counts → Record harmonisation: supplies counts (evidence: `pipeline/fire_atlas/harmonise.py`)
- Record harmonisation → Site-data export: exports record
- Scientific settings → Ingest and filter: configures (evidence: `pipeline/fire_atlas/ingest.py`)
- Scientific settings → Cell-day counts: configures (evidence: `pipeline/fire_atlas/counts.py`)
- Scientific settings → Calibration factors: configures (evidence: `pipeline/fire_atlas/factors.py`)
- Explorer user → App navigation: opens explorer
- App navigation → Explore workflow: routes to (evidence: `web/src/App.jsx`)
- App navigation → Validation view: routes to (evidence: `web/src/App.jsx`)
- App navigation → 2012 comparison: routes to (evidence: `web/src/App.jsx`)
- App navigation → Method and limits: routes to (evidence: `web/src/App.jsx`)
- Explore workflow → Area search: renders (evidence: `web/src/pages/Explore.jsx`)
- Area search → Area calculations: creates area (evidence: `web/src/components/SearchBar.jsx`)
- Explore workflow → Historical data engine: loads record (evidence: `web/src/pages/Explore.jsx`)
- Historical data engine → Geographic decoding: decodes status (evidence: `web/src/lib/data.js`)
- Explore workflow → Period analysis: computes summaries (evidence: `web/src/pages/Explore.jsx`)
- Explore workflow → Map display: renders activity (evidence: `web/src/pages/Explore.jsx`)
- Explore workflow → Result downloads: offers downloads (evidence: `web/src/pages/Explore.jsx`)
- Site-data export → Historical data engine: provides site files (evidence: `web/src/lib/data.js`)
- Validation view → Historical data engine: loads record (evidence: `web/src/pages/Validation.jsx`)
- Pipeline checks → Satellite coverage: uses coverage (evidence: `pipeline/fire_atlas/checks.py`)
- Worldwide tests → Satellite coverage: checks outage days (evidence: `pipeline/fire_atlas/tiles.py`)
- NASA FIRMS → Recent FIRMS fetch: serves live detections
- Recent FIRMS fetch → Recent snapshot: checks snapshot (evidence: `recent/snapshot.py`)
- Recent snapshot → Recent-layer data: publishes recent data
- Explore workflow → Recent-layer data: loads recent layer (evidence: `web/src/pages/Explore.jsx`)
- Explore workflow → Recent map panel: renders selection (evidence: `web/src/pages/Explore.jsx`)
- Weather context → Explore workflow: adds context
