How vivek-010107/oilnexus works
OilNexus is a SAR oil-spill analysis prototype with a React intelligence dashboard and FastAPI backend. The main workflow accepts an image and scenario metadata, detects oil, optionally georeferences and reconstructs drift, then optionally ranks synthetic AIS candidates; results and reports are presented in the UI. The map, live-traffic view, and incident archive are separate product capabilities. Backend execution and component imports are supported by excerpts or the SOURCE INDEX; unsampled internals and some UI-to-backend wiring are not expanded beyond shown evidence.
Main entry points: main.py Analysis API · pipeline.py Pipeline Orchestrator · App.jsx Dashboard · LiveTraffic.jsx Live Traffic
Components 31
Investigation UI
- Dashboard
frontend/src/App.jsx - API Client
frontend/src/api.js - Report View
frontend/src/ReportView.jsx - Evidence Drawer
frontend/src/EvidenceDrawer.jsx - Forensic Map
frontend/src/ForensicMap.jsx - Globe Surface
frontend/src/GlobeSurface.jsx - Live Traffic
frontend/src/LiveTraffic.jsx - Live Data
frontend/src/liveData.js - Live Clock
frontend/src/liveClock.js - Incident Archive
frontend/src/IncidentArchive.jsx
Analysis API
- Analysis API
backend/main.py - Pipeline Orchestrator
backend/pipeline.py - Report Generation
backend/reporting.py - Mock Pipeline
backend/mock_pipeline.py
SAR Detection
- SAR Inference
backend/stage1/inference.py - Model Loading
backend/stage1/model.py - Pixel Geometry
backend/stage1/geometry.py - Georeferencing
backend/stage1/georeferencing.py
Drift and Attribution
- Drift Reconstruction
backend/stage2/drift.py - Current Grid
backend/stage2/currents.py - Wind Inputs
backend/stage2/winds.py - Wind Engine
backend/stage2/wind_engine.py - Current Engine
backend/stage2/opendrift_engine.py - AIS Attribution
backend/stage3/attribution.py
Contracts and Utilities
- Request Models
backend/schemas/requests.py - Response Models
backend/schemas/responses.py - Shared Schemas
backend/schemas/common.py - Runtime Settings
backend/settings.py - Pipeline Errors
backend/utils/errors.py - Image Utilities
backend/utils/images.py
Other components
- Analyst
Connections 37
- Analyst → Dashboard: uses
README.md - Dashboard → API Client: calls
frontend/src/App.jsx - Dashboard → Analysis API: submits analysis
frontend/src/App.jsx - Dashboard → Report View: renders
frontend/src/App.jsx - Dashboard → Incident Archive: renders
frontend/src/App.jsx - Dashboard → Live Traffic: renders
frontend/src/App.jsx - Dashboard → Evidence Drawer: renders
frontend/src/App.jsx - Report View → Forensic Map: renders
frontend/src/ReportView.jsx - Report View → Evidence Drawer: renders
frontend/src/ReportView.jsx - Forensic Map → Globe Surface: renders
frontend/src/ForensicMap.jsx - Live Traffic → Globe Surface: renders
frontend/src/LiveTraffic.jsx - Live Traffic → Live Data: uses
frontend/src/LiveTraffic.jsx - Live Traffic → Live Clock: uses
frontend/src/LiveTraffic.jsx - Analysis API → Request Models: validates
backend/main.py - Analysis API → Image Utilities: decodes image
backend/main.py - Analysis API → Pipeline Orchestrator: runs
backend/main.py - Analysis API → Report Generation: generates report
backend/main.py - Analysis API → Runtime Settings: configures
backend/main.py - Pipeline Orchestrator → SAR Inference: detects
backend/pipeline.py - Pipeline Orchestrator → Mock Pipeline: runs mock stages
backend/pipeline.py - Pipeline Orchestrator → Georeferencing: georeferences
backend/pipeline.py - Pipeline Orchestrator → Drift Reconstruction: reconstructs
backend/pipeline.py - Pipeline Orchestrator → AIS Attribution: attributes
backend/pipeline.py - SAR Inference → Model Loading: loads
backend/stage1/inference.py - SAR Inference → Pixel Geometry: measures
backend/stage1/inference.py - Drift Reconstruction → Current Grid: loads
backend/stage2/drift.py - Drift Reconstruction → Wind Inputs: uses
backend/stage2/drift.py - Drift Reconstruction → Wind Engine: simulates with
backend/stage2/drift.py - AIS Attribution → Current Grid: loads
backend/stage3/attribution.py - AIS Attribution → Current Engine: simulates candidates
backend/stage3/attribution.py - Analysis API → Response Models: returns
backend/main.py - Response Models → Shared Schemas: uses types
backend/schemas/responses.py - Response Models → Request Models: embeds input
backend/schemas/responses.py - Request Models → Shared Schemas: uses types
backend/schemas/requests.py - Pipeline Orchestrator → Response Models: builds results
backend/pipeline.py - Analysis API → Pipeline Errors: handles
backend/main.py - Pipeline Orchestrator → Pipeline Errors: raises
backend/pipeline.py