生物统计 · 本科二年级 · 教学单元
帕尔默群岛三种企鹅的形态分化
一个 4 周的教学单元:用一项真实野外研究的公开数据,练习研究设计、缺测值、分组描述统计、两组比较和回归,并认识合并分析的陷阱。
材料
发给学生的文件
把下列文件和文件夹交给学生即可(保持目录结构,讲义和幻灯片才能找到图片):
course/
├── assets/ 样式和论文图
├── data/penguins.csv
├── exercise/exercise.ipynb(或 exercise.py)
├── lecture1/ handout.html、slides.html、figures/
├── syllabus.html
└── rubric.html
不要发exercise/solution.*、exercise/answers.html、exercise/solution_output/。另外,讲义和大纲里链接了论文初稿 ../paper/paper.html;如果暂不想公开初稿,学生那边这个链接会打不开,其余内容不受影响,原始研究可引用 Gorman 等(2014)和 Horst 等(2022)。
课前准备
- Python 环境。学生需要 Python 3.10 以上版本和三个库:
pip install pandas matplotlib scipy jupyter。机房统一安装时,参考答案在 Python 3.10(pandas 2.0、NumPy 1.24、SciPy 1.10、Matplotlib 3.7)到 Python 3.13(pandas 3.1、NumPy 2.5、SciPy 1.18、Matplotlib 3.11)的三套环境下测试过,结果相同。 - 先跑一遍参考答案。在
course/exercise/下运行uv run solution.py(或python solution.py),约 10 秒,图和全部数值写入solution_output/。 - 幻灯片。用 Chrome、Edge、Firefox 或 Safari 直接打开
lecture1/slides.html,不需要联网或安装任何东西。要发 PDF 时,在浏览器里打印并选“另存为 PDF”,每页一张幻灯片。
修改之后
uv run course/tools/build_exercise.py # 改了 solution.py 后:重新生成自查格、学生版和两个 .ipynb
uv run course/lecture1/make_figures.py # 重画讲义和幻灯片的插图
python3 course/tools/check_course.py --run # 重新运行参考答案,并核对全部材料
check_course.py 检查:数据文件与论文所用文件逐字节一致;参考答案算出的每个数与论文一致;网页中标注了来源的数字(<span data-k="…">)与论文或参考答案一致,未标注的数字也都能在其中找到;学生版与答案版的题目和自查格逐字相同,每道题都有自查格;参考答案通过全部自查;笔记本与 .py 同步;网页不加载任何外部资源,相对链接都存在。论文的数字变了,重新运行它就会列出需要改的地方。
文件结构
course/
├── index.html 本页
├── syllabus.html 单元大纲
├── rubric.html 评分标准
├── assets/
│ ├── course.css 文档样式(只用系统字体)
│ ├── Figure1.webp 论文图 1
│ └── Figure2.webp 论文图 2(样本流程)
├── data/penguins.csv 与 paper/ 所用数据逐字节相同
├── lecture1/
│ ├── handout.html 第一讲讲义
│ ├── slides.html 第一讲幻灯片(样式和脚本都在文件内)
│ ├── figures/ 讲义和幻灯片的插图
│ └── make_figures.py 重画插图
├── exercise/
│ ├── exercise.ipynb / .py 学生版(由 solution.py 生成,含自查格)
│ ├── solution.ipynb / .py 参考答案(仅教师)
│ ├── answers.html 参考答案与评分要点(仅教师)
│ └── solution_output/ 参考答案运行结果:图和 answers.csv
└── tools/
├── build_exercise.py 由参考答案生成学生版和自查格
├── build_notebooks.py .py → .ipynb
└── check_course.py 核对全部材料