"""Step 8-14 候補 α 前半: max_depth スイープ.
R=0.85 のまま max_depth ∈ {8, 12, 16, 20, 28} を 5 値スイープして
多重反射の取りこぼし量と「形」「数値」の収束を観察する.
理論累積(R/(1-R) を 100% とした場合):
depth= 8 → 72.7% (現状ベースライン)
depth=12 → 85.8%
depth=16 → 92.6%
depth=20 → 96.1%
depth=28 → 98.7%
実行方法:
uv run python scripts/sweep_max_depth.py
前提条件:
- configs/scene_baseline.yaml が存在すること
- configs/eval_baseline_dng_target.yaml が存在すること
- sm-render / sm-evaluate が PATH に通っていること
出力:
- output/max_depth_sweep/d{N}/luminance.npy (各ジョブのレンダリング結果)
- output/max_depth_sweep/d{N}/metrics.csv (各ジョブの評価指標)
- output/max_depth_sweep/summary.csv (全 5 ジョブの集約結果)
- configs/_tmp_depth/scene_d{N}.yaml (一時 YAML,実行後も残す)
TECH_10 参照: 残差主因候補 §A9「max_depth 8 → 16+」
"""
from __future__ import annotations
import csv
import subprocess
import sys
import time
from pathlib import Path
import yaml
# ---------------------------------------------------------------------------
# 定数
# ---------------------------------------------------------------------------
ROOT = Path(__file__).resolve().parents[1]
TEMPLATE_YAML = ROOT / "configs" / "scene_baseline.yaml"
EVAL_CONFIG_YAML = ROOT / "configs" / "eval_baseline_dng_target.yaml"
TMP_DIR = ROOT / "configs" / "_tmp_depth"
OUTPUT_BASE = ROOT / "output" / "max_depth_sweep"
# スイープ値(R=0.85 で最終 bounce の寄与が 0.27 → 0.01 まで)
DEPTHS = [8, 12, 16, 20, 28]
SUMMARY_EXTRA_COLS = [
"cov", "std", "max_min_ratio", "mean", "max", "min",
"center_periphery_ratio", "gradient_magnitude",
"radial_min_max_ratio", "radial_min_distance", "radial_min", "radial_max",
]
def _generate_tmp_yaml(depth: int) -> Path:
"""指定 max_depth の一時 YAML を生成する."""
TMP_DIR.mkdir(parents=True, exist_ok=True)
with TEMPLATE_YAML.open(encoding="utf-8") as f:
data = yaml.safe_load(f)
# geometry.meshes の STL 相対パスを絶対化
template_base = TEMPLATE_YAML.parent
for item in data.get("geometry", {}).get("meshes", []):
rel_path = item.get("path")
if rel_path and not Path(rel_path).is_absolute():
item["path"] = str((template_base / rel_path).resolve())
# render.max_depth を書き換え
data["render"]["max_depth"] = depth
data["name"] = f"baseline_minitias_depth_{depth}"
tmp_path = TMP_DIR / f"scene_d{depth}.yaml"
with tmp_path.open("w", encoding="utf-8") as f:
yaml.dump(data, f, allow_unicode=True, default_flow_style=False, sort_keys=False)
return tmp_path
def _run(cmd: list[str], label: str) -> int:
"""外部コマンドを実行."""
print(f" [run] {' '.join(cmd)}")
result = subprocess.run(cmd, check=False) # noqa: S603
if result.returncode != 0:
print(f" [ERROR] {label} failed (returncode={result.returncode})", file=sys.stderr)
return result.returncode
def _read_metrics(csv_path: Path) -> dict:
"""metrics.csv の 1 行目を読む."""
with csv_path.open(encoding="utf-8", newline="") as f:
rows = list(csv.DictReader(f))
if not rows:
msg = f"metrics.csv が空: {csv_path}"
raise ValueError(msg)
return rows[0]
def main() -> int:
if not TEMPLATE_YAML.exists():
print(f"エラー: テンプレート YAML が見つかりません: {TEMPLATE_YAML}", file=sys.stderr)
return 1
if not EVAL_CONFIG_YAML.exists():
print(f"エラー: 評価 config YAML が見つかりません: {EVAL_CONFIG_YAML}", file=sys.stderr)
return 1
OUTPUT_BASE.mkdir(parents=True, exist_ok=True)
print(f"=== max_depth sweep: {len(DEPTHS)} jobs ===")
print(f" depths: {DEPTHS}")
print(f" output: {OUTPUT_BASE}")
print()
failed: list[str] = []
rows: list[dict] = []
total_start = time.time()
for i, d in enumerate(DEPTHS, start=1):
job_name = f"d{d}"
output_dir = OUTPUT_BASE / job_name
metrics_csv = output_dir / "metrics.csv"
print(f"--- Job {i}/{len(DEPTHS)}: {job_name} ---")
job_start = time.time()
tmp_yaml = _generate_tmp_yaml(d)
print(f" tmp YAML: {tmp_yaml}")
if _run(["sm-render", "--scene", str(tmp_yaml), "--output", str(output_dir)],
f"sm-render ({job_name})") != 0:
failed.append(f"{job_name} [render]")
print(" -> スキップ: render 失敗\n")
continue
npy = output_dir / "luminance.npy"
if _run(["sm-evaluate", "--image", str(npy), "--config", str(EVAL_CONFIG_YAML),
"--output", str(output_dir)], f"sm-evaluate ({job_name})") != 0:
failed.append(f"{job_name} [evaluate]")
print(" -> スキップ: evaluate 失敗\n")
continue
try:
m = _read_metrics(metrics_csv)
except (FileNotFoundError, ValueError) as exc:
print(f" [ERROR] metrics.csv 読み込み失敗: {exc}", file=sys.stderr)
failed.append(f"{job_name} [metrics_read]")
print()
continue
elapsed = time.time() - job_start
cov = m.get("cov", "N/A")
grad = m.get("gradient_magnitude", "N/A")
print(f" -> 完了 ({elapsed:.1f}s) CoV={cov}, grad={grad}%")
row: dict = {"job": job_name, "max_depth": d, "elapsed_s": f"{elapsed:.1f}"}
for col in SUMMARY_EXTRA_COLS:
row[col] = m.get(col, "")
rows.append(row)
print()
summary_csv = OUTPUT_BASE / "summary.csv"
if rows:
fieldnames = ["job", "max_depth", "elapsed_s", *SUMMARY_EXTRA_COLS]
with summary_csv.open("w", encoding="utf-8", newline="") as f:
writer = csv.DictWriter(f, fieldnames=fieldnames, extrasaction="ignore")
writer.writeheader()
writer.writerows(rows)
print(f"集約 CSV 保存: {summary_csv}")
total_elapsed = time.time() - total_start
print(f"\n=== 完了: {len(rows)}/{len(DEPTHS)} 成功, 総時間 {total_elapsed:.1f}s ===")
if failed:
print("失敗ジョブ:", failed, file=sys.stderr)
return 1
return 0
if __name__ == "__main__":
sys.exit(main())