实现 BMI 与热量计算脚本:确定成人用 Mifflin-St Jeor、18 岁以下用 Schofield;PAL 按步数分档;营养素按蛋白 g/kg、脂肪 25-30%、碳水余量反推。

决策:
- 选定判定标准分三档:>=20 岁用 WHO 成人分类,5-19 岁用 WHO 2007 BMI-for-age 的 Z 分数,0-5 岁只输出 BMI 数值并提示改用身长/体重曲线。
- 决定给年龄(0-122)、身高(30-250cm)、体重(0.5-500kg)、步数(0-200000) 设上界,并对年龄与身高/体重做交叉校验。
- 决定对超出适用范围的输入拒绝外推(报错返回),并对 BMR/TDEE 设下限与物理上界封顶。
- 决定未成年人一律以维持或温和增重为目标,不输出减脂方案。
This commit is contained in:
2026-09-24 04:00:03 +00:00
parent 7886d67e70
commit 8dde0ea71e
+344
View File
@@ -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())