Update AMORE instruction for PMD:sjena
[u/mrichter/AliRoot.git] / PMD / info / pmd_amore.txt
1 AMORE MODULE FOR the PMD
2 ++++++++++++++++++++++++++
3 This is a brief note on pmd amrore:
4  - the codes
5  - how to's P@2
6
7
8 Please let me know when you need to 
9 change it
10  
11 Author: Satyajit Jena
12 Date: 14 Nov 2009
13 Fri Jan 16 14:20:05 CET 2015
14
15 ++++++++++++++++++++++++++
16 Code Structures
17 ++++++++++++++++++++++++++
18
19 PMD Amore runs Using ALICE offline QA in
20 aliroot. The main codes are 
21
22 AliPMDQAChecker.cxx     
23 AliPMDQADataMakerRec.cxx 
24 AliPMDQADataMakerSim.cxx
25
26 and we have following objects in the QA 
27 (Related to Data only)
28
29 Frequency Distributions for each DDL
30
31 hDdl2304
32 hDdl2305
33 hDdl2308
34 hDdl2309
35
36 XY - Display for each Plan
37 hPreXY
38 hCpvXY
39
40 Multiplicity Plots:
41 hPmdMultiplicityP
42 hPmdMultiplicityC
43
44 Quality Plots:
45
46 hPmdQualityWAdc: The wighted ADC over two DDLs in a same plane ( divided in 20 eta rings - 10 each plane) 
47 hPmdQualityHit : The total hits over two DDLs in a same plane ( divided in 20 eta rings - 10 each plane)
48
49 ++++++++++++++++++++++++++
50 Running at P@2
51 ++++++++++++++++++++++++++
52
53 A detail information can be found at 
54 https://aliceinfo.cern.ch/DAQ/node/739
55
56 (Please send me info to edit it if needed)
57
58 ==== to start GUI
59
60 From any ACR machine, you can connect to a dqm node by doing
61
62 shdqm PMDQA
63
64 - another terminal you open 
65
66    amore -d EVE -m GenericGui
67
68 it will pop up with amore screen.
69
70 - PMD agent is now visible in the tree and locate the objects
71
72 - Optionally, to see only PMD agent in the tree, type PMD in the filter field
73
74 - Select the histos by double clicking corresponding name from amore tree.
75
76 NOTE: By default, it will pick data from amoreAgent PMDShifter. 
77 Which is link to DQM QA checkers. But instantaneously we can 
78 launch our own agent. it will not crash with earlier one. 
79 if want to do so, then do following before lunching GUI.
80
81 To start the agent (this is for expert plots):
82
83 1. connect to DQM server 
84 2. Type :amoreAgent -a PMDQA
85 3. keep it running
86 4. follow the above steps GUI. 
87
88
89 Don't Use it!! Experts only
90 to see the all amore agents running
91 dumpAmoreDbs | grep PMD
92
93 ++++++++++++++++++++++++++
94 During Operation at P@2
95 ++++++++++++++++++++++++++
96
97 For the Central Shifter following two plots should be
98 ok to judge PMD quality
99
100 hPmdQualityWAdc: The wighted ADC over two DDLs in a same plane ( divided in 20 eta rings - 10 each plane) 
101 hPmdQualityHit : The total hits over two DDLs in a same plane ( divided in 20 eta rings - 10 each plane)
102
103 The ratio (hit and adc weighted hit) of two ddls in same plane. 
104 => this produces four combinations, but for simplicity it merged to two histograms 
105 => zones are leveled in the plot itself.
106 => The marker should stay between 1 to 4 in y-axis. Because of asymmetric hits these 
107    value might oscillate very fast, however if these value stay at 1 for a long time 
108    ( 10 minutes - then on-call should be called ) => Briefly this if it stay at 1 
109     for long time then DDLs are sending blank data.
110
111 => PMD HI: Expected 150Kb/evt if more pedestal run is required. PMD PP: 
112         Event Size 8 Kbs/event Can go upto 15Kbs if more pedestal run is required.
113
114 => During cosmic runs and technical runs we mostly collect noise so these references 
115 may not be of good quality.
116
117 => Please wait until at least three cycle to declare PMD quality as bad.
118
119
120 ++++++++++++++++++++++++++
121 Links and contacts
122 ++++++++++++++++++++++++++
123
124
125 In case any trouble please contact PMD oncall and PMD experts
126
127 - PMD twiki:https://twiki.cern.ch/twiki/bin/view/ALICE/AMORE
128 - PMDEVE:   https://twiki.cern.ch/twiki/bin/view/ALICE/EVEPMD
129 - DQM Guide: https://twiki.cern.ch/twiki/bin/viewauth/ALICE/DQMShiftersGuide
130 - Detail Amore Manual: https://aliceinfo.cern.ch/DAQ/products/amore-modules-developer-manual
131
132 Please feel free to contact me (sjena@cern.ch, satya.ino@gmail.com) to know
133 more or in case of any trouble.