Disable matplotlib autoscale after imshow so polygon plot() calls
(rubber-band line, vertices) can't expand the view limits. Also reset
xlim/ylim explicitly in load_clip for clips with different resolutions.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
7 annotators, 5 days each, 11 of 24 days double-covered for inter-annotator agreement.
Removed annotator_summary.txt in favour of the README table.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- questions: extracted from config.yaml into config/questions.yaml (committed, like optical_flow_config.yaml)
- optical_flow_config_file and questions_config_file are now required fields
- data_dir and out_dir are now required (no defaults)
- filenames: trimmed to input-only in example; output filenames stay as code defaults
- annotator: remove optional guard around optical flow config loading
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add Quick start section, surface uv run throughout, fix repo URL
placeholder, and rename 'How it works' to 'Internals'.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- New filesystem.py: make_fs() factory (returns s3fs.S3FileSystem or None),
plus fsjoin/fsstem/fsname path helpers
- config.py: storage field is now required ('local' or 's3'); load_config
raises a clear ValueError when it is missing
- video_loader, clip_selector, annotator: thread fs through all file I/O;
local paths unchanged, S3 paths use fs.open/fs.exists/fs.pipe
- annotation_script: load .env via python-dotenv at startup, create fs from
config and pass to Annotator
- Add .env.example with SwitchEngines endpoint and AWS checksum env vars
- pyproject.toml: add s3fs and python-dotenv dependencies
- Reduce default mask alpha from 40% to 15%
- Update example clip names to colon-separated timestamps
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Annotators can now press Auto Segment to replace the current mask with
an automatic river segmentation based on dense optical flow magnitude
and frame brightness. The result is pushed onto the undo stack, so it
can be refined or reverted like any other mask operation.
Parameters (norm_squared_threshold, gaussian_kernel, brightness_range)
live in a separate config/optical_flow_config.yaml; the button is only
enabled when optical_flow_config_file is set in config.yaml.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Introduce two new drawing modes alongside the existing brush:
- Polygon mode: left-click to place vertices connected by lines; right-click
removes the last vertex; clicking near the first vertex (red dot) when >= 3
points are placed closes the shape (bold cyan outline). Multiple shapes can
coexist as canvas overlays. Cancel Current Poly discards the in-progress
polygon; Del Shape removes the last completed shape.
- Fill mode: left-click inside any closed polygon to rasterise it onto the
mask. Selects the innermost shape containing the click (smallest area via
cv2.contourArea). Polygons whose centroid lies inside the target are punched
out as holes. Each fill is a single undoable step in the mask history.
Also renames the Alpha slider label to Mask Alpha and removes the stale
Reload Saved reference from the README.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Three vertical sliders (Brightness, Contrast, Gamma) to the left of the
canvas for display-only image adjustment; all use power/linear formulae
applied on-the-fly without touching saved data
- Alpha slider controls mask overlay transparency
- Brush size slider moved to its own row
- Each slider has a reset (↺) button restoring its default value
- Hide Mask button turns red when active; Eraser button turns orange
- Load Prev Mask button copies the saved mask from the previous clip in
the list onto the current clip; the action is pushed onto the undo stack
so it can be reverted with Undo
- Right survey panel narrowed (stretch factor 2 → 1)
- README Controls section updated to document all new features
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
mask_canvas.py:
- Redo stack: new strokes clear it, undo pushes onto it, redo pops from it.
- undo10(): undoes up to 10 steps in one call with a single redraw.
- Brush circle preview: white Circle patch tracks mouse position and shows
current brush radius; hidden when cursor leaves the axes.
- toggle_mask() / btn_mask: hides or shows the green mask overlay without
affecting the underlying mask data.
annotator.py:
- Removed Reload Saved button and reload_saved() — clip already loads its
saved state on navigation, making the button redundant.
- Added Undo×10 and Redo buttons wired to mc.undo10 / mc.redo.
- Added Hide Mask button (mc.btn_mask) to the toolbar row.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Previous: saves current clip and navigates back through session history;
disabled on the first clip, re-enabled automatically as you advance.
- Next: shows a dialog when a saved annotation already exists, letting the
annotator choose to replace it or keep the existing save before advancing.
- Removed the standalone Save button; Next auto-saves on every advance.
- Skip already wrote nothing to disk; clarified in README.
- Refactored _advance_clip into _switch_ui_to_clip (shared with prev/next).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Show a modal dialog when all clips have been processed and quit cleanly.
Add --no-skip CLI flag to include already-annotated clips (default remains to skip them).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove .claude/, .github/workflows/, data/, and notebooks/ from git
tracking so they no longer appear in the remote repository.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- config.py constants -> config/config.yaml (user-editable, git-ignored)
- Questions and defaults now defined in the YAML, including per-question defaults
- ClipSelector no longer scans the data dir; reads a user-provided clips.txt instead
- Removed --daily / --time / --skip-existing-day args
- video_loader now samples frames evenly across the full clip
- pyyaml added as a dependency
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
