Project

General

Profile

Wiki » History » Version 6

Alexandre Camsonne, 09/21/2017 11:02 AM

1 1 Alexandre Camsonne
h1. Wiki
2
3 6 Alexandre Camsonne
[[test]]
4 1 Alexandre Camsonne
5
h1. EIC Compton Electron detector talks
6 2 Joshua Hoskins
7
h1. EIC Compton Electron Detector Simulation Analysis Software
8
9
All software is available from my github account (instructions below). Please forward all desired functionality and bug reports to me by filing an issue on github.
10
A great reference to get you started using git can be found here: http://rogerdudler.github.io/git-guide/
11
<pre>
12
Cloning a repository
13
     git clone <repository address>
14
</pre>
15
**Compton Generator**
16 3 Joshua Hoskins
     Required libraries: ROOT (https://root.cern.ch/)
17 2 Joshua Hoskins
     Repository:
18
     https://github.com/jrhosk/EIC-Compton-Generator.git
19
20
<pre>
21
./generator <options>
22
23
--filename <string>      Sets the name of the output file.
24
--polarization <double>  Sets the polarization of the events to be generated. Values range from -1 to 1.
25
--energy <double>        Sets the energy of the incoming electrons.
26
--sigmax <double>        Sets the beam size in the x-direction (cm). 
27
--sigmay <double>        Sets the beam size in the y-direction (cm).
28
--events <int>           The number of events to be generated. 
29
</pre>
30 1 Alexandre Camsonne
31 3 Joshua Hoskins
The only required option is __--events__ The default energy is 5 GeV. The generator is built using Make
32
<pre>
33
     make generator
34
</pre>
35
36
**Compton Asymmetry Fit**
37
     Required libraries: BOOST C++ libraries (http://www.boost.org/doc/libs/1_48_0/index.html), ROOT (https://root.cern.ch/)
38
     Repository:
39
     https://github.com/jrhosk/comptonfit.git
40
<pre>
41
Configuration Files
42
43
The fitting runs using parameters from external configuration files found in config/. You will need to provide at least four config files
44
all of which must end in '.config'. Two magnet files are required for the EIC chicane setup. The files needed and an explanation of
45
what each parameter is can be found below.
46
47
  parameter.config
48
   beam : beam is the beam energy given in GeV
49
   laser: laser energy given in GeV
50
51
  detector
52
   width  : strip width in meters
53
   spacing: strip spacing in meters
54
   theta  : detector tilts in radians
55
   x : detector x position in meters
56
   y : detector y position in meters
57
   z : detector z position in meters
58
59
  magnet
60
   theta : dipole angular tilt in radians
61
   length: dipole length (full) in meters
62
   dipole: dipole strength in T
63
   x : magnet x position in meters
64
   y : magnet y position in meters
65
   z : magnet z position in meters
66
</pre>
67
68
+Installation+
69
Simply unzip the code in your favorite directory and make sure the ROOT and BOOST environment variables are set properly. The current
70
default is /usr/lib64/ and /usr/include/. If your libraries are in a different place you will need to either make a symbolic link
71
or change the directories in the Makefile.
72
73
    make clean && make
74
75
Running the code
76
<pre>
77
   ./comptonfit <options>
78
79
   --graphics                                Enables graphical output.
80
   --residuals                               Calculate and plot residuals of asymmetry fit.
81
   --fit_range     <first strip:last strip>  Define the range of strips over which the fit will be done.
82
   --pol_range     <minimum:max>             Define the range of polarization over which the fit will be done.
83
   --compton_range <minimum:max>             Define the range of compton edge over which the fit will be done.
84
</pre>
85 4 Joshua Hoskins
86
**Compton Analysis**
87
     Required libraries: BOOST C++ libraries (http://www.boost.org/doc/libs/1_48_0/index.html), ROOT (https://root.cern.ch/)
88
     Repository:
89
     https://github.com/jrhosk/eic_compton_analysis.git
90
91
+Installation+
92
Simply unzip the code in your favorite directory and make sure the ROOT and BOOST environment variables are set properly. The current
93
default is /usr/lib64/ and /usr/include/. If your libraries are in a different place you will need to either make a symbolic link
94
or change the directories in the Makefile.
95
96
    make analysis
97
98
Running the code
99
<pre>
100
   ./analysis <options>
101
102
         --graphics                      Graphical output flag.
103
         --file <file name>              Defines input root file.
104
         --output-file  <file name>      Defines output root file.
105
         --compton-weight                Weighting flag.
106
         --halo-weight                   Weighting flag.
107
         --background-weight             Weighting flag.
108
         --polarization  <polarization>  Beam polarization.
109
         --energy        <energy GeV>    Beam energy.
110
         --aperture-size <size cm>       Beam energy.
111
</pre>