Documentation · Tab 6 of 6

Processing

Turns raw sensor bursts into things you can actually look at: per-frame PNGs and timing-accurate video.

How it works

Batch-converts one or more experiment folders' .npy bursts into PNG image sequences and/or video (MP4 + VFR MKV). Add folders manually, or let the Experiment tab's Auto-process feature queue and start a folder automatically the moment a run finishes. Per-well and overall progress bars, plus a scrolling log, track a batch as it runs.

What comes out

For each well: a PNG per frame, filenamed with frame index, timestamp, and laser state (e.g. A1_00152_005003ms_laser-on.png) for direct use in downstream tracking pipelines; a VFR MKV with per-frame PTS accurate to about 1 ms (archival); and a constant-fps MP4 with a laser-ON asterisk overlay (smooth, Pi-hardware-decodable playback).

Same thing, headless

The CLI equivalent is scripts/reconstruct_vfr.py, useful for scripting or running on a machine without the GUI open:

# All wells in an experiment directory
python scripts/reconstruct_vfr.py outputs/20260625_133324_my_experiment/

# Images only
python scripts/reconstruct_vfr.py outputs/exp/ --no-video

# Video only
python scripts/reconstruct_vfr.py outputs/exp/ --no-images

# Lossless video
python scripts/reconstruct_vfr.py outputs/exp/ --codec ffv1
← PreviousManual Control ↻ Back toWorkflow guide