163 lines
6.1 KiB
Python
163 lines
6.1 KiB
Python
#!/usr/bin/env python3
|
||
# -*- coding: utf-8 -*-
|
||
"""每日热量需求估算器。
|
||
|
||
算法:
|
||
1. BMR 采用 Mifflin-St Jeor 公式
|
||
2. TDEE 用两种方法交叉验证
|
||
法一(活动系数法):TDEE = BMR * PAL,PAL 按每日步数查表
|
||
法二(步数能耗法):TDEE = BMR * 1.3 + 0.5 * 体重(kg) * 步行距离(km)
|
||
3. 按目标(增重 / 维持 / 减重)对 TDEE 做盈余或赤字调整
|
||
|
||
用法示例:
|
||
python calorie_calculator.py --sex female --age 30 --height 160 --weight 50 \\
|
||
--steps 10000 --goal gain
|
||
"""
|
||
|
||
import argparse
|
||
|
||
# 目标 -> 热量调整比例
|
||
SURPLUS = {
|
||
"gain": 0.12, # 增重:+12%
|
||
"maintain": 0.00, # 维持
|
||
"lose": -0.175, # 减重:-17.5%(本方案不适用,仅作完整实现)
|
||
}
|
||
|
||
# 每日步数 -> (PAL 下限, PAL 上限)
|
||
PAL_TABLE = [
|
||
(0, 5000, 1.20, 1.30), # 久坐
|
||
(5000, 7500, 1.30, 1.40), # 轻度
|
||
(7500, 10000, 1.40, 1.50), # 轻度偏上
|
||
(10000, 12500, 1.50, 1.60), # 中度
|
||
(12500, 15000, 1.60, 1.70), # 中度偏上
|
||
(15000, float("inf"), 1.70, 1.90), # 高度
|
||
]
|
||
|
||
BASE_PAL = 1.30 # 不含额外走路的基础日常活动水平
|
||
STRIDE_RATIO = 0.415 # 步幅 ≈ 0.415 × 身高
|
||
WALK_KCAL_PER_KG_KM = 0.5 # 平路步行(约 5 km/h)的净能耗
|
||
PROTEIN_PER_KG = (1.2, 1.6) # 蛋白质推荐区间 g/(kg 体重)
|
||
|
||
|
||
def bmr_mifflin(sex, weight_kg, height_cm, age):
|
||
"""Mifflin-St Jeor 基础代谢率(kcal/天)。"""
|
||
base = 10 * weight_kg + 6.25 * height_cm - 5 * age
|
||
return base + 5 if sex == "male" else base - 161
|
||
|
||
|
||
def pal_range(steps):
|
||
"""按每日步数返回活动系数区间。"""
|
||
for lo, hi, pal_lo, pal_hi in PAL_TABLE:
|
||
if lo <= steps < hi:
|
||
return pal_lo, pal_hi
|
||
return PAL_TABLE[-1][2], PAL_TABLE[-1][3]
|
||
|
||
|
||
def stride_m(height_cm):
|
||
"""由身高估算步幅(米)。"""
|
||
return STRIDE_RATIO * height_cm / 100
|
||
|
||
|
||
def bmi_category(bmi):
|
||
"""中国成人 BMI 分级。"""
|
||
if bmi < 18.5:
|
||
return "偏瘦"
|
||
if bmi < 24:
|
||
return "正常" + ("(贴近偏瘦边缘)" if bmi < 20 else "")
|
||
if bmi < 28:
|
||
return "超重"
|
||
return "肥胖"
|
||
|
||
|
||
def estimate(sex, age, height_cm, weight_kg, steps=10000, goal="gain", surplus=None):
|
||
"""返回完整的估算结果字典。"""
|
||
bmr = bmr_mifflin(sex, weight_kg, height_cm, age)
|
||
|
||
pal_lo, pal_hi = pal_range(steps)
|
||
pal_mid = (pal_lo + pal_hi) / 2
|
||
tdee_pal = bmr * pal_mid
|
||
|
||
distance_km = steps * stride_m(height_cm) / 1000
|
||
walk_kcal = WALK_KCAL_PER_KG_KM * weight_kg * distance_km
|
||
tdee_steps = bmr * BASE_PAL + walk_kcal
|
||
|
||
tdee = (tdee_pal + tdee_steps) / 2
|
||
|
||
ratio = SURPLUS[goal] if surplus is None else surplus
|
||
target = tdee * (1 + ratio)
|
||
|
||
bmi = weight_kg / (height_cm / 100) ** 2
|
||
|
||
return {
|
||
"bmr": bmr,
|
||
"pal_lo": pal_lo,
|
||
"pal_hi": pal_hi,
|
||
"pal_mid": pal_mid,
|
||
"distance_km": distance_km,
|
||
"walk_kcal": walk_kcal,
|
||
"tdee_pal": tdee_pal,
|
||
"tdee_steps": tdee_steps,
|
||
"tdee": tdee,
|
||
"ratio": ratio,
|
||
"target": target,
|
||
"protein_low": PROTEIN_PER_KG[0] * weight_kg,
|
||
"protein_high": PROTEIN_PER_KG[1] * weight_kg,
|
||
"bmi": bmi,
|
||
"bmi_label": bmi_category(bmi),
|
||
}
|
||
|
||
|
||
def format_report(r, sex, age, height_cm, weight_kg, steps, goal):
|
||
goal_label = {"gain": "增重", "maintain": "维持", "lose": "减重"}[goal]
|
||
sign = "+" if r["ratio"] >= 0 else ""
|
||
return "\n".join([
|
||
"=" * 46,
|
||
"每日热量需求估算",
|
||
"=" * 46,
|
||
f"输入:{('男' if sex == 'male' else '女')},{age} 岁,"
|
||
f"{height_cm:.1f} cm,{weight_kg:.1f} kg,每天 {steps} 步",
|
||
f"BMI:{r['bmi']:.1f}({r['bmi_label']})",
|
||
"",
|
||
f"1) 基础代谢 BMR : {r['bmr']:.0f} kcal/天",
|
||
f"2) 步行距离 : {r['distance_km']:.1f} km"
|
||
f"(走路净消耗约 {r['walk_kcal']:.0f} kcal)",
|
||
f" 活动系数 PAL : {r['pal_mid']:.2f}"
|
||
f"(区间 {r['pal_lo']:.2f}–{r['pal_hi']:.2f})",
|
||
"",
|
||
f"3) 维持热量(系数法) : {r['tdee_pal']:.0f} kcal/天",
|
||
f" 维持热量(步数能耗法) : {r['tdee_steps']:.0f} kcal/天",
|
||
f" 维持热量(两法取中) : {r['tdee']:.0f} kcal/天",
|
||
"",
|
||
f"4) 目标:{goal_label},热量调整 {sign}{r['ratio'] * 100:.0f}%",
|
||
f" 建议每日摄入 : {r['target']:.0f} kcal/天",
|
||
f" 建议蛋白质 : {r['protein_low']:.0f}–{r['protein_high']:.0f} g/天",
|
||
"",
|
||
"说明:以上为估算值,请用连续 2 周晨起空腹体重均值校准;",
|
||
" 体重无变化则每天再加 150–200 kcal,逐步逼近 0.25–0.4 kg/周。",
|
||
"=" * 46,
|
||
])
|
||
|
||
|
||
def main():
|
||
parser = argparse.ArgumentParser(description="每日热量需求估算(BMR / TDEE)")
|
||
parser.add_argument("--sex", required=True, choices=["male", "female"],
|
||
help="性别:male / female")
|
||
parser.add_argument("--age", type=float, required=True, help="年龄(岁)")
|
||
parser.add_argument("--height", type=float, required=True, help="身高(cm)")
|
||
parser.add_argument("--weight", type=float, required=True, help="体重(kg)")
|
||
parser.add_argument("--steps", type=int, default=10000, help="每日步数,默认 10000")
|
||
parser.add_argument("--goal", choices=["gain", "maintain", "lose"], default="gain",
|
||
help="目标:gain 增重 / maintain 维持 / lose 减重,默认 gain")
|
||
parser.add_argument("--surplus", type=float, default=None,
|
||
help="自定义热量调整比例,如 0.15 表示 +15%%")
|
||
args = parser.parse_args()
|
||
|
||
result = estimate(args.sex, args.age, args.height, args.weight,
|
||
steps=args.steps, goal=args.goal, surplus=args.surplus)
|
||
print(format_report(result, args.sex, args.age, args.height, args.weight,
|
||
args.steps, args.goal))
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|