diff --git a/calculator.py b/calculator.py new file mode 100644 index 0000000..9d27383 --- /dev/null +++ b/calculator.py @@ -0,0 +1,344 @@ +#!/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())