实现 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:
+344
@@ -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())
|
||||
Reference in New Issue
Block a user