Examples#

This gallery walks through physicskit.particle’s worked examples: radioactivity and decay chains, relativistic kinematics, nuclear physics, detector signatures, the weak interaction, the neutral kaon system, electroweak theory, QCD confinement, flavor physics, the collider pipeline, and resonance discovery.

See also the narrative tutorials:

Each script in this gallery is self-contained and can be run directly with python examples/particle/<section>/<script>.py. Every script also carries an RST module docstring as its title/description and uses # %% markers to split narrative text from code, which is exactly what Sphinx-Gallery renders into the pages below – the script is the source of truth for what you see, not a copy of it.

Sections#

  • radioactivity – the exponential decay law and Bateman’s decay chains.

  • kinematics – mass-energy equivalence, Compton scattering, and Mandelstam variables.

  • nuclear – Rutherford scattering, the neutron and the semi-empirical mass formula, and fusion/fission energy release.

  • detector_signatures – cloud-chamber tracks and cascade showers.

  • weak_interaction – two- vs. three-body decay kinematics, inverse beta decay, parity violation, and neutrino oscillations.

  • kaon_system – the neutral kaon system, from discovery to CP violation.

  • electroweak – renormalized QED, the Higgs mechanism, and electroweak unification.

  • qcd – asymptotic freedom and confinement.

  • flavor_physics – the CKM quark-mixing matrix.

  • collider_pipeline – from collision to detector: the hard 2-to-2 vertex, its parton shower, and the curved tracks final-state particles leave in a schematic detector.

  • resonance_discovery – the invariant-mass bump hunt behind the J/psi, W/Z, top quark, and Higgs discoveries.

Collider pipeline#

From a hard 2-to-2 collision through its QCD parton shower to the curved tracks final-state particles leave in a schematic detector.

From collision to detector: a hard scatter, its shower, and its tracks

From collision to detector: a hard scatter, its shower, and its tracks

Detector signatures#

Curved cloud-chamber tracks and branching cascade showers – the signatures that identified the positron, the muon, and cosmic-ray showers, from physicskit.particle.collider.

Cloud-chamber tracks: the positron and the muon

Cloud-chamber tracks: the positron and the muon

Bhabha and Heitler’s cascade theory of cosmic-ray showers

Bhabha and Heitler's cascade theory of cosmic-ray showers

Electroweak theory#

Renormalized QED annihilation, the Higgs symmetry-breaking mechanism, and their unification into a single electroweak theory, from physicskit.particle.electroweak.

Tomonaga, Schwinger, Feynman, and Dyson: renormalized QED

Tomonaga, Schwinger, Feynman, and Dyson: renormalized QED

Higgs, Brout-Englert, and Guralnik-Hagen-Kibble: symmetry breaking

Higgs, Brout-Englert, and Guralnik-Hagen-Kibble: symmetry breaking

Glashow, Weinberg, and Salam: electroweak unification

Glashow, Weinberg, and Salam: electroweak unification

Flavor physics#

The CKM quark-mixing matrix and its single, unavoidable CP-violating phase once three quark generations mix.

Kobayashi and Maskawa: the CKM matrix and three quark generations

Kobayashi and Maskawa: the CKM matrix and three quark generations

The neutral kaon system#

From the discovery of the strange particles to CP violation: the Wigner-Weisskopf two-state mixing model in physicskit.particle.electroweak.

The neutral kaon system: from discovery to CP violation

The neutral kaon system: from discovery to CP violation

Relativistic kinematics#

Mass-energy equivalence, Compton scattering, and Mandelstam variables – the four-vector machinery in physicskit.particle.kinematics and physicskit.particle.scattering.

Einstein’s mass-energy equivalence

Einstein's mass-energy equivalence

Compton scattering: the photon as a relativistic particle

Compton scattering: the photon as a relativistic particle

Mandelstam variables and relativistic collision kinematics

Mandelstam variables and relativistic collision kinematics

Nuclear physics#

Rutherford scattering, the neutron and the semi-empirical mass formula, and the fusion/fission energy release at opposite ends of the binding-energy curve, from physicskit.particle.scattering and physicskit.particle.nuclear.

Rutherford scattering and the discovery of the nucleus

Rutherford scattering and the discovery of the nucleus

Chadwick’s neutron and the Weizsacker semi-empirical mass formula

Chadwick's neutron and the Weizsacker semi-empirical mass formula

Cockcroft-Walton’s disintegration and the discovery of fission

Cockcroft-Walton's disintegration and the discovery of fission

Quantum chromodynamics#

Confinement and string breaking, from physicskit.particle.confinement.

Asymptotic freedom and confinement: a receding quark pair’s string

Asymptotic freedom and confinement: a receding quark pair's string

Radioactivity#

The exponential decay law and Bateman’s closed-form solution for multi-species radioactive decay chains, from physicskit.particle.decays.

The radioactive decay law: Becquerel, Rutherford, and Soddy

The radioactive decay law: Becquerel, Rutherford, and Soddy

Bateman’s equations for radioactive decay chains

Bateman's equations for radioactive decay chains

Resonance discovery#

The invariant-mass “bump hunt” – the generic technique behind the discovery of the J/psi, the W/Z bosons, the top quark, and the Higgs boson – built on physicskit.particle.kinematics.invariant_mass().

The invariant-mass bump hunt: J/psi, the W/Z, the top quark, and Higgs

The invariant-mass bump hunt: J/psi, the W/Z, the top quark, and Higgs

The weak interaction#

Two-body vs. three-body decay kinematics, inverse beta decay, parity violation, and neutrino oscillations, from physicskit.particle.decays and physicskit.particle.neutrinos.

Pauli, Fermi, and the pion: two-body vs. three-body decay kinematics

Pauli, Fermi, and the pion: two-body vs. three-body decay kinematics

Cowan and Reines: direct detection of the neutrino

Cowan and Reines: direct detection of the neutrino

Lee, Yang, and Wu: the discovery of parity violation

Lee, Yang, and Wu: the discovery of parity violation

Pontecorvo, Maki, Nakagawa, and Sakata: neutrino oscillations

Pontecorvo, Maki, Nakagawa, and Sakata: neutrino oscillations

Gallery generated by Sphinx-Gallery