| Geant4 Cross Reference |
1 ---------------------------------------------- 1 -------------------------------------------------------------------
>> 2 $Id: README 73614 2013-09-02 10:16:16Z gcosmo $
2 ---------------------------------------------- 3 -------------------------------------------------------------------
3 4
4 ========================================= 5 =========================================================
5 Geant4 - Nanobeam example 6 Geant4 - Nanobeam example
6 ========================================= 7 =========================================================
7 8
8 README file 9 README file
9 -------------------- 10 ----------------------
10 11
11 CORRESPONDING AUTHO 12 CORRESPONDING AUTHOR
12 13
13 S. Incerti (a, *) et al. 14 S. Incerti (a, *) et al.
14 a. Centre d'Etudes Nucleaires de Bordeaux-Grad 15 a. Centre d'Etudes Nucleaires de Bordeaux-Gradignan
15 (CENBG), IN2P3 / CNRS / Bordeaux 1 University, 16 (CENBG), IN2P3 / CNRS / Bordeaux 1 University, 33175 Gradignan, France
16 * e-mail:incerti@cenbg.in2p3.fr 17 * e-mail:incerti@cenbg.in2p3.fr
17 18
18 ---->1. INTRODUCTION. 19 ---->1. INTRODUCTION.
19 20
20 The nanobeam example simulates the beam optics 21 The nanobeam example simulates the beam optics of the nanobeam line installed
21 on the AIFIRA electrostatic accelerator facili 22 on the AIFIRA electrostatic accelerator facility located at CENBG,
22 Bordeaux-Gradignan, France. For more informati 23 Bordeaux-Gradignan, France. For more information on this facility,
23 please visit : 24 please visit :
24 http://www.cenbg.in2p3.fr/ 25 http://www.cenbg.in2p3.fr/
25 26
26 The code can be used to calculate : 27 The code can be used to calculate :
27 1) intrinsic aberration coefficients of the na 28 1) intrinsic aberration coefficients of the nanobeam line
28 2) beam image from a relasitic primary emittan 29 2) beam image from a relasitic primary emittance distribution
29 3) grid shadow images 30 3) grid shadow images
30 31
31 Three quadrupole field models can be used : 32 Three quadrupole field models can be used :
32 - a simple square field model 33 - a simple square field model
33 - a 3D mesh field model computed from OPERA3D 34 - a 3D mesh field model computed from OPERA3D
34 - an analytical model based on Enge's model 35 - an analytical model based on Enge's model
35 36
36 ---->2. GEOMETRY SET-UP. 37 ---->2. GEOMETRY SET-UP.
37 38
38 The full magnetic configuration of the nanobea 39 The full magnetic configuration of the nanobeam line is simulated.
39 This configuration is made of a combination of 40 This configuration is made of a combination of a doublet and triplet of
40 5 Oxford Microbeams Ltd. OM50 quadrupoles. 41 5 Oxford Microbeams Ltd. OM50 quadrupoles.
41 42
42 More details on the experimental setup and its 43 More details on the experimental setup and its simulation with Geant4 can
43 be found in the following papers: 44 be found in the following papers:
44 45
45 - A DETAILED RAY-TRACING SIMULATION OF THE HIG 46 - A DETAILED RAY-TRACING SIMULATION OF THE HIGH RESOLUTION MICROBEAM AT THE
46 AIFIRA FACILITY 47 AIFIRA FACILITY
47 By F. Andersson, Ph. Barberet, S. Incerti, Ph. 48 By F. Andersson, Ph. Barberet, S. Incerti, Ph. Moretto
48 Published in Nucl.Instrum.Meth.B266:1653-1658, 49 Published in Nucl.Instrum.Meth.B266:1653-1658, 2008
49 50
50 - MONTE CARLO SIMULATION OF THE CENBG MICROBEA 51 - MONTE CARLO SIMULATION OF THE CENBG MICROBEAM AND NANOBEAM LINES WITH THE
51 GEANT4 TOOLKIT 52 GEANT4 TOOLKIT
52 By S. Incerti, Q. Zhang, F. Andersson, Ph. Mor 53 By S. Incerti, Q. Zhang, F. Andersson, Ph. Moretto, G.W. Grime,
53 M.J. Merchant, D.T. Nguyen, C. Habchi, T. Pout 54 M.J. Merchant, D.T. Nguyen, C. Habchi, T. Pouthier and H. Seznec
54 Published in Nucl.Instrum.Meth.B260:20-27, 200 55 Published in Nucl.Instrum.Meth.B260:20-27, 2007
55 56
56 - GEANT4 SIMULATION OF THE NEW CENBG MICRO AND 57 - GEANT4 SIMULATION OF THE NEW CENBG MICRO AND NANO PROBES FACILITY
57 By S. Incerti, C. Habchi, Ph. Moretto, J. Oliv 58 By S. Incerti, C. Habchi, Ph. Moretto, J. Olivier and H. Seznec
58 Published in Nucl.Instrum.Meth.B249:738-742, 2 59 Published in Nucl.Instrum.Meth.B249:738-742, 2006
59 60
60 - A COMPARISON OF RAY-TRACING SOFTWARE FOR THE 61 - A COMPARISON OF RAY-TRACING SOFTWARE FOR THE DESIGN OF QUADRUPOLE MICROBEAM
61 SYSTEMS 62 SYSTEMS
62 By S. Incerti et al., 63 By S. Incerti et al.,
63 Published in Nucl.Instrum.Meth.B231:76-85, 200 64 Published in Nucl.Instrum.Meth.B231:76-85, 2005
64 65
65 ---->3 VISUALIZATION 66 ---->3 VISUALIZATION
66 67
67 Visualization has not been implemented. 68 Visualization has not been implemented.
68 69
69 ---->4. HOW TO RUN THE EXAMPLE 70 ---->4. HOW TO RUN THE EXAMPLE
70 71
71 1) You must have compiled your Geant4 installa 72 1) You must have compiled your Geant4 installation with the FULL version of the
72 CLHEP library which can handle matrix operatio 73 CLHEP library which can handle matrix operations.
73 74
74 2) The code should be compiled cmake and run w 75 2) The code should be compiled cmake and run with :
75 76
76 ./nanobeam 77 ./nanobeam
77 78
78 The macro file default.mac is read by default. 79 The macro file default.mac is read by default.
79 80
80 Several macro files are provided: 81 Several macro files are provided:
81 82
82 1) for the computation of intrinsic aberration 83 1) for the computation of intrinsic aberration coefficients :
83 coef-square.mac : using square magnetic field << 84 coef-square.mac : using square magnetic field model (=default.mac)
84 coef-map.mac : using 3D map magnetic field mod 85 coef-map.mac : using 3D map magnetic field model
85 coef-enge.mac : using Enge's analytical field 86 coef-enge.mac : using Enge's analytical field model
86 87
87 2) for the simulation of the beam image with a 88 2) for the simulation of the beam image with a realistic emittance :
88 image-square.mac : using square magnetic field << 89 image-square.mac : using square magnetic field model
89 image-map.mac : using 3D map magnetic field mo 90 image-map.mac : using 3D map magnetic field model
90 image-enge.mac : using Enge's analytical field 91 image-enge.mac : using Enge's analytical field model
91 92
92 3) for the simulation of grid shadow images 93 3) for the simulation of grid shadow images
93 grid-square.mac : using square magnetic field 94 grid-square.mac : using square magnetic field model
94 grid-map.mac : using 3D map magnetic field mod 95 grid-map.mac : using 3D map magnetic field model
95 grid-enge.mac : using Enge's analytical field 96 grid-enge.mac : using Enge's analytical field model
96 97
97 These macros files are stored in the ./macros 98 These macros files are stored in the ./macros directory.
98 99
99 To run macros which include *map* in their nam 100 To run macros which include *map* in their name, copy the file OM50.grid
100 into the directory in which you run ./nanobeam 101 into the directory in which you run ./nanobeam.
101 102
102 The code can be run in MT mode, for high stati 103 The code can be run in MT mode, for high statistics image simulation.
103 Do not use MT for aberration coefficients calc 104 Do not use MT for aberration coefficients calculation (32 rays only are shot).
104 The switch to MT can be made in nanobeam.cc. 105 The switch to MT can be made in nanobeam.cc.
105 106
>> 107
106 ---->5. PHYSICS 108 ---->5. PHYSICS
107 109
108 The example runs with protons with fluctuating 110 The example runs with protons with fluctuating energies around 3 MeV.
109 Standard electromagnetic processes are activat 111 Standard electromagnetic processes are activated by default (corresponding to the
110 Physics builder G4EmStandardPhysics), includin 112 Physics builder G4EmStandardPhysics), including the G4StepLimiter process.
111 113
112 ---->6. SIMULATION OUTPUT AND RESULT ANALYZIS 114 ---->6. SIMULATION OUTPUT AND RESULT ANALYZIS
113 115
114 All results are stored in the nanobeam.root fi 116 All results are stored in the nanobeam.root file and can be displayed with the provided
115 ROOT macro file plot.C: 117 ROOT macro file plot.C:
116 * be sure to have ROOT installed on your machi 118 * be sure to have ROOT installed on your machine
117 * be sure to be in the directory where ROOT ou 119 * be sure to be in the directory where ROOT output files are generated
118 * copy plot.C into this directory 120 * copy plot.C into this directory
119 * launch ROOT by typing root, then under your << 121 * launch ROOT by typing root
120 to execute the macro file << 122 * under your ROOT session, type in : .X plot.C to execute the macro file
121 * or type directly: root plot.X <<
122 123
123 This macro file shows : 124 This macro file shows :
124 - the beam profile along the nanobeam line (on 125 - the beam profile along the nanobeam line (only for the computation of intrinsic
125 coefficients) 126 coefficients)
126 - the beam image (Y vs X) on target 127 - the beam image (Y vs X) on target
127 - the beam emittance (THETA vs X) and (PHY vs 128 - the beam emittance (THETA vs X) and (PHY vs Y) on target
128 - the grid shadow image (option) 129 - the grid shadow image (option)
129 130
130 The output ntuples can be written as xml or cs << 131 The output ntuples can be written as xml or csv files, by uncommenting the
>> 132 appropriate header file in include/Analysis.hh
>> 133 and by leaving all others commented.
131 134
132 ---------------------------------------------- 135 ---------------------------------------------------------------------------
133 136
134 Should you have any enquiry, please do not hes 137 Should you have any enquiry, please do not hesitate to contact:
135 incerti@cenbg.in2p3.fr 138 incerti@cenbg.in2p3.fr