dad59f8ad65767539098469148fa12de9a8bdacf
[u/mrichter/AliRoot.git] / PMD / info / run_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 Now Amore is working on aldaqacr58 pc (PMD ACR PC). 
59 It could be run by simply typing
60
61 amore -d EVE -m GenericGui
62
63 Detailed step to start the gui :
64
65 1. On ACR machine type :
66
67    amore -d EVE -m GenericGui
68
69 it will pop up with amore screen.
70
71 2. PMD agent is now visible in the tree and locate the objects
72
73 3. Optionally, to see only PMD agent in the tree, type PMD in the filter field
74
75 4. Select EDep of corresponding SMs or XY histos by double clicking corresponding name from amore tree.
76
77 In this no way to flush the memory being processed by central QA server.
78
79 NOTE: Default it will pick data from amoreAgentPMDShifter. Which is link to DQM QA 
80 checkers. But instantaneously we can launch our own agent. it will not crash with 
81 earlier one. if so do following before lunching GUI.
82
83 To start the agent :
84 1. connect to DQM server
85 2. Type :amoreAgent -a amoreAgentPMDQA
86
87 Then follow the above steps GUI. 
88
89 ++++++++++++++++++++++++++
90 During Operation at P@2
91 ++++++++++++++++++++++++++
92
93 For the Central Shifter following two plots should be
94 ok to judge PMD quality
95
96 hPmdQualityWAdc: The wighted ADC over two DDLs in a same plane ( divided in 20 eta rings - 10 each plane) 
97 hPmdQualityHit : The total hits over two DDLs in a same plane ( divided in 20 eta rings - 10 each plane)
98
99 The ratio (hit and adc weighted hit) of two ddls in same plane. 
100 => this produces four combinations, but for simplicity it merged to two histograms 
101 => zones are leveled in the plot itself.
102 => The marker should stay between 1 to 4 in y-axis. Because of asymmetric hits these 
103    value might oscillate very fast, however if these value stay at 1 for a long time 
104    ( 10 minutes - then on-call should be called ) => Briefly this if it stay at 1 
105     for long time then DDLs are sending blank data.
106
107 => PMD HI: Expected 150Kb/evt if more pedestal run is required. PMD PP: 
108         Event Size 8 Kbs/event Can go upto 15Kbs if more pedestal run is required.
109
110 => During cosmic runs and technical runs we mostly collect noise so these references 
111 may not be of good quality.
112
113 => Please wait until at least three cycle to declare PMD quality as bad.
114
115
116 ++++++++++++++++++++++++++
117 Links and contacts
118 ++++++++++++++++++++++++++
119
120
121 In case any trouble please contact PMD oncall and PMD experts
122
123 - PMD twiki:https://twiki.cern.ch/twiki/bin/view/ALICE/AMORE
124 - PMDEVE:   https://twiki.cern.ch/twiki/bin/view/ALICE/EVEPMD
125 - DQM Guide: https://twiki.cern.ch/twiki/bin/viewauth/ALICE/DQMShiftersGuide
126 - Detail Amore Manual: https://aliceinfo.cern.ch/DAQ/products/amore-modules-developer-manual
127
128 Please feel free to contact me (sjena@cern.ch, satya.ino@gmail.com) to know
129 more or in case of any trouble.