• MARaBOU tasks
  
• MBS Hardware configuration
  • VME, single branch
    
  • VME, dual branch
    
  • CAMAC, Miniball Exp
    
• ROOT/C++ classes
  
  • Class Index
  • Experimental configuration in a MBS environment
    • TMrbConfig: base class to describe the experimental layout (HowTo)
    • Basic ROOT/MBS classes
      • TMrbEvent: event structure
      • TMrbSubevent: subevent structure
    • Classes describing MBS data formats
      • TMrbEvent_10_1: MBS event type [10,1]
      • TMrbSubevent_10_1: MBS subevent type [10,1], data labelled with channel number, 1 module per subevent only
      • TMrbSubevent_10_11: same as [10,1], no channel numbers, zero padded
      • TMrbSubevent_10_12: same as [10,1], including module headers, any number of modules per subevent
      • TMrbSubevent_10_13: same as [10,1]; data will be stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_10_14: same as [10,11]; data will be stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_10_15: stores raw data in an intermediate buffer. User has to provide his own method TUsrSevtXXX::DecodeBuffer() (via TMrbConfig::IncludeUserCode()) to transfer data to parameters.
      • TMrbSubevent_DGF_1: subevent [10,21], handles data from a XIA DGF4C module
      • TMrbSubevent_DGF_2: subevent [10,22], same as TMrbSubevent_DGF_1, but stored in a TUsrHitBuffer together with its time stamp
      • TMrbSubevent_DGF_3: subevent [10,23], same as TMrbSubevent_DGF_2, data members are of type TUsrHit instead of plain integer
      • TMrbSubevent_Silena_1: subevent [10,31] holds Silena 4418V/T data in zero-suppressed mode
      • TMrbSubevent_Silena_2: subevent [10,32], same as TMrbSubevent_Silena_1, but stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_Caen_1: subevent [10,41] stores CAEN V775/V785 data
      • TMrbSubevent_Caen_2: subevent [10,42], same as TMrbSubevent_Caen_1, but stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_Caen_3: subevent [10,43], same as TMrbSubevent_Caen_2, data members are of type TUsrHit instead of plain integer
      • TMrbSubevent_Caen_Q1: subevent [10,44], similar to TMrbSubevent_Caen_1, but stores CAEN V965 QDC data
      • TMrbSubevent_Caen_V556_1: subevent [10,33] stores CAEN V556 data
      • TMrbSubevent_Caen_V556_2: subevent [10,34], same as TMrbSubevent_Caen_V556_1, but stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_Caen_V556_3: subevent [10,43], same as TMrbSubevent_Caen_V556_2, data members are of type TUsrHit instead of plain integer
      • TMrbSubevent_Caen_V1190_1: subevent [10,45] stores CAEN V1190 TDC data
      • TMrbSubevent_Caen_V1190_2: subevent [10,46], same as TMrbSubevent_Caen_V1190_1, but stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_Caen_V1190_3: subevent [10,47], same as TMrbSubevent_Caen_V1190_2, data members are of type TUsrHit instead of plain integer
      • TMrbSubevent_Sis_1: subevent [10,51], stores SIS 3XXX data
      • TMrbSubevent_Sis_2: subevent [10,52], same as TMrbSubevent_Sis_1, but stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_Sis_3: subevent [10,53], same as TMrbSubevent_Sis_2, data members are of type TUsrHit instead of plain integer
      • TMrbSubevent_Sis_33: subevent [10,54], stores SIS 3300 flash adc data
      • TMrbSubevent_Mesytec_1: subevent [10,81], stores Mesytec MADC32/MQDC32 data
      • TMrbSubevent_Mesytec_2: subevent [10,82], same as TMrbSubevent_Mesytec_1, but stored in a TUsrHitBuffer together with a time stamp
      • TMrbSubevent_Mesytec_3: subevent [10,83], same as TMrbSubevent_Mesytec_2, data members are of type TUsrHit instead of plain integer
      • TMrbSubevent_Gassiplex_1: subevent [10,101], stores GASSIPLEX data
      • TMrbSubevent_Gassiplex_2: subevent [10,102], same as TMrbSubevent_Gassiplex_1, but stored in a TUsrHitBuffer
      • TMrbSubevent_Gassiplex_3: subevent [10,103], same as TMrbSubevent_Gassiplex_2, data members are of type TUsrHit instead of plain integer
      • TMrbSubeventRaw: a used-defined subevent containing raw data
      • TMrbSubevent_Data_S: subevent [10,91] contains short integer data (16 bit)
      • TMrbSubevent_Data_I: subevent [10,92] contains integer data (32 bit)
      • TMrbSubevent_Data_F: subevent [10,93] contains floating-point data
      • TMrbSubevent_Obj: subevent [10,94] contains one or more objects derived from TObject
    • Classes describing basic module types:
      • TMrbModule, TMrbModuleChannel, TMrbModuleRegister
      • TMrbCamacModule, TMrbCamacChannel, TMrbCamacRegister
      • TMrbVMEModule, TMrbVMEChannel, TMrbVMERegister
      • TMrbScaler, TMrbCamacScaler, TMrbVMEScaler
    • Classes describing individual modules
      • TMrbModuleRaw: a user-defined module
      • CAMAC:
        • TMrbSilena_4418V: ADC type Silena 4418/V, 8 chn @ 12 bit
        • TMrbSilena_4418T: TDC type Silena 4418/T, 8 chn @ 12 bit
        • TMrbUct_8904: universal counter/timer type UCT 8904
        • TMrbSen_16P_2047: SEN pattern unit
        • TMrbSilena_7420: Silena 7420 (NIM type) + input register
        • TMrbLeCroy_2228A: TDC type LeCroy 22
        • TMrbLeCroy_2280: LeCroy's system processor 2280 (QDCs, 48 chn @ 12 bit each)
        • TMrbLeCroy_4432, TMrbLeCroy_4434: scaler, 32 chn @ 24 bit
        • TMrbLeCroy_4448: pattern unit 48 bit (3 chn @ 16 bit)
        • TMrbAdcd_9701: dual flash ADC 2 x 2K chn @ 12 bit
        • TMrbSen_2010: dual input register, 2 chn @ 16 bit
        • TMrbNE_9041: dual input register
        • TMrbKinetics_3655: timing generator
        • TMrbGanelec_Q1612F: Gan'elec QDC 2 x 8 chn @ 12 bit
        • TMrbISN_4481: TDC type ISN 4481, 8 chn @ 12 bit
        • TMrbOrtec_413A: ADC type Ortec AD413A, 4 chn @ 13 bit
        • TMrbXia_DGF_4C: XIA DGF-4C, Digital Gamma Finder
        • TMrbCologne_CPTM: clock and programmable trigger module
      • VME:
        • TMrbCaen_V260: scaler, 16 channels, 100MHz
        • TMrbCaen_V556: Peak-sensing ADC, 8 chn @ 12 bit
        • TMrbCaen_V775: TDC, 16 or 32 chn @ 12 bit
        • TMrbCaen_V785: Peak-sensing ADC, 32 chn @ 12 bit
        • TMrbCaen_V879: Peak-sensing ADC, 32 chn @ 12 bit
        • TMrbCaen_V820: Latching scaler, 32 chn @ 32 bit
        • TMrbCaen_V965: QDC, 32 chn @ 12 bit
        • TMrbCaen_V1190: TDC, 128 chn @ 19 bit, 100 ps
        • TMrbMesytec_Madc32: Fast 32 channel peak-sensing ADC
        • TMrbMesytec_Mqdc32: 32/16 channel charge integrating QDC
        • TMrbMesytec_Mtdc32: 32+2 channel time digitizing TDC
        • TMrbGassiplex: GASSIPLEX module, N x 64 chn, 11 bit, multiplexed
        • TMrbSis_3300: Digitizing ADC, 8 chn @ 12 bit, 100 MHz
        • TMrbSis_3302: Digitizing ADC, 8 chn @ 12 bit, 100 MHz
        • TMrbSis_3600: Buffered pattern unit, 32 bit
        • TMrbSis_3801: Buffered scaler, 32 chn @ 32 bit
        • TMrbSis_3820: Buffered scaler, 32 chn @ 32 bit
        • TMrbLeCroy_1176: Multi-hit, multi-event TDC, 16 chn @ 16 bit
        • TMrbAcromag_IP341: Sampling ADC type Acromag-9660/IP341, 4 x 16 chn @ 14 bit
        • TMrbMpiHD_IOReg: Input/output register (8 bit in / 8 bit out) (MPI Heidelberg "MPIORL")
        • TMrbVulomTB: TriggerBox - a VME version of the famous TB8000! (GSI)
        Special:
        • TMrbMesytec_Mux16: Mesytec multiplexer MUX-16, N * 16 channels
    • Code generators
      • TMrbConfig::MakeReadoutCode(): generate C code to be linked to MBS
      • TMrbConfig::MakeAnalyzeCode(): generate C++ classes to be used for data analysis within ROOT
      • TMrbConfig::MakeRcFile(): generate a ROOT-style environment from config data
    • Converting config data to ROOT format and vice versa
      • TMrbConfig::WriteToFile: save config data to ROOT file
      • TMrbConfig::ReadFromFile: read config data from ROOT file
      • TMrbConfig::MakeConfigCode: generate config code from objects in memory
    • Example of a configuration file
      • Resulting readout code for MBS
      • Resulting C++ files for ROOT
        • User's analyzing code
        • C++ class definitions
        • Global pointer definitions
  • Data transfer from MBS to ROOT
    • TMrbTransport: read data from file or server
    • mbsio: library routines to decode MBS data
  • Data acquisition and analysis
    • TMrbAnalyze: base class for user's data analysis
    • TMrbIOSpec: class to control input/output during data acquisition/evaluation
    • TUsrEvent: base class for user-defined event structures
    • TUsrEvtStart, TUsrEvtStop: start and stop events
    • TUsrEventBuilder: a user/specific event builder
    • TUsrDeadTime: dead time info
    • TMrbModuleListEntry, TMrbParamListEntry, TMrbHistoListEntry: book keeping for modules, parameters, and histograms
    • TUsrHitBuffer, TUsrHit, store event data together with time stamp, module id, and channel number,
      
    • TUsrHBX, a wrapper class to access hitbuffer elements,
      
    • TUsrMux, decoder / sorter for Mesytec MUX-16 multiplexers
  • MBS Setup
    • TMbsSetup: maintain setup data base for MBS
  • Clients to connect to m_esone_srv under MBS
    • TMrbEsone, TMrbEsoneCnaf: ESONE client to connect to CAMAC @ MBS
    • TMrbDGF, TMrbDGFData: operate a XIA DGF-4C Digital Gamma Finder
    • TMrbDGFEventBuffer, TMrbDGFHistogramBuffer: DGF buffer structures
    • TMrbLofDGFClusters, TMrbDGFCluster, TMrbDGFClusterMember: data base for DGF clusters
      
    • TMrbCPTM clock and programmable trigger module to be used with DGF-4C modules
      (Ch. Görgen, G. Pascovici, Univ. Cologne)
  • Clients to connect to mrbLynxOsSrv under LynxOs
    • TMrbC2Lynx: client to connect to LynxOs server
    • TC2LVMEModule: VME module to be accessed via LynxOs
    • TC2LSis3302: SIS 3302 flash ADC via LynxOs
    • TC2LCaen785: CAEN V785 peak sensing ADC via LynxOs
  • Utilities
    • TMrbNamedX and TMrbLofNamedX: define (a list of) named indices
    • TMrbTemplate: process templates
    • TMrbLofData: a list of (structured) data items
    • TMrbVariable, TMrbVarI, TMrbVarF, TMrbVarS,
      TMrbVarArrayI, TMrbVarArrayF,
      TMrbWindowI, TMrbWindowF
      TMrbWindow2D
      TMrbLofUserVars
      provide user-defined variables and 1-dim windows
    • TMrbLofMacros: manage a list of root macros
    • TMrbNamedArrayC, TMrbNamedArrayI, TMrbNamedArrayF, TMrbNamedArrayD: a TArray"X" combined with a TNamed
    • TMrbNamedDouble: a named Double_t item
    • TMrbSystem: extensions to TSystem
    • TMrbEnv: extensions to TEnv
    • TMrbResource: a replacement for TMrbEnv
    • TMrbStatistics: maintain histogram statistics
    • TableOfLabels, TableOfStrings, TableOfFloats
    • TMrbString: type conversion for TString objects
    • TMrbWildcard: wildcard function ("*" and "?")
    • TMrbLogger, TMrbLogMessage: MARaBOU's message logger
    • TMrbTail: browse file contents like tail(1)
    • TMrbHelpBrowser: a simple HTML browser to implement Online Help facilities
      
    • TMrbTidyDoc, TMrbTidyOption, TMrbTidyNode, TMrbTidyAttr: interface to Dave Raggett's TidyLib
      
  • Miscellaneous
    • TMrbSerialComm: establish communication to a RS232 serial port
    • TPolControl: control the polarized ion source via RS232 (HowTo)
    • TSnkDDA0816: operate a DDA0816 DAC interface in the SNAKE environment
    • QEnv: a QT class to handle ROOT's environment files (see also TEnv)
  • Graphical User Interface
    • TGMrbMessageViewer: display messages from MARaBOU's message logger
    • TGMrbTextButtonGroup, ...List: a group or list of text buttons
    • TGMrbRadioButtonGroup, ...List: a group or list of radio buttons
    • TGMrbCheckButtonGroup, ...List: a group or list of check buttons
    • TGMrbLabelEntry: a labelled text entry
    • TGMrbFileEntry: a labelled file entry (file dialog box)
    • TGMrbLabelCombo: a labelled combo box
    • TGMrbFileObjectCombo, TGMrbFileObjectListBox,: a labelled file entry and a combo/list box showing ROOT objects from selected file
    • TGMrbProgressBar: a transient frame showing a TGProgressBar
    • TGMrbTableFrame: a matrix of text entries
    • TGMrbMacroBrowserMain, ..., Composite, ...Group, ...Popup, ...Transient:
      execute root macros interactively in a GUI
    • TGMrbMacroEdit: a widget to edit/modify macro defs
    • TGMrbLofKeyBindings: handle key strokes via ProcessMessage()
    • TGMrbGeometry: define window geometry
    • TGMrbLayout: layout hints and graphic context
  • Applications:
    • C_Analyze: a GUI to control data acquisition
    • HistPresent, Online Help: HistPresent, Online Help pages
    • HistPresent, an example: a histogram presenter (example session)
    • DGFControl: a GUI to control a XIA DGF-4C Digital Gamma Finder
    • MacroBrowser: a GUI to execute ROOT macros
      
    Documentation:
    • MED data structure: a list mode format derived from MBS' lmd format
    • DAQ instructions for Miniball: how to use MARaBOU in a Miniball experiment
    • EventBuilder for Miniball: how to perform event building in a Miniball experiment
    • Energy calibration: how to perform an energy calibration
    • Format of a file list entry: File lists may be used in C_analyze / M_analyze to process several files in (quasi) batch mode
• Download MARaBOU / HistPresent from Git Repository
• Presentation of HistPresent at the ROOT2005 Workshop, CERN September 26-28, 2005

(MARaBOU, Last Update 22-May-2019, Otto Schaile)