シーン定義仕様 (Scene Definition Schema)

name: <string>            # 必須．設計識別名（出力ディレクトリ名に使う）
description: <string>     # 任意．自由記述

geometry: { ... }         # 必須．メッシュ一覧
materials: { ... }        # 必須．名前付き BSDF 辞書
lights: [ ... ]           # 必須．光源リスト（1 個以上）
sensor: { ... }           # 必須．カメラ 1 個（複数センサは未対応）
render: { ... }           # 必須．レンダリングパラメータ
evaluation: { ... }       # 任意．評価設定（省略時は CLI で別 YAML 指定）

geometry:
  meshes:
    - id: housing                     # シーン内ユニーク ID
      path: configs/meshes/housing.stl
      unit: mm                        # mm | m
      material: housing_inner         # materials の key を参照
    - id: diffuser
      path: configs/meshes/diffuser.stl
      unit: mm
      material: diffuser_pmma
    - id: whiteboard
      path: configs/meshes/whiteboard.stl
      unit: mm
      material: white_lambert

materials:
  housing_inner:
    type: diffuse
    reflectance: [0.05, 0.05, 0.05]   # マットな筐体内壁

  white_lambert:
    type: diffuse
    reflectance: 0.95                 # スカラ可．RGB 同値の近似白

  diffuser_pmma:
    type: thindielectric              # 薄膜誘電体（半透明散乱の簡易モデル）
    int_ior: 1.49                     # PMMA 屈折率
    ext_ior: 1.0

materials:
  printer_white_with_specular:
    type: blendbsdf
    weight: 0.15                       # specular 成分の比率 (0=純 diffuse, 1=純 specular)
    components:
      - type: diffuse
        reflectance: [0.85, 0.85, 0.85]
      - type: roughconductor
        alpha: 0.3                     # GGX 粗さ (0=完全鏡面, 1=拡散的鏡面)
        distribution: ggx

lights:
  - id: led_top
    type: point                      # point | area | directional | spot
    position: [0, 30, 10]            # mm 単位
    intensity: [1.0, 1.0, 1.0]       # RGB．スカラも可
    profile: lambertian              # lambertian | isotropic

  - id: led_ring_segment
    type: area
    shape: rectangle
    center: [0, 0, 20]
    size: [10, 10]                   # mm
    direction: [0, 0, -1]
    radiance: [50, 50, 50]

  - id: led_spot                     # 指向性 LED（データシート配光角に合わせる）
    type: spot
    position: [0, 30, 10]            # mm
    direction: [0, 0, -1]            # 光軸方向ベクトル
    cutoff_angle: 40                 # 光が完全に 0 になる角度 [deg]（0 < cutoff ≤ 90）
    beam_width: 20                   # 中央フラット領域の半角 [deg]（0 ≤ beam_width ≤ cutoff_angle）
    intensity: [1.0, 1.0, 1.0]       # 軸上強度 I_0 [W/sr]．スカラも可

# パターン 1: perspective（通常カメラ）— fov_deg 必須
sensor:
  type: perspective
  position: [0, 0, 50]               # mm
  target: [0, 0, 0]
  up: [0, 1, 0]
  fov_deg: 60                        # x 方向 FOV [deg]
  film:
    width: 1920
    height: 1920
    rfilter: gaussian                # ピクセルフィルタ

# パターン 2: orthographic（平行投影）— ortho_scale 必須
sensor:
  type: orthographic
  position: [0, 0, -50]              # mm（撮影面に対する距離）
  target: [0, 0, 0]                  # 撮影面の中心
  up: [0, 1, 0]
  ortho_scale: [50, 52]              # 撮影範囲の半幅 (sx, sy) [mm]．画像 X 軸 ±sx, Y 軸 ±sy にマップ
  film:
    width: 512
    height: 512
    rfilter: gaussian

render:
  variant: llvm_ad_rgb               # 省略時は llvm_ad_rgb
  integrator: path                   # path | direct | volpath | ptracer
  max_depth: 8
  spp: 256                           # サンプル数

evaluation:
  roi:
    type: image_pixel                # image_pixel | scene_face
    x: 539
    y: 1015
    width: 1400
    height: 1409
  zones:
    enabled: true
    boundaries: [0.33, 0.66]         # 中心d<0.33 / 中間 / 周辺d≥0.66
  metrics:
    cov: true
    std: true
    max_min: true
    radial_profile: true
    radial_min_max: false            # 動径 min/max 比の 4 列を metrics.csv に追加（既定 false）
    shape_metrics: false             # 形状指標（輝度重心 / 角度-放射分解 / PCA 主軸）を追加（既定 false）
    shape_reference: null            # SSIM / NCC 算出用の参照画像パス（.npy / .png）．shape_metrics=true 時のみ有効
  oetf:                              # 任意．省略時 OETF 無効（linear のまま評価＝後方互換）
    enabled: true                    # シミュ linear 出力を実測と同じ sRGB 空間へ変換
    transfer: srgb                   # srgb のみ（IEC 61966-2-1）
    exposure:
      mode: anchor_mean              # OETF 後 ROI mean を target_mean に対数二分で合わせる（実測 AE アンカー）
      target_mean: 146.7146          # 実測 ROI mean（uint8 [0,255] スケール）
    quantize_uint8: true             # OETF 後を実測 PNG 同様 uint8 量子化
  normalization:                     # 任意．省略時 normalization 無効（後方互換）．OETF と排他
    enabled: true
    type: mean_anchor                # mean_anchor のみ（将来 max_anchor / range_anchor 等を拡張予定）
    target_mean: 146.7146            # ROI mean を target_mean に線形ゲインで揃える（uint8 スケール想定）