From Track to TruthCourse home课程主页Syllabus课程大纲Primer入门背景FAQ

Online course · 12 weeks · Geant4 11.4在线课程 · 12 周 · Geant4 11.4

From Track to Truth从径迹到真相

Geant4 muon simulation in 12 weeks: one virtual laboratory, from the first track you draw to a number you can defend.12 周 Geant4 缪子模拟:一座虚拟实验室,从画出第一条径迹,到给出一个经得起追问的数。

Learn Geant4 the way experiments use it. Each week is one run: a question, a short lesson, a model you can play with, a lab you run in your own terminal, and a self-check. You start with a Python Monte Carlo and finish with a virtual experiment you can defend in front of a referee.

像真正的实验那样学习 Geant4。每一周就是一次运行:一个问题、一段简短讲解、一个可以动手玩的模型、一个在你自己终端里完成的实验,以及一组自测题。从一个 Python 蒙特卡罗开始,到一个能在审稿人面前答辩的虚拟实验结束。

  • Beginner to intermediate入门到中级no particle physics needed无需粒子物理基础
  • 12 weeks12 周about 2–3 h a week每周约 2–3 小时
  • English and Chinese英文与中文switch any time随时切换
  • Geant4 11.4musrSim on 10.7musrSim 用 10.7

Taught by Kim Siang Khaw · Tsung-Dao Lee Institute, Shanghai Jiao Tong University主讲 许金祥 · 上海交通大学李政道研究所

/vis/open TSGevent display事例显示

Watch a hill filter the sky.看一座山如何“过滤”天空。

TOY MODEL. A hill of standard rock (2.65 g/cm³) with a tunnel and a 14 m void. Muons aimed at the telescope have a toy spectrum dN/dE ∝ E−2.7 above 1 GeV and a cos²θ angular distribution (real sea-level spectra are flatter below about 10 GeV and steepen towards E−3.7 above about 100 GeV, so the toy overstates transmission through very thick rock); directions are kept close to the drawing plane. A muon reaches the tunnel only if its range, from the PDG standard-rock table, exceeds the rock along its path; otherwise it stops where the range runs out. The telescope is drawn larger than life. Lines of sight through the void cross less rock, so slightly more muons arrive from there: that excess is the muography signal.玩具模型。一座标准岩石(2.65 g/cm³)山体,内有隧道和一个 14 m 的空洞。射向望远镜的缪子取玩具能谱 dN/dE ∝ E−2.7(1 GeV 以上)和 cos²θ 角分布(真实海平面能谱在 10 GeV 以下更平缓,在约 100 GeV 以上变陡至 E−3.7,因此玩具模型高估了很厚岩石的透射);方向限制在绘图平面附近。只有当缪子的射程(取自 PDG 标准岩石表)大于路径上的岩石厚度时,它才能到达隧道;否则在射程耗尽处停下。望远镜画得比实际大。穿过空洞的视线所经岩石更少,从那里来的缪子会略多一些:这个超出就是缪子成像的信号。

Outcomes学习成果

What you'll learn你将学到

  • Write, build and run a Geant4 application: geometry, materials, a particle gun and a physics list.编写、编译并运行 Geant4 应用:几何、材料、粒子枪与物理列表。
  • Predict how much energy a muon loses before you simulate it, and check the run against PDG reference values.在模拟之前预测缪子的能量损失,并用 PDG 参考值检验模拟结果。
  • Turn energy deposits into hits, triggers and digitised data, and analyse the output in Python.把能量沉积变成击中、触发与数字化数据,并用 Python 分析输出。
  • Measure momentum in a magnetic field and work out what limits the resolution.在磁场中测量动量,并弄清分辨率受什么限制。
  • Simulate a muon-spin (μSR) experiment with musrSim and fit the asymmetry.用 musrSim 模拟缪子自旋(μSR)实验并拟合不对称度。
  • Debug and validate a simulation, then propose and defend your own virtual experiment.调试并验证一个模拟,然后提出并答辩你自己的虚拟实验。

Skills you'll gain你将获得的技能

  • Geant4 11.4Geant4 11.4
  • C++17 and CMakeC++17 与 CMake
  • Monte Carlo methods蒙特卡罗方法
  • Detector simulation探测器模拟
  • Energy loss (Bethe–Bloch)能量损失(Bethe–Bloch)
  • Scintillator readout and triggers闪烁体读出与触发
  • Physics lists and cuts物理列表与产生阈
  • Magnetic spectrometers磁谱仪
  • Multithreaded ntuples多线程 ntuple
  • Python: uproot and awkwardPython:uproot 与 awkward
  • musrSim and μSRmusrSim 与 μSR
  • Muography缪子成像
  • Validation against PDG对照 PDG 验证
  • Reproducible research可复现研究

Start here从这里开始

No particle physics needed: civil engineers and geologists are welcome.不需要粒子物理基础:欢迎土木工程和地质学的同学。

Cosmic-ray muons rain down at about one per square centimetre per minute and cross hundreds of metres of rock. Counting how many get through a hillside, a dam or the ground above a tunnel reveals how much mass lies along each direction. This is muography, and Geant4 is the standard tool for simulating it before a detector goes into the field.

宇宙线缪子以每平方厘米每分钟约一个的速率落下,能穿过几百米的岩石。统计有多少缪子穿过了山坡、大坝或隧道上方的地层,就能知道每个方向上有多少质量。这就是缪子成像。在探测器进入现场之前,Geant4 是模拟它的标准工具。

Step 0第 0 步Background primer入门背景What a muon is, the units (GeV, g/cm², m.w.e.), energy loss in rock, muography, and how a project maps onto the weeks. About 45 minutes.缪子是什么、相关单位(GeV、g/cm²、米水当量)、岩石中的能量损失、缪子成像,以及一个项目如何对应到各周。约 45 分钟。 Week 0第 0 周Set up your computer配置你的电脑Geant4 11.4 with its datasets on Linux, macOS or Windows (WSL2): conda-forge without admin rights, or the course container. Do it before Week 2; plan about two hours.在 Linux、macOS 或 Windows(WSL2)上安装带数据集的 Geant4 11.4:无需管理员权限的 conda-forge,或课程容器。在第 2 周之前完成,预留约两小时。
Physics track物理方向Weeks 1–12第 1–12 周All twelve weeks. Final project: any virtual experiment, including μSR.全部十二周。结课项目:任何虚拟实验,包括 μSR。
Muography track缪子成像方向Weeks 1–8, 11, 12第 1–8、11、12 周Skim Week 9; Week 10 (muon spin) is optional. Final project: a void above a tunnel, an overburden or a dam density.第 9 周略读;第 10 周(缪子自旋)选修。结课项目:隧道上方空洞、覆盖层厚度或大坝密度。

Syllabus课程大纲

Five stages, from seeing a track to trusting a number.五个阶段:从看见径迹,到相信一个数。

How each week works每周如何学习

Follow the detector, not the class list.跟着探测器走,而不是跟着类列表走。

  1. 15 minRead the physics question and write a prediction读物理问题,写下预测
  2. 20 minRun the supplied example without changing code不改代码,先运行给定示例
  3. 30 minStudy the two or three lines that matter细读最关键的两三行代码
  4. 30 minChange one physical parameter and make a plot改变一个物理参数并作图
  5. 15 minCompare the result with your prediction把结果与预测比较
  6. 10 minWrite one limitation and one next question写下一个局限和下一个问题

If you cannot explain the plot without opening the source code, repeat the experiment before moving on.

如果不打开源代码就讲不清这张图,那就再做一遍实验,然后再往下走。

Instructor主讲人

Instructor主讲人

Kim Siang Khaw 许金祥

Associate Professor, Tsung-Dao Lee Institute, Shanghai Jiao Tong University · leads the Muon Physics Group上海交通大学李政道研究所副教授 · 缪子物理课题组负责人

Works on muon g-2 at Fermilab, the muon EDM search at PSI, the SHINE muon source in Shanghai and muography.研究方向包括费米实验室的缪子 g-2、PSI 的缪子电偶极矩寻找、上海的 SHINE 缪子源以及缪子成像。

FAQ

Frequently asked questions常见问题

Do I need a particle-physics background?需要粒子物理基础吗?

No. Read the background primer first (about 45 minutes): it explains muons, cosmic rays, the units and muography in plain language. Every week also opens with a background section. You do need to be comfortable with a terminal; C++ experience helps but Week 1 starts in Python.

不需要。先读入门背景(约 45 分钟),它用通俗的语言讲解缪子、宇宙线、相关单位和缪子成像。每一周开头也有一节背景知识。你需要会使用终端;有 C++ 经验更好,但第 1 周从 Python 开始。

What software do I need?需要什么软件?

Week 1 needs only Python 3 with NumPy. Weeks 2–8 and 10–12 need Geant4 11.4 with its datasets (C++17, CMake 3.16 or newer) and Python with numpy, scipy, matplotlib, uproot and awkward; ROOT is not needed for them. Week 9 and the musrSim parts of Week 10 use Geant4 10.7 with ROOT, kept in a separate environment. Week 0 · Set up your computer gives step-by-step routes for Linux, macOS and Windows (WSL2), with mirrors for mainland China.

第 1 周只需要 Python 3 和 NumPy。第 2–8 周和第 10–12 周需要带数据集的 Geant4 11.4(C++17、CMake 3.16 或更新)以及装有 numpy、scipy、matplotlib、uproot、awkward 的 Python,不需要 ROOT。第 9 周和第 10 周的 musrSim 部分使用 Geant4 10.7 与 ROOT,请放在单独的环境里。第 0 周 · 配置你的电脑为 Linux、macOS 和 Windows(WSL2)提供了逐步的安装路线,并给出中国大陆可用的镜像。

How much time does it take?需要多少时间?

The pages add up to about 30 hours, plus about two hours of setup. Students who already use Linux and some C++ need 2–3 hours a week. If C++ or the Linux terminal is new to you, plan 4–6 hours a week: the first build and the first debugging take longest. Part-time students with about 3 hours a week should plan 20–24 calendar weeks. Every item on a week page shows its own estimate.

各页面合计共约 30 小时,另加约两小时的环境配置。已经会用 Linux、懂一些 C++ 的同学每周需要 2–3 小时。如果 C++ 或 Linux 终端对你是新的,请按每周 4–6 小时安排:第一次编译和第一次调试最花时间。每周只有约 3 小时的在职学员,请按 20–24 个自然周规划。周页面上每一项都标有各自的预计时间。

How do I get help?遇到问题找谁?

Your instructor will give you the course discussion channel and office hour at enrolment.

讲师会在报名时告诉你课程讨论渠道和答疑时间。

Which language is the course in?课程用什么语言?

Every page is written in both English and Chinese. Use the language switch at the top: EN, Chinese, or both side by side. The combined view helps if you are learning the technical terms in a second language.

每一页都同时有英文和中文。用页面顶部的 EN · 中文 · EN+中 切换;EN+中 会同时显示两种语言,适合想同时掌握两种语言术语的同学。

Where is my progress saved?我的进度保存在哪里?

Only in this browser, on this device. Nothing is sent anywhere. Clearing the site data, or opening the course in a private window, starts from zero.

只保存在当前设备的这个浏览器里,不会发送到任何地方。清除网站数据或在无痕窗口中打开,进度会从零开始。

Are the numbers on the pages real?页面上的数字是真实的吗?

Yes. Expected outputs, histograms and three of the event displays come from our own Geant4 11.4.p01 runs. Where our build machine lacked the physics datasets we ran with a reduced electromagnetic physics list, and each lab says so; your FTFP_BERT run should agree within the stated uncertainties. Anything simplified is labelled TOY MODEL and lists its approximations.

是的。预期输出、直方图和其中三个事例显示来自我们自己的 Geant4 11.4.p01 运行。在构建机器缺少物理数据集的地方,我们使用了精简的电磁物理列表,每个实验都会注明;你用 FTFP_BERT 的运行结果应在给出的不确定度内与之一致。凡是简化的内容都标有 TOY MODEL(玩具模型)并列出近似。