ops: sweep_n4_post.sh — single-command post-N4-sweep update

Author: NMGorovenko

scripts/sweep_n4_post.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+# Post-N=4-sweep automation: when configs/sweeps/maze-camera-only-n4.yaml
+# completes, this script:
+#
+#   1. Refuses to run while the sweep is still in flight.
+#   2. Re-runs sweep_finalize_camera.sh (analyze_sweep with N=4 data).
+#   3. Prints a side-by-side N=2 vs N=4 summary for the operator to
+#      copy-paste into the article narrative.
+#
+# Usage:  bash scripts/sweep_n4_post.sh
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+if pgrep -f "multi_seed_sweep.*camera-only-n4" > /dev/null 2>&1; then
+    echo "ERROR: N=4 sweep is still running. Wait for it to finish." >&2
+    exit 1
+fi
+if pgrep -f "multi_seed_sweep" > /dev/null 2>&1; then
+    echo "ERROR: A multi_seed_sweep process is running. Wait for it." >&2
+    exit 1
+fi
+
+echo "=== Step 1: Re-running analyze_sweep over camera-only evidence ==="
+bash scripts/sweep_finalize_camera.sh
+
+echo
+echo "=== Step 2: Side-by-side N=2 vs N=4 summary ==="
+cd python
+PYTHONPATH=. .venv/bin/python <<'EOF'
+import json
+from pathlib import Path
+import statistics
+
+evidence = Path("../docs/report/master-thesis/sprint-4-bc-variance-2026-06/sweeps-camera-only")
+
+def summarize(branch_dir, metric_key):
+    vals = []
+    for seed_dir in sorted(branch_dir.glob("seed-*")):
+        e = seed_dir / "eval_full.json"
+        if not e.exists():
+            continue
+        try:
+            data = json.loads(e.read_text())
+        except Exception:
+            continue
+        v = data.get(metric_key)
+        if v is None:
+            continue
+        vals.append(float(v))
+    return vals
+
+for branch_dir in sorted(evidence.iterdir()):
+    if not branch_dir.is_dir():
+        continue
+    rewards = summarize(branch_dir, "avgReward")
+    progresses = summarize(branch_dir, "avgProgress")
+    if not rewards:
+        continue
+    mean_r = statistics.fmean(rewards)
+    std_r = statistics.pstdev(rewards) if len(rewards) > 1 else 0.0
+    mean_p = statistics.fmean(progresses) if progresses else 0.0
+    std_p = statistics.pstdev(progresses) if len(progresses) > 1 else 0.0
+    cv = (std_r / mean_r * 100) if mean_r != 0 else 0.0
+    print(f"{branch_dir.name:18s}  N={len(rewards)}  reward {mean_r:7.2f} ± {std_r:6.2f}  (CV {cv:5.1f} %)  progress {mean_p:.3f} ± {std_p:.3f}")
+EOF
+cd ..
+
+echo
+echo "=== Step 3: Copy these tables into article §4.5 Tables 3, 3a ==="
+echo
+echo "Mean reward (replace existing Table 3 in article.md §4.5):"
+cat docs/report/master-thesis/sprint-4-bc-variance-2026-06/analysis-camera-only/variance-table-mean-reward.md
+echo
+echo "Mean progress (replace existing Table 3а in article.md §4.5):"
+cat docs/report/master-thesis/sprint-4-bc-variance-2026-06/analysis-camera-only/variance-table-avgProgress.md
+
+echo
+echo "=== Step 4: Commit + push ==="
+echo "After manually editing article §4.5 narrative numbers, run:"
+echo "  git add docs/report/master-thesis/articles/2026-occupancy-variance/article.md \\"
+echo "          docs/report/master-thesis/sprint-4-bc-variance-2026-06/CHAPTER_OCCUPANCY.md \\"
+echo "          docs/report/master-thesis/sprint-4-bc-variance-2026-06/analysis-camera-only/"
+echo "  git commit -m 'doc: N=4 variance numbers for camera-only experiment'"
+echo "  git push origin develop"