SVD DQM
Contents
21.6. SVD DQM#
The SVD DQM modules produce plots to assess the quality of the data.
Only SVDUnpackerDQM
is executed on HLT, the rest of the modules are executed on ExpressReco on a fraction of events.
21.6.1. DQM Modules#
This is a list of the svd
dqm modules.
- SVDDQMClustersOnTrack#
SVD DQM module for clusters related to tracks.
- Package
svd
- Library
libsvdDQM.so
- Parameters
- Clusters (str, default=’’)
SVDCluster StoreArray name.
- EventInfo (str, default=’’)
SVDEventInfo StoreArray name.
- RecoDigits (str, default=’’)
SVDRecoDigits StoreArray name.
- ShaperDigits (str, default=’’)
SVDShaperDigits StoreArray name.
- TriggerBin (int, default=-1)
select events for a specific trigger bin, if -1 then no selection is applied (default)
- desynchronizeSVDTime (bool, default=False)
if True, svd time back in SVD time reference
- histogramDirectoryName (str, default=’SVDClsTrk’)
Name of the directory where histograms will be placed.
- samples3 (bool, default=False)
if True 3 samples histograms analysis is performed
- skipHLTRejectedEvents (bool, default=True)
If True, skip events rejected by HLT.
- SVDDQMDose#
The SVD dose-monitoring DQM module. Fills histograms of the SVD’s instantaneous occupancy and of SVD occupancy vs time since last injection and time in beam revolution cycle.
- Package
svd
- Library
libsvdDQM.so
- Parameters
- eventTypeFilter (unsigned int, default=7)
Types of events to include in the plots (1 = less than noInjectionTimeout after HER injection, 2 = less than noInjectionTimeout after LER injection, 4 = more than noInjectionTimeout after any injection; bitwise or combinations are possible; see SVDDQMDoseModule::EEventType).
- histogramDirectoryName (str, default=’SVDDose’)
Name of the directory where histograms will be placed in the ROOT file.
- noInjectionTimeout (float, default=30000.0)
Time (microseconds) since last injection after which an event is considered “No Injection”. Also the limit for the x axis of the 2D histograms.
- offlineZSShaperDigits (str, default=’SVDShaperDigitsZS5’)
Name of the SVDShaperDigits to use for computing occupancy (default is SVDShaperDigitsZS5).
- trgTypes (list(int), default=[13])
Trigger types for event selection. Empty to select everything. Default is only Poisson w/o inj. veto.
- SVDDQMEfficiency#
Create basic histograms to compute the average sensor efficiency.
- Package
svd
- Library
libsvdDQM.so
- Parameters
- Clusters (str, default=’’)
name of StoreArray with SVD cluster.
- Intercepts (str, default=’’)
name of StoreArray with SVDIntercepts.
- binsU (int, default=4)
histogram bins in u direction.
- binsV (int, default=6)
histogram bins in v direction.
- fiducialU (float, default=0.5)
Fiducial Area, U direction.
- fiducialV (float, default=0.5)
Fiducial Area, V direction.
- histogramDirectoryName (str, default=’SVDEfficiency’)
Name of the directory where histograms will be placed.
- maxHalfResidU (float, default=0.05000000074505806)
half window for cluster search around intercept, U direction.
- maxHalfResidV (float, default=0.05000000074505806)
half window for cluster search around intercept, V direction.
- minCDCHits (unsigned int, default=20)
Number of CDC hits required in a track to be considered.
- minSVDHits (unsigned int, default=1)
Number of SVD hits required in a track to be considered.
- momCut (float, default=0.0)
Set a cut on the track momentum.
- pValCut (float, default=0.0)
Set a cut on the track p-value.
- ptCut (float, default=1.0)
Set a cut on the track transverse momentum.
- samples3 (bool, default=False)
if True 3 samples histograms analysis is performed
- saveExpertHistos (bool, default=False)
if True, save additional histograms.
- SVDDQMExpressReco#
Original SVD DQM module for ExpressReco.
- Package
svd
- Library
libsvdDQM.so
- Parameters
- Clusters (str, default=’SVDClusters’)
Cluster StoreArray name.
- CutSVDCharge (float, default=0.0)
minimum charge (ADC) to fill the strip-hitmap histogram.
- CutSVDClusterCharge (float, default=0.0)
minimum charge (in e-) to fill the cluster-hitmap histogram.
- ShaperDigits (str, default=’SVDShaperDigits’)
not zero-suppressed ShaperDigits StoreArray name.
- ShowAllHistos (int, default=0)
Flag to show all histos in DQM, default = 0.
- additionalPlots (bool, default=False)
Flag to produce additional plots
- desynchronizeSVDTime (bool, default=False)
if True, svd time back in SVD time reference.
- histogramDirectoryName (str, default=’SVDExpReco’)
Name of the directory where histograms will be placed.
- offlineZSShaperDigits (str, default=’SVDShaperDigitsZS5’)
ShaperDigits StoreArray name - usually ZS5 strips.
- samples3 (bool, default=False)
if True 3 samples histograms analysis is performed
- skipHLTRejectedEvents (bool, default=True)
If True, skip events rejected by HLT.
- SVDDQMHitTime#
Make data quality monitoring plots for SVD Hit Time for bhabha, mu mu, and hadron samples seeded by different trigger times (ECL, CDC).
- Package
svd
- Library
libsvdDQM.so
- Parameters
- Clusters (str, default=’’)
SVDCluster StoreArray name.
- EventInfo (str, default=’’)
SVDEventInfo StoreObjPtr name.
- desynchronizeSVDTime (bool, default=False)
if True, svd time back in SVD time reference
- histogramDirectoryName (str, default=’SVDHitTime’)
Name of the directory where histograms will be placed.
- samples3 (bool, default=False)
if True 3 samples histograms analysis is performed
- SVDDQMInjection#
Monitor SVD Occupancy after Injection.
- Package
svd
- Library
libsvdDQM.so
- Parameters
- ShaperDigits (str, default=’’)
Name of SVD ShaperDigits to count occupancy - usually ZS5 strips.
- histogramDirectoryName (str, default=’SVDInjection’)
Name of the directory where histograms will be placed.
- SVDUnpackerDQM#
DQM Histogram of the SVD Raw Data format.
- Package
svd
- Library
libsvdDQM.so
- Parameters
- DAQDiagnostics (str, default=’’)
Name of DAQDiagnostics Store Array.
- EventInfo (str, default=’’)
Name of SVDEventInfo object.
- histogramDirectoryName (str, default=’SVDUnpacker’)
Name of the directory where histograms will be placed.
21.6.2. DQM Analysis Modules#
- DQMHistAnalysisSVDDose#
Monitoring of SVD Dose with events from Poisson trigger w/o inj. veto. See also SVDDQMDoseModule.
- Package
dqm
- Library
libdqm_analysis_modules.so
- Parameters
- deltaTPVSuffix (str, default=’Occ:Pois:UpdateInterval’)
Suffix for the PV that monitors the update interval of the PVs.
- epicsUpdateSeconds (float, default=1000.0)
Minimum interval between two successive PV updates (in seconds).
- pvPrefix (str, default=’DQM:SVD:’)
Prefix for EPICS PVs.
- pvSuffix (str, default=’:Occ:Pois:Avg’)
Suffix for EPICS PVs.
- statePVSuffix (str, default=’Occ:Pois:State’)
Suffix for the PV with the state of the monitoring.
- DQMHistAnalysisSVDEfficiency#
DQM Analysis Module that computes the average SVD sensor efficiency.
- Package
dqm
- Library
libdqm_analysis_modules.so
- Parameters
- PVPrefix (str, default=’SVD:’)
PV Prefix
- RefHistoFile (str, default=’SVDrefHisto.root’)
Reference histogram file name
- effLevel_Error (float, default=0.9)
Efficiency error (%) level (red)
- effLevel_Warning (float, default=0.94)
Efficiency WARNING (%) level (orange)
- efficiencyMax (int, default=-1111)
Maximum of efficiency histogram
- efficiencyMin (int, default=0)
Minimum of efficiency histogram
- samples3 (bool, default=False)
if True 3 samples histograms analysis is performed
- setEfficiencyRange (bool, default=False)
If true you can set the range of the efficiency histogram with ‘efficiencyMax’ and ‘efficiencyMin’ parameters.
- statThreshold (float, default=100.0)
minimal number of tracks per sensor to set green/red alert
- DQMHistAnalysisSVDGeneral#
DQM Analysis Module that produces colored canvas for a straightforward interpretation of the SVD Data Quality.
- Package
dqm
- Library
libdqm_analysis_modules.so
- Parameters
- PVPrefix (str, default=’SVD:’)
PV Prefix
- RefHistoFile (str, default=’SVDrefHisto.root’)
Reference histrogram file name
- additionalPlots (bool, default=False)
Flag to produce additional plots
- occLevel_Empty (float, default=0.0)
Maximum Occupancy (%) for which the sensor is considered empty
- occLevel_Error (float, default=5.0)
Maximum Occupancy (%) allowed for safe operations (red)
- occLevel_Warning (float, default=3.0)
Occupancy (%) at WARNING level (orange)
- onlineOccLevel_Empty (float, default=0.0)
Maximum OnlineOccupancy (%) for which the sensor is considered empty
- onlineOccLevel_Error (float, default=10.0)
Maximum OnlineOccupancy (%) allowed for safe operations (red)
- onlineOccLevel_Warning (float, default=5.0)
OnlineOccupancy (%) at WARNING level (orange)
- printCanvas (bool, default=False)
if True prints pdf of the analysis canvas
- refMCTC (float, default=0.0)
Mean of the signal time peak from Cosmic reference run
- refMCTP (float, default=0.0)
Mean of the signal time peak from Physics reference run
- samples3 (bool, default=False)
if True 3 samples histograms analysis is performed
- statThreshold (float, default=10000.0)
Minimal number of events to compare histograms
- timeThreshold (float, default=6.0)
Acceptable difference between mean of central peak for present and reference run
- unpackerErrorLevel (float, default=1e-05)
Maximum bin_content/ # events allowed before throwing ERROR
- DQMHistAnalysisSVDOnMiraBelle#
DQM Analysis Module that extracts monitoring variables from SVD DQM histograms and provides input to MiraBelle.
- Package
dqm
- Library
libdqm_analysis_modules.so