Files

75 lines
4.6 KiB
Markdown
Raw Permalink 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-calculator
BMI 与每日营养方案计算工具集:输入身高、体重、年龄、性别、步数等参数,输出 BMI 值、分级,以及每日所需热量与七大营养素建议。
## 目录结构
| 文件 | 说明 |
| --- | --- |
| `bmi.py` | 命令行 BMI 计算器:输入身高、体重,输出 BMI 值与分级 |
| `nutrition_plan.py` | 命令行每日营养方案计算器:输出体脂率、BMR、TDEE、目标热量与三大营养素克数 |
| `nutrition-calculator.html` | 网页版「每日热量与三大营养素计算器」,输入参数后实时计算结果 |
| `我的健康饮食方案_项目书.html` | 可交互学生项目书:理想热量 / 营养目标 → 3 天真实饮食核验 → 方案迭代 → 评价,全程自动计算并可导出 |
## 设计决策
### BMI 计算与分级(`bmi.py`)
- 计算公式:BMI = 体重(kg) ÷ 身高(m)²
- 分级同时给出两套标准:
- 中国标准(WS/T 428-2013):< 18.5 偏瘦;18.5–23.9 正常;24.0–27.9 超重;≥ 28.0 肥胖
- WHO 国际标准:< 18.5 偏瘦;18.5–24.9 正常;25.0–29.9 超重;≥ 30.0 肥胖
- 按身高反推「正常」BMI 区间对应的健康体重范围,并提示与目标体重的差距
- 输入范围校验(身高 50–250 cm、体重 10–500 kg),非法输入则重新询问
### 每日营养方案(`nutrition_plan.py`)
- 以体重 70 kg、身高 180 cm 为基准默认值
- 体脂率:未实测时按 Deurenberg 公式估算,并标注校准方法去除脂肪体重
- 基础代谢率:Mifflin-St Jeor 与 Katch-McArdle 两式取平均
- 按活动系数(久坐 / 轻度 / 中度 / 高度)估算 TDEE,再按目标(减脂 −18% / 维持 / 增肌 +8%)调整,得出目标摄入热量
- 三大产能营养素:蛋白质 2.2 g/kg 去脂体重、脂肪 1.0 g/kg 体重,剩余热量由碳水补足
- 输出三大营养素克数、能量系数与供能比,以及每日食物建议量(以 2300 kcal 为基准按目标热量等比例缩放)
### 网页版计算器(`nutrition-calculator.html`)
- 以 BMI 正常、偏瘦、每天约 1 万步的活动量为前提设定默认值
- 计算方法:Mifflin-St Jeor 基础代谢 + MET 法估算能耗 + DRIs 2023 供能比
- 三大产能营养素供能比:蛋白质 16.7%、脂肪 27.5%、碳水化合物 55.8%
- 步行能耗按 MET 3.5、步速 100 步/分钟估算
- 输入身高、体重、年龄、性别、步数、目标,实时重算
- 七大营养素全景:蛋白质、脂肪、碳水(产能);膳食纤维、维生素、矿物质、水(不产能)
### 可交互项目书(`我的健康饮食方案_项目书.html`)
面向 14–17 岁中学生的《我的健康饮食方案》项目书,按「理想目标 → 真实核验 → 迭代 → 评价」的完整流程组织,边填边算:
- 封面与进度:自动汇总热量目标、BMI、BMR、TDEE、3 天平均摄入与达成率,并显示五部分填写进度
- 第一部分 理想热量摄入:Mifflin-St Jeor 公式(女性 −161)算 BMR → 乘活动系数得 TDEE → 按维持 / 减脂 / 增肌调整得每日热量目标,并展示代入数据的完整算式
- 第二部分 理想营养摄入:8 项指标(碳水、蛋白质、脂肪、水、膳食纤维、钙、铁、维生素 C)自动推荐,营养素参考值按 14–17 岁取值;碳水 55%、脂肪 25%、蛋白质 1.6 g/kg,实时显示三大营养素供能占比
- 第三部分 真实数据核验:内置约 60 种常见食物成分表,连续 3 天记录自动算出热量与三大营养素,自动生成 3.2 核验对照表(目标 / 每日 / 平均 / 偏差 / 合格判定)并汇总到 3.3 结论
- 第四部分 方案迭代:一次只改 1–2 个问题,可一键「带入最差项」;最终版方案含三餐比例与每日必做 3 件事
- 第五部分 评价:学生自评 5 项 + 同伴互评 6 项,自动带出核验结果汇总
- 数据自动存于浏览器本地;支持打印 / 存 PDF、导出 Markdown、导出与导入 JSON、载入示例数据
## 使用方法
### 命令行
```bash
python bmi.py
python nutrition_plan.py --weight 70 --height 180 --bodyfat 15.5 \
--age 25 --sex male --activity light --goal maintain
```
### 网页版
用浏览器打开 `nutrition-calculator.html`,修改任一输入会立即重新计算。
项目书用浏览器打开 `我的健康饮食方案_项目书.html` 直接填写;交作业可点「打印 / 存为 PDF」或「查看 Markdown」后复制保存。
## 说明
以上结果皆为可参考估算,不构成医学或营养处方;公式计算存在 ±10%–15% 的个体差异,建议以 2–4 周体重变化实测校准。