A four-lab series taking you from a fresh Linux install to a working PET-scanner simulation, using Geant4 for the physics and Python (pandas, matplotlib) for analysis.

Read the labs at: https://jwinterm.github.io/geant4-radiation-labs/

Labs

	Title	Topic
1	Setting Up Linux and Building Geant4	Ubuntu VM + Geant4 build with Qt visualization
2	First Simulation: Building and Running B1	Compile B1, run interactively + via macros, vary particle/energy
3	Acquiring and Analyzing Simulation Data	Patch B1 to write CSV via `G4AnalysisManager`; analyze in Python
4	Medical Physics Application: A PET Scanner	Use B3a PET example; identify 511 keV photopeak; reconstruct lines of response

Building locally

This site is built with Quarto. To preview locally:

quarto preview

To regenerate a single lab as PDF:

quarto render lab1_setup/lab1.qmd --to pdf

License

This repository uses a dual license:

Code (Python, C++ snippets, Quarto/YAML config, diagram-generation scripts) is licensed under the MIT License.
Lab content (prose, diagrams, screenshots, generated figures) is licensed under Creative Commons Attribution 4.0 International (CC-BY-4.0).

In short: use, modify, redistribute, and even commercialize freely — just keep attribution to such.software and the lab authors.

Instructors and inquiries

Using these labs in a course, want a customized version, or interested in CE-accredited or on-site delivery? Email info@such.software.

Authors

John Murphy and Steven Carlson · such.software