12/6/2011 TAU Monitoring group
Histograms for the SHIFTER
TGC Level-1 Trigger Monitoring
Version 1.1 – preliminary definitions and examples
ABSTRACT
This is a preliminary version of the ATLAS TGC Level-1 Monitoring
manual for the SHIFTER. In this version we will introduce the various
types of SHIFT histograms as well as their basic attributes. Some graphic
examples are also presented here. The various configurations related to
the operation of the histogram presenters from the control room are also
considered here.
1. Introduction
The ATLAS TGC Level-1 Monitoring Histograms are produced inside a machine
called "TGC On-line Monitoring Box" (TomBox) located in point1. Inside the
TomBox there are several modules that run synchronously with a common goal of
producing histograms that monitor the detector. The basic process is to pool
encoded events packets from the detector (more specifically, from the TGC RODs
via the GIGAswitch), then, decode and process these events packets while filling a
predefined set of histograms. Finally, the histograms are being pushed back to the
TDAQ partition in the beginning of the run and later they are being updated in some
rate throughout it. One can use a variety of presenters to view the (sequentially
updated) histograms present in the TDAQ partition. Currently, we are using OHP
and DQMF for monitoring these histograms.
On-line Histogram Presenter (OHP). This is a rather primitive
though quite substantial tool. It merely presents the histograms in a
browser mode or in a tabs mode. Currently, we are not defining any
tabs because it makes it run much slower. OHP can be used without
needing to specify any configuration file. However, it is strongly
recommended to load the configuration file (at any time during a run)
from: /det/tgc/data/gnam/TGC_ohp.conf.xml in point1.
Data Quality Monitoring Framework (DQMF). This is a smart tool
which has active functionalities. It can make data quality examinations
while loading some given algorithms. These algorithms can
automatically determine some desired properties of a given histogram
and correspondingly, send an alert to the shifter when some value
exceeds its permitted range. For the time being the TGC DQMF
agent is nothing more than a primitive presenter (like OHP). It is in our
plans for the near future to develop some alert-algorithms. DQMF also
requires configuration files and the definition of a database. These are
located in: SHOULD COMPLETE
1
12/6/2011 TAU Monitoring group
2. Hierarchies
The starting point will be identifying the TDAQ_PARTITION name, the
PROVIDER name and the ON-LINE HISTOGRAM SERVER name. The later
two are currently set to:
Provider name: TGCGnam-00
On-line Histogram Server name: Histogramming-tgc
The TDAQ_PARTITION name should be chosen according to an ad-hoc run
(usually set to be equal to "ATLAS"). This is done automatically by the DAQ control
in the beginning of the run. These 3 variables are handed to the modules which
process and analyze the events packets (namely, TGCRODSampler and gnam, in the
TomBox) therefore, all the histograms will be published (by these 2 modules) in:
TDAQ_PARTITION → Histogramming-tgc → TGCGnam-00
While navigating through the various histograms, it is likely that all of what the
shifter will see from this prefix is only the provider name.
The bare histograms' names themselves do not depend on these prefixes since they
are being defined without it. Every histogram bare-name must begin with one of the
following prefixes:
/SHIFT/
/EXPERT/
Actually, there are currently only 2 basic types of SHIFT histograms,
corresponding to one hierarchy:
The two SHIFTER-histograms types are:
GlobalChamberStripHit
GlobalChamberWireHit
The hierarchy (inside the PROVIDER) is:
Shift → Side(A/C) → Sector(1-12) → HistogramType
which appears in the presenters as follows:
TGCGnam-00/SHIFT/SIDE_[#]/SECTOR_[#]/GlobalChamberStripHit
TGCGnam-00/SHIFT/SIDE_[#]/SECTOR_[#]/GlobalChamberWireHit
One can note the absence of the Partition name and the On-line Histogram
Server name in this paths
It should be mentioned that there are many other types and hierarchies of
histograms with much higher level of details and resolution, down to the level of a
strip/wire single channel in a single chamber. These correspond to the EXPERT
histograms which are accessible in exactly the same manner (if one wishes to explore
with higher resolution than the SHIFT one), but will not be discussed here.
2
12/6/2011 TAU Monitoring group
3. Histograms
3.1 GlobalChamberStripHit (2D)
TGCGnam-00/SHIFT/SIDE_[#]/SECTOR_[#]/GlobalChamberStripHit
[X] axis: Global Chamber number in one sector (see section 4)
[Y] axis: number of strip-hits received in the chamber with global id=[X]
gnam name: GlobalChamberStripHits[i][k]
An example of the GlobalChamberStripHit histogram as seen in OHP panel in its browser mode. One
can note the mentioned hierarchy, appearing as subfolders in the left of OHP panel.
3
12/6/2011 TAU Monitoring group
3.2 GlobalChamberWireHit (2D)
TGCGnam-00/SHIFT/SIDE_[#]/SECTOR_[#]/GlobalChamberWireHit
[X] axis: Global Chamber number in one sector (see section 4)
[Y] axis: number of wire-hits received in the chamber with global id=[X]
gnam name: GlobalChamberWireHits[i][k]
An example of the GlobalChamberWireHit histogram as seen in OHP panel in its browser mode. One
can note the mentioned hierarchy, appearing as subfolders in the left of OHP panel.
4
12/6/2011 TAU Monitoring group
4. Global Chamber id convention to an exact location
4.1 Conversion software – Global numbering to exact location
*** You might want to skip to section 4.2 to see the actual conversion table ***
The conversion is quite complicated therefore we have written a small-and-
friendly software to get the exact location from a supplied global chamber id.
This is crucial for the SHIFTER histograms since in *all* of them these
numbers span the X axis as can be seen in section 3.1 and 3.2 example
snapshots.
The software is interactive, but it also produces 3 database files (located in the
dada dir) of the conversions (both ways) to view at any time. Of course, there
can be bugs and this is only the preliminary version of it. It is available in lxplus
and in point1 on the TomBox.
It is currently available from LXPLUS in ~hod/public/numbering. You can
run this software without the need to copy or compile it locally. To do that,
follow these simple 4 steps:
-- cd ~hod/public/numbering
-- zsh
-- source setup
-- bin/globalNumbering.exe
If it refuses to be executed, then probably there are some paths missing in your
LD_LIBRARY_PATH. In that case, look at the 'setup' script in the base
directory to add these paths manually.
To view the generated files with all the conversions results:
-- less data/global2local.txt
You can copy this software to your home directory in lxplus and to use it there.
You just have to do:
-- cd to base dir: cd numbering
-- configure the environment: source setup
-- make it: make
-- execute: bin/globalNumbering.exe
We hope that in the future, the presenters themselves will allow viewing the
conversions on-line in a graphical mode.
5
12/6/2011 TAU Monitoring group
4.2 Conversion table – Global numbering to exact location.
This table was produced using the software from 4.1
Global Wheel Layer Chamber Eta Phi
0 1 1 F 5 0
1 1 1 F 5 1
2 1 1 E4 3 0
3 1 1 E4 3 1
4 1 1 E4 3 2
5 1 1 E4 3 3
6 1 1 E3 2 0
7 1 1 E3 2 1
8 1 1 E3 2 2
9 1 1 E3 2 3
10 1 1 E2 1 0
11 1 1 E2 1 1
12 1 1 E2 1 2
13 1 1 E2 1 3
14 1 1 E1 0 0
15 1 1 E1 0 1
16 1 1 E1 0 2
17 1 1 E1 0 3
18 1 2 F 5 0
19 1 2 F 5 1
20 1 2 E4 3 0
21 1 2 E4 3 1
22 1 2 E4 3 2
23 1 2 E4 3 3
24 1 2 E3 2 0
25 1 2 E3 2 1
26 1 2 E3 2 2
27 1 2 E3 2 3
28 1 2 E2 1 0
29 1 2 E2 1 1
30 1 2 E2 1 2
31 1 2 E2 1 3
32 1 2 E1 0 0
33 1 2 E1 0 1
34 1 2 E1 0 2
35 1 2 E1 0 3
36 1 3 F 5 0
37 1 3 F 5 1
38 1 3 E4 3 0
39 1 3 E4 3 1
40 1 3 E4 3 2
41 1 3 E4 3 3
6
12/6/2011 TAU Monitoring group
42 1 3 E3 2 0
43 1 3 E3 2 1
44 1 3 E3 2 2
45 1 3 E3 2 3
46 1 3 E2 1 0
47 1 3 E2 1 1
48 1 3 E2 1 2
49 1 3 E2 1 3
50 1 3 E1 0 0
51 1 3 E1 0 1
52 1 3 E1 0 2
53 1 3 E1 0 3
54 2 4 F 5 0
55 2 4 F 5 1
56 2 4 E5 4 0
57 2 4 E5 4 1
58 2 4 E5 4 2
59 2 4 E5 4 3
60 2 4 E4 3 0
61 2 4 E4 3 1
62 2 4 E4 3 2
63 2 4 E4 3 3
64 2 4 E3 2 0
65 2 4 E3 2 1
66 2 4 E3 2 2
67 2 4 E3 2 3
68 2 4 E2 1 0
69 2 4 E2 1 1
70 2 4 E2 1 2
71 2 4 E2 1 3
72 2 4 E1 0 0
73 2 4 E1 0 1
74 2 4 E1 0 2
75 2 4 E1 0 3
76 2 5 F 5 0
77 2 5 F 5 1
78 2 5 E5 4 0
79 2 5 E5 4 1
80 2 5 E5 4 2
81 2 5 E5 4 3
82 2 5 E4 3 0
83 2 5 E4 3 1
84 2 5 E4 3 2
85 2 5 E4 3 3
86 2 5 E3 2 0
87 2 5 E3 2 1
88 2 5 E3 2 2
7
12/6/2011 TAU Monitoring group
89 2 5 E3 2 3
90 2 5 E2 1 0
91 2 5 E2 1 1
92 2 5 E2 1 2
93 2 5 E2 1 3
94 2 5 E1 0 0
95 2 5 E1 0 1
96 2 5 E1 0 2
97 2 5 E1 0 3
98 3 6 F 5 0
99 3 6 F 5 1
100 3 6 E5 4 0
101 3 6 E5 4 1
102 3 6 E5 4 2
103 3 6 E5 4 3
104 3 6 E4 3 0
105 3 6 E4 3 1
106 3 6 E4 3 2
107 3 6 E4 3 3
108 3 6 E3 2 0
109 3 6 E3 2 1
110 3 6 E3 2 2
111 3 6 E3 2 3
112 3 6 E2 1 0
113 3 6 E2 1 1
114 3 6 E2 1 2
115 3 6 E2 1 3
116 3 6 E1 0 0
117 3 6 E1 0 1
118 3 6 E1 0 2
119 3 6 E1 0 3
120 3 7 F 5 0
121 3 7 F 5 1
122 3 7 E5 4 0
123 3 7 E5 4 1
124 3 7 E5 4 2
125 3 7 E5 4 3
126 3 7 E4 3 0
127 3 7 E4 3 1
128 3 7 E4 3 2
129 3 7 E4 3 3
130 3 7 E3 2 0
131 3 7 E3 2 1
132 3 7 E3 2 2
133 3 7 E3 2 3
134 3 7 E2 1 0
135 3 7 E2 1 1
8
12/6/2011 TAU Monitoring group
136 3 7 E2 1 2
137 3 7 E2 1 3
138 3 7 E1 0 0
139 3 7 E1 0 1
140 3 7 E1 0 2
141 3 7 E1 0 3
142 4 8 F 5 0
143 4 8 E1 0 0
144 4 9 F 5 0
145 4 9 E1 0 0
146 -1 -1 ?? -1 -1
147 -1 -1 ?? -1 -1
148 -1 -1 ?? -1 -1
149 -1 -1 ?? -1 -1
150 -1 -1 ?? -1 -1
151 -1 -1 ?? -1 -1
152 -1 -1 ?? -1 -1
153 -1 -1 ?? -1 -1
154 -1 -1 ?? -1 -1
155 -1 -1 ?? -1 -1
156 -1 -1 ?? -1 -1
157 -1 -1 ?? -1 -1
158 -1 -1 ?? -1 -1
159 -1 -1 ?? -1 -1
160 -1 -1 ?? -1 -1
161 -1 -1 ?? -1 -1
162 -1 -1 ?? -1 -1
163 -1 -1 ?? -1 -1
164 -1 -1 ?? -1 -1
165 -1 -1 ?? -1 -1
166 -1 -1 ?? -1 -1
167 -1 -1 ?? -1 -1
9
12/6/2011 TAU Monitoring group
5. Setting up the system
5.1 From ATLAS Control Room:
5.2 From outside point1:
10