5 \page README_mapping README mapping
8 See detailed description in ALICE-INT-2003-025.
11 \section mapping_s1 Graphical User Interface
13 To use the GUI to plot DE segmentation run:
22 new AliMpDEVisu(w, h);
25 if you want to change the size of the GUI window.
28 w = 1200, h = 600 for PC
29 w = 1000, h = 550 for laptop
33 - drawing motif of a slat/quadrant
34 - search of a given manu (motif) number
35 - draw the channel number for a given manu number by clicking of the motif in canvas
36 - write down in log message informations about the given detection element
38 * number of buspatches, manus, manu serials
39 - option to save log message onto disc
41 \section mapping_s2 Test macros
46 root [0] .x testMacroName.C
47 see available macros below
50 A set of test macros be run at once by test_suite.pl scripts:
51 - test_suite.pl - run all test macros and compare results with
53 - test_suite_ref.pl - generates reference output
54 !! this script will overwrite the refence output
55 provided with the source;
56 it should be used only by developers
58 Macros included in the test suite:
67 - testSectorPadIterators.C
68 - testMotifTypeIterators.C
69 - testNeighboursPadIterator.C
70 - testAnyPadIterators.C
72 - testPlaneAreaIterator.C
74 Other macros (not included in the test suite):
76 - testUpdateGlobalIndices.C
79 \section mapping_s3 Data files format
82 \subsection mapping_s3_sub1 zones.dat:
84 Describes layout of zones, rows, row segments, subzones, motifs
90 direction of constant pad size (X or Y)
96 half legth of pad size in x
97 half legth of pad size in y
104 x offset (in number of pads)
105 y offset (in number of pads)
108 first motif position Id
109 step to the next motif position Id (+1 or -1)
113 \subsection mapping_s3_sub2 zones_special.dat:
115 Describes layout of special row segments (with irregular motifs)
129 number of these pad rows in row
132 mumber of pads in the rows segment
138 Describes characteristics of the motif type X
148 \subsection mapping_s3_sub3 motifSpecialX.dat
150 Describes characteristics of the special motif with motif Id X;
151 the special motif caontains pads of different size
157 half legth of pad size in x
158 half legth of pad size in y
161 \subsection mapping_s3_sub4 padPosX.dat
163 Maps pad numbers used in the motifX.dat files to
164 the local pad indices (i,j)
174 \subsection mapping_s3_sub4 *.pcb files
176 Lines starting with # are comments.
179 SIZES PadSizeX PadSizeY SizeX SizeY (cm)
181 MOTIF motifType ix iy
182 MOTIF motifType ix iy
186 where ix, iy are the local coordinates (in pad unit) of the
187 lower-left corner of the motif (0,0 is the lower-left corner
190 PCB *MUST* be described in a rotating way, starting lower-left and
191 then counter-clockwise, otherwise the manu-to-motif association
192 (fixed in the slat definition files) will be wrong.
194 Note that for "full" PCBs, the SizeX and SizeY are redundant as they could be
195 computed from the motif alone (but that serves as a cross-check that the motif
196 pattern given is ok). That's not the case for short or rounded PCB though.
199 \subsection mapping_s3_sub5 *.slat files
201 A slat is defined by the list of its PCB, described starting
202 from the beam and going outward.
204 One PCB per line, preceded by the keyword PCB
205 Other lines not matching this syntax are ignored.
206 After the PCB is the list of manu ids for this PCB.
211 PCB X 1-3;24-20;42;44;53
214 PCB Z 1;2;3;4;5;6;7;12;120
217 defines a slat with 4 PCBs : XXYZ
219 The manu to motif relationship is attached to the fact that we're counting
220 counter-clockwise, starting on the lower-left of the PCB. (and the pcb files
221 have to follow this convention to defined their motifs, otherwise all
224 Note that the definition of the PCBs have to be in files with extension
225 .pcb (X.pcb, Y.pcb, Z.pcb)
228 \subsection mapping_s3_sub6 DetElemIdToBusPatch.dat
230 Lines starting with # are comments.
232 Contains the detection element identifier with the associated buspatch numbers
233 and the corresponding DDL identifier.
234 The link between buspatches and DE's is needed on the rawdata level to identify
235 the type of quadrant/slat to get the corresponding mapping.
236 The DDL id is needed for the rawdata generation only.
238 To generate this file, the macro MUONGenerateBusPatch.C could be used.
241 \subsection mapping_s3_sub7 crate.dat
243 Muon trigger electronics configuration file (decoded in class
244 AliMUONTriggerCrateStore) directly copy/paste from the ALICE PRR
245 ALICE-EN-2003-010. Gives local board number, name,
246 crate name it belongs to, slot number, and internal switches
247 (used in the algorithm).
250 \section mapping_s4 Units used
252 Lengths are in centimeters.