Back to home page

EIC code displayed by LXR

 
 

    


Warning, /geant4/examples/extended/exoticphysics/monopole/README is written in an unsupported language. File is not indexed.

0001 -------------------------------------------------------------------
0002 
0003      =========================================================
0004      Geant4 - an Object-Oriented Toolkit for Simulation in HEP
0005      =========================================================
0006 
0007                             monopole
0008                             --------
0009                   V.Ivanchenko, M.Vladymyrov
0010                   CERN,  Geneva, Switzerland
0011           Lebedev Physical Institute, Moscow, Russia
0012 
0013 
0014 This example is devoted to the energy deposited by classical magnetic
0015 monopole.
0016 
0017 
0018 
0019  1- GEOMETRY DEFINITION
0020 
0021      The geometry consists of a single block of a homogenous material,
0022      placed in a world.
0023 
0024      Four parameters define the geometry :
0025         - the material of the box 
0026         - the thickness of the box 
0027         - the tranverse dimension of the box 
0028         - the maximal step size in target
0029 
0030      The default is 10 cm of alumunium, step is limited by 5mm.
0031      Equivalent UI commands are following:
0032         /testex/det/setMat G4_Al
0033         /testex/det/sizeX  10 cm
0034         /testex/det/sizeYZ 5 cm
0035         /testex/det/setStepSize 5 mm
0036 
0037      The default geometry is constructed in DetectorConstruction class,
0038      but all of the above parameters can be changed interactively via
0039      the commands defined in the DetectorMessenger class. 
0040 
0041      In addition, a global, uniform, and transverse magnetic field can be applied
0042      via G4MonopoleFieldSetup class, with the default z-value 0.2 tesla.
0043      This value can be changed via UI command:
0044         /testex/fld/setField 0.2 tesla
0045 
0046  2- PHYSICS LIST
0047 
0048     The physics list includes standard FTFP_BERT physics and the additional builder
0049     or monopole physics.
0050     To define monopole parameters an extra string should be provided via 
0051     the program arguments:
0052          ./monopole -s '2 0 200 GeV'              # in the interactive mode
0053          ./monopole -m file.mac -s '2 0 200 GeV'  # in the batch mode
0054 
0055  3- AN EVENT : THE PRIMARY GENERATOR
0056 
0057      The primary kinematic consists of a single particle which hits the
0058      block perpendicular to the input face. The type of the particle
0059      and its energy are set in the PrimaryGeneratorAction class, and can
0060      changed via the G4 build-in commands of ParticleGun class (see
0061      the macros provided with this example).
0062      The default is monopole 100 GeV.
0063 
0064  4- VISUALIZATION
0065 
0066      The Visualization Manager is set in the main() for interactive session,
0067      the initial parameters of the program are defined in the init_vis.mac macro
0068      which then executes the visualisation macro, vis.mac.
0069 
0070      The detector has a default view which is a longitudinal view of the box.
0071      
0072      The tracks are drawn at the end of event, and erased at the end of run.
0073 
0074 
0075  5- HOW TO RUN ?
0076 
0077     This example handles the program arguments in a similar way as the basic 
0078     B4 example.
0079     It can be run with the following optional arguments:
0080     % ./monopole [-m macro ] [-s setupMonopole] [-t nThreads]
0081     
0082     The -s option was already explained in the Physics list section. 
0083     The -t option is available only in multi-threading mode
0084     and it allows the user to override the Geant4 default number of 
0085     threads. The number of threads can be also set via G4FORCENUMBEROFTHREADS
0086     environment variable which has the top priority.
0087  
0088      - Execute program  in the 'batch' mode from macro files
0089         % ./monopole  -m monopole.in [-s setupMonopole]
0090 
0091      - Execute program  in the 'interactive mode' with visualization
0092         % ./monopole [-s setupMonopole]
0093                 ....
0094         Idle> type your commands
0095                 ....
0096         Idle> exit
0097 
0098 
0099  6- HISTOGRAMS
0100 
0101      The result is five histograms:
0102                                 - Monopole eneregy deposition in current material
0103                                 - dedx for proton
0104                                 - dedx for monopole
0105                                 - range for proton in current material
0106                                 - range for monopole in current material
0107 
0108      The histogram is saved in Root file.
0109                  Limit of bin size can be set with testex/run/binSize (default 5mm). Real size
0110                  is chosen as a minimal between this and step limit (see Geometry section)
0111