Package IfrFastMon 

Coordinator:    Maurizio Lo Vetere lovetere@ge.infn.it

Contact person:    Stefano Bagnasco bagnasco@ge.infn.it


This package contains classes that define histograms used in IFR fast monitoring, and AppModule classes to book and fill these histograms. There are 4 main histogram families, used each in a separate AppModuleBuild module: FEC histograms, TDC Histograms, Digi histograms and Cluster histograms.

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.

Conventions and numbering:

Directory structure:

 
  • IfrFMonModuleFEC
  • Total Strip Multiplicity
    FEE Occupancy
  • Crates directory
  • FEC multiplicity by crate (8 histograms)
  • Strip directory
  • Strip multiplicity by FEE (128 histograms or 1 2-D histogram)
    Strip occupancy by FEE (128 histograms or 1 2-D histogram)
  • FEC directory
  • FEC occupancy by FEE (128 histograms or 1 2-D histogram)
  • IfrFMonModuleDigi
  • Overall Digi Occupancy
    Chamber Digi Multiplicity
  • Maps Directory
  • Barrel and inner RPC XY front view
    Barrel sectors, front and side vews (12 histograms)
    Doors, top and side vews (8 histograms)
  • Sectors Directory
  • 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:

    If you aborted (ctrl-C)  the macro execution, and want to close files, restore default settings and such: For further reference, see the document on Ifr Fast Monitoring

    You may also want to check the history file.
     
     


    Common classes

    IfrFMonAbsHist

    IfrFMonAbsModule

    IfrFMonIndex


    Group I: FEC histograms

    IfrFMonAbsIsFEC

    IfrFMonAbsFECHist, IfrFMonFECHist

    IfrFMonModuleFEC

    Concrete histogram classes:

    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.


    Group II: Digi histograms

    IfrFMonAbsIsDigi

    IfrFMonAbsDigiHist, IfrFMonDigiHist

    IfrFMonModuleDigi

    Concrete histogram classes:

    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


    Group III: Cluster histograms

    NOTE: These will probably at some point moved to a Prompt Monitoring package

    IfrFMonAbsIs1DHistogram, IfrFMonAbsIs3DHistogram

    IfrFMonAbs1DClustHist, IfrFMon1DClustHist

    IfrFMonAbs3DClustHist, IfrFMon3DClustHist

    IfrFMonModuleCluster

    Concrete histogram classes:

    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


    Group IV: TDC histograms

    Work in progress...