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