1 |
- HOW-TO-DIGIT, or "how to learn the PAMELA Digitizer in 5 minutes" |
2 |
- Creation: October 2007 |
3 |
- main contribution: S. Bottai |
4 |
- author: S. Orsi |
5 |
|
6 |
1) Install a database dedicated to simulation (if not already installed) : |
7 |
Set the PAMELA enviroment variable. Then set variable for the dedicated |
8 |
database : |
9 |
unset PAM_DBHOST |
10 |
unset PAM_DBUSER |
11 |
unset PAM_DBPSW |
12 |
|
13 |
export PAM_DBHOST=mysql://nameofmachine/namedatabase |
14 |
(example : PAM_DBHOST=mysql://srv-g2-01.ts.infn.it/pameladigit) |
15 |
export PAM_DBUSER=root |
16 |
export PAM_DBPSW=pameladb |
17 |
|
18 |
2) Create the database for simulation with the script install_GPAMELADB.sh, which is in Profiler |
19 |
directory under docs (you must run it in the dierectory itself or copy in the directory where the sql |
20 |
files are present ). The script will create the database and fill it with the approprate reference to |
21 |
the calibrations files for the simulation. |
22 |
(This is possible only for CVS version after 9/10/2007 , when the calibration files and their link have |
23 |
been put on the repository.) |
24 |
|
25 |
3) Fill the GL_TLE table with "YodaProfiler -tle tle.txt" where the tle.txt file can be found in the |
26 |
Profiler directory under docs |
27 |
|
28 |
4) Run the digitizer : |
29 |
|
30 |
./Pamelagp2Digits namegpamelafile.his |
31 |
|
32 |
It creates the files : |
33 |
namegpamelafile.pam (input for Yoda) |
34 |
namegpamelafile.gp.root (root conversion of namegpamelafile.his) |
35 |
|
36 |
5) Run yoda : |
37 |
yoda namegpamelafile.pam |
38 |
|
39 |
this will produce the file namegpamelafile.root |
40 |
|
41 |
6) Run the Profiler with the option -gpamela |
42 |
YodaProfiler -gpamela -yodaFile namegpamelafile.root |
43 |
It determines automatically the timesync and boot number and fills the database |
44 |
|
45 |
7) You can check the entry in the database with the |
46 |
R2-D2 -filename nomegpamelafile.root |
47 |
which tells you the idRun automatically associated |
48 |
|
49 |
8) Run DarthVader. |
50 |
Some examples of usage: |
51 |
|
52 |
DarthVader -zerofill -idRun 1 -ALL +RUN +CAL [ --no-crosstalk ] +TRK +TOF +AC +TRG +ND |
53 |
DarthVader -zerofill -idRun 1 +CAL [ --no-crosstalk ] -S4 |
54 |
|
55 |
The previous 2 commands have the same output, i.e. all detectors are included except S4 (the default |
56 |
behaviour includes the option "+ALL"). |
57 |
If the TRK is not present the option --no-tracker must be specified: |
58 |
c) DarthVader -zerofill -idRun 1 -ALL +RUN +CAL [ --no-crosstalk --no-tracker] +AC |
59 |
|
60 |
It is recommended to run DarthVader specifying as output the file namegpamelafile.gp.root (file created |
61 |
by the digitizer, containing the gpamela data in root [see above]). |
62 |
The option "--no-crosstalk" (and "--no-tracker") can be omitted in this case |
63 |
|
64 |
DarthVader -zerofill -idRun 1 -ALL +RUN +CAL +TRK ... -processFile namegpamelafile.gp.root |
65 |
|
66 |
In this way all gpamela info and Level2 info are contained in the same file (namegpamelafile.gp.root). |
67 |
|
68 |
With the latest DarthVader you can also include S4 and ORB without errors (but S4 data will be empty |
69 |
until fully implemented in the Digitizer code). |
70 |
|
71 |
9) Default parameters for simulation are included in DarthVader since 9/10/2007. |
72 |
In case is not possible to use the CVS version after 9/10/2007 you must force DarthVader to use |
73 |
alignment and eta parameters needed by the tracker. |
74 |
This is also possible if for some reason you want to test other sets of parameters. |
75 |
To do this simply write : |
76 |
|
77 |
DarthVader -zerofill -idRun 1 -ALL +RUN +TRK [ -4 /path-to-eta-parameter-for-simulation/ -5 /path-to-] |
78 |
... |
79 |
|
80 |
To load different parameter types you have to use different numbers, according to the same notation of |
81 |
the DB: |
82 |
|
83 |
1 field map |
84 |
2 adc-to-mip |
85 |
3 charge correlation |
86 |
4 position-finding |
87 |
5 alignment |
88 |
6 VA1 mask |
89 |
|
90 |
The default parameters for the simulation are now in the CVS repository under the directory: |
91 |
|
92 |
DarthVader/param/trk-param/align_param_GP-0/ |
93 |
DarthVader/param/trk-param/eta_param_GP-0/ |
94 |
|
95 |
|
96 |
********* NB: ********** |
97 |
On the machines pamelatov in Roma2 the flags "-lmathlib -lpacklib -lkernlib" must be present in the |
98 |
Make file: |
99 |
LDFLAGS = -g -lmathlib -lpacklib -lkernlib -llapack -lg2c -lm -lnsl -lcrypt -L/cern/2005/lib |
100 |
On other machines (for example pamelaws02 in Naples) the digitizer does not compile if the same flags |
101 |
are speficied, so they should be removed. |