Files
class04f21 8dde0ea71e 实现 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 设下限与物理上界封顶。
- 决定未成年人一律以维持或温和增重为目标,不输出减脂方案。
2026-09-24 04:00:03 +00:00

345 lines
12 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/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())