diff --git a/tdee.py b/tdee.py new file mode 100644 index 0000000..589b7b4 --- /dev/null +++ b/tdee.py @@ -0,0 +1,193 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""每日热量与六大营养素估算。 + +用法示例: + python tdee.py + python tdee.py --sex male --age 25 --height 180 --weight 65 --steps 10000 + python tdee.py --goal maintain # 维持体重 + python tdee.py --goal lose # 减重 + +算法: + BMI = 体重(kg) / 身高(m)^2 + BMR = Mifflin-St Jeor (1990) + TDEE = BMR × PAL(PAL 由每日步数分档) + 目标 = TDEE × (1 + 增减重盈余) + 三大营养素克数 = 目标热量按 Atwater 系数 4 / 4 / 9 kcal/g 分配 + 矿物质 / 维生素 / 水 / 膳食纤维 = 中国居民膳食指南与 DRIs 参考值 +""" + +import argparse + +# 每日步数 -> (PAL 系数, 说明),参考 FAO/WHO 能量需求与步数分级 +STEP_LEVELS = [ + (5000, 1.375, "久坐 / 很少活动"), + (7500, 1.5, "轻度活动"), + (10000, 1.6, "中等活动(约 1 万步)"), + (12500, 1.7, "较高活动"), + (10 ** 9, 1.9, "高强度活动"), +] + +# 中国 DRIs 2023:成年男性(25 岁)矿物质参考摄入量 +MINERALS = [ + ("钠", "1500 mg(PI 上限 2000 mg)"), + ("氯", "约 2300 mg"), + ("钾", "2000 mg"), + ("钙", "800 mg"), + ("磷", "720 mg"), + ("镁", "330 mg"), + ("铁", "12 mg"), + ("锌", "12.5 mg"), + ("铜", "0.8 mg"), + ("锰", "4.5 mg"), + ("硒", "60 µg"), + ("碘", "120 µg"), +] + +# 中国 DRIs 2023:成年男性(25 岁)维生素参考摄入量 +VITAMINS = [ + ("维生素 C", "100 mg"), + ("维生素 E", "14 mg α-TE"), + ("烟酸(B3)", "15 mg NE"), + ("泛酸(B5)", "5 mg"), + ("维生素 B1", "1.4 mg"), + ("维生素 B2", "1.4 mg"), + ("维生素 B6", "1.4 mg"), + ("叶酸(B9)", "400 µg DFE"), + ("维生素 A", "800 µg RAE"), + ("维生素 D", "10 µg"), + ("维生素 K", "80 µg"), + ("维生素 B12", "2.4 µg"), + ("胆碱", "500 mg"), +] + +SURPLUS = {"maintain": 0.0, "gain": 0.12, "lose": -0.15} + + +def pal_from_steps(steps): + """把每日步数换算成活动系数 PAL。""" + for limit, pal, label in STEP_LEVELS: + if steps <= limit: + return pal, label + return 1.9, "高强度活动" + + +def calc_bmi(height_cm, weight_kg): + return weight_kg / (height_cm / 100) ** 2 + + +def classify(bmi): + """中国标准 WS/T 428-2013。""" + if bmi < 18.5: + return "偏瘦" + if bmi < 24: + return "正常" + if bmi < 28: + return "超重" + return "肥胖" + + +def calc_bmr(sex, weight_kg, height_cm, age): + """Mifflin-St Jeor 基础代谢公式。""" + base = 10 * weight_kg + 6.25 * height_cm - 5 * age + return base + 5 if sex == "male" else base - 161 + + +def macro_grams(target_kcal, weight_kg, protein_per_kg=1.6, fat_ratio=0.25): + """返回 (碳水 g, 蛋白质 g, 脂肪 g)。 + + 蛋白质按体重给定系数;脂肪占目标热量固定比例;碳水用剩余热量补齐。 + """ + protein_g = protein_per_kg * weight_kg + fat_g = target_kcal * fat_ratio / 9 + carb_kcal = target_kcal - protein_g * 4 - fat_g * 9 + return carb_kcal / 4, protein_g, fat_g + + +def walk_kcal(steps, weight_kg, stride_m=0.75, cost=0.5): + """步行净消耗估算:距离(km) × 体重(kg) × 0.5 kcal/kg/km。""" + km = steps * stride_m / 1000 + return km, km * weight_kg * cost + + +def line(label, value, width=14): + return " {:<{w}}{}".format(label, value, w=width) + + +def main(): + p = argparse.ArgumentParser(description="每日热量与六大营养素估算") + p.add_argument("--sex", choices=["male", "female"], default="male") + p.add_argument("--age", type=float, default=25) + p.add_argument("--height", type=float, default=180, help="身高(cm)") + p.add_argument("--weight", type=float, default=65, help="体重(kg)") + p.add_argument("--steps", type=int, default=10000, help="每天步数") + p.add_argument("--goal", choices=["maintain", "gain", "lose"], default="gain") + args = p.parse_args() + + bmi = calc_bmi(args.height, args.weight) + bmr = calc_bmr(args.sex, args.weight, args.height, args.age) + pal, pal_label = pal_from_steps(args.steps) + tdee = bmr * pal + surplus = SURPLUS[args.goal] + target = tdee * (1 + surplus) + carbs, protein, fat = macro_grams(target, args.weight) + km, walk = walk_kcal(args.steps, args.weight) + + goal_cn = {"maintain": "维持体重", "gain": "增重 / 增肌", "lose": "减重"}[args.goal] + + print("=" * 44) + print("每日热量与六大营养素估算") + print("=" * 44) + print("【基础信息】") + print(line("性别 / 年龄", "{}{:.0f} 岁".format("男" if args.sex == "male" else "女", args.age))) + print(line("身高 / 体重", "{:.0f} cm / {:.1f} kg".format(args.height, args.weight))) + print(line("每天步数", "{} 步".format(args.steps))) + print(line("目标", goal_cn)) + print() + + print("【BMI】") + print(line("BMI", "{:.1f}".format(bmi))) + print(line("分类", "{}(WS/T 428-2013)".format(classify(bmi)))) + print() + + print("【热量】") + print(line("基础代谢 BMR", "{:,.0f} 千卡/天".format(bmr))) + print(line("活动系数 PAL", "{:.2f} ({})".format(pal, pal_label))) + print(line("维持热量 TDEE", "{:,.0f} 千卡/天".format(tdee))) + print(line("增减重盈余", "{:+.0%}".format(surplus))) + print(line("每日目标热量", "{:,.0f} 千卡/天".format(target))) + print(line("走路净消耗", "约 {:.0f} 千卡({:.1f} km)".format(walk, km))) + print() + + print("【六大营养素】") + print(line("1 碳水", "{:.0f} g ({:.0f} 千卡,{:.0f}%)".format( + carbs, carbs * 4, carbs * 4 / target * 100))) + print(line("2 蛋白质", "{:.0f} g ({:.0f} 千卡,{:.0f}%)".format( + protein, protein * 4, protein * 4 / target * 100))) + print(line("3 脂肪", "{:.0f} g ({:.0f} 千卡,{:.0f}%)".format( + fat, fat * 9, fat * 9 / target * 100))) + print(line("4 矿物质", "约 8 g/天(见下列明细,不以克计供能)")) + print(line("5 维生素", "约 140 ~ 640 mg/天(见下列明细)")) + print(line("6 水", "2000 ~ 2500 mL/天")) + print() + print(" 附:膳食纤维 30 g/天(常称“第七大营养素”)") + print() + + print("【矿物质明细(中国 DRIs 2023)】") + for name, amount in MINERALS: + print(line(" " + name, amount)) + print() + + print("【维生素明细(中国 DRIs 2023)】") + for name, amount in VITAMINS: + print(line(" " + name, amount)) + print() + + print("提示:估算存在个体误差(BMR ±10%,PAL 不确定性最大)。") + print(" 建议按目标热量执行 2~4 周后称重校准:") + print(" 每周涨 0.25~0.5 kg 为合适;体重不动则加 200~300 千卡,") + print(" 超过 1 kg/周则减 200 千卡。") + + +if __name__ == "__main__": + main()