From Laurent:
[u/mrichter/AliRoot.git] / MUON / READMEmapping
1  $Id$
2
3
4  The mapping package
5  ====================
6  
7  See detailed description in ALICE-INT-2003-025.
8
9  Test macros
10  ============
11    cd ../mapping/macro
12    root
13    root [0] .x testMacroName.C    
14                         - see available macros below   
15                    
16    A set of test macros be run at once by test_suite.pl scripts:
17      test_suite.pl      - run all test macros and compare results with
18                           the reference output
19      test_suite_ref.pl  - generates reference output
20                           !! this script will overwrite the refence output
21                              provided with the source;
22                              it should be used only by developers 
23
24    Macros included in the test suite:
25      testReadSector.C
26      testReadMotifType.C
27      testGraphics.C        
28      testSectorFind.C
29      testPlaneFind.C
30      testPrintLimits.C         
31      testExistingPads.C    
32      testPadDimensions.C    
33      testSectorPadIterators.C
34      testMotifTypeIterators.C     
35      testNeighboursPadIterator.C  
36      testAnyPadIterators.C  
37      testPadsUp.C
38      testPlaneAreaIterator.C
39      
40    Other macros (not included in the test suite):
41      testAllIndices.C
42      testUpdateGlobalIndices.C
43    
44
45   Data files format
46   ============
47
48   zones.dat:
49   -------------
50   Describes layout of zones, rows, row segments, subzones, motifs
51
52   SECTOR_DATA
53     number of zones  
54     number of rows  
55     direction of constant pad size (X or Y)
56     offset in X direction
57     offset in Y direction
58   
59   ZONE     
60     number of zone  
61     half legth of pad size in x  
62     half legth of pad size in y
63
64   SUBZONE  
65     motif id  
66     motif type_id       
67
68   ROW_SEGMENT  
69     x offset (in number of pads) 
70     y offset (in number of pads) 
71     row number 
72     nof motifs 
73     first motif position Id
74     step to the next motif position Id (+1 or -1)
75   
76   zones_special.dat:
77   ------------------
78   Describes layout of special row segments (with irregular motifs)
79
80   SECTOR_SPECIAL_DATA
81
82   MOTIF
83     zone id
84     motif id  
85     motif type_id       
86
87   ROW
88     row number
89   
90   PAD_ROWS
91     number of these pad rows in row   
92   
93   PAD_ROW_SEGMENT
94     mumber of pads in the rows segment  
95     motif id  
96     motif position id
97   
98   motifX.dat
99   ----------
100   Describes characteristics of the motif type X
101
102   In lines:
103     Berg number
104     Kapton number
105     Pad number
106     Gassi number
107
108   motifSpecialX.dat
109   ------------------
110   Describes characteristics of the special motif with motif Id X;
111   the special motif caontains pads of different size
112
113   In lines:
114     pad index i (in x)
115     pad index j (in y)
116     half legth of pad size in x  
117     half legth of pad size in y
118   
119   padPosX.dat
120   -----------
121   Maps pad numbers used in the motifX.dat files to
122   the local pad indices (i,j)
123
124   In lines:
125     Pad number
126     pad index i (in x)
127     pad index j (in y)
128   
129   
130