#!/usr/bin/env python3 # -*- coding: utf-8 -*- """BMI 与每日热量计算工具。 算法链路(顺序执行): 1. 数据校验:单位、生理/物理上界、是否落在模型适用范围 2. BMI = 体重(kg) / 身高(m)^2 3. 参考标准判定: - 0-5 岁 : WHO 2006 Child Growth Standards(身长/体重曲线) - 5-19 岁 : WHO 2007 BMI-for-age(Z 分数 / 百分位) - >=20 岁 : WHO 成人 BMI 分类 4. BMR:<18 岁用 Schofield(FAO/WHO);>=18 岁用 Mifflin-St Jeor 5. TDEE = BMR x PAL(PAL 按每日步数分档,并设代谢物理上界) 6. 目标热量 = TDEE +/- 250~350 kcal 7. 营养素反推:蛋白 g/kg、脂肪 25-30%、碳水为余量 8. 每 2-4 周按体重趋势校准 说明:内置参考曲线为公开资料近似值,正式临床使用请替换为 WHO 官方 LMS 表。 """ from __future__ import annotations import argparse from dataclasses import dataclass, field from statistics import NormalDist NORMAL = NormalDist() # ------------------------------------------------------------- 上界常量 AGE_MIN, AGE_MAX = 0.0, 122.0 # 人类最长寿纪录 HEIGHT_CM_MIN, HEIGHT_CM_MAX = 30.0, 250.0 WEIGHT_KG_MIN, WEIGHT_KG_MAX = 0.5, 500.0 STEPS_MIN, STEPS_MAX = 0.0, 200_000.0 # 24 小时步行纪录量级 TDEE_MAX = 12_000.0 # 超耐力赛事历史峰值量级 BMR_FLOOR = 400.0 # 成人静息代谢合理下限量级 # ------------------------------------- WHO 2007 BMI-for-age 近似中位数表 BMI_FOR_AGE = { "female": {5: 15.3, 6: 15.4, 7: 15.7, 8: 16.1, 9: 16.7, 10: 17.3, 11: 18.0, 12: 18.7, 13: 19.3, 14: 19.8, 15: 20.1, 16: 20.4, 17: 20.7, 18: 20.9, 19: 21.1}, "male": {5: 15.4, 6: 15.5, 7: 15.7, 8: 16.0, 9: 16.3, 10: 16.7, 11: 17.2, 12: 17.8, 13: 18.4, 14: 19.0, 15: 19.6, 16: 20.2, 17: 20.7, 18: 21.1, 19: 21.5}, } @dataclass class Check: errors: list = field(default_factory=list) warnings: list = field(default_factory=list) @property def ok(self) -> bool: return not self.errors @dataclass class Result: bmi: float classification: str detail: str goal: str bmr: float bmr_formula: str pal: float tdee: float target_kcal: float protein_g: tuple fat_g: tuple carb_g: tuple notes: list # --------------------------------------------------------------- 校验 def validate(sex: str, age: float, height_cm: float, weight_kg: float, steps: float) -> Check: """第 1 步:校验输入是否落在模型适用范围内。""" c = Check() if sex not in ("female", "male"): c.errors.append("性别只能为 female 或 male。") if not (AGE_MIN <= age <= AGE_MAX): c.errors.append( f"年龄 {age:g} 超出 {AGE_MIN:.0f}-{AGE_MAX:.0f} 岁," "超出所有人类参考人群,拒绝外推。") if not (HEIGHT_CM_MIN <= height_cm <= HEIGHT_CM_MAX): c.errors.append( f"身高 {height_cm:g} cm 超出 {HEIGHT_CM_MIN:.0f}-{HEIGHT_CM_MAX:.0f} cm 合理范围。") if not (WEIGHT_KG_MIN <= weight_kg <= WEIGHT_KG_MAX): c.errors.append( f"体重 {weight_kg:g} kg 超出 {WEIGHT_KG_MIN}-{WEIGHT_KG_MAX} kg 合理范围。") if not (STEPS_MIN <= steps <= STEPS_MAX): c.errors.append( f"步数 {steps:g} 超出 {STEPS_MIN:.0f}-{STEPS_MAX:.0f} 步范围" "(上界取 24 小时步行纪录量级),无限或负值无定义。") # 交叉校验:年龄 vs 身高 / 体重 if 0 <= age < 2 and weight_kg > 30: c.errors.append( f"{age:g} 岁婴幼儿体重 {weight_kg:g} kg 与发育规律不符(该月龄通常 < 15 kg)," "该组合需即刻就医而非居家计算。") if 0 <= age < 2 and height_cm > 100: c.warnings.append( f"{age:g} 岁身高 {height_cm:g} cm 偏高(该月龄通常约 70-80 cm),请核对。") if age < 5 and not c.errors: c.warnings.append( "0-5 岁应以 WHO 2006 身长/体重曲线评估,本工具仅输出 BMI 数值作参考。") if age < 18 and not c.errors: c.warnings.append( "未成年人须用同年龄同性别百分位判定,不可套用成人 18.5-24.9 标准。") return c # --------------------------------------------------------------- BMI def compute_bmi(weight_kg: float, height_cm: float) -> float: """第 2 步:BMI = 体重(kg) / 身高(m)^2。""" return weight_kg / ((height_cm / 100.0) ** 2) def classify_adult(bmi: float) -> tuple: """第 3 步(>=20 岁):WHO 成人分类。""" if bmi < 16.0: return "重度偏瘦", "WHO 成人分类:BMI < 16.0" if bmi < 17.0: return "中度偏瘦", "WHO 成人分类:16.0 <= BMI < 17.0" if bmi < 18.5: return "轻度偏瘦", "WHO 成人分类:17.0 <= BMI < 18.5" if bmi < 25.0: return "正常", "WHO 成人分类:18.5 <= BMI < 25.0" if bmi < 30.0: return "超重", "WHO 成人分类:25.0 <= BMI < 30.0" if bmi < 35.0: return "I 度肥胖", "WHO 成人分类:30.0 <= BMI < 35.0" if bmi < 40.0: return "II 度肥胖", "WHO 成人分类:35.0 <= BMI < 40.0" return "III 度肥胖", "WHO 成人分类:BMI >= 40.0" def classify_youth(sex: str, age: float, bmi: float) -> tuple: """第 3 步(5-19 岁):WHO 2007 BMI-for-age 的 Z 分数判定。""" table = BMI_FOR_AGE[sex] ages = sorted(table) key = min(max(int(round(age)), ages[0]), ages[-1]) median = table[key] sd = 1.1 + 0.045 * (key - 5) # 近似:年龄越大 BMI 分布越分散 z = (bmi - median) / sd pct = NORMAL.cdf(z) * 100.0 if z < -3: label = "重度消瘦" elif z < -2: label = "消瘦" elif z <= 1: label = "正常" elif z <= 2: label = "超重风险" elif z <= 3: label = "超重" else: label = "肥胖" detail = (f"WHO 2007 BMI-for-age({age:g} 岁 {sex}):中位数 {median:.1f}," f"Z = {z:+.2f},约第 {pct:.0f} 百分位;" "判定阈值 Z < -2(<第 2.3 百分位)为消瘦。") return label, detail, z, pct # --------------------------------------------------------------- BMR def bmr_schofield(sex: str, age: float, weight_kg: float) -> float: """第 4 步:Schofield (FAO/WHO) 公式,单位 kcal/天。""" if sex == "female": if age < 3: return 61.0 * weight_kg - 51.0 if age < 10: return 22.5 * weight_kg + 499.0 if age < 18: return 12.2 * weight_kg + 746.0 if age < 30: return 14.7 * weight_kg + 496.0 if age < 60: return 8.7 * weight_kg + 829.0 return 10.5 * weight_kg + 596.0 if age < 3: return 60.9 * weight_kg - 54.0 if age < 10: return 22.7 * weight_kg + 495.0 if age < 18: return 17.5 * weight_kg + 651.0 if age < 30: return 15.3 * weight_kg + 679.0 if age < 60: return 11.6 * weight_kg + 879.0 return 13.5 * weight_kg + 487.0 def bmr_mifflin(sex: str, age: float, height_cm: float, weight_kg: float) -> float: """第 4 步:Mifflin-St Jeor 公式(成人),单位 kcal/天。""" s = 5.0 if sex == "male" else -161.0 return 10.0 * weight_kg + 6.25 * height_cm - 5.0 * age + s # --------------------------------------------------------------- TDEE def pal_from_steps(steps: float) -> float: """第 5 步:按每日步数估算活动系数 PAL。""" if steps < 5000: return 1.45 if steps < 7500: return 1.55 if steps < 10000: return 1.65 if steps < 12500: return 1.75 return 1.85 # --------------------------------------------------------------- 主流程 def analyze(sex: str, age: float, height_cm: float, weight_kg: float, steps: float, pal: float | None = None) -> Result: chk = validate(sex, age, height_cm, weight_kg, steps) if not chk.ok: raise ValueError("输入校验未通过:\n - " + "\n - ".join(chk.errors)) notes = list(chk.warnings) # 第 2 步 bmi = compute_bmi(weight_kg, height_cm) # 第 3 步 if age >= 20: label, detail = classify_adult(bmi) underweight = bmi < 18.5 elif age >= 5: label, detail, z, _ = classify_youth(sex, age, bmi) underweight = z < -1 else: label = "婴幼儿(需身长/体重曲线)" detail = "0-5 岁以 WHO 2006 身长/体重标准评估,BMI 数值仅供参考。" underweight = False # 第 4 步 if age < 18: bmr = bmr_schofield(sex, age, weight_kg) formula = "Schofield (FAO/WHO)" else: bmr = bmr_mifflin(sex, age, height_cm, weight_kg) formula = "Mifflin-St Jeor" if age >= 18 and bmr < BMR_FLOOR: notes.append(f"BMR 计算值 {bmr:.0f} kcal 低于合理下限,已按 {BMR_FLOOR:.0f} kcal 封顶。") bmr = BMR_FLOOR # 第 5 步 pal = pal if pal is not None else pal_from_steps(steps) tdee = bmr * pal if tdee > TDEE_MAX: notes.append( f"TDEE 计算值 {tdee:.0f} kcal 超过代谢物理上界,已按 {TDEE_MAX:.0f} kcal 封顶。") tdee = TDEE_MAX # 第 6 步:未成年人以增重/维持为目标,不建议减脂 if underweight: target = tdee + 300.0 goal = "温和增重(+300 kcal/天)" elif age >= 20 and bmi >= 25.0: target = tdee - 400.0 goal = "温和减重(-400 kcal/天)" else: target = tdee goal = "维持" # 第 7 步:营养素反推 if age < 18: p_lo, p_hi = 1.3, 1.5 elif goal.startswith("温和增重"): p_lo, p_hi = 1.5, 1.8 else: p_lo, p_hi = 1.2, 1.6 protein_g = (p_lo * weight_kg, p_hi * weight_kg) fat_g = (target * 0.25 / 9.0, target * 0.30 / 9.0) carb_g = ((target - protein_g[1] * 4.0 - fat_g[1] * 9.0) / 4.0, (target - protein_g[0] * 4.0 - fat_g[0] * 9.0) / 4.0) return Result( bmi=bmi, classification=label, detail=detail, goal=goal, bmr=bmr, bmr_formula=formula, pal=pal, tdee=tdee, target_kcal=target, protein_g=protein_g, fat_g=fat_g, carb_g=carb_g, notes=notes, ) def format_result(sex: str, age: float, height_cm: float, weight_kg: float, steps: float, r: Result) -> str: lines = [ "=========== 输入 ===========", f"性别 {sex} | 年龄 {age:g} | 身高 {height_cm:g} cm | " f"体重 {weight_kg:g} kg | 步数 {steps:g}", "=========== BMI ===========", f"BMI = {weight_kg:g} / ({height_cm / 100.0:g})^2 = {r.bmi:.2f}", f"判定:{r.classification}", f"依据:{r.detail}", "========= 热量 ===========", f"BMR = {r.bmr:.0f} kcal/天({r.bmr_formula})", f"PAL = {r.pal:.2f}", f"TDEE = {r.bmr:.0f} x {r.pal:.2f} = {r.tdee:.0f} kcal/天", f"目标:{r.goal} -> {r.target_kcal:.0f} kcal/天", "======== 营养素 ==========", f"蛋白质 {r.protein_g[0]:.0f}-{r.protein_g[1]:.0f} g", f"脂肪 {r.fat_g[0]:.0f}-{r.fat_g[1]:.0f} g", f"碳水 {r.carb_g[0]:.0f}-{r.carb_g[1]:.0f} g", ] if r.notes: lines.append("========= 提示 ===========") lines.extend(f"- {n}" for n in r.notes) lines.append( "注:公式为人群平均估计值,个体差异可达 +/-10-15%;未成年人、" "婴幼儿及伴随症状者请以医生/注册营养师意见为准。") return "\n".join(lines) def main(argv=None) -> int: p = argparse.ArgumentParser(description="BMI 与每日热量计算工具") p.add_argument("--sex", required=True, choices=["female", "male"]) p.add_argument("--age", type=float, required=True, help="年龄(岁)") p.add_argument("--height", type=float, required=True, help="身高(cm)") p.add_argument("--weight", type=float, required=True, help="体重(kg)") p.add_argument("--steps", type=float, default=0.0, help="每日步数") p.add_argument("--pal", type=float, default=None, help="手动指定活动系数,覆盖步数估算") args = p.parse_args(argv) try: r = analyze(args.sex, args.age, args.height, args.weight, args.steps, args.pal) except ValueError as exc: print(exc, flush=True) return 2 print(format_result(args.sex, args.age, args.height, args.weight, args.steps, r)) return 0 if __name__ == "__main__": raise SystemExit(main())