The modules use the HepTuple abstract class, so it may be configured to use Dhp (OST sockets or CORBA) to communicate in shared memory with a browser or simply use HbkTuple to dump histograms in a HBOOK file.
Each module creates its own directory structure, and accepts commands from a .tcl file (see module files for reference); setting a command to TRUE means book and fill histograms in the specified directory. All commands are defaulted to TRUE, except for doXY in the digi module (the histogram is quite large and creates problems with DhpTuple)
NOTE: Cluster histograms have been temporarily removed in version V00-01-00. Please checkout older versions if you need those classes.
sectorCode | "Offline" name | "Geographical" name |
-11 | bwdCapLeftTop | Backward West top |
-10 | bwdCapLeftMiddle | Backward West middle |
-9 | bwdCapLeftBottom | Backward West bottom |
-8 | bwdCapRightTop | Backward East top |
-7 | bwdCapRightMiddle | Backward East middle |
-6 | bwdCapRightBottom | Backward East bottom |
-5 | fwdCapLeftTop | Forward East top |
-4 | fwdCapLeftMiddle | Forward East middle |
-3 | fwdCapLeftBottom | Forward East bottom |
-2 | fwdCapRightTop | Forward West top |
-1 | fwdCapRightMiddle | Forward West middle |
0 | fwdCapRightBottom | Forward West bottom |
1-6 | Barrel sextants | |
7-10 | Inner Cylindrical RPC |
|
Total Strip Multiplicity | |
FEE Occupancy | ||
|
FEC multiplicity by crate (8 histograms) | |
|
Strip multiplicity by FEE (128 histograms or 1 2-D histogram) | |
Strip occupancy by FEE (128 histograms or 1 2-D histogram) | ||
|
FEC occupancy by FEE (128 histograms or 1 2-D histogram) | |
|
Overall Digi Occupancy | |
Chamber Digi Multiplicity | ||
|
Barrel and inner RPC XY front view | |
Barrel sectors, front and side vews (12 histograms) | ||
Doors, top and side vews (8 histograms) | ||
|
Digi occupancy by chamber (22 histograms) | |
Digi multiplicity by chamber (22 histograms) | ||
An example printall.kumac file is supplied in the package to dump all histograms in a postscript file from PAW, with appropriate titles, scale settings, a fancy cover page, bells and whistles; remember it's more than 40 pages. To make the postscript file, supposing you copied the Kumac file to your directory:
You may also want to check the history file.
The module loops over all data items in an event and call the appropriate fill method for each histogram in filling lists for which the event meet the specified criteria. For example, a digi describing a hit in a sector of the Ifr will be sent only the histograms in allDigisList and in the sectorDigiList for that sector.
Accepts doStrip, doFEC, doCrate and compact boolean commands from TCL. compact instructs the module to book 2-D histograms instead of lenghty sets of 1-D, see below for details.
Class name | Directory | HBOOK name | |
IfrFMonStripMultip | Overall strip multiplicity (number of hit strips per event) | Module root | Str.Mltp.Tot. |
IfrFMonStripMultipFEE | Strip multiplicity by FEE, 128 histograms. (number of hit strips per event per IFB/ITB) | Strip directory | Str.Mltp.FEE.nn |
IfrFMonStripMultipFEE2D | Same, but as a 2-D histogram instead of a set of histograms; X is FEE, Y is multiplicity. Booked if compact option is set to true. | Strip directory | Str.Mltp.FEE.2D |
IfrFMonStripOccupFEE | Strip occupancy by FEE, 128 histograms. (each of the 1024 bins is a 'channel' in an IFB/ITB; ITB histograms will be filled only in the first 96 channels) | Strip directory | Str.Occ.FEE.nn |
IfrFMonStripOccupFEE2D | Same, but as a 2-D histogram instead of a set of histograms. Booked if compact option is set to true. | Strip directory | Str.Occ.FEE.2D |
IfrFMonFECOccupFEE | FEC occupancy by FEE, 128 histograms. (each of the 96 bins is a FEC in an ITB/IFB; IFB histograms are filled only in the firs 64 channels) | FEC directory | FEC.Occ.FEE.nn |
IfrFMonFECOccupFEE2D | Same, but as a 2-D histogram instead of a set of histograms. Booked if compact option is set to true. | FEC directory | FEC.Occ.FEE.2D |
IfrFMonFECMultipCrate | FEC multiplicity by crate, 8 histograms (number of FEC with at least 1 hit per event per crate) | Crates directory | FEC.Mltp.Crate.n |
IfrFMonFEEOccup | FEE occupancy (Each channel is a slot in one of the 8 crates; please note that channels corresponding to the ICCs are not filled.) | Module root | FEE.Occup. |
Accepts doXY, doSectors and doMaps commands from TCL.
Class name | Directory | HBOOK name | |
IfrFMonDigiMultip | Overall digi multiplicity | Module root | Digi.Multip. |
IfrFMonDigiMultipCh | Overall Digi multiplicity by chamber ; 22 sector histograms. (2-D: X is layer number, Y is multiplicity) | Sectors | Digi.Mult.Sec.nn |
IfrFMonDigiOccup | Overall Digi occupancy (2-D: X is sector, Y is layer number) | Module root | Digi.Occup. |
IfrFMonDigiOccupSec | Digi occupancy by sector; 22 histograms. (X is layer number) | Sectors | Digi.Occup.Sec.nn |
IfrFMonDigiXY | Barrel digi occupancy, in 2 cm bins, XY global view including inner CylRPC. LARGE histogram! NOT booked by default. | Maps | Digi.ED.XY |
IfrFMonDigiXYSec | Barrel sector digi occupancy, front view; 6 histograms. (X is in cm, Y is layer number) | Maps | Digi.ED.XY.nn |
IfrFMonDigiZSec | Barrel sector digi occupancy, side view; 6 histograms. (X is in cm along the global Z direction, with bin width equal to the strip pitch of 38.5 mm, Y is layer number) | Maps | Digi.ED.Z.nn |
IfrFMonDigiYZDoors | Endcaps digi occupancy by door, side view ; 4 histograms. (X is layer number, Y in cm along the vertical direction with bin width equal to the strip pitch of 28.4 mm) | Maps | Digi.ED.YZ.nn |
IfrFMonDigiXZDoors | Endcaps digi occupancy by door, top view; 4 histograms. (X is layer number, Y in cm along the global X direction with bin width equal to the strip pitch of 38.0 mm; plots are rotated, so that the innermost corner is always in the bottom left corner of the figure) | Maps | Digi.Ed.XZ.nn |
Class name | Directory | HBOOK name | |
IfrFMon1DClustMultip | Overall 1D cluster multiplicity | Module root | |
IfrFMon1DClusterMultipCh | 1D cluster multiplicity by sector/chamber (22 2-D histograms) | Chambers | |
IfrFMon1DClustSize | 1D cluster size (cm) | Module root | |
IfrFMon3DClustMultip | Overall 3D clusters multiplicity | Module root | |
IfrFMon3DClustNDigi | Number of digis per 3D cluster | Module root | |
IfrFMon3DClustNLayers | Number of hit layers per 3D cluster | Module root | |
IfrFMon3DClustTheta | Theta angle of 3D cluster center of gravity | Modulr root | |
IfrFMon3DClustPhi | Phi angle of 3D cluster center of gravity | Module root |