How sebaspalate/firetrack works
Firetrack turns public NASA FIRMS hotspot observations into a region-clipped, Aqua-referenced activity index, then presents calendars, maps, comparisons, method/validation evidence, and per-sensor CSV exports. The principal path is mirror ingestion → harmonization and processed artifacts → API or exported static data → browser dashboard. The README documents product capabilities and both serving modes; several UI component internals and pipeline modules were not excerpted, so their finer call relationships are not inferred.
Main entry points: Dashboard.tsx Dashboard · api.ts Data client · main.py Read-only API · export_web.py Static data export
Components 20
Data pipeline
- Detection ingest
pipeline/firms.py - Region boundaries
pipeline/regions.py - Sensor normalization
pipeline/normalize.py
Serving and artifacts
- Processed artifacts
data/processed - Payload formatting
pipeline/payloads.py - Read-only API
services/api/main.py - Static data export
pipeline/export_web.py - Browser data files
apps/web/public/data
Web experience
- Dashboard
apps/web/src/components/Dashboard.tsx - Data client
apps/web/src/lib/api.ts - Detection parser
apps/web/src/lib/detections.ts - Activity calendar
apps/web/src/components/CalendarHeatmap.tsx - Detection map
apps/web/src/components/MapPanel.tsx - Comparison views
apps/web/src/components/MonthlySeries.tsx - CSV export
apps/web/src/lib/api.ts
Method and evidence
- Calibration and index
pipeline/harmonize.py - Method and validation
apps/web/src/components/Validation.tsx - Provenance details
apps/web/src/components/Provenance.tsx
Other components
- Fire manager
- FIRMS mirror
Connections 23
- FIRMS mirror → Detection ingest: supplies detections
pipeline/firms.py - Detection ingest → Region boundaries: clips by region
pipeline/firms.py - Detection ingest → Calibration and index: caches detections
pipeline/harmonize.py - Calibration and index → Sensor normalization: normalizes sensors
pipeline/harmonize.py - Calibration and index → Processed artifacts: writes artifacts
pipeline/harmonize.py - Fire manager → Dashboard: explores activity
README.md - Dashboard → Data client: loads data
- Data client → Read-only API: requests payloads
apps/web/src/lib/api.ts - Data client → Browser data files: reads static files
apps/web/src/lib/api.ts - Read-only API → Payload formatting: formats responses
services/api/main.py - Read-only API → Processed artifacts: queries artifacts
services/api/main.py - Static data export → Processed artifacts: reads artifacts
pipeline/export_web.py - Static data export → Payload formatting: builds shared payloads
pipeline/export_web.py - Static data export → Browser data files: writes browser files
pipeline/export_web.py - Dashboard → Activity calendar: presents calendar
README.md - Dashboard → Detection map: presents map
README.md - Dashboard → Comparison views: presents comparisons
README.md - Dashboard → Method and validation: shows validation
README.md - Dashboard → Provenance details: shows evidence
README.md - Data client → Detection parser: provides detection URLs
apps/web/src/lib/detections.ts - Detection parser → Browser data files: loads yearly CSV
apps/web/src/lib/detections.ts - Data client → CSV export: downloads detections
apps/web/src/lib/api.ts - Read-only API → CSV export: serves detection CSV
services/api/main.py