Project

General

Profile

Wiki » History » Version 3

Joshua Hoskins, 09/19/2017 11:30 AM

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