更新说明文档:写明文件构成、用法、算法链路、设计取舍与免责范围。
This commit is contained in:
@@ -1,3 +1,44 @@
|
|||||||
# bmi-health-calculator
|
# bmi-health-calculator
|
||||||
|
|
||||||
BMI 与每日热量计算工具:输入性别/年龄/身高/体重/步数,输出 BMI、参考标准判定、热量目标与饮食建议,并附算法说明。
|
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、伴随月经停闭/掉发/乏力/怕冷等症状者,请以医生或注册营养师意见为准,本工具不能替代诊断。
|
||||||
|
|||||||
Reference in New Issue
Block a user