How s-t-a-rnalin1/tidetrail works
TideTrail is an offline oil-spill detection and vessel-attribution console. An analyst selects or uploads a radar scene and runs a job; the pipeline detects and characterises slicks, estimates origin and forecast drift, joins AIS traffic, and ranks vessels. Forward source tests compare candidate releases with the observed slick, while the console presents the case and its evidence. The graph includes documented EO corroboration and upload/probe capabilities. Several implementation links rely on the SOURCE INDEX or README because the relevant source excerpts are incomplete.
Main entry points: app/pipeline.py Analysis pipeline · api HTTP API · api/pipeline.py Run endpoints · store.py Job records
Components 27
Console and jobs
- Case console
app/static/app.js - HTTP API
app/api - Run endpoints
app/api/pipeline.py - Job records
app/jobs/store.py - Analysis pipeline
app/pipeline.py - Case reporting
app/api/report.py - Map overlays
app/viz/tiles.py
Scene and detection
- Scene catalog
app/scenes.py - User data
app/userdata.py - SAR detection
app/ml/infer.py - Look-alike detection
app/ml/fallback.py - EO corroboration
app/eo/corroborate.py
Drift and sources
- Metocean fields
app/drift/fields.py - Drift integration
app/drift/advection.py - Forecast cone
app/drift/cone.py - Coast checks
app/drift/land.py - Forward source tests
app/drift/source.py
AIS attribution
- AIS ingestion
app/ais/ingest.py - Traffic filtering
app/ais/filter.py - Track interpolation
app/ais/interpolate.py - Vessel ranking
app/ais/score.py - Dark-vessel analysis
app/ais/dark.py
Shared foundations
- Slick geometry
app/geo/geometry.py - Raster georeferencing
app/geo/raster.py - Coordinate transforms
app/geo/crs.py - Runtime configuration
app/config.py
Other components
- Analyst
Connections 30
- Analyst → Case console: uses
README.md - Case console → HTTP API: requests
- HTTP API → Run endpoints: routes runs
app/main.py - Run endpoints → Analysis pipeline: runs analysis
app/api/pipeline.py - Run endpoints → Job records: reads progress
app/api/pipeline.py - Run endpoints → Job records: lists jobs
app/api/pipeline.py - HTTP API → User data: handles uploads
app/api/data.py - HTTP API → Scene catalog: starts scene runs
app/api/detect.py - Analysis pipeline → SAR detection: detects slicks
app/pipeline.py - SAR detection → Look-alike detection: uses fallback
app/ml/infer.py - Analysis pipeline → Slick geometry: characterises slicks
app/pipeline.py - Analysis pipeline → EO corroboration: corroborates optically
app/pipeline.py - Analysis pipeline → Metocean fields: loads fields
app/pipeline.py - Analysis pipeline → Drift integration: integrates drift
app/pipeline.py - Analysis pipeline → Forecast cone: forecasts flow
app/pipeline.py - Analysis pipeline → Coast checks: checks coast
app/pipeline.py - Analysis pipeline → Forward source tests: tests sources
app/pipeline.py - Analysis pipeline → AIS ingestion: queries AIS
app/pipeline.py - Analysis pipeline → Traffic filtering: filters traffic
app/pipeline.py - Analysis pipeline → Track interpolation: reconstructs tracks
app/pipeline.py - Analysis pipeline → Vessel ranking: ranks vessels
app/pipeline.py - Analysis pipeline → Dark-vessel analysis: checks dark vessels
app/pipeline.py - Analysis pipeline → Job records: persists results
app/pipeline.py - Analysis pipeline → Map overlays: renders overlays
app/pipeline.py - Case reporting → Job records: reads case records
app/api/report.py - Raster georeferencing → Coordinate transforms: uses transforms
app/geo/raster.py - Slick geometry → Coordinate transforms: uses projection
app/geo/geometry.py - Analysis pipeline → Scene catalog: loads scene
app/pipeline.py - Analysis pipeline → Raster georeferencing: loads raster
app/pipeline.py - Analysis pipeline → Runtime configuration: uses settings
app/pipeline.py