How wrtide/wormstudio works
WormStudio is a local desktop application for tracking and measuring worms in video. The main workflow is to select a video, mark the analysis region and worm, process the video, then review annotated playback and export measurements. The graph also preserves documented batch and channel-count workflows, phenotype and quality analysis, and saved-run review. Several edges are supported by README workflow descriptions or SOURCE INDEX references; unsampled modules limit confidence about internal call order, so the graph avoids assuming a detailed pipeline.
Main entry points: analyze_phenotypes.py Phenotype Analysis · manual_worm_annotation.py Worm Annotation · review_result.js Result Review · studio.js Studio Interface
Components 22
Desktop Workspace
- Desktop Shell
tools/electron/main.cjs - Studio Interface
web/studio.js - Workspace Sessions
src/workspace_sessions.py
Annotation & Inputs
- Worm Annotation
src/manual_worm_annotation.py - Measurement Units
src/measurement_units.py - Channel Counts
src/channel_counts.py
Tracking & Analysis
- Pipeline Entry
worm_pipeline.py - Phenotype Analysis
src/analyze_phenotypes.py - Body Sequence Solver
src/body_sequence_solver.py - Centerline Methods
src/centerline_methods.py - Quality Schema
src/quality_schema.py - Quality Stage
src/quality_stage.py - Live Preview
src/live_preview.py - Pipeline Progress
src/pipeline_progress.py
Results & Review
- Result Metrics
src/result_metrics.py - Result Overlay
src/result_overlay.py - Result Review
web/review_result.js - Run Storage
src/run_storage.py
Additional Analysis
- Phenotype Statistics
src/phenotype_statistics.py - Evaluation Dataset
src/evaluation_dataset.py - Channel Tracker
src/wormtracker/engine/mog2.py
Other components
- Researcher
Connections 26
- Researcher → Desktop Shell: launches
README.md - Desktop Shell → Studio Interface: opens workspace
tools/electron/main.cjs - Researcher → Studio Interface: selects video
README.md - Studio Interface → Worm Annotation: starts annotation
README.md - Worm Annotation → Measurement Units: configures units
src/manual_worm_annotation.py - Worm Annotation → Channel Counts: offers counting
src/manual_worm_annotation.py - Worm Annotation → Pipeline Entry: submits configuration
README.md - Pipeline Entry → Phenotype Analysis: runs analysis
worm_pipeline.py - Phenotype Analysis → Body Sequence Solver: solves body sequence
src/analyze_phenotypes.py - Phenotype Analysis → Centerline Methods: selects method
src/analyze_phenotypes.py - Phenotype Analysis → Quality Schema: uses quality rules
src/analyze_phenotypes.py - Phenotype Analysis → Quality Stage: runs quality stage
src/analyze_phenotypes.py - Phenotype Analysis → Live Preview: writes previews
src/analyze_phenotypes.py - Pipeline Entry → Pipeline Progress: reports progress
src/pipeline_progress.py - Phenotype Analysis → Result Metrics: uses metrics
src/analyze_phenotypes.py - Phenotype Analysis → Result Overlay: creates overlays
src/analyze_phenotypes.py - Phenotype Analysis → Phenotype Statistics: computes statistics
src/analyze_phenotypes.py - Phenotype Analysis → Run Storage: stores run data
src/analyze_phenotypes.py - Studio Interface → Workspace Sessions: loads saved runs
- Workspace Sessions → Run Storage: preserves snapshots
src/workspace_sessions.py - Researcher → Result Review: reviews results
README.md - Result Review → Result Metrics: shows measurements
README.md - Result Review → Result Overlay: plays annotations
README.md - Result Review → Workspace Sessions: opens history
src/workspace_sessions.py - Channel Counts → Channel Tracker: counts crossings
- Researcher → Evaluation Dataset: evaluates annotations