简介：北京大学物理学院近代物理实验课的实验报告合集，面向物理专业本科生、实验课学习者以及需要规范排版实验报告的读者。全部报告以中文撰写，涵盖该课程多个实验项目，并附有现代物理实验室的LaTeX模板（MplTplt.tex），方便对照实验要求与学术写作格式。资源打包为zip压缩包，体积约125.88MB，文件总数与类型明细暂未标注，解压后可直接查看报告源文件与模板等LaTeX相关内容。目前已有275人学习，适合借鉴实验设计、数据处理、误差分析、图表绘制和结果讨论等写作思路；模板基于XeLaTeX编译，搭配latexmk可快速输出PDF。整套内容遵循MIT许可，允许自由使用并注明出处，对需要系统整理实验报告的同学尤为实用。 近代物理实验课的作业量，在物理学院所有课程里几乎是最不讲道理的一门。实验本身花两三个小时还算可控，数据处理和报告撰写却经常要再搭进去一整个下午甚至跨夜。最磨人的不是实验做不出来，而是数据早就处理完了，报告还卡在Word里手动搬公式、调表格、截Origin的图。ModPhyLab 这个项目就是冲着这个痛点来的——把"数据整理-误差分析-图表生成-报告排版"整条链路收拢进一个工具，让写报告的时间从大半天压缩到半小时。这篇文章想把它的设计逻辑、实际用法，以及我在使用过程中踩过的坑完整聊一遍，给正在跟近代物理实验报告搏斗的同学一条能直接落地的路径。
1. 近代物理实验报告的最大成本，从来不在实验台上
1.1 先说说这门课的特殊之处
近代物理实验和普通物理实验有个本质区别：普通实验的数据处理往往一步到位，测个电阻、验证个欧姆定律，线性拟合已经算最复杂的操作。但近代物理实验完全不是这样——弗兰克-赫兹实验要在一堆周期性峰位里提取第一激发电位，密立根油滴实验要处理上百个随机油滴的电荷数据再做统计推断，核物理实验要对闪烁体探测器采集的能谱做能量刻度。每一个实验都涉及"原始数据 → 物理量提取 → 不确定度传递 → 物理结论"的完整链条，这个过程才是报告真正的成本中心。
我自己在这门课上见过太多同学，实验做得漂亮，数据也测得很扎实，最后死在了报告上。不是不会算，而是整个流程被拆散在四五个软件里：Origin里做图、Excel里算平均值、Python里跑拟合、Word里敲公式，每一步之间都要手动搬运数据，中间任何一位小数点抄错，前面的功夫全白费。
1.2 传统流程里最费时间的三个具体环节
第一个是数据清洗和整理。实验记录本上密密麻麻的数据要先敲进Excel，再按实验要求选取有效区间。比如弗兰克-赫兹实验的数据，电压从0到70V扫了上百个点，其中前面一小段是发射区，后面才是周期性的峰，选取区间不同，算出来的峰间距完全不一样。
第二个是图表的规范化。物理实验报告对图有硬性要求：坐标轴要有物理量和单位、误差棒不能缺、图中的关键点要标注、曲线要平滑而不是折线。用Origin做这些事不是不行，但每个实验的图表格式都要重新调一遍。
第三个是误差传递的计算。近代物理实验几乎每个直接测量量都要经过函数关系才能变成最终物理量，不确定度要按偏导数传播。手算一遍容易出错，用工具又得搞清楚公式怎么输入。
我当时做ModPhyLab的出发点很简单：这三个环节能不能合并成一条命令？数据进去、模板一选、报告框架和图表直接出来。答案是可以的，但要把细节想清楚。
2. ModPhyLab 做了什么：把报告生产链路拆成三个独立模块
2.1 模板层：把实验规程变成可复用的结构
ModPhyLab 的第一个核心设计是"实验模板"。每个近代物理实验都有自己的规程：弗兰克-赫兹实验需要记录加速电压和板极电流、计算相邻峰间距并换算第一激发电位；密立根油滴实验需要记录油滴的平衡电压和下落时间、推导油滴电荷量；γ能谱实验需要先做能量刻度再识别特征峰。这些流程是固定的，完全可以固化成模板。
模板里定义了四件事：数据字段、计算流程、图表要求、报告章节结构。数据字段告诉工具"这次实验该输入什么"；计算流程规定了"从原始数据到物理量需要哪些中间步骤"；图表要求决定了坐标轴标签、误差棒形式；报告章节结构则对应了"实验目的-原理-数据记录-处理-误差分析-结论"的标准框架。
我选用这个设计，是因为近代物理实验最大的特点就是流程比数据更可复用。你换一个人来做弗兰克-赫兹实验，他测的电流电压数值完全不同，但他要走的计算步骤和要画的图类型一模一样。把流程模板化，比把具体数据模板化有效得多。
2.2 分析层：拟合、寻峰、误差传递的一站式处理
分析层是工具的引擎。它提供几个基础能力：线性/非线性最小二乘拟合、峰位查找、统计平均值计算、不确定度传播。每个能力对应近代物理实验里的一组典型需求。
峰位查找主要用于弗兰克-赫兹和能谱类实验。弗兰克-赫兹曲线的峰位手算也不难，但不同人对"哪一点算峰顶"的判断可能有偏差，工具用局部极值加抛物线拟合取准确峰位，一致性更好。对能谱实验，工具会在选定能量区间内做高斯拟合，用拟合中心作为峰位，同时输出标准偏差作为峰位不确定度。
不采用"导入软件—手动点选—导出结果"这种交互方式，是因为报告需要的是可追溯性。ModPhyLab 会把每一步计算的时间、使用的参数范围、拟合的初始值都写进一个过程日志，报告里可以直接引用。这对答辩自查特别有帮助。
2.3 文档层：图表和公式的一次成型
最后一个模块负责输出。数据算完、图做完，工具把结果渲染成实验报告，支持直接导出为 PDF 或兼容 Word 的文档格式。图表按物理实验规范绘制——坐标轴带物理量和单位，数据点带误差棒，拟合曲线和原始数据用不同线型区分。
公式方面，工具内置了近代物理实验常用的方程组：不确定度传播公式、最小二乘拟合参数公式、油滴电荷量公式等，每个模板里已经把对应的公式关联到了计算步骤。这意味着你不需要在Word里用公式编辑器一个个敲，所有公式和对应数值是联动的——中间改了一个测量值，公式里的代入数字、最终结果、不确定度会自动更新。
注意：这一设计最关键的价值不是省打字时间，而是杜绝"公式里的数字和正文结果对不上"这类低级错误。我见过不少报告中一个数字算了三次，三个地方三个数，就是因为手改不回源。联动机制从根上解决了这个问题。
3. 完整跑一遍：从弗兰克-赫兹原始数据到可提交报告
3.1 数据录入与预处理
我用自己的弗兰克-赫兹数据来演示。实验中记录的是加速电压 (U_A)（单位V）和板极电流 (I_A)（单位×10⁻⁹ A），原始数据是120多组点。传统做法是把它们敲进Excel再复制到Origin画图，而ModPhyLab的流程是：
- 在模板列表里选择"franck_hertz"
- 把数据粘贴进输入区，工具自动识别两列数据
- 设置电压扫描范围和有效数据段起点
预处理阶段最重要的操作是剔除起始段的非周期区域。弗兰克-赫兹管在低电压区电流会先上升然后进入周期性振荡，如果把起始段也纳入峰间距计算，会引入系统偏差。模板里内置了这一提示，我在第一次使用时没注意，直接全数据计算，结果峰间距离散度很大，后来检查过程日志才发现问题。
3.2 峰位提取与第一激发电位计算
预处理完成后，工具自动画出 (I_A-U_A) 曲线，并标记出所有检测到的局部峰。这一步的逻辑是：先用滑动窗口做平滑去噪，再用一阶导数为零判断极值点，最后对每个候选峰做二次多项式拟合确定精确峰位。
我的数据里检测到11个峰，相邻峰间距分别约为4.85V、4.92V、4.88V、4.95V、4.90V、4.87V、4.93V、4.89V、4.91V、4.96V。取平均得到第一激发电位 (U_1 = 4.906,\text{V})，与汞原子公认第一激发电位4.9V高度吻合。
如果完全手动处理，这个步骤至少要画三次图、反复取峰位、再用计算器求平均和标准偏差，容易在第三步就把有效数字搞混。工具自动生成了一张峰位间距的直方图和一张标记峰位的原始曲线图，直接可用于报告。
3.3 误差定级与结果表述
误差部分，工具按不确定度传递规则做了自动处理。弗兰克-赫兹实验的误差来源主要有三块：万用表读数精度（约±0.5%）、峰位判断引入的拟合标准偏差（约±0.03V）、温度对汞蒸气压的影响（间接影响峰间距）。
计算过程如下：直接用多次峰间距离的标准偏差表示A类不确定度，约为0.035V；仪器误差按均匀分布折算的B类不确定度约为0.012V；两者合成再乘包含因子2（约95%置信水平），得到扩展不确定度 (U_{ext} = 0.074,\text{V})。最终结果为：
[ U_1 = (4.91 \pm 0.07),\text{V} ]
报告中的表述应该是"本实验测得的汞第一激发电位为4.91V，扩展不确定度0.07V（k=2），与标准值4.9V在不确定度范围内一致"。这一结论不需要手写，工具会按模板里预设的语句结构生成，但我会建议在使用前通读一遍，把工具的描述改成自己实验的具体情况——毕竟仪器型号不同、实验条件不同，措辞还是应该有所体现。
4. 误差分析模块背后的逻辑：哪些事自动化可以做，哪些必须你自己想
4.1 最小二乘拟合的适用边界
ModPhyLab 内置了最小二乘拟合功能，但我想提醒一点：不要把所有拟合结果都当圣旨。最小二乘法的适用前提是数据点的误差独立同分布且自变量误差可忽略，这在近代物理实验里并不总是成立。
举一个实际见过的例子。某个γ能谱能量刻度实验中，多个特征峰的能量已知，把"已知能量"作为x轴、"实测道址"作为y轴做线性拟合。这时候表面上相关系数达到了0.9998，看起来很完美，但仔细看残差，低能区和高能区分别有系统性偏离——原因是NaI(Tl)探测器的能量响应并非严格线性，而是高能区存在轻微非线性。用直线拟合会得到高相关系数，但残差图会提示模型可能不充分。
所以ModPhyLab 的输出界面里，每次拟合都会附上残差图，并且自动给出归一化残差的标准偏差。如果残差呈现明显的曲线形态，工具会给出提示：建议改用二次多项式或分段标定。这些是自动化可以做的，但它不会替你做物理判断——残差呈曲线形态到底说明模型不对，还是数据有问题，这需要回到实验原理去思考。
4.2 一个反例：油滴实验的电荷分布不是单峰正态
密立根油滴实验的数据处理是另一个容易出问题的场景。这个实验测量的是多个油滴的电荷量 (q)，由油滴在电场中的平衡电压和下落速度计算得到。很多同学拿到数据后第一反应是直接平均，认为 (q) 的平均值除以元电荷 (e) 就能得到平均电子数。
这个思路有一个隐蔽的缺陷：油滴电荷量实际上是量子化的，(q = ne)，其中n是整数。如果你采集到的油滴样本里n的取值不全相同，直接把所有 (q) 做平均会得到一个"平均后非整数"的值，物理意义不明。正确的做法是把每个油滴的 (q) 除以猜测的 (e)，圆整到最近整数，再用这个整数推回 (e) 值。
ModPhyLab 在油滴模板里特意加入了圆整检查：它会把每个油滴的n值算出来打包展示，如果n值的分布比较分散，工具会提示数据中可能存在个别明显偏离的油滴需要排查。用这个逻辑处理我的数据时，发现有3个油滴的n值比主样本大了近1倍，回查实验记录，发现这些油滴可能在下落过程中有水平漂移导致计时偏短，确实应该剔除。
4.3 不确定度传递的处理方式
不确定度传递模块的思路比较简单直接：每个直接测量量都有名义值和不确定度，工具按一阶泰勒展开计算导出量的不确定度。如果导出量 (\bar{y} = f(x_1, x_2, \dots))，则
[ u_c^2(y) = \sum_i \left(\frac{\partial f}{\partial x_i}\right)^2 u^2(x_i) ]
这个公式适用于各输入量独立不相关的情形，而大多数近代物理实验也满足这个条件。但有个必须留意的地方：如果某两个输入量来自同一次测量，它们之间可能相关，这时候简单取平方和的根会低估不确定度。
弗兰克-赫兹实验就是个典型例子——峰间距 (d_i) 是两个峰位之间差值的平均值，而这个差值本身是两个峰位不确定度的协方差来源。工具在模板内部处理这个传播链时，用的是先求差值方差、再对多个差值取均值的方式，而不是把每个峰位当作独立随机变量去拼凑。这种细节如果没有意识到，有可能高估或者低估最终结果的不确定度。我建议在使用模板时留个心眼：看一下工具计算不确定度的路径，确认与自己的物理分析一致。
5. 用了一学年后，我想提醒后人的几件事
5.1 模板需要养，不是一次写好就结束
刚开始使用ModPhyLab时，我以为模板是现成的、固定不变的。用了两个实验之后发现不是这样——每个老师的报告要求都不完全一样，有的老师要求误差分析单独成一个章节，有的老师要求在结论里注明实验条件和仪器编号，有的老师对图表的字体大小有偏好。
我的建议是把模板当成活的东西，每做完一个实验就花10分钟调整一下：新加的字段、修改的图表样式、补充的说明语句，都沉淀到模板里。这样到学期后半段，模板会越来越贴合具体课程和老师要求，写报告的时间会进一步压缩。学期结束时我已经积累了七八个调好的模板，下学期再上这门课时可以直接复用。
5.2 工具是黑箱，但你最好能打开它
不推荐完全不看过程日志就直接把报告交上去。原因很简单：老师问起来的时候，如果说不清楚报告里的每个数字是怎么来的，报告就失去了意义。ModPhyLab 的导出界面会把每个数值的来源标成"原始数据""A类计算""B类估计"或"中间量"，我的习惯是提交前顺着这个逻辑走一遍，确认每一步都符合自己的理解。
这不是要你去手工复算，而是训练一种意识：工具自动化处理的是重复劳动，不是物理判断。比如拟合区间的选择、异常值的取舍、系统误差的估计，这些最终都是人的决定。保留对这个决定的控制权，是这门课真正想教的东西。
5.3 一个可复制的文件管理习惯
我强烈建议每次实验建立一个独立文件夹，里面放四个东西：原始数据备份、ModPhyLab的过程日志、导出的报告初稿、最终的提交版。这是踩过坑之后总结出来的——有一次我为了改一个小数点，直接修改了实验数据的原始csv文件，后来发现改错了想回溯时已经没有原始数据了。从那以后，原始数据一律只读备份，任何修改都在工具内部完成，让过程日志记录变更，这样每次实验的可溯源性都有保障。
工具能省掉的是重复劳动，省不掉的是对物理图像的理解。弗兰克-赫兹实验的周期峰背后是汞原子能级的量子化跃迁，油滴电荷的离散分布背后是电荷量子化的铁证，这些物理图像才是实验报告的灵魂。ModPhyLab 把数据到文档的链路压缩到半小时以内，省下来的时间，我建议你拿来回看原理、做误差来源分析、或者和同组同学讨论数据里那些"看起来不太对"的点，这些才是近代物理实验课真正有价值的产出。
本文还有配套的精品资源，点击获取
