How santhosh-i/neuro-stack_plastic-ledger works
Plastic-Ledger turns a selected coastal area and date into a marine-debris investigation: analysts configure and launch a run, the backend records its status and invokes the pipeline, and the dashboard supports review of detections, polymer classes, backtracks, attribution, hotspots, and reports. The seven-stage pipeline is documented as an ordered workflow; the excerpted runner confirms orchestration but does not expose every stage call. Frontend-to-API behavior and several dashboard capabilities are documented in the README, not verified from their unsampled implementations.
Main entry points: run_pipeline.py Pipeline runner · api.ts API client · App.tsx Application routes · 01_ingest.py Satellite ingest
Components 24
Analyst dashboard
- Application routes
frontend/src/App.tsx - Run tracking
frontend/src/pages/TrackingPage.tsx - Run dashboard
frontend/src/pages/DashboardPage.tsx - Run detail
frontend/src/pages/RunDetailPage.tsx - Hotspots
frontend/src/pages/HotspotsPage.tsx - Model outputs
frontend/src/pages/modelpage.jsx - API client
frontend/src/lib/api.ts
Run management API
- Run API
server/api/views.py - Run records
server/api/models.py - Run validation
server/api/serializers.py
Analysis pipeline
- Pipeline runner
src/pipeline/run_pipeline.py - Satellite ingest
src/pipeline/01_ingest.py - Image preprocessing
src/pipeline/02_preprocess.py - Debris detection
src/pipeline/03_detect.py - Polymer classification
src/pipeline/04_polymer.py - Particle backtracking
src/pipeline/05_backtrack.py - Source attribution
src/pipeline/06_attribute.py - Run reporting
src/pipeline/07_report.py
Pipeline utilities
- Stage caching
src/pipeline/utils/cache_utils.py - Geospatial helpers
src/pipeline/utils/geo_utils.py - Pipeline logging
src/pipeline/utils/logging_utils.py
Other components
- Analyst
- Copernicus Sentinel-2
- CMEMS and ERA5
Connections 38
- Analyst → Run tracking: configures run
README.md - Application routes → Run tracking: routes to
frontend/src/App.tsx - Application routes → Run dashboard: routes to
frontend/src/App.tsx - Application routes → Run detail: routes to
frontend/src/App.tsx - Application routes → Hotspots: routes to
frontend/src/App.tsx - Application routes → Model outputs: routes to
frontend/src/App.tsx - Run tracking → API client: submits run
- Run dashboard → API client: loads run data
- Run detail → API client: loads run data
- Hotspots → API client: explores run data
- Model outputs → API client: reads evaluation artifacts
- API client → Run API: requests run data
- Run API → Run validation: validates and serializes
server/api/views.py - Run validation → Run records: validates records
server/api/serializers.py - Run API → Run records: creates and updates
server/api/views.py - Run API → Pipeline runner: starts pipeline
server/api/views.py - Pipeline runner → Satellite ingest: runs stage 1
README.md - Pipeline runner → Image preprocessing: runs stage 2
src/pipeline/run_pipeline.py - Pipeline runner → Debris detection: runs stage 3
README.md - Pipeline runner → Polymer classification: runs stage 4
src/pipeline/run_pipeline.py - Pipeline runner → Particle backtracking: runs stage 5
README.md - Pipeline runner → Source attribution: runs stage 6
README.md - Pipeline runner → Run reporting: runs stage 7
src/pipeline/run_pipeline.py - Satellite ingest → Image preprocessing: passes imagery
README.md - Image preprocessing → Debris detection: passes image patches
README.md - Debris detection → Polymer classification: passes detections
README.md - Polymer classification → Particle backtracking: passes classified clusters
README.md - Particle backtracking → Source attribution: passes trajectories
README.md - Source attribution → Run reporting: passes attribution
README.md - Copernicus Sentinel-2 → Satellite ingest: provides imagery
README.md - CMEMS and ERA5 → Particle backtracking: provides currents and wind
README.md - Satellite ingest → Geospatial helpers: uses geospatial helpers
src/pipeline/01_ingest.py - Satellite ingest → Stage caching: uses cache helpers
src/pipeline/01_ingest.py - Source attribution → Geospatial helpers: uses geospatial helpers
src/pipeline/06_attribute.py - Source attribution → Stage caching: uses cache helpers
src/pipeline/06_attribute.py - Run reporting → Stage caching: uses cache helpers
src/pipeline/07_report.py - Geospatial helpers → Pipeline logging: gets logger
src/pipeline/utils/geo_utils.py - Stage caching → Pipeline logging: gets logger
src/pipeline/utils/cache_utils.py