How whoigit/stingraytools works
StingrayTools processes Stingray cruise sensor data and camera metadata into dashboard-ready CSVs. The main workflow is sensor-file ingestion and calibration, time-binned cruise merging, frame-timestamp generation, and attaching media metadata; the companion image-analysis repository performs abundance updates to that same CSV. CTD reference downloads and other image utilities are additional capabilities. The graph follows README workflow statements and SOURCE INDEX references; unsampled subsystem internals and external service wiring are not expanded.
Main entry points: merge.py Cruise sensor merge · add_media.py Attach media metadata · main.py Image commands · download.py CTD download command
Components 30
Commands
- Command interface
packages/stingraytools/src/stingray/cli/main.py - Sensor commands
packages/stingraytools/src/stingray/cli/sensors.py - Image commands
packages/stingraytools/src/stingray/cli/main.py - CTD download command
packages/stingraytools/src/stingray/ctd/download.py
Sensor processing
- Cruise sensor merge
packages/stingraytools/src/stingray/sensors/merge.py - CTD processing
packages/stingraytools/src/stingray/sensors/ctd.py - Fluorometer processing
packages/stingraytools/src/stingray/sensors/fluorometer.py - PAR processing
packages/stingraytools/src/stingray/sensors/par.py - SUNA processing
packages/stingraytools/src/stingray/sensors/suna.py - SUNA calibration I/O
packages/stingraytools/src/stingray/io/suna.py
Camera and images
- Frame timestamp builder
packages/stingraytools/src/stingray/images/build_frame_timestamps.py - Attach media metadata
packages/stingraytools/src/stingray/images/add_media.py - Image abundance
packages/stingraytools/src/stingray/images/abundance.py - Image utilities
packages/stingraytools/src/stingray/images
Shared processing
- CSV handling
packages/stingraytools/src/stingray/io/csv.py - File indexing
packages/stingraytools/src/stingray/io/indexing.py - Dataset columns
packages/stingraytools/src/stingray/config/columns.py - Time conversion
packages/stingraytools/src/stingray/utils/temporal.py - Time and position grids
packages/stingraytools/src/stingray/utils/gridding.py - Spatial utilities
packages/stingraytools/src/stingray/utils/spatial.py - Profile identification
packages/stingraytools/src/stingray/profiles/identify.py
Other components
- Operator
- Raw cruise sensors
- Cruise dashboard CSV
- Camera media files
- Frame-list CSVs
- Media-enriched cruise CSV
- Companion analysis workflow
- CTD reference source
- CTD reference data
Connections 31
- Operator → Command interface: runs
README.md - Command interface → Sensor commands: dispatches
packages/stingraytools/src/stingray/cli/main.py - Sensor commands → Cruise sensor merge: invokes
packages/stingraytools/src/stingray/cli/sensors.py - Raw cruise sensors → Cruise sensor merge: supplies files
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → CTD processing: uses
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → Fluorometer processing: uses
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → PAR processing: uses
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → SUNA processing: uses
packages/stingraytools/src/stingray/sensors/merge.py - SUNA processing → SUNA calibration I/O: loads calibration
packages/stingraytools/src/stingray/sensors/suna.py - Cruise sensor merge → File indexing: indexes files
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → CSV handling: writes CSV
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → Dataset columns: uses schema
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → Time conversion: converts times
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → Time and position grids: bins observations
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → Spatial utilities: uses coordinates
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → Profile identification: identifies profiles
packages/stingraytools/src/stingray/sensors/merge.py - Cruise sensor merge → Cruise dashboard CSV: creates
README.md - Operator → Image commands: runs
README.md - Image commands → Frame timestamp builder: invokes
README.md - Camera media files → Frame timestamp builder: provides media
README.md - Frame timestamp builder → Frame-list CSVs: creates
README.md - Image commands → Attach media metadata: invokes
README.md - Cruise dashboard CSV → Attach media metadata: provides cruise data
README.md - Frame-list CSVs → Attach media metadata: provides timestamps
README.md - Attach media metadata → Media-enriched cruise CSV: updates CSV
README.md - Media-enriched cruise CSV → Companion analysis workflow: feeds abundance
README.md - Companion analysis workflow → Image abundance: runs step
README.md - Image abundance → Cruise dashboard CSV: updates same CSV
README.md - Operator → CTD download command: runs
README.md - CTD download command → CTD reference source: downloads from
- CTD download command → CTD reference data: stores reference
README.md