PHYS1006 Workspace

适用于 HITSZer 的一站式物理实验报告工作区，可以帮助你完成数据处理和报告排版的部分工作。本 workspace 特点是用 python 处理实验数据，用 Typst 排版文档。

进展

标「💤」为我本学期未选实验，欢迎 PR！

为了使用此 workspace，

首先，克隆本仓库，修改根目录下的 stu-info.typ 文件，在其中填入你的个人信息，这将会出现在每份报告的头部。

每个实验对应一个文件夹，其一般具有如下结构：

.
├── a10-hall-effect.ipynb
├── data
├── fig
├── manuscript
├── report.pdf
├── report-start.typ
├── report.typ
└── utils.typ

对于每个实验：

将实验原始数据填入 data 文件中。（也可能是 data 目录中的多个文件）

如对于同一记录表，同时存在形如 st1-VH-IM-raw.csv 和 st1-VH-IM.csv 的文件，则将原始数据填入 raw 文件中，运行下述程序之后，处理好的数据将会被写入另一个中。
运行与实验文件夹同名的 ipynb 文件（注意阅读其中的文字和注释），这就能处理数据、绘制图像，有用的计算值会显示在其单元格的输出中，图像将保存在 fig 目录中。只要你不改变这些中间文件的名称，这些数据和图像将自动嵌入 Typst 文档中。你可以修改代码以改变图像的颜色、线形等。

注意：Notebook 的不同部分可能有同名变量，建议按顺序执行各代码块，否则可能出错。
将 report-start.typ 文件复制为 report.typ，在后者中书写你的报告内容（注意阅读其中的注释）。
嵌入教师签字、成绩和手写内容。方法如下：
- 扫描或拍摄你的纸质实验报告，用图像处理程序处理所得图像，保存在 manuscript 目录中
- 设置 page 的 background 或 foreground 属性为该图像，微调缩放和偏移值，使叠加图像处于正确位置，例如：
```
#page(
  foreground: move(dx: 0pt, dy: -1pt, scale(104%, origin: center+horizon,
    image("./manuscript/overlay-p1.jpg")
  ))
)[
  // 页面内容……
```

除非另有说明，本仓库内容按 CC BY-NC-SA 4.0 International 协议许可，只要遵守一定条件，你可以自由地修改、复制或发布之。若你向本仓库贡献，即视为你亦将贡献的内容以同样的协议许可。