Files
bmi-health-calculator/README.md
T

45 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# bmi-health-calculator
BMI 与每日热量计算工具:输入性别 / 年龄 / 身高 / 体重 / 步数,输出 BMI、参考标准判定、BMR、TDEE、目标热量与营养素建议。
## 文件
| 文件 | 说明 |
|---|---|
| `calculator.py` | 计算脚本(含输入校验与命令行接口) |
| `ALGORITHM.md` | 算法说明与决策记录 |
## 使用
```bash
python calculator.py --sex female --age 15 --height 155 --weight 41.6 --steps 3000
python calculator.py --sex female --age 25 --height 180 --weight 50 --steps 8000
```
可选参数 `--pal` 手动指定活动系数,覆盖按步数的估算。
## 算法链路
```
1. 数据校验(单位 / 生理上界 / 模型适用范围)
2. BMI = 体重(kg) / [身高(m)]^2
3. 参考标准判定:>=20 岁 WHO 成人分类;5-19 岁 WHO 2007 BMI-for-age(Z 分数);0-5 岁只给 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 周按体重趋势校准
```
## 设计取舍
- 超出适用范围的输入(如年龄 700000、步数无穷大)一律报错,不做外推。
- 未成年人只给维持或温和增重,不输出减脂方案。
- BMR 下限 400 kcal/天,TDEE 上限 12000 kcal/天,超出时封顶并提示。
## 免责说明
- 公式为人群平均估计值,个体差异可达 +/-10-15%。
- 内置参考曲线为公开资料近似值,正式临床使用请替换为 WHO 官方 LMS 表。
- 婴幼儿、未成年人,或 BMI 超出 +/-3SD、伴随月经停闭/掉发/乏力/怕冷等症状者,请以医生或注册营养师意见为准,本工具不能替代诊断。