# reference.yaml — 기종 컬럼 프리셋, 예측식 계수 참고, 정상 참고치.
# 본 도구는 연구용·참고용이며 임상 의사결정에 직접 사용 금지.

# 다기종 export 컬럼 매핑 프리셋.
# canonical 키: time, vo2, vco2, (선택) ree_device, rq_device
# units: vo2/vco2 단위 힌트 ('mL/min' 또는 'L/min'); auto 면 자동 추정.
device_presets:
  COSMED:
    columns:
      time: ["t", "Time", "time"]
      vo2: ["VO2", "VO2 STPD", "V'O2"]
      vco2: ["VCO2", "VCO2 STPD", "V'CO2"]
      rq_device: ["RQ", "R"]
      ree_device: ["EE", "EEm", "REE"]
    vo2_unit_hint: "mL/min"
  Vyntus:
    columns:
      time: ["Time", "t"]
      vo2: ["VO2", "V'O2"]
      vco2: ["VCO2", "V'CO2"]
      rq_device: ["RER", "RQ"]
      ree_device: ["EE"]
    vo2_unit_hint: "mL/min"
  Quark:
    columns:
      time: ["Time", "t"]
      vo2: ["VO2", "VO2(STPD)"]
      vco2: ["VCO2", "VCO2(STPD)"]
      rq_device: ["RQ", "R"]
      ree_device: ["EE", "REE"]
    vo2_unit_hint: "mL/min"
  Vmax:
    columns:
      time: ["TIME", "Time"]
      vo2: ["VO2", "VO2 (STPD)"]
      vco2: ["VCO2", "VCO2 (STPD)"]
      rq_device: ["RER", "RQ"]
      ree_device: ["EE", "REE"]
    vo2_unit_hint: "mL/min"

# 정상 참고치 (QC·해석용 가이드, 절대 기준 아님)
reference_ranges:
  rq_physiologic_min: 0.67   # 순수 지방 산화
  rq_physiologic_max: 1.00   # 순수 탄수화물 산화
  rq_fasting_typical: [0.78, 0.85]
  ree_per_kg_typical_kcal: [20, 25]   # 성인 대략적 kcal/kg/day
  metabolic_adaptation_ratio_threshold: 0.90  # 측정/예측 < 0.90 시 적응 의심

# 예측식 출처 메모 (식 자체는 predictive.py 에 구현)
predictive_equations:
  Mifflin-St Jeor: "Mifflin MD et al. Am J Clin Nutr 1990;51:241-7"
  Harris-Benedict: "Harris JA, Benedict FG. Carnegie Inst 1919"
  Henry/Schofield: "Henry CJK. Public Health Nutr 2005;8:1133-52 (Oxford eqs)"
  Cunningham: "Cunningham JJ. Am J Clin Nutr 1980;33:2372-4 (FFM-based)"

# 핵심 식 상수 (calorimetry.py 와 일치, 문서화 목적)
constants:
  weir_vo2_coeff: 3.941     # L/min
  weir_vco2_coeff: 1.106    # L/min
  weir_un_coeff: 2.17       # g/day
  minutes_per_day: 1440
  frayn_cho_vco2: 4.55
  frayn_cho_vo2: 3.21
  frayn_cho_n: 2.87
  frayn_fat_diff: 1.67
  frayn_fat_n: 1.92
  kcal_per_g_cho: 4.0
  kcal_per_g_fat: 9.0
  kcal_per_g_pro: 4.0
