Default Parameters

The following parameters are built-in by default. They are actually compiled into the code rather than set from a parameter file, so that all users will always have the same starting set of defaults. You can override any of these parameters in your own files.

Overall program control

i:Ts/Seed = 1 # starting random seed
i:Ts/MaxStepNumber = 1000000 # limit on number of steps before a track is killed
i:Ts/MaxInterruptedHistories = 10 # limit on how many histories can throw rare Geant4 errors
b:Ts/DumpParameters = "False" # Set true to dump full set of parameters to html file TopasParameterDump_Run0.html
b:Ts/DumpNonDefaultParameters = "False" # Like above but omits defaults
b:Ts/ListUnusedParameters = "False" # Set true to list unused parameters on the console
i:Ts/ShowHistoryCountAtInterval = 1 # How often to print history count to the console
b:Ts/ShowHistoryCountLessFrequentlyAsSimulationProgresses = "False" # Counts by 1, then by 10, then by 100, etc.
i:Ts/MaxShowHistoryCountInterval = "2147483647" # Stops increasing count interval after this limit
b:Ts/ShowHistoryCountOnSingleLine = "False" # Set true to make history count reuse same line of console
b:Ts/IncludeTimeInHistoryCount = "False" # Adds time stamp to history count
i:Ts/RunIDPadding = 4 # pad Run ID numbers to this many places in file names
b:Ts/PauseBeforeInit = "False" # Pause for Geant4 commands before initialization
b:Ts/PauseBeforeSequence = "False" # Pause for Geant4 commands before run sequence
b:Ts/PauseBeforeQuit = "False" # Pause for Geant4 commands before quitting
i:Ts/RunVerbosity = 0 # Set to larger integer to see details of run. Maximum is 2
i:Ts/EventVerbosity = 0 # Set to larger integer to see details of event. Maximum is 5
i:Ts/TrackingVerbosity = 0 # Set to larger integer to see details of tracking
i:Ts/SequenceVerbosity = 0 # Set to larger integer to see details of TOPAS run sequence
b:Ts/QuitIfManyHistoriesSeemAnomalous = "True" # Quits if Geant4 warnings issued on too many histories
i:Ts/NumberOfAnomalousHistoriesToAllowInARow = 10000 # Limit for above
b:Ts/RestoreResultsFromFile = "False" # Re-reads previous results to allow new output format or outcome modeling
i:Ts/NumberOfThreads = 1 # Number of CPU threads to which work will be distributed
b:Ts/BufferThreadOutput = "False" # Causes console output to be show one thread at a time
b:Ts/TreatExcitedIonsAsGroundState = "False" # Allows you to read back in excited ions in a phase space file
s:Ts/G4DataDirectory = "" # Specify path to Geant4 Data files (instead of having to set environment variable)

Overall timeline control

b:Tf/RandomizeTimeDistribution = "False" # Causes each history to be at a different time sampled from timeline
d:Tf/TimelineStart = 0. s
d:Tf/TimelineEnd = Tf/TimelineStart s
i:Tf/NumberOfSequentialTimes = 1
i:Tf/Verbosity = 0 # set to 1 to generate time log, set to 2 to get detailed update messages

Optional checks on correctness of geometry

b:Ge/CheckForOverlaps = "True"
b:Ge/CheckInsideEnvelopesForOverlaps = "False" # Speeds up checking by assuming inner parts of components are OK
i:Ge/CheckForOverlapsResolution = 1000
d:Ge/CheckForOverlapsTolerance = 0. mm
b:Ge/QuitIfOverlapDetected = "True"
i:Ge/NumberOfPointsPerOverlapCheck = 100
b:Ge/CheckForUnusedComponents = "True"

Top level geometry component, the World Volume

s:Ge/World/Type = "TsBox"
s:Ge/World/Material = "Air"
d:Ge/World/HLX = 5. m # Half Length
d:Ge/World/HLY = 5. m
d:Ge/World/HLZ = 5. m
d:Ge/World/TransX = 0. m
d:Ge/World/TransY = 0. m
d:Ge/World/TransZ = 0. m
d:Ge/World/RotX = 0. deg
d:Ge/World/RotY = 0. deg
d:Ge/World/RotZ = 0. deg

Demo Beam position

s:Ge/BeamPosition/Parent = "World"
s:Ge/BeamPosition/Type = "Group"
d:Ge/BeamPosition/TransX = 0. m
d:Ge/BeamPosition/TransY = 0. m
d:Ge/BeamPosition/TransZ =  Ge/World/HLZ m
d:Ge/BeamPosition/RotX = 180. deg
d:Ge/BeamPosition/RotY = 0. deg
d:Ge/BeamPosition/RotZ = 0. deg

Demo Particle Source

s:So/Demo/Type = "Beam" # Beam, Isotropic, Emittance or PhaseSpace
s:So/Demo/Component = "BeamPosition"
s:So/Demo/BeamParticle = "proton"
d:So/Demo/BeamEnergy = 169.23 MeV
u:So/Demo/BeamEnergySpread = 0.757504
s:So/Demo/BeamPositionDistribution = "Gaussian" # Flat or Gaussian
s:So/Demo/BeamPositionCutoffShape = "Ellipse" # Point, Ellipse, Rectangle or Isotropic
d:So/Demo/BeamPositionCutoffX = 10. cm
d:So/Demo/BeamPositionCutoffY = 10. cm
d:So/Demo/BeamPositionSpreadX = 0.65 cm
d:So/Demo/BeamPositionSpreadY = 0.65 cm
s:So/Demo/BeamAngularDistribution = "Gaussian" # Flat or Gaussian
d:So/Demo/BeamAngularCutoffX = 90. deg
d:So/Demo/BeamAngularCutoffY = 90. deg
d:So/Demo/BeamAngularSpreadX = 0.0032 rad
d:So/Demo/BeamAngularSpreadY = 0.0032 rad
i:So/Demo/NumberOfHistoriesInRun = 0
i:So/Demo/NumberOfHistoriesInRandomJob = 0

Physics

s:Ph/ListName = "Default"
b:Ph/ListProcesses = "False" # Set true to dump list of active physics processes to console
s:Ph/Default/Type = "Geant4_Modular"
sv:Ph/Default/Modules = 6 "g4em-standard_opt4" "g4h-phy_QGSP_BIC_HP" "g4decay" "g4ion-binarycascade" "g4h-elastic_HP" "g4stopping"
d:Ph/Default/EMRangeMin = 100. eV
d:Ph/Default/EMRangeMax = 500. MeV

Scoring

b:Sc/AddUnitEvenIfItIsOne = "False" # If unit is 1, rather than, say, Gy, default is to leave out unit in header.
s:Sc/RootFileName = "topas" # name for root output files
s:Sc/XmlFileName = "topas" # name for xml output files

Graphics

b:Gr/Enable = "True" # Set False to avoid instantiating any part of Geant4 visualization system (useful for running on batch machines that lack the OpenGL graphics library)
i:Gr/Verbosity = 0 # Set to higher integer to increase verbosity of Geant4 visualization system
s:Gr/RefreshEvery = "Run" # "History", "Run" or "Session"
i:Gr/ShowOnlyOutlineIfVoxelCountExceeds = 8000 # Above this limit, only show outer box
i:Gr/SwitchOGLtoOGLIifVoxelCountExceeds = 70000000 # Above this limit, switch OpenGL Graphics to Immediate mode

Elements

s:El/Hydrogen/Symbol = "H"
s:El/Helium/Symbol = "He"
s:El/Lithium/Symbol = "Li"
s:El/Beryllium/Symbol = "Be"
s:El/Boron/Symbol = "B"
s:El/Carbon/Symbol = "C"
s:El/Nitrogen/Symbol = "N"
s:El/Oxygen/Symbol = "O"
s:El/Fluorine/Symbol = "F"
s:El/Neon/Symbol = "Ne"
s:El/Sodium/Symbol = "Na"
s:El/Magnesium/Symbol = "Mg"
s:El/Aluminum/Symbol = "Al"
s:El/Silicon/Symbol = "Si"
s:El/Phosphorus/Symbol = "P"
s:El/Sulfur/Symbol = "S"
s:El/Chlorine/Symbol = "Cl"
s:El/Argon/Symbol = "Ar"
s:El/Potassium/Symbol = "K"
s:El/Calcium/Symbol = "Ca"
s:El/Scandium/Symbol = "Sc"
s:El/Titanium/Symbol = "Ti"
s:El/Vanadium/Symbol = "V"
s:El/Chromium/Symbol = "Cr"
s:El/Manganese/Symbol = "Mn"
s:El/Iron/Symbol = "Fe"
s:El/Cobalt/Symbol = "Co"
s:El/Nickel/Symbol = "Ni"
s:El/Copper/Symbol = "Cu"
s:El/Zinc/Symbol = "Zn"
s:El/Gallium/Symbol = "Ga"
s:El/Germanium/Symbol = "Ge"
s:El/Arsenic/Symbol = "As"
s:El/Selenium/Symbol = "Se"
s:El/Bromine/Symbol = "Br"
s:El/Krypton/Symbol = "Kr"
s:El/Rubidium/Symbol = "Rb"
s:El/Strontium/Symbol = "Sr"
s:El/Yttrium/Symbol = "Y"
s:El/Zirconium/Symbol = "Zr"
s:El/Niobium/Symbol = "Nb"
s:El/Molybdenum/Symbol = "Mo"
s:El/Technetium/Symbol = "Tc"
s:El/Ruthenium/Symbol = "Ru"
s:El/Rhodium/Symbol = "Rh"
s:El/Palladium/Symbol = "Pd"
s:El/Silver/Symbol = "Ag"
s:El/Cadmium/Symbol = "Cd"
s:El/Indium/Symbol = "In"
s:El/Tin/Symbol = "Sn"
s:El/Antimony/Symbol = "Sb"
s:El/Tellurium/Symbol = "Te"
s:El/Iodine/Symbol = "I"
s:El/Xenon/Symbol = "Xe"
s:El/Caesium/Symbol = "Cs"
s:El/Barium/Symbol = "Ba"
s:El/Lanthanum/Symbol = "La"
s:El/Cerium/Symbol = "Ce"
s:El/Praseodymium/Symbol = "Pr"
s:El/Neodymium/Symbol = "Nd"
s:El/Promethium/Symbol = "Pm"
s:El/Samarium/Symbol = "Sm"
s:El/Europium/Symbol = "Eu"
s:El/Gadolinium/Symbol = "Gd"
s:El/Terbium/Symbol = "Tb"
s:El/Dysprosium/Symbol = "Dy"
s:El/Holmium/Symbol = "Ho"
s:El/Erbium/Symbol = "Er"
s:El/Thulium/Symbol = "Tm"
s:El/Ytterbium/Symbol = "Yb"
s:El/Lutetium/Symbol = "Lu"
s:El/Hafnium/Symbol = "Hf"
s:El/Tantalum/Symbol = "Ta"
s:El/Tungsten/Symbol = "W"
s:El/Rhenium/Symbol = "Re"
s:El/Osmium/Symbol = "Os"
s:El/Iridium/Symbol = "Ir"
s:El/Platinum/Symbol = "Pt"
s:El/Gold/Symbol = "Au"
s:El/Mercury/Symbol = "Hg"
s:El/Thallium/Symbol = "Tl"
s:El/Lead/Symbol = "Pb"
s:El/Bismuth/Symbol = "Bi"
s:El/Polonium/Symbol = "Po"
s:El/Astatine/Symbol = "At"
s:El/Radon/Symbol = "Rn"
s:El/Francium/Symbol = "Fr"
s:El/Radium/Symbol = "Ra"

Materials

s:Ma/DefaultColor = "white"
i:Ma/Verbosity = 0 # Set to 1 to report each time a material is defined

sv:Ma/Vacuum/Components = 4 "Carbon" "Nitrogen" "Oxygen" "Argon"
uv:Ma/Vacuum/Fractions = 4 0.000124 0.755268 0.231781 0.012827
d:Ma/Vacuum/Density = 1.0E-25 g/cm3
s:Ma/Vacuum/State = "Gas"
d:Ma/Vacuum/Temperature = 2.73 kelvin
d:Ma/Vacuum/Pressure = 3.0E-18 pascal
s:Ma/Vacuum/DefaultColor = "skyblue"

sv:Ma/Carbon/Components = 1 "Carbon"
uv:Ma/Carbon/Fractions = 1 1.0
d:Ma/Carbon/Density = 1.867 g/cm3
d:Ma/Carbon/MeanExcitationEnergy = 78 eV
s:Ma/Carbon/DefaultColor = "green"

sv:Ma/Aluminum/Components = 1 "Aluminum"
uv:Ma/Aluminum/Fractions = 1 1.0
d:Ma/Aluminum/Density = 2.6989 g/cm3
s:Ma/Aluminum/DefaultColor = "skyblue"
i:Ma/Aluminum/AtomicNumber =  13
d:Ma/Aluminum/AtomicMass = 26.98154 g/mole

sv:Ma/Nickel/Components = 1 "Nickel"
uv:Ma/Nickel/Fractions = 1 1.0
d:Ma/Nickel/Density = 8.902 g/cm3
s:Ma/Nickel/DefaultColor = "indigo"

sv:Ma/Copper/Components = 1 "Copper"
uv:Ma/Copper/Fractions = 1 1.0
d:Ma/Copper/Density = 8.96 g/cm3
s:Ma/Copper/DefaultColor = "orange"

sv:Ma/Iron/Components = 1 "Iron"
uv:Ma/Iron/Fractions = 1 1.0
d:Ma/Iron/Density = 7.87 g/cm3
s:Ma/Iron/DefaultColor = "skyblue"

sv:Ma/Tantalum/Components = 1 "Tantalum"
uv:Ma/Tantalum/Fractions = 1 1.0
d:Ma/Tantalum/Density = 16.654 g/cm3
s:Ma/Tantalum/DefaultColor = "indigo"

sv:Ma/Lead/Components = 1 "Lead"
uv:Ma/Lead/Fractions = 1 1.0
d:Ma/Lead/Density = 11.35 g/cm3
i:Ma/Lead/AtomicNumber =  82
d:Ma/Lead/AtomicMass = 207.19 g/mole
d:Ma/Lead/MeanExcitationEnergy = 823 eV
s:Ma/Lead/DefaultColor = "brown"

sv:Ma/Air/Components = 4 "Carbon" "Nitrogen" "Oxygen" "Argon"
uv:Ma/Air/Fractions = 4 0.000124 0.755268 0.231781 0.012827
d:Ma/Air/Density = 1.20484 mg/cm3
d:Ma/Air/MeanExcitationEnergy = 85.7 eV
s:Ma/Air/DefaultColor = "lightblue"

sv:Ma/Brass/Components = 2 "Copper" "Zinc"
uv:Ma/Brass/Fractions = 2 0.7 0.3
d:Ma/Brass/Density = 8.550 g/cm3
d:Ma/Brass/MeanExcitationEnergy = 324.4 eV
s:Ma/Brass/DefaultColor = "grass"

sv:Ma/Lexan/Components = 3 "Hydrogen" "Carbon" "Oxygen"
uv:Ma/Lexan/Fractions = 3 0.055491 0.755751 0.188758
d:Ma/Lexan/Density = 1.2 g/cm3
d:Ma/Lexan/MeanExcitationEnergy = 73.1 eV
s:Ma/Lexan/DefaultColor = "grey"

sv:Ma/Lucite/Components = 3 "Hydrogen" "Carbon" "Oxygen"
uv:Ma/Lucite/Fractions = 3 0.080538 0.599848 0.319614
d:Ma/Lucite/Density = 1.190 g/cm3
d:Ma/Lucite/MeanExcitationEnergy = 74.0 eV
s:Ma/Lucite/DefaultColor = "grey"

sv:Ma/Mylar/Components = 3 "Hydrogen" "Carbon" "Oxygen"
uv:Ma/Mylar/Fractions = 3 0.041959 0.625017 0.333025
d:Ma/Mylar/Density = 1.40 g/cm3
s:Ma/Mylar/DefaultColor = "red"

sv:Ma/Mylon/Components = 4 "Hydrogen" "Carbon" "Nitrogen" "Oxygen"
uv:Ma/Mylon/Fractions = 4 0.097976 0.636856 0.123779 0.141389
d:Ma/Mylon/Density = 1.140 g/cm3
s:Ma/Mylon/DefaultColor = "purple"

sv:Ma/Kapton/Components = 4 "Hydrogen" "Carbon" "Nitrogen" "Oxygen"
uv:Ma/Kapton/Fractions = 4 0.026362 0.691133 0.073270 0.209235
d:Ma/Kapton/Density = 1.420 g/cm3
s:Ma/Kapton/DefaultColor = "purple"

sv:Ma/Water_75eV/Components = 2 "Hydrogen" "Oxygen"
uv:Ma/Water_75eV/Fractions = 2 0.111894 0.888106
d:Ma/Water_75eV/Density = 1.0 g/cm3
d:Ma/Water_75eV/MeanExcitationEnergy = 75.0 eV
s:Ma/Water_75eV/DefaultColor = "blue"

sv:Ma/Titanium/Components = 1 "Titanium"
uv:Ma/Titanium/Fractions = 1 1.0
d:Ma/Titanium/Density = 4.54 g/cm3
s:Ma/Titanium/DefaultColor = "blue"

sv:Ma/Steel/Components = 8 "Carbon" "Silicon" "Phosphorus" "Sulfur" "Chromium" "Manganese" "Iron" "Nickel"
uv:Ma/Steel/Fractions = 8 0.0015 0.01 0.00045 0.0003 0.19 0.02 0.67775 0.1
d:Ma/Steel/Density = 8.027 g/cm3
s:Ma/Steel/DefaultColor = "lightblue"

Colors

iv:Gr/Color/White =     3 255 255 255
iv:Gr/Color/Silver =    3 191 191 191
iv:Gr/Color/Gray =      3 127 127 127
iv:Gr/Color/Grey =      3 127 127 127
iv:Gr/Color/Black =     3   0   0   0
iv:Gr/Color/Red =       3 255   0   0
iv:Gr/Color/Maroon =    3 127   0   0
iv:Gr/Color/Yellow =    3 255 255   0
iv:Gr/Color/Olive =     3 127 127   0
iv:Gr/Color/Lime =      3   0 255   0
iv:Gr/Color/Green =     3   0 127   0
iv:Gr/Color/Aqua =      3   0 255 255
iv:Gr/Color/Teal =      3   0 127 127
iv:Gr/Color/Blue =      3   0   0 255
iv:Gr/Color/Navy =      3   0   0 127
iv:Gr/Color/Fuchsia =   3 255   0 255
iv:Gr/Color/Purple =    3 127   0 127

iv:Gr/Color/Lightblue = 3 175 255 255
iv:Gr/Color/Skyblue =   3 175 124 255
iv:Gr/Color/Magenta =   3 255   0 255
iv:Gr/Color/Violet =    3 224   0 255
iv:Gr/Color/Pink =      3 255   0 222
iv:Gr/Color/Indigo =    3   0   0 190
iv:Gr/Color/Grass =     3   0 239   0
iv:Gr/Color/Orange =    3 241 224   0
iv:Gr/Color/Brown =     3 225 126  66

iv:Gr/Color/grey020 =   3  20  20  20
iv:Gr/Color/grey040 =   3  40  40  40
iv:Gr/Color/grey060 =   3  60  60  60
iv:Gr/Color/grey080 =   3  80  80  80
iv:Gr/Color/grey100 =   3 100 100 100
iv:Gr/Color/grey120 =   3 120 120 120
iv:Gr/Color/grey140 =   3 140 140 140
iv:Gr/Color/grey160 =   3 160 160 160
iv:Gr/Color/grey180 =   3 180 180 180
iv:Gr/Color/grey200 =   3 200 200 200
iv:Gr/Color/grey220 =   3 220 220 220
iv:Gr/Color/grey240 =   3 240 240 240