feat: 添加 calculator.py(CLI 版热量需求计算器)
This commit is contained in:
+273
@@ -0,0 +1,273 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""teen-calorie-calculator —— 每日热量需求计算器(青少年 + 成人)
|
||||
|
||||
输入:性别 / 年龄 / 身高(cm) / 体重(kg) / 每日步数
|
||||
输出:BMI 及年龄别判定 / BMR / PAL / TDEE / 目标摄入 / 蛋白质·钙目标
|
||||
|
||||
算法(详见 README.md):
|
||||
1. BMI = 体重(kg) / 身高(m)^2
|
||||
7~17 岁用「年龄别 + 性别别」界值判定;18 岁起用成人标准
|
||||
2. BMR:<18 岁用 Schofield 青少年公式;>=18 岁用 Mifflin-St Jeor 公式
|
||||
3. PAL:由每日步数分段线性插值(5000 步 ≈ 1.45,10000 步 ≈ 1.60)
|
||||
4. TDEE = BMR × PAL,未成年再加 20~25 kcal/天 生长耗能
|
||||
5. 目标摄入:维持量 ~ 维持量×1.1(BMI 处于正常范围偏下段时留出余量)
|
||||
|
||||
用法:
|
||||
python calculator.py # 默认示例参数
|
||||
python calculator.py --sex 男 --age 15 --height 173 --weight 55 --steps 5000
|
||||
python calculator.py --sex 女 --age 30 --height 160 --weight 48 --steps 8000 --json
|
||||
|
||||
免责:结果为统计学估算(误差约 ±10%,约 ±200 kcal),不构成医学建议。
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
|
||||
MJCAL = 239.006 # 1 MJ = 239.006 kcal,用于 Schofield 公式单位换算
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
CUTOFF_PATH = os.path.join(HERE, "cutoffs.json")
|
||||
|
||||
# 每日步数 -> PAL 锚点(分段线性插值);PAL = 总能量消耗 / 基础代谢
|
||||
PAL_ANCHORS = [
|
||||
(0, 1.20),
|
||||
(2500, 1.30),
|
||||
(5000, 1.45),
|
||||
(7500, 1.525),
|
||||
(10000, 1.60),
|
||||
(12500, 1.70),
|
||||
(15000, 1.80),
|
||||
(20000, 1.95),
|
||||
]
|
||||
PAL_JITTER = 0.05 # 输出估算区间时上下浮动
|
||||
|
||||
# 钙 RNI 参考值 mg/天(中国居民膳食营养素参考摄入量)
|
||||
CALCIUM_RNI = [
|
||||
(0, 6, 200),
|
||||
(7, 10, 1000),
|
||||
(11, 13, 1200),
|
||||
(14, 17, 1000),
|
||||
(18, 49, 800),
|
||||
(50, 200, 1000),
|
||||
]
|
||||
|
||||
|
||||
def normalize_sex(value):
|
||||
v = str(value).strip().lower()
|
||||
if v in ("male", "m", "男", "1", "boy"):
|
||||
return "male"
|
||||
if v in ("female", "f", "女", "0", "2", "girl"):
|
||||
return "female"
|
||||
raise ValueError("性别只能是 male/男 或 female/女,收到:%r" % value)
|
||||
|
||||
|
||||
def load_cutoffs(path=CUTOFF_PATH):
|
||||
with open(path, "r", encoding="utf-8") as fh:
|
||||
return json.load(fh)
|
||||
|
||||
|
||||
def interp_cutoff(table, age):
|
||||
"""按年龄在界值表上线性插值,支持 15.5 这类半岁。"""
|
||||
ages = sorted(float(k) for k in table)
|
||||
if age <= ages[0]:
|
||||
return dict(table["%.1f" % ages[0]])
|
||||
if age >= ages[-1]:
|
||||
return dict(table["%.1f" % ages[-1]])
|
||||
for a0, a1 in zip(ages, ages[1:]):
|
||||
if age <= a1:
|
||||
ratio = (age - a0) / (a1 - a0)
|
||||
lo, hi = table["%.1f" % a0], table["%.1f" % a1]
|
||||
return {k: round(lo[k] + ratio * (hi[k] - lo[k]), 2) for k in lo}
|
||||
return dict(table["%.1f" % ages[-1]])
|
||||
|
||||
|
||||
def calc_bmi(weight_kg, height_cm):
|
||||
h = height_cm / 100.0
|
||||
return weight_kg / (h * h)
|
||||
|
||||
|
||||
def classify_bmi(bmi, age, sex):
|
||||
"""返回 (判定, 依据说明)。7<=age<18 用年龄别界值,其余用成人标准。"""
|
||||
if 7 <= age < 18:
|
||||
cut = interp_cutoff(load_cutoffs()["age_bmi"][sex], age)
|
||||
basis = "年龄别界值:消瘦 <%.1f;超重 >=%.1f;肥胖 >=%.1f" % (
|
||||
cut["thin"],
|
||||
cut["overweight"],
|
||||
cut["obese"],
|
||||
)
|
||||
if bmi < cut["thin"]:
|
||||
return "消瘦", basis
|
||||
if bmi >= cut["obese"]:
|
||||
return "肥胖", basis
|
||||
if bmi >= cut["overweight"]:
|
||||
return "超重", basis
|
||||
return "正常", basis
|
||||
|
||||
basis = "成人标准:偏瘦 <18.5;正常 18.5-23.9;超重 24-27.9;肥胖 >=28"
|
||||
if bmi < 18.5:
|
||||
return "偏瘦", basis
|
||||
if bmi < 24.0:
|
||||
return "正常", basis
|
||||
if bmi < 28.0:
|
||||
return "超重", basis
|
||||
return "肥胖", basis
|
||||
|
||||
|
||||
def pal_from_steps(steps):
|
||||
if steps <= PAL_ANCHORS[0][0]:
|
||||
return PAL_ANCHORS[0][1]
|
||||
for (s0, p0), (s1, p1) in zip(PAL_ANCHORS, PAL_ANCHORS[1:]):
|
||||
if steps <= s1:
|
||||
return round(p0 + (steps - s0) / (s1 - s0) * (p1 - p0), 3)
|
||||
return PAL_ANCHORS[-1][1]
|
||||
|
||||
|
||||
def bmr_schofield(sex, age, weight_kg):
|
||||
"""Schofield 体重公式(青少年),返回 kcal/天。"""
|
||||
if age < 3:
|
||||
mj = 0.249 * weight_kg - 0.127 if sex == "male" else 0.244 * weight_kg - 0.130
|
||||
elif age < 10:
|
||||
mj = 0.095 * weight_kg + 2.110 if sex == "male" else 0.085 * weight_kg + 2.033
|
||||
elif age < 18:
|
||||
mj = 0.074 * weight_kg + 2.754 if sex == "male" else 0.056 * weight_kg + 2.898
|
||||
elif age < 30:
|
||||
mj = 0.063 * weight_kg + 2.896 if sex == "male" else 0.062 * weight_kg + 2.036
|
||||
elif age < 60:
|
||||
mj = 0.048 * weight_kg + 3.653 if sex == "male" else 0.034 * weight_kg + 3.538
|
||||
else:
|
||||
mj = 0.049 * weight_kg + 2.459 if sex == "male" else 0.038 * weight_kg + 2.755
|
||||
return mj * MJCAL
|
||||
|
||||
|
||||
def bmr_mifflin(sex, age, height_cm, weight_kg):
|
||||
"""Mifflin-St Jeor 公式(成人),返回 kcal/天。"""
|
||||
return 10 * weight_kg + 6.25 * height_cm - 5 * age + (5 if sex == "male" else -161)
|
||||
|
||||
|
||||
def calc_bmr(sex, age, height_cm, weight_kg):
|
||||
if age < 18:
|
||||
return bmr_schofield(sex, age, weight_kg), "Schofield(青少年)"
|
||||
return bmr_mifflin(sex, age, height_cm, weight_kg), "Mifflin-St Jeor(成人)"
|
||||
|
||||
|
||||
def growth_allowance(age):
|
||||
"""生长发育额外耗能(kcal/天)。"""
|
||||
if age < 10:
|
||||
return 20
|
||||
if age < 18:
|
||||
return 25
|
||||
return 0
|
||||
|
||||
|
||||
def protein_range(weight_kg):
|
||||
"""1.2 - 1.5 g/kg 体重/天"""
|
||||
return round(weight_kg * 1.2), round(weight_kg * 1.5)
|
||||
|
||||
|
||||
def calcium_target(age):
|
||||
for lo, hi, value in CALCIUM_RNI:
|
||||
if lo <= age <= hi:
|
||||
return value
|
||||
return 800
|
||||
|
||||
|
||||
def build_report(sex, age, height_cm, weight_kg, steps):
|
||||
bmi = calc_bmi(weight_kg, height_cm)
|
||||
category, basis = classify_bmi(bmi, age, sex)
|
||||
bmr, formula = calc_bmr(sex, age, height_cm, weight_kg)
|
||||
mifflin = bmr_mifflin(sex, age, height_cm, weight_kg)
|
||||
pal = pal_from_steps(steps)
|
||||
growth = growth_allowance(age)
|
||||
|
||||
tdee = bmr * pal + growth
|
||||
low = bmr * max(pal - PAL_JITTER, 1.0) + growth
|
||||
high = bmr * (pal + PAL_JITTER) + growth
|
||||
|
||||
# 目标摄入:正常范围偏下段(BMI < 20)留 10% 余量,其余留 5%
|
||||
upper_factor = 1.1 if (category == "正常" and bmi < 20) else 1.05
|
||||
target_low, target_high = tdee, tdee * upper_factor
|
||||
p_lo, p_hi = protein_range(weight_kg)
|
||||
|
||||
return {
|
||||
"input": {
|
||||
"sex": "男" if sex == "male" else "女",
|
||||
"age": age,
|
||||
"height_cm": height_cm,
|
||||
"weight_kg": weight_kg,
|
||||
"steps_per_day": steps,
|
||||
},
|
||||
"bmi": round(bmi, 2),
|
||||
"bmi_category": category,
|
||||
"bmi_basis": basis,
|
||||
"bmr_kcal": round(bmr),
|
||||
"bmr_formula": formula,
|
||||
"bmr_alt_mifflin_kcal": round(mifflin),
|
||||
"pal": pal,
|
||||
"growth_kcal": growth,
|
||||
"tdee_kcal": round(tdee),
|
||||
"tdee_range_kcal": [round(low), round(high)],
|
||||
"target_intake_kcal": [round(target_low), round(target_high)],
|
||||
"protein_g": [p_lo, p_hi],
|
||||
"calcium_mg": calcium_target(age),
|
||||
"note": "估算误差约 ±10%(±200 kcal);未成年人请在家长或医生指导下调整饮食。",
|
||||
}
|
||||
|
||||
|
||||
def format_report(r):
|
||||
i = r["input"]
|
||||
g = lambda v: ("%g" % v)
|
||||
lines = [
|
||||
"=" * 50,
|
||||
"每日热量需求估算报告",
|
||||
"=" * 50,
|
||||
"输入:%s / %s 岁 / %s cm / %s kg / 每天约 %s 步"
|
||||
% (i["sex"], g(i["age"]), g(i["height_cm"]), g(i["weight_kg"]), g(i["steps_per_day"])),
|
||||
"",
|
||||
"1) BMI = %.2f → %s" % (r["bmi"], r["bmi_category"]),
|
||||
" %s" % r["bmi_basis"],
|
||||
"",
|
||||
"2) BMR(基础代谢)= %d kcal/天 [%s]" % (r["bmr_kcal"], r["bmr_formula"]),
|
||||
" 对照:成人 Mifflin 公式 = %d kcal/天" % r["bmr_alt_mifflin_kcal"],
|
||||
"",
|
||||
"3) PAL(身体活动水平)= %.3f (每天约 %s 步)" % (r["pal"], g(i["steps_per_day"])),
|
||||
"",
|
||||
"4) TDEE(维持当前体重的热量)= %d kcal/天 区间 %d - %d" % (
|
||||
r["tdee_kcal"], r["tdee_range_kcal"][0], r["tdee_range_kcal"][1]),
|
||||
]
|
||||
if r["growth_kcal"]:
|
||||
lines.append(" 已含生长发育额外耗能 +%d kcal/天" % r["growth_kcal"])
|
||||
lines += [
|
||||
"",
|
||||
"5) 建议每日摄入 = %d - %d kcal" % tuple(r["target_intake_kcal"]),
|
||||
" 蛋白质 %d - %d g/天,钙 >= %d mg/天" % (r["protein_g"][0], r["protein_g"][1], r["calcium_mg"]),
|
||||
"",
|
||||
"提示:" + r["note"],
|
||||
"=" * 50,
|
||||
]
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def main(argv=None):
|
||||
parser = argparse.ArgumentParser(description="每日热量需求计算器(青少年 + 成人)")
|
||||
parser.add_argument("--sex", default="male", help="male/男 或 female/女(默认 male)")
|
||||
parser.add_argument("--age", type=float, default=15, help="年龄(岁)")
|
||||
parser.add_argument("--height", type=float, default=173, help="身高 cm")
|
||||
parser.add_argument("--weight", type=float, default=55, help="体重 kg")
|
||||
parser.add_argument("--steps", type=int, default=5000, help="每日步数")
|
||||
parser.add_argument("--json", action="store_true", help="以 JSON 输出")
|
||||
args = parser.parse_args(argv)
|
||||
|
||||
report = build_report(
|
||||
normalize_sex(args.sex), args.age, args.height, args.weight, args.steps
|
||||
)
|
||||
if args.json:
|
||||
print(json.dumps(report, ensure_ascii=False, indent=2))
|
||||
else:
|
||||
print(format_report(report))
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
raise SystemExit(main())
|
||||
Reference in New Issue
Block a user