lab/cupido
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
cupido/scripts/barrier_picker_app
History
Giorgio Gilestro 4ed988a617 Show experimental metadata above the video in the picker 
Each video row now carries a `metadata` dict aggregated from the
merged TSV: species, memory (STM/LTM), training_length_hr,
consolidation_length_hr, age, training/testing date-time, and
trained/naive fly counts. The UI renders these as a row of key:value
pills above the video, with the session role (training/testing)
colour-coded so the analyst can see at a glance what they're picking.

The merged TSV currently has duplicate rows per (date, machine, ROI);
the aggregator de-dups on those keys so counts aren't doubled. (The
duplication itself should be cleaned up upstream.)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-01 12:54:40 +01:00
..
static Show experimental metadata above the video in the picker 2026-05-01 12:54:40 +01:00
app.py Show experimental metadata above the video in the picker 2026-05-01 12:54:40 +01:00
docker-compose.yml Add barrier_picker_app — Dockerised web picker for barrier opening 2026-05-01 12:33:28 +01:00
Dockerfile Add barrier_picker_app — Dockerised web picker for barrier opening 2026-05-01 12:33:28 +01:00
README.md Add barrier_picker_app — Dockerised web picker for barrier opening 2026-05-01 12:33:28 +01:00
requirements.txt Add barrier_picker_app — Dockerised web picker for barrier opening 2026-05-01 12:33:28 +01:00

README.md

Cupido — web-based barrier-opening picker

A small FastAPI + HTML5-video app for annotating the barrier-opening moment in each tracked recording. Lives in its own Docker container so it can run on the lab server without polluting any existing environment.

What it does

For every video referenced by all_video_info_merged.tsv that has a tracking DB on disk and isn't yet in barrier_opening.csv, it serves a <video> element pre-loaded with that mp4. The analyst plays / scrubs / pauses at the moment the barrier opens, then clicks one of:

button meaning written to bad_rois
All barriers open every ROI (1..6) is usable post-opening empty
Upper barriers open only the top row opens (ROIs 1, 3, 5) 2,4,6
Lower barriers open only the bottom row opens (ROIs 2, 4, 6) 1,3,5

Plus a Skip (advance without saving) and Unusable (write opening_s = NaN).

Keyboard shortcuts

  • Space — play / pause
  • ← / → — ±5 s
  • Shift+arrows — ±1 s
  • Ctrl+arrows — ±0.1 s
  • , / . — ±1 frame
  • 1 / 2 / 3 — All / Upper / Lower
  • s — skip ; u — unusable

Run locally (docker compose)

cd scripts/barrier_picker_app
docker compose up --build

Then browse to http://localhost:8000/.

The container mounts:

  • /mnt/data/projects/cupido (data volume, read-only)
  • /mnt/ethoscope_data/videos (source mp4s, read-only)
  • data/metadata/ from the repo (read-write — for persisting barrier_opening.csv)

Adjust paths in docker-compose.yml if your layout differs.

Run without Docker (development)

cd scripts/barrier_picker_app
pip install -r requirements.txt
python app.py     # serves on http://localhost:8000

By default it expects:

  • merged TSV at /mnt/data/projects/cupido/all_video_info_merged.tsv
  • inventory at /cupido/data/metadata/video_inventory.csv
  • writes to /cupido/data/metadata/barrier_opening.csv

Override via environment variables:

CUPIDO_DATA_VOLUME=/path/to/data \
CUPIDO_INVENTORY_CSV=$(pwd)/../../data/metadata/video_inventory.csv \
CUPIDO_OUTPUT_CSV=$(pwd)/../../data/metadata/barrier_opening.csv \
python app.py