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