Add batch wrapper for ZED grid MP4 conversion

2026-03-19 10:41:45 +00:00
parent 58ee647c8a
commit c2e5cc561f
2 changed files with 625 additions and 0 deletions
@@ -113,6 +113,49 @@ Use the grid converter to merge four synced ZED recordings into a 2x2 CCTV-style

 The tool syncs the four inputs using the same common-start timestamp rule as the ZED multi-camera playback sample, defaults to a 2x2 layout ordered as `zed1 zed2 / zed3 zed4`, and writes `<segment>/<segment>_grid.mp4` unless `--output` is provided. By default each tile is scaled to `0.5x`, so a four-camera 1920x1200 segment produces a 1920x1200 composite. Use repeated `--input` flags instead of `--segment-dir` when you want explicit row-major ordering.

+Use the batch wrapper to run `zed_svo_grid_to_mp4` over many segment directories with one aggregate progress bar:
+
+```bash
+uv run python scripts/zed_batch_svo_grid_to_mp4.py \
+    /workspaces/data/kindergarten \
+    --recursive \
+    --jobs 2 \
+    --encoder-device auto \
+    --duration-seconds 2
+```
+
+You can also provide the exact segments to convert:
+
+```bash
+uv run python scripts/zed_batch_svo_grid_to_mp4.py \
+    --segment-dir /workspaces/data/kindergarten/jump/external/recording/2026-03-18T11-23-22 \
+    --segment-dir /workspaces/data/kindergarten/jump/experiment/1/2026-03-18T11-26-23 \
+    --jobs 2
+```
+
+Or preserve a precomputed CSV ordering:
+
+```bash
+uv run python scripts/zed_batch_svo_grid_to_mp4.py \
+    --segments-csv /workspaces/data/kindergarten/svo2_segments_sorted.csv \
+    --jobs 2 \
+    --duration-seconds 2
+```
+
+The batch grid wrapper mirrors the grid encoder options, skips existing `<segment>/<segment>_grid.mp4` outputs by default, and returns a nonzero exit code if any segment fails.
+
+#### Expected CSV Input Format
+
+The `--segments-csv` input expects a header row with at least a `segment_dir` column. Extra columns are allowed and ignored by the batch wrapper. `segment_dir` values may be absolute paths or paths relative to the CSV file's parent directory. Use `--csv-root` to override that base directory.
+
+Repeated rows for the same `segment_dir` are allowed; the wrapper converts each unique segment once, preserving the first-seen CSV order. This makes `/workspaces/data/kindergarten/svo2_segments_sorted.csv` a valid input even though it stores one row per camera file:
+
+```csv
+timestamp,activity,group_path,segment_dir,camera,relative_path
+2026-03-18T11-23-22,jump,jump/external/recording,jump/external/recording/2026-03-18T11-23-22,zed1,jump/external/recording/2026-03-18T11-23-22/2026-03-18T11-23-22_zed1.svo2
+2026-03-18T11-23-22,jump,jump/external/recording,jump/external/recording/2026-03-18T11-23-22,zed2,jump/external/recording/2026-03-18T11-23-22/2026-03-18T11-23-22_zed2.svo2
+```
+
 ### Mandatory Acceptance (Standalone)

 Run the full mandatory acceptance suite. This executes the complete protocol/codec matrix without requiring external servers.