Skip to content

PlotResults

Overview#

The PlotResults program is used to visualize ROOT histograms, mainly for data quality monitoring. It uses the multi-threaded ROOT PROOF framework and processes data from the output of EventBuilder.

Depending on configuration, it can generate:

  • Basic histograms: multiplicities, detector IDs, and timing checks
  • Monitoring histograms: variable evolution over the experiment
  • Rates histograms: detector rates over time
  • Calibrated histograms: for gamma-ray spectroscopy
  • Histograms for angular correlations

Configuration File: PlotResults.conf#

BuilderDir:         Path to the input files (from EventBuilder)  
OutputDir:          Path to store output histograms  
Mode:               TAG, or LaBr3  
PlotOptions:        One or more of: Basic, Monitoring, Rates, Calibrated, RelAngles, XTalk, Dev (see below)
EWindow:            Energy and width for a specific gamma transition to monitor over time  
EGBinning:          Binning for 1D energy spectra
EGGBinning:         Binning for 2D energy spectra (3 or 6 parameters)
EGammaETotMult:     Max mult to be plotted for EGammaETot histograms (ex: 4 will plot EG_ETot_M1, EG_ETot_M2... EG_ETot_M4)
EGammaETotBinning:  Binning for 1D energy spectra (3 or 6 parameters)
GGIsomer:           Time gates for prompt-delayed matrices
SumThresholdForGG:  Energy threshold on coincidences for GG (ex. E1 + E2 > 3MeV)
RelAnglesMode:      Clover or Ge
RelAnglesNorm:      Norm NormOnly (if not defined, don't create normalization matrices)
RelAnglesCond:      See section below  
RelAnglesBinning    Binning for angular correlation matrices
BunchSize           Number of events in a bunch in the normalisation treatment (default 1000)
NMixingPerBunch     Number of event per bunch to be mixed (default 100)

Here is an example of EventBuilder.conf file:

###################
### Input Files ###
###################

BuilderDir  ./Builder
OutputDir   ./PlotResults/

############
### Mode ###
############

Mode  FIPPS

####################
### Plot options ###
####################

PlotOptions     Basic Calibrated Monitoring RelAngles

EGBinning  8000 0 8000
EGGBinning 4000 0 8000

EGammaETotMult 4
EGammaETotBinning 4000 0 8000

GGIsomer 0 50 200 250

SumThresholdForGG 3000

############################
### Angular Correlations ###
############################

RelAnglesMode       Clov
RelAnglesNorm       Norm
RelAnglesCond       NoCond

RelAnglesBinning    2000 0 4000

BunchSize               1000
NMixingPerBunch         100

##################
### Data Check ###
##################

EWindow 1408 50

Plot options#

  • Basic -> Multiplicities, Ids, Timing
  • Monitoring -> E vs Time, E vs Run
  • Rates -> Rates per dets (Hz)
  • Calibrated -> Energy spectra (necessary for RelAngles, XTalk, Dev, OsloTSC)
  • RelAngles -> Generate matrices for angular correlations (see Angular Correlations for config)
  • XTalk -> Generate matrices for x-talk measurements
  • Dev -> Generate some specific histograms for developers

Relative Angle Conditions#

The RelAnglesCond line defines coincidence conditions for building gamma-gamma angular correlation matrices.

  • Conditions are space-separated.
  • Use NoCond to build matrices for each relative angle without gating.
  • Use Energy_Width (e.g., 1279_5) to gate on specific transitions.

Example:

RelAnglesCond    NoCond 1279_5

This will produce:

  • A set of gamma-gamma matrices for each angle (ungated)
  • A second set gated on the 1279 ± 5 keV transition

Usage#

To display usage information, run:

PlotResults

Make sure your ROOT environment is properly configured with PROOF enabled.