# 学习时长研究复现包

## 这个包可以复现什么

用四条模拟记录计算两种声音环境下的平均学习时长。这些数据仅用来演示工作流程。

## 文件说明

| 路径 | 用途 |
| --- | --- |
| `data/sessions.csv` | 输入数据。 |
| `data/data-dictionary.zh.md` | 字段定义、单位和缺失值规则。 |
| `analysis/analyze.py` | 按声音环境分组，计算平均学习时长。 |
| `expected/means.csv` | 校验本次运行的预期结果表。 |
| `results/means.csv` | 脚本运行后生成的结果。 |

## 运行并核对结果

在解压后的项目目录里运行：

```sh
python --version
python analysis/analyze.py
```

如果系统用 `python3` 或 `py -3` 启动 Python 3，把命令里的 `python` 换成相应写法。示例在 Linux x86_64 上用 Python 3.12.14 测试通过，只需要 Python 标准库。

打开 `results/means.csv`，对照 `expected/means.csv` 检查。背景噪音条件平均为 20.0 分钟，安静条件平均为 25.0 分钟。再次运行时会覆盖生成的结果表。

## 改成你自己的研究说明

替换研究目的和文件列表。写清楚从哪条命令开始、实际测试的解释器和依赖版本、数据版本或申请方式、代码版本、预期输出，以及数据和代码各自的许可证。如果公开复现只能用模拟数据，说明演示中的输入和结果与真实研究有哪些差异。
