36.5. Common Particle Definitions
Table of Contents
Overview
In Geant4 you never write your own particle classes. Instead, you request particle types from Geant4, and the toolkit provides complete definitions that include mass, charge, lifetime, and standard physics processes. For practical work you mainly need to know:
- Which class or factory provides the particle.
- The PDG-style name string used in macros.
- Which “particle table” category the particle belongs to.
This appendix collects the most common particles and where to find them in Geant4.
Always use Geant4’s built-in particle definitions such as G4Gamma::Gamma() or /gps/particle e-. Never invent your own masses, charges, or lifetimes unless you are deliberately defining an exotic or test particle.
The Particle Table and Names
Geant4 keeps all known particles in a central G4ParticleTable. You usually do not access it directly, but it is useful to know:
In C++ you can obtain a particle by name:
auto particleTable = G4ParticleTable::GetParticleTable();
G4ParticleDefinition* electron =
particleTable->FindParticle("e-");In macros you use the same name string:
/gps/particle e-Common particles follow standard PDG naming conventions. The table below shows typical name patterns you will see in Geant4 macros and in particle table lookups.
| Category | Example name | Pattern / Notes |
|---|---|---|
| Photon | gamma | Gamma rays, i.e. photons |
| Electron / positron | e-, e+ | Charge sign as in PDG |
| Muons | mu-, mu+ | Negative and positive muons |
| Pions | pi-, pi+,pi0 | Charged and neutral pions |
| Kaons | kaon-, kaon+,kaon0, kaon0L, kaon0S | Strange mesons |
| Nucleons | proton, anti_proton, neutron, anti_neutron | With underscore for anti |
| Ions | ion, specific ions via command options | Created via ion commands |
| Neutrinos | nu_e, anti_nu_e, nu_mu, anti_nu_mu, … | If enabled by physics list |
Use these exact strings when setting up particle sources via macro commands.
Fundamental Electromagnetic Particles
Electromagnetic particles are the most commonly used in detector simulations, radiation studies, and medical physics. Geant4 gives convenient C++ helpers for them.
Photon (Gamma)
In Geant4 a “gamma” is a photon. It is defined with zero mass and zero charge.
Typical C++ access:
auto gamma = G4Gamma::Gamma();Macro name:
/gps/particle gammaPhotons are heavily used as primary particles in gamma detectors, shielding studies, and medical imaging examples.
Electron and Positron
Electrons and positrons are defined with their physical mass and charges:
auto electron = G4Electron::Electron(); // e-
auto positron = G4Positron::Positron(); // e+Macro names:
/gps/particle e-
/gps/particle e+These are important for electromagnetic showers, beta radiation, and annihilation processes.
Muons
Muons appear frequently in cosmic-ray simulations and some detector backgrounds.
C++:
auto muMinus = G4MuonMinus::MuonMinus(); // mu-
auto muPlus = G4MuonPlus::MuonPlus(); // mu+Macro names:
/gps/particle mu-
/gps/particle mu+Muons are heavier cousins of electrons with the same charge signs.
Hadrons: Pions, Kaons, and Nucleons
Hadronic particles are important for calorimetry, accelerator shielding, and nuclear physics applications. Most of the time you simply set the particle by its name.
Pions
Pions are the lightest mesons and appear in hadronic showers and many beam lines.
C++ definitions:
auto piPlus = G4PionPlus::PionPlus(); // pi+
auto piMinus = G4PionMinus::PionMinus(); // pi-
auto pi0 = G4PionZero::PionZero(); // pi0Macro names:
/gps/particle pi+
/gps/particle pi-
/gps/particle pi0Kaons
Kaons carry strangeness and appear in higher-energy hadron interactions.
Common C++ helpers:
auto kp = G4KaonPlus::KaonPlus(); // kaon+
auto km = G4KaonMinus::KaonMinus(); // kaon-
auto k0 = G4KaonZero::KaonZero(); // kaon0 (generic)
auto k0L = G4KaonZeroLong::KaonZeroLong(); // kaon0L
auto k0S = G4KaonZeroShort::KaonZeroShort();// kaon0SMacro names:
/gps/particle kaon+
/gps/particle kaon-
/gps/particle kaon0
/gps/particle kaon0L
/gps/particle kaon0SProtons and Neutrons
Protons and neutrons are crucial in shielding, activation studies, and proton therapy examples.
C++:
auto proton = G4Proton::Proton(); // proton
auto neutron = G4Neutron::Neutron(); // neutron
auto antiP = G4AntiProton::AntiProton(); // anti_proton
auto antiN = G4AntiNeutron::AntiNeutron(); // anti_neutronMacro names:
/gps/particle proton
/gps/particle neutron
/gps/particle anti_proton
/gps/particle anti_neutronFor clinical proton beams or detailed neutron transport, always choose an appropriate reference physics list and production cuts. Using the right physics list is essential for correct energy loss and scattering behavior.
Ions and Nuclei
Geant4 can simulate any nucleus using an ion definition. You normally do not construct these directly via C++ factory classes; instead you request ions from G4IonTable or, more commonly in beginner setups, via macro commands.
Ion Names and Commands
In macros you can configure generic ions with the /gun/ion or /gps/ion commands. For example, a monoenergetic carbon-12 beam:
/gps/particle ion
/gps/ion 6 12 6 0The arguments are:
| Parameter | Meaning |
|---|---|
| Z | Atomic number (protons) |
| A | Mass number (nucleons) |
| Q | Charge state (in units of e) |
| E | Excitation energy (in keV) |
So /gps/ion 6 12 6 0 means: Z = 6, A = 12, ion charge = +6e, excitation energy = 0 keV, which corresponds to fully stripped carbon-12.
C++ access via the ion table:
auto ionTable = G4IonTable::GetIonTable();
G4ParticleDefinition* carbon12 =
ionTable->GetIon(6, 12, 0.*keV);This is particularly important for heavy ion therapy simulations and nuclear physics.
Common Light Ions
Typical small ions used in medical and space applications include:
| Ion | Z | A | Example macro snippet |
|---|---|---|---|
| Deuteron | 1 | 2 | /gps/particle deuteron |
| Triton | 1 | 3 | /gps/particle triton |
| Alpha (He-4) | 2 | 4 | /gps/particle alpha or /gps/ion 2 4 2 0 |
| Generic ion | any | any | /gps/particle ion + /gps/ion Z A Q E |
Geant4 provides direct names for some light ions like alpha, deuteron, and triton in both C++ and macros, so you do not always need /gps/ion.
Neutrinos and Other Leptons
Neutrinos are often not central to detector response in Geant4, but they can be defined and transported depending on the physics list.
Common neutrino names:
/gps/particle nu_e
/gps/particle anti_nu_e
/gps/particle nu_mu
/gps/particle anti_nu_muTheir presence and behavior depend strongly on the chosen physics list. For many detector simulations neutrinos essentially escape without interaction.
Tau leptons and their neutrinos also exist:
/gps/particle tau-
/gps/particle tau+
/gps/particle nu_tau
/ gps/particle anti_nu_tauThese are more relevant for high-energy physics than for typical beginner detector examples.
Geant4 Particle Categories
Internally, Geant4 organizes particles into categories. This is mostly useful if you explore or filter the particle table, but it helps to understand where standard particles “live”.
Main categories used in G4ParticleTable:
| Category | Examples |
|---|---|
G4Lepton | e-, e+, mu-, mu+, tau |
G4Boson | gamma, W, Z, Higgs |
G4Meson | pi, kaon, others |
G4Baryon | proton, neutron, hyperons |
G4Ion / G4Ions | All nuclei and heavy ions |
G4ShortLivedParticle | Resonances, virtuals |
For typical beginner simulations you only work with standard leptons, photons, nucleons, mesons, and ions. Exotic and short-lived states are usually handled automatically by the physics processes you enable.
Using Particle Definitions in C++ and Macros
For most applications you will use one of two approaches.
In C++ code, when configuring a primary generator with a particle gun:
#include "G4ParticleGun.hh"
#include "G4ParticleTable.hh"
...
G4ParticleGun* fGun = new G4ParticleGun(1);
auto particleTable = G4ParticleTable::GetParticleTable();
auto proton = particleTable->FindParticle("proton");
fGun->SetParticleDefinition(proton);Here the most important part is the name string, which must match the Geant4 particle definition exactly.
In macro files, for the General Particle Source:
/gps/particle gamma
/gps/energy 1 MeV
/gps/position 0 0 0 mm
/gps/direction 0 0 1
This uses the same particle name string as FindParticle.
Always verify that the particle name you use in macros or in FindParticle() exactly matches a Geant4 definition. A typo such as "protton" will quietly fail and typically lead to a null pointer in C++, or a macro error.
Summary Table of Common Particle Names
The table below summarizes the most common particle names you will use in Geant4 beginner projects.
| Type | C++ class example | Macro name example |
|---|---|---|
| Photon | G4Gamma::Gamma() | gamma |
| Electron | G4Electron::Electron() | e- |
| Positron | G4Positron::Positron() | e+ |
| Muon minus | G4MuonMinus::MuonMinus() | mu- |
| Muon plus | G4MuonPlus::MuonPlus() | mu+ |
| Pion plus | G4PionPlus::PionPlus() | pi+ |
| Pion minus | G4PionMinus::PionMinus() | pi- |
| Pion zero | G4PionZero::PionZero() | pi0 |
| Kaon plus | G4KaonPlus::KaonPlus() | kaon+ |
| Kaon minus | G4KaonMinus::KaonMinus() | kaon- |
| Proton | G4Proton::Proton() | proton |
| Neutron | G4Neutron::Neutron() | neutron |
| Anti proton | G4AntiProton::AntiProton() | anti_proton |
| Anti neutron | G4AntiNeutron::AntiNeutron() | anti_neutron |
| Alpha | via G4IonTable or helper | alpha or ion+params |
| Deuteron | via G4Deuteron::Deuteron() | deuteron |
| Triton | via G4Triton::Triton() | triton |
| Generic ion | via G4IonTable | ion + /gps/ion |
| Electron neutrino | via G4NeutrinoE | nu_e, anti_nu_e |
| Muon neutrino | via G4NeutrinoMu | nu_mu, anti_nu_mu |
With these definitions and names you can configure almost any primary beam commonly used in the rest of this course, from gamma sources and electron beams to protons, neutrons, and simple ion beams.
Views: 0
Where to Move
Move chapter:
- ☰ 1. Introduction to Geant4
- ☰ 1.1. What Is Geant4?
- ☰ 1.2. How Geant4 Works
- ☰ 1.3. Geant4 Simulation Structure
- ☰ 1.4. Geant4 and C++
-
- ☰ 2. Installing Geant4
- ☰ 2.1. Geant4 Requirements
- ☰ 2.2. Installing Geant4 on Linux
- ☰ 2.3. Installing Visualization Libraries
- ☰ 2.4. Verifying the Installation
- ☰ 2.5. Geant4 Example Applications
-
- ☰ 3. C++ Basics for Geant4
- ☰ 3.1. Classes and Objects
- ☰ 3.2. Inheritance
- ☰ 3.3. Pointers and References
- ☰ 3.4. Header and Source Files
- ☰ 3.5. Standard Library Containers
-
- ☰ 4. Creating Your First Geant4 Project
- ☰ 4.1. Project Structure
- ☰ 4.2. CMake Configuration
- ☰ 4.3. The Main Program
- ☰ 4.4. User Initialization Classes
- ☰ 4.5. Building and Running
-
- ☰ 5. Geant4 Units and Constants
- ☰ 5.1. Geant4 Unit System
- ☰ 5.2. Using Units in C++
- ☰ 5.3. Physical Constants
- ☰ 5.4. Printing Values with Units
-
- ☰ 6. Creating the Simulation World
- ☰ 6.1. DetectorConstruction
- ☰ 6.2. Solids
- ☰ 6.3. Logical Volumes
- ☰ 6.4. Physical Volumes
- ☰ 6.5. Creating the World Volume
-
- ☰ 7. Materials
- ☰ 7.1. Geant4 Materials
- ☰ 7.2. NIST Material Database
- ☰ 7.3. Common Materials
- ☰ 7.4. Creating Custom Materials
- ☰ 7.5. Detector Materials
-
- ☰ 8. Building Detector Geometry
- ☰ 8.1. Basic Geometrical Shapes
- ☰ 8.2. Boolean Solids
- ☰ 8.3. Positioning Volumes
- ☰ 8.4. Repeated Geometry
- ☰ 8.5. Detector Arrays
- ☰ 8.6. Geometry Overlap Checking
-
- ☰ 9. Geometry Visualization
- ☰ 9.1. Visualization in Geant4
- ☰ 9.2. Starting the Visualization System
- ☰ 9.3. Changing the View
- ☰ 9.4. Visualization Attributes
- ☰ 9.5. Displaying Particle Tracks
-
- ☰ 10. Primary Particle Generation
- ☰ 10.1. PrimaryGeneratorAction
- ☰ 10.2. Particle Gun
- ☰ 10.3. Particle Energy
- ☰ 10.4. Particle Position
- ☰ 10.5. Particle Direction
- ☰ 10.6. Common Particle Sources
-
- ☰ 11. General Particle Source
- ☰ 11.1. Introduction to GPS
- ☰ 11.2. Position Distributions
- ☰ 11.3. Angular Distributions
- ☰ 11.4. Energy Distributions
- ☰ 11.5. Configuring Sources with Macros
-
- ☰ 12. Physics Lists
- ☰ 12.1. What Is a Physics List?
- ☰ 12.2. Reference Physics Lists
- ☰ 12.3. Electromagnetic Physics
- ☰ 12.4. Gamma Interactions
- ☰ 12.5. Positron Physics
- ☰ 12.6. Hadronic Physics
- ☰ 12.7. Choosing a Physics List
-
- ☰ 13. Particle Tracking
- ☰ 13.1. Tracks
- ☰ 13.2. Steps
- ☰ 13.3. Energy Deposition
- ☰ 13.4. Track Status
- ☰ 13.5. Parent and Secondary Particles
-
- ☰ 14. User Actions
- ☰ 14.1. RunAction
- ☰ 14.2. EventAction
- ☰ 14.3. SteppingAction
- ☰ 14.4. TrackingAction
- ☰ 14.5. StackingAction
- ☰ 14.6. ActionInitialization
-
- ☰ 15. Sensitive Detectors
- ☰ 15.1. What Is a Sensitive Detector?
- ☰ 15.2. Creating a Sensitive Detector
- ☰ 15.3. Hits
- ☰ 15.4. Hit Collections
- ☰ 15.5. Assigning Sensitive Detectors
-
- ☰ 16. Recording Energy Deposition
- ☰ 16.1. Energy Deposition
- ☰ 16.2. Energy per Event
- ☰ 16.3. Energy per Detector
- ☰ 16.4. Energy Spectra
- ☰ 16.5. Detector Efficiency
-
- ☰ 17. Particle Position and Timing
- ☰ 17.1. Particle Position
- ☰ 17.2. Interaction Position
- ☰ 17.3. Global Time
- ☰ 17.4. Time of Flight
- ☰ 17.5. Detector Timing
-
- ☰ 18. Geant4 Analysis System
- ☰ 18.1. Introduction to G4AnalysisManager
- ☰ 18.2. Histograms
- ☰ 18.3. Ntuples
- ☰ 18.4. Filling Ntuples
- ☰ 18.5. Writing Output Files
- ☰ 18.6. Closing Analysis Files
-
- ☰ 19. Geant4 and ROOT
- ☰ 19.1. ROOT Output from Geant4
- ☰ 19.2. Reading Geant4 Output with ROOT
- ☰ 19.3. Plotting Energy Spectra
- ☰ 19.4. Event Analysis
- ☰ 19.5. Simulation-to-Analysis Workflow
-
- ☰ 20. Geant4 Macro Commands
- ☰ 20.1. Macro Files
- ☰ 20.2. Run Commands
- ☰ 20.3. Particle Source Commands
- ☰ 20.4. Visualization Commands
- ☰ 20.5. Controlling Simulations Without Recompiling
-
- ☰ 21. Random Numbers and Reproducibility
- ☰ 21.1. Monte Carlo Random Numbers
- ☰ 21.2. Setting Random Seeds
- ☰ 21.3. Running Independent Simulations
- ☰ 21.4. Reproducing an Event
-
- ☰ 22. Multithreading
- ☰ 22.1. Geant4 Multithreading
- ☰ 22.2. Running with Multiple Threads
- ☰ 22.3. Thread-Safe User Code
- ☰ 22.4. Analysis with Multithreading
- ☰ 22.5. Performance Considerations
-
- ☰ 23. Practical Example: Gamma-Ray Detector
- ☰ 23.1. Project Overview
- ☰ 23.2. Creating the World
- ☰ 23.3. Creating the Detector
- ☰ 23.4. Adding the Material
- ☰ 23.5. Creating a Gamma Source
- ☰ 23.6. Selecting Electromagnetic Physics
- ☰ 23.7. Recording Energy Deposition
- ☰ 23.8. Creating an Energy Spectrum
- ☰ 23.9. Simulating Detector Resolution
- ☰ 23.10. Analyzing the Spectrum with ROOT
-
- ☰ 24. Practical Example: Radiation Shielding
- ☰ 24.1. Project Overview
- ☰ 24.2. Creating the Source
- ☰ 24.3. Creating the Shield
- ☰ 24.4. Comparing Shielding Materials
- ☰ 24.5. Varying Shield Thickness
- ☰ 24.6. Recording Transmitted Particles
- ☰ 24.7. Calculating Transmission
- ☰ 24.8. Calculating Attenuation
- ☰ 24.9. Comparing Simulation Results
-
- ☰ 25. Practical Example: PET Scanner
- ☰ 25.1. Introduction to PET Simulation
- ☰ 25.2. Creating a PET Detector Ring
- ☰ 25.3. Creating Detector Crystals
- ☰ 25.4. Assigning Detector IDs
- ☰ 25.5. Creating a Positron Source
- ☰ 25.6. Simulating Positron Annihilation
- ☰ 25.7. Recording Detector Hits
- ☰ 25.8. Applying an Energy Window
- ☰ 25.9. Finding Coincidence Events
- ☰ 25.10. Recording Detector Positions
- ☰ 25.11. Creating Lines of Response
- ☰ 25.12. Saving PET Events to ROOT
- ☰ 25.13. Analyzing PET Data with ROOT
-
- ☰ 26. Practical Example: Proton Beam in Water
- ☰ 26.1. Project Overview
- ☰ 26.2. Creating the Water Phantom
- ☰ 26.3. Creating a Proton Beam
- ☰ 26.4. Selecting the Physics List
- ☰ 26.5. Recording Energy Deposition
- ☰ 26.6. Dividing the Phantom into Slices
- ☰ 26.7. Calculating Depth Dose
- ☰ 26.8. Observing the Bragg Peak
- ☰ 26.9. Plotting the Depth-Dose Curve
-
- ☰ 27. Detector Resolution and Smearing
- ☰ 27.1. Ideal vs Realistic Detector Response
- ☰ 27.2. Energy Resolution
- ☰ 27.3. Position Resolution
- ☰ 27.4. Time Resolution
- ☰ 27.5. Applying Detector Effects
- ☰ 27.6. Comparing Ideal and Smeared Results
-
- ☰ 28. Simulation Validation
- ☰ 28.1. Why Validate a Simulation?
- ☰ 28.2. Checking Geometry
- ☰ 28.3. Checking Energy Conservation
- ☰ 28.4. Comparing with Analytical Calculations
- ☰ 28.5. Comparing with Reference Data
- ☰ 28.6. Statistical Uncertainties
- ☰ 28.7. Number of Simulated Events
-
- ☰ 29. Improving Simulation Performance
- ☰ 29.1. Geometry Performance
- ☰ 29.2. Physics List Performance
- ☰ 29.3. Production Cuts
- ☰ 29.4. Reducing Unnecessary Output
- ☰ 29.5. Multithreading
- ☰ 29.6. Running Large Simulations
- ☰ 29.7. Parameter Scans
-
- ☰ 30. Debugging Geant4 Simulations
- ☰ 30.1. Compilation Errors
- ☰ 30.2. Geometry Errors
- ☰ 30.3. Overlapping Volumes
- ☰ 30.4. Missing Particles
- ☰ 30.5. Missing Energy Deposition
- ☰ 30.6. Physics List Problems
- ☰ 30.7. Sensitive Detector Problems
- ☰ 30.8. Empty Output Files
- ☰ 30.9. Segmentation Faults
- ☰ 30.10. Using Geant4 Verbose Output
-
- ☰ 31. Writing Better Geant4 Applications
- ☰ 31.1. Organizing Source Code
- ☰ 31.2. Separating Geometry and Analysis
- ☰ 31.3. Using Configuration Parameters
- ☰ 31.4. Avoiding Hard-Coded Values
- ☰ 31.5. Creating Reusable Detector Components
- ☰ 31.6. Naming Conventions
- ☰ 31.7. Documentation
- ☰ 31.8. Version Control with Git
-
- ☰ 32. Advanced Geometry
- ☰ 32.1. Parameterized Geometry
- ☰ 32.2. Replica Volumes
- ☰ 32.3. Nested Geometry
- ☰ 32.4. Complex Detector Arrays
- ☰ 32.5. Importing CAD Geometry
- ☰ 32.6. Exporting Geometry with GDML
-
- ☰ 33. Optical Photons
- ☰ 33.1. Introduction to Optical Physics
- ☰ 33.2. Optical Photons
- ☰ 33.3. Material Optical Properties
- ☰ 33.4. Scintillation Light
- ☰ 33.5. Optical Surfaces
- ☰ 33.6. Photodetectors
- ☰ 33.7. Counting Optical Photons
-
- ☰ 34. Medical Physics Applications
- ☰ 34.1. Geant4 in Medical Physics
- ☰ 34.2. Radiation Dose Simulation
- ☰ 34.3. PET Simulation
- ☰ 34.4. SPECT Simulation
- ☰ 34.5. Radiotherapy Simulation
- ☰ 34.6. Proton Therapy Simulation
- ☰ 34.7. Biological Tissue Materials
-
- ☰ 35. Final Project
- ☰ 35.1. Project Overview
- ☰ 35.2. Define the Simulation Goal
- ☰ 35.3. Create the Geometry
- ☰ 35.4. Define Materials
- ☰ 35.5. Configure the Particle Source
- ☰ 35.6. Select the Physics List
- ☰ 35.7. Implement Sensitive Detectors
- ☰ 35.8. Record Simulation Data
- ☰ 35.9. Run the Simulation
- ☰ 35.10. Analyze the Results with ROOT
- ☰ 35.11. Validate the Simulation
- ☰ 35.12. Create Scientific Figures
- ☰ 35.13. Document the Simulation
-
- ☰ 36. Appendices
- ☰ 36.1. Geant4 Class Cheat Sheet
- ☰ 36.2. Geant4 Units Cheat Sheet
- ☰ 36.3. Common Geant4 Macro Commands
- ☰ 36.4. Common Geometry Classes
- ☰ 36.5. Common Particle Definitions
- ☰ 36.6. Common Physics Lists
- ☰ 36.7. G4AnalysisManager Cheat Sheet
- ☰ 36.8. Common Visualization Commands
- ☰ 36.9. Common Geant4 Errors and Solutions
- ☰ 36.10. Recommended Geant4 Project Structure
- ☰ 36.11. Recommended Geant4 Simulation Workflow
-
Comments
Please login to add a comment.
Don't have an account? Register now!