36.2. Geant4 Units Cheat Sheet
Table of Contents
Length Units
Geant4 uses its own internal unit system. You must always multiply numeric literals by a unit constant. This prevents silent mistakes and keeps code readable.
Typical length units are defined in G4SystemOfUnits.hh and used directly in C++ code, for example 10cm or 2.5m.
Common length units include:
| Quantity | Symbol | Geant4 constant | Relation (to mm) |
|---|---|---|---|
| millimeter | mm | mm | $1 \,\text{mm}$ |
| centimeter | cm | cm | $1 \,\text{cm} = 10\,\text{mm}$ |
| meter | m | m | $1 \,\text{m} = 1000\,\text{mm}$ |
| micrometer | µm | micrometer | $1 \,\mu\text{m} = 10^{-3}\,\text{mm}$ |
| nanometer | nm | nanometer | $1 \,\text{nm} = 10^{-6}\,\text{mm}$ |
| kilometer | km | km | $1 \,\text{km} = 10^{6}\,\text{mm}$ |
Example:
G4double worldSize = 1.0*m;
G4double pixelSize = 300*micrometer;
Always multiply raw numbers by a Geant4 unit constant like mm, cm, or m.
Never mix raw SI numbers with Geant4 numbers without an explicit unit.
Energy Units
Energy is central in Geant4. The base energy unit is MeV internally, but you should always use the symbolic constants.
Common energy units:
| Quantity | Symbol | Geant4 constant | Relation (to eV) |
|---|---|---|---|
| electronvolt | eV | eV | $1 \,\text{eV}$ |
| kiloelectronvolt | keV | keV | $1 \,\text{keV} = 10^{3}\,\text{eV}$ |
| megaelectronvolt | MeV | MeV | $1 \,\text{MeV} = 10^{6}\,\text{eV}$ |
| gigaelectronvolt | GeV | GeV | $1 \,\text{GeV} = 10^{9}\,\text{eV}$ |
| teraelectronvolt | TeV | TeV | $1 \,\text{TeV} = 10^{12}\,\text{eV}$ |
| joule | J | joule | $1 \,\text{J} \approx 6.2415\times10^{18}\,\text{eV}$ |
Examples:
G4double gammaEnergy = 511*keV;
G4double beamEnergy = 120*GeV;
Use keV, MeV, or *GeV when setting particle energies, cut values, or histogram ranges.
Do not assume the default is eV or MeV without writing the unit.
Time Units
Time units are important for timing studies, time of flight, and detector response.
Common time units:
| Quantity | Symbol | Geant4 constant | Relation (to ns) |
|---|---|---|---|
| second | s | s | $1 \,\text{s} = 10^{9}\,\text{ns}$ |
| millisecond | ms | ms | $1 \,\text{ms} = 10^{6}\,\text{ns}$ |
| microsecond | µs | microsecond | $1 \,\mu\text{s} = 10^{3}\,\text{ns}$ |
| nanosecond | ns | ns | $1 \,\text{ns}$ |
| picosecond | ps | ps | $1 \,\text{ps} = 10^{-3}\,\text{ns}$ |
| femtosecond | fs | fs | $1 \,\text{fs} = 10^{-6}\,\text{ns}$ |
Example:
G4double gateWidth = 10*ns;
G4double coincidenceWindow = 5*ns;
Use explicit time units like ns, microsecond, and s whenever you work with GetGlobalTime() or timing histograms.
Never rely on implicit time scales.
Mass and Density Units
Mass and density appear when creating materials and defining particle properties.
Common mass units:
| Quantity | Symbol | Geant4 constant | Relation (to kg) |
|---|---|---|---|
| kilogram | kg | kg | $1 \,\text{kg}$ |
| gram | g | g | $1 \,\text{g} = 10^{-3}\,\text{kg}$ |
| milligram | mg | mg | $1 \,\text{mg} = 10^{-6}\,\text{kg}$ |
Density units often combine mass and volume units:
| Quantity | Geant4 constant | Example value |
|---|---|---|
| g per cubic centimeter | g/cm3 | Water: 1.0*g/cm3 |
| mg per cubic centimeter | mg/cm3 | Lung tissue: 0.3*mg/cm3 |
| kg per cubic meter | kg/m3 | Air: about 1.29*kg/m3 |
Example material definition:
G4double density = 1.0*g/cm3;
G4double a = 1.01*g/mole;
G4Material* H = new G4Material("Hydrogen", 1., a, density);
When defining materials always specify density with combined units like g/cm3 or kg/m3.
Do not try to compute density in pure SI and forget the unit factor.
Angle and Solid Angle Units
Geant4 uses radians internally but provides constants for both radians and degrees.
Angle units:
| Quantity | Geant4 constant | Relation |
|---|---|---|
| radian | rad | $1 \,\text{rad}$ |
| degree | deg | $1 \,\text{deg} = \pi / 180 \,\text{rad}$ |
Solid angle:
| Quantity | Geant4 constant | Relation |
|---|---|---|
| steradian | sr | $1 \,\text{sr}$ |
Example:
G4double theta = 45*deg;
G4double phi = 90*deg;
Do not pass bare numbers where an angle is expected. Always use deg or rad to avoid confusion between radians and degrees.
Other Common Units
Velocity, magnetic field, and dose units appear frequently in detector and medical simulations.
Selected examples:
| Quantity | Geant4 constant | Notes |
|---|---|---|
| speed of light | c_light | In units of mm/ns |
| magnetic field | tesla, gauss | 1 tesla is $10^{4}$ gauss |
| electric field | volt/m, kV/cm | Frequently used in drift detectors |
| dose | gray | 1 gray is 1 J/kg |
| activity | becquerel, curie | 1 curie is $3.7\times10^{10}$ Bq |
Examples:
G4double fieldStrength = 1.5*tesla;
G4double dose = 2*gray;Unit Conversion Helpers
Geant4 provides utility functions to convert between internal and human readable units.
For printing values with preferred units you can use:
#include "G4SystemOfUnits.hh"
#include "G4UnitsTable.hh"
G4double energy = 5*MeV;
G4cout << "Energy = " << G4BestUnit(energy, "Energy") << G4endl;
G4double length = 150*cm;
G4cout << "Length = " << G4BestUnit(length, "Length") << G4endl;
Useful categories for G4BestUnit include "Length", "Energy", "Time", "Volumic Mass" for density, and "Dose".
You can also force a specific unit by dividing:
G4cout << "Energy (MeV) = " << energy/MeV << G4endl;
G4cout << "Length (cm) = " << length/cm << G4endl;
To print a value in specific units divide by that unit, for example value/MeV or value/cm.
G4BestUnit chooses a human friendly scale automatically but you must still pass the correct quantity type string.
Typical Code Patterns
This section shows concise patterns you will reuse in most applications.
Setting geometry sizes:
G4double worldSizeXYZ = 1.0*m;
G4Box* solidWorld = new G4Box("World", 0.5*worldSizeXYZ, 0.5*worldSizeXYZ, 0.5*worldSizeXYZ);Defining cuts and energies:
G4double cutValue = 1.0*mm;
SetCutValue(cutValue, "gamma");
G4double primaryEnergy = 662*keV;
particleGun->SetParticleEnergy(primaryEnergy);Working with positions and times:
G4ThreeVector pos(0.0, 0.0, -10*cm);
particleGun->SetParticlePosition(pos);
G4double t = step->GetPreStepPoint()->GetGlobalTime();
G4double t_ns = t/ns;Dose and density:
G4double density = 1.0*g/cm3;
G4double dose = edep / mass; // edep in joule, mass in kg, result in gray
Whenever you see a dimensional quantity in your code, stop and check that it is multiplied or divided by the correct Geant4 unit constant.
Systematic unit mistakes are among the most common and hardest to debug problems in Geant4 simulations.
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!