ATLAS Offline Software
SCTCalibFlags.py
Go to the documentation of this file.
1 #
2 # Copyright (C) 2002-2024 CERN for the benefit of the ATLAS collaboration
3 #
4 
5 
6 def defaultSCTCalibFlags(flags, **kwargs):
7  flags.addFlag('SCTCalib.EventNumber', 999999) # default; set in the job json file
8  flags.addFlag('SCTCalib.RunNumber', 999999) # default; set in the job json file
9  flags.addFlag('SCTCalib.ForceRefRunNumber', False) # force reference run to current run number when checking information uploaded to COOL for previous runs
10  flags.addFlag('SCTCalib.RunStartTime', 999999) # default; set in the job json file
11  flags.addFlag('SCTCalib.RunEndTime', 999999) # default; set in the job json file
12  flags.addFlag('SCTCalib.EvtMax', -1) # default; set in the job json file
13  flags.addFlag('SCTCalib.LBMax', -1) # default; set in the job json file
14  flags.addFlag('SCTCalib.GeometryTag', '') # empty in default
15  flags.addFlag('SCTCalib.ConditionsTag', '') # empty in default
16  flags.addFlag('SCTCalib.DataSource', 'data') # 'data' or 'geant4', although geant has not been used since >10 years
17  flags.addFlag('SCTCalib.beamType', 'cosmics') # 'cosmics', 'singlebeam' or 'collisions'
18 
19  #------------------------------------------------------------
20  # Flags for input
21  # - BS : NoisyStrips, DeadChip, DeadStrip, QuietChip, QuietStrip (, HV)
22  # - HIST : NoiseOccupancy, RawOccupancy, Efficiency, BSErrorDB, LorentzAngle
23  #------------------------------------------------------------
24  flags.addFlag('SCTCalib.ReadBS', True)
25  flags.addFlag('SCTCalib.InputType', '')
26  flags.addFlag('SCTCalib.InputHist', [''])
27 
28  #------------------------------------------------------------
29  # Algorithm turned on
30  # - Set only one flag to True and others to False
31  #------------------------------------------------------------
32  #--- Algs using TrkVal or BS
33  flags.addFlag('SCTCalib.DoHitMaps', False)
34  flags.addFlag('SCTCalib.DoHitMapsLB', False)
35  flags.addFlag('SCTCalib.DoHV', False)
36  flags.addFlag('SCTCalib.DoNoisyStrip', True)
37  flags.addFlag('SCTCalib.DoDeadStrip', False)
38  flags.addFlag('SCTCalib.DoDeadChip', False)
39  flags.addFlag('SCTCalib.DoQuietStrip', False)
40  flags.addFlag('SCTCalib.DoQuietChip', False)
41  #--- Algs using HIST
42  flags.addFlag('SCTCalib.DoNoiseOccupancy', False)
43  flags.addFlag('SCTCalib.DoRawOccupancy', False)
44  flags.addFlag('SCTCalib.DoEfficiency', False)
45  flags.addFlag('SCTCalib.DoBSErrorDB', False)
46  flags.addFlag('SCTCalib.DoLorentzAngle', False)
47 
48  #------------------------------------------------------------
49  # Default setup for specific flags in SCTCalib
50  # - This default is for NoisyStrips
51  #------------------------------------------------------------
52  flags.addFlag('SCTCalib.UseDCS', False)
53  flags.addFlag('SCTCalib.UseConfiguration', True)
54  flags.addFlag('SCTCalib.UseCalibration', True)
55  flags.addFlag('SCTCalib.UseMajority', True)
56  flags.addFlag('SCTCalib.UseBSError', False)
57  flags.addFlag('SCTCalib.ReadHitMaps', True) # True = two steps of HitMap production and analysis, False = simultaneous production and analysis
58  flags.addFlag('SCTCalib.DoBSErrors', False)
59 
60  #------------------------------------------------------------
61  # Properties in SCTCalib
62  #------------------------------------------------------------
63  #--- local DB
64  flags.addFlag('SCTCalib.WriteToCool', True) # To create the db output
65 
66  # hitmaps
67  flags.addFlag('SCTCalib.LbsPerWindow', 30) # number of lumi blocks when time dependent histograms are created
68 
69  #--- Noisy strips
70  flags.addFlag('SCTCalib.NoisyUpdate', False) # True = Write out difference from the existing data, False = Write out all (default since 2017)
71  flags.addFlag('SCTCalib.NoisyWriteAllModules', True)
72  flags.addFlag('SCTCalib.NoisyMinStat', 10000) # 50000 (enough), 10000 (still possible), 5000 (for commissioning)
73  flags.addFlag('SCTCalib.NoisyStripAll', True) # True = All noisy strips into DB, False = Only newly found strips
74  flags.addFlag('SCTCalib.NoisyStripThrDef', True) # True = Offline, False = Calib
75  flags.addFlag('SCTCalib.NoisyStripThrOffline', 1.5E-2) # Threshold in Offline
76  flags.addFlag('SCTCalib.NoisyStripThrOnline', 1.5E-3) # Threshold in Online/Calibration (TBD)
77  flags.addFlag('SCTCalib.NoisyWaferFinder', True) # True = turn on noisy wafer criteria, False = turn off
78  flags.addFlag('SCTCalib.NoisyWaferWrite', True) # True = include noisy wafer, False = do not include
79  flags.addFlag('SCTCalib.NoisyWaferAllStrips', False) # True = write out all strips, False = only noisy strips
80  flags.addFlag('SCTCalib.NoisyWaferThrBarrel', 1.0E-3)
81  flags.addFlag('SCTCalib.NoisyWaferThrECA', 1.0E-3)
82  flags.addFlag('SCTCalib.NoisyWaferThrECC', 1.0E-3)
83  flags.addFlag('SCTCalib.NoisyWaferFraction', 0.5)
84  flags.addFlag('SCTCalib.NoisyChipFraction', 0.5)
85  flags.addFlag('SCTCalib.NoisyUploadTest', True) # only false during the first few runs
86  flags.addFlag('SCTCalib.NoisyModuleAverageInDB', -1.)
87  flags.addFlag('SCTCalib.NoisyStripLastRunInDB', -999.)
88  flags.addFlag('SCTCalib.NoisyStripAverageInDB', -999.)
89  flags.addFlag('SCTCalib.NoisyModuleList', 5000)
90  flags.addFlag('SCTCalib.NoisyModuleDiff', 0.3)
91  flags.addFlag('SCTCalib.NoisyStripDiff', 0.3)
92  flags.addFlag('SCTCalib.NoisyReadNumRuns', 3) # Number of runs to calculate the recent average
93 
94  #--- Dead strips/chips
95  flags.addFlag('SCTCalib.DeadStripMinStat', 5000)
96  flags.addFlag('SCTCalib.DeadStripMinStatBusy', 5000)
97  flags.addFlag('SCTCalib.DeadChipMinStat', 5000)
98  flags.addFlag('SCTCalib.DeadStripSignificance', 6)
99  flags.addFlag('SCTCalib.DeadChipSignificance', 6)
100  flags.addFlag('SCTCalib.BusyThr4DeadFinding', 1.0E-4)
101  flags.addFlag('SCTCalib.NoisyThr4DeadFinding', 5.0E-2)
102  flags.addFlag('SCTCalib.DeadChipUploadTest', True)
103  flags.addFlag('SCTCalib.DeadStripUploadTest', True)
104  flags.addFlag('SCTCalib.QuietThresholdStrip', 0.5)
105  flags.addFlag('SCTCalib.QuietThresholdChip', 0.5)
106 
107  #--- Efficiency
108  flags.addFlag('SCTCalib.EfficiencyDoChips', False)
109 
110  #--- HIST
111  flags.addFlag('SCTCalib.NoiseOccupancyTriggerAware', False)
112  flags.addFlag('SCTCalib.NoiseOccupancyMinStat', 5000)
113  flags.addFlag('SCTCalib.RawOccupancyMinStat', 5000)
114  flags.addFlag('SCTCalib.EfficiencyMinStat', 5000)
115  flags.addFlag('SCTCalib.BSErrorDBMinStat', 5000)
116  flags.addFlag('SCTCalib.LorentzAngleMinStat', 5000)
117 
118  #--- Lorentz Angle Debug Mode
119  flags.addFlag('SCTCalib.LorentzAngleDebugMode', True)
120 
121  #--------------------------------------------------------------
122  # Tags for local DB and XML files in SCTCalib/SCTCalibWriteSvc
123  #--------------------------------------------------------------
124  flags.addFlag('SCTCalib.TagID4NoisyStrips', 'SctDerivedMonitoring-RUN2-UPD4-005') # UPD4, open IOV for BLK
125  flags.addFlag('SCTCalib.TagID4DeadStrips', 'SctDerivedDeadStrips-003-00')
126  flags.addFlag('SCTCalib.TagID4DeadChips', 'SctDerivedDeadChips-003-00')
127  flags.addFlag('SCTCalib.TagID4NoiseOccupancy', 'SctDerivedNoiseOccupancy-003-01')
128  flags.addFlag('SCTCalib.TagID4RawOccupancy', 'SctDerivedRawOccupancy-003-00')
129  flags.addFlag('SCTCalib.TagID4Efficiency', 'SctDerivedEfficiency-003-00')
130  flags.addFlag('SCTCalib.TagID4BSErrors', 'SctDerivedBSErrorsRun2-001-00')
131  flags.addFlag('SCTCalib.TagID4LorentzAngle', 'SctDerivedLorentzAngleRun2_v2-001-00')
132 
133  #--------------------------------------------------------------
134  # A list of GeometryTags
135  # - One tag is chosen in topOptions from magnet current info
136  #--------------------------------------------------------------
137  flags.addFlag('SCTCalib.GeometryTagSTF', 'ATLAS-R2-2015-03-00-00') # Solenoid=ON, BarrelToroid=ON
138  flags.addFlag('SCTCalib.GeometryTagNTF', 'ATLAS-R2-2015-03-00-00') # Solenoid=ON, BarrelToroid=OFF
139  flags.addFlag('SCTCalib.GeometryTagNSF', 'ATLAS-R2-2015-03-00-00') # Solenoid=OFF, BarrelToroid=ON
140  flags.addFlag('SCTCalib.GeometryTagNF', 'ATLAS-R2-2015-03-00-00') # Solenoid=OFF, BarrelToroid=OFF
141  flags.addFlag('SCTCalib.GeometryTagMC', 'ATLAS-R2-2015-03-00-00') # MC
142 
143  #--------------------------------------------------------------
144  # A list of ConditionsTags
145  # - One tag is chosen in topOptions from magnet current info
146  #--------------------------------------------------------------
147  #--- MC
148  flags.addFlag('SCTCalib.ConditionsTagMC', 'OFLCOND-DR-BS7T-ANom-00') # digi+rec for MC09 - Nominal
149  #--- BLK : bulk production
150  flags.addFlag('SCTCalib.ConditionsTagSTF', 'CONDBR2-ES1PA-2016-03') # Solenoid=ON, BarrelToroid=ON
151  flags.addFlag('SCTCalib.ConditionsTagNTF', 'CONDBR2-ES1PA-2016-03') # Solenoid=ON, BarrelToroid=OFF
152  flags.addFlag('SCTCalib.ConditionsTagNSF', 'CONDBR2-ES1PA-2016-03') # Solenoid=OFF, BarrelToroid=ON
153  flags.addFlag('SCTCalib.ConditionsTagNF', 'CONDBR2-ES1PA-2016-03') # Solenoid=OFF, BarrelToroid=OFF
154 
155  #--------------------------------------------------------------
156  # Read /SCT/Derived/Monotoring in COOL
157  flags.addFlag('SCTCalib.TagID4NoisyUploadTest', 'SctDerivedMonitoring-RUN2-UPD4-005')
158  #--------------------------------------------------------------
SCTCalibFlags.defaultSCTCalibFlags
def defaultSCTCalibFlags(flags, **kwargs)
Definition: SCTCalibFlags.py:6