ATLAS Offline Software
Loading...
Searching...
No Matches
athenaEF.RunParams Class Reference
Collaboration diagram for athenaEF.RunParams:

Public Member Functions

 __init__ (self, run_number=None, lb_number=None, detector_mask=None, sor_time=None, solenoid_current=None, toroids_current=None, beam_type=None, beam_energy=None, run_type=None, trigger_type=None, recording_enabled=None, T0_project_tag='', stream='', lumiblock=0)
 to_dict (self)
 from_args (cls, args)
 from_is (cls, partition=None, webdaq_base=None, strict=False, solenoid_current_override=None, toroids_current_override=None)

Public Attributes

int run_number = run_number if run_number is not None else self.DEFAULT_RUN_NUMBER
int lb_number = lb_number if lb_number is not None else self.DEFAULT_LB_NUMBER
str detector_mask = detector_mask if detector_mask is not None else self.DEFAULT_DETECTOR_MASK
 sor_time = sor_time if sor_time is not None else dt.now().strftime('%d/%m/%y %H:%M:%S.%f')
 solenoid_current = solenoid_current
 toroids_current = toroids_current
int beam_type = beam_type if beam_type is not None else self.DEFAULT_BEAM_TYPE
int beam_energy = beam_energy if beam_energy is not None else self.DEFAULT_BEAM_ENERGY
str run_type = run_type if run_type is not None else self.DEFAULT_RUN_TYPE
int trigger_type = trigger_type if trigger_type is not None else self.DEFAULT_TRIGGER_TYPE
bool recording_enabled = recording_enabled if recording_enabled is not None else self.DEFAULT_RECORDING_ENABLED
 T0_project_tag = T0_project_tag
 stream = stream
 lumiblock = lumiblock

Static Public Attributes

int DEFAULT_RUN_NUMBER = 0
int DEFAULT_LB_NUMBER = 0
str DEFAULT_DETECTOR_MASK = 'f' * 32
 DEFAULT_SOR_TIME = None
float DEFAULT_SOLENOID_CURRENT = 7730.0
float DEFAULT_TOROIDS_CURRENT = 20400.0
int DEFAULT_BEAM_TYPE = 0
int DEFAULT_BEAM_ENERGY = 0
str DEFAULT_RUN_TYPE = "Physics"
int DEFAULT_TRIGGER_TYPE = 0
bool DEFAULT_RECORDING_ENABLED = False

Detailed Description

Container for run parameters needed by HltEventLoopMgr::prepareForStart().

This class centralizes all run parameter defaults or their retrieval from IS.

Definition at line 61 of file athenaEF.py.

Constructor & Destructor Documentation

◆ __init__()

athenaEF.RunParams.__init__ ( self,
run_number = None,
lb_number = None,
detector_mask = None,
sor_time = None,
solenoid_current = None,
toroids_current = None,
beam_type = None,
beam_energy = None,
run_type = None,
trigger_type = None,
recording_enabled = None,
T0_project_tag = '',
stream = '',
lumiblock = 0 )
Initialize run parameters with defaults for any unspecified values.

Definition at line 81 of file athenaEF.py.

95 lumiblock=0):
96 """Initialize run parameters with defaults for any unspecified values."""
97 self.run_number = run_number if run_number is not None else self.DEFAULT_RUN_NUMBER
98 self.lb_number = lb_number if lb_number is not None else self.DEFAULT_LB_NUMBER
99 self.detector_mask = detector_mask if detector_mask is not None else self.DEFAULT_DETECTOR_MASK
100 self.sor_time = sor_time if sor_time is not None else dt.now().strftime('%d/%m/%y %H:%M:%S.%f')
101 self.solenoid_current = solenoid_current
102 self.toroids_current = toroids_current
103 self.beam_type = beam_type if beam_type is not None else self.DEFAULT_BEAM_TYPE
104 self.beam_energy = beam_energy if beam_energy is not None else self.DEFAULT_BEAM_ENERGY
105 self.run_type = run_type if run_type is not None else self.DEFAULT_RUN_TYPE
106 self.trigger_type = trigger_type if trigger_type is not None else self.DEFAULT_TRIGGER_TYPE
107 self.recording_enabled = recording_enabled if recording_enabled is not None else self.DEFAULT_RECORDING_ENABLED
108 self.T0_project_tag = T0_project_tag
109 self.stream = stream
110 self.lumiblock = lumiblock
111

Member Function Documentation

◆ from_args()

athenaEF.RunParams.from_args ( cls,
args )
Create RunParams from argparse args, using defaults for unset values.

Definition at line 132 of file athenaEF.py.

132 def from_args(cls, args):
133 """Create RunParams from argparse args, using defaults for unset values."""
134 return cls(
135 run_number=args.run_number,
136 lb_number=args.lb_number,
137 detector_mask=args.detector_mask,
138 sor_time=args.sor_time,
139 solenoid_current=getattr(args, 'solenoid_current', None),
140 toroids_current=getattr(args, 'toroids_current', None),
141 beam_type=getattr(args, 'beam_type', None),
142 beam_energy=getattr(args, 'beam_energy', None),
143 T0_project_tag=getattr(args, 'T0_project_tag', ''),
144 stream=getattr(args, 'stream', ''),
145 lumiblock=getattr(args, 'lumiblock', 0),
146 )
147

◆ from_is()

athenaEF.RunParams.from_is ( cls,
partition = None,
webdaq_base = None,
strict = False,
solenoid_current_override = None,
toroids_current_override = None )
Create RunParams by reading from IS via the WEBDAQ REST API.

This uses the webis_server REST API to fetch run parameters, avoiding
direct dependencies on TDAQ libraries. The API endpoint is determined by:
1. The webdaq_base parameter if provided
2. The TDAQ_WEBDAQ_BASE environment variable

The IS objects accessed are:
- RunParams.RunParams: run_number, det_mask, timeSOR, trigger_type, etc.
- Magnets.Magnets: SolenoidCurrent, ToroidsCurrent

Args:
   partition: The partition name (default: from TDAQ_PARTITION env var)
   webdaq_base: Base URL for webis_server (default: from TDAQ_WEBDAQ_BASE env var)
   strict: If True, raise an exception if IS read fails (for --online-environment)
   solenoid_current_override: If provided, skip IS fetch for solenoid (command-line override)
   toroids_current_override: If provided, skip IS fetch for toroids (command-line override)

Returns:
   RunParams instance with values from IS, or defaults if unavailable

Raises:
   RuntimeError: If strict=True and IS read fails

Definition at line 149 of file athenaEF.py.

150 solenoid_current_override=None, toroids_current_override=None):
151 """
152 Create RunParams by reading from IS via the WEBDAQ REST API.
153
154 This uses the webis_server REST API to fetch run parameters, avoiding
155 direct dependencies on TDAQ libraries. The API endpoint is determined by:
156 1. The webdaq_base parameter if provided
157 2. The TDAQ_WEBDAQ_BASE environment variable
158
159 The IS objects accessed are:
160 - RunParams.RunParams: run_number, det_mask, timeSOR, trigger_type, etc.
161 - Magnets.Magnets: SolenoidCurrent, ToroidsCurrent
162
163 Args:
164 partition: The partition name (default: from TDAQ_PARTITION env var)
165 webdaq_base: Base URL for webis_server (default: from TDAQ_WEBDAQ_BASE env var)
166 strict: If True, raise an exception if IS read fails (for --online-environment)
167 solenoid_current_override: If provided, skip IS fetch for solenoid (command-line override)
168 toroids_current_override: If provided, skip IS fetch for toroids (command-line override)
169
170 Returns:
171 RunParams instance with values from IS, or defaults if unavailable
172
173 Raises:
174 RuntimeError: If strict=True and IS read fails
175 """
176 import requests
177
178 # Determine the base URL
179 if webdaq_base is None:
180 webdaq_base = os.environ.get('TDAQ_WEBDAQ_BASE')
181
182 if not webdaq_base:
183 msg = "TDAQ_WEBDAQ_BASE not set, cannot read from IS"
184 if strict:
185 raise RuntimeError(msg + " (required for --online-environment)")
186 log.warning(msg + ". Using defaults.")
187 return cls()
188
189 # Determine partition
190 if partition is None:
191 partition = os.environ.get('TDAQ_PARTITION', 'ATLAS')
192
193 log.info("Reading run parameters from IS via WEBDAQ: %s (partition=%s)", webdaq_base, partition)
194
195 params = {}
196
197 # Fetch RunParams from IS
198 # API: GET /info/current/{partition}/is/{server}/{server}.{name}?format=compact
199 # Response format: [name, type, timestamp, data] - we need element [3]
200 try:
201 url = f"{webdaq_base}/info/current/{partition}/is/RunParams/RunParams.RunParams?format=compact"
202 log.debug("Fetching RunParams from: %s", url)
203
204 response = requests.get(url, timeout=10)
205 if response.status_code == 200:
206 response_data = response.json()
207 log.debug("RunParams response from IS: %s", response_data)
208
209 # Response is [name, type, timestamp, data]
210 if isinstance(response_data, list) and len(response_data) >= 4:
211 runparams = response_data[3]
212 else:
213 runparams = response_data
214
215 log.debug("RunParams data: %s", runparams)
216
217 # Map IS fields to our RunParams fields
218 if 'run_number' in runparams:
219 params['run_number'] = int(runparams['run_number'])
220 if 'lumiblock' in runparams:
221 params['lb_number'] = int(runparams['lumiblock'])
222 if 'det_mask' in runparams:
223 params['detector_mask'] = runparams['det_mask']
224 if 'timeSOR' in runparams:
225 sor_time = runparams['timeSOR']
226 # Ensure microseconds are present (TrigSORFromPtreeHelper expects format with .%f)
227 if '.' not in sor_time:
228 sor_time += '.000000'
229 params['sor_time'] = sor_time
230 if 'beam_type' in runparams:
231 params['beam_type'] = int(runparams['beam_type'])
232 if 'beam_energy' in runparams:
233 params['beam_energy'] = int(runparams['beam_energy'])
234 if 'run_type' in runparams:
235 params['run_type'] = runparams['run_type']
236 if 'trigger_type' in runparams:
237 params['trigger_type'] = int(runparams['trigger_type'])
238 if 'recording_enabled' in runparams:
239 params['recording_enabled'] = runparams['recording_enabled'] in ('1', 'true', 'True', True, 1)
240
241 log.info("Got run parameters from IS: run=%s, lb=%s",
242 params.get('run_number'), params.get('lb_number'))
243 else:
244 msg = f"Failed to fetch RunParams from IS: HTTP {response.status_code}"
245 if strict:
246 raise RuntimeError(msg + " (required for --online-environment)")
247 log.warning(msg)
248
249 except requests.exceptions.RequestException as e:
250 msg = f"Error fetching RunParams from IS: {e}"
251 if strict:
252 raise RuntimeError(msg + " (required for --online-environment)")
253 log.warning(msg)
254 except (ValueError, KeyError) as e:
255 msg = f"Error parsing RunParams from IS: {e}"
256 if strict:
257 raise RuntimeError(msg + " (required for --online-environment)")
258 log.warning(msg)
259
260 # Fetch Magnets from IS
261 # In strict mode (online environment), magnets are required unless provided via command line
262 # If command-line overrides are provided, use those instead of fetching from IS
263 have_solenoid_override = solenoid_current_override is not None
264 have_toroids_override = toroids_current_override is not None
265
266 if have_solenoid_override:
267 params['solenoid_current'] = solenoid_current_override
268 log.info("Using solenoid_current=%.1f from command line override", solenoid_current_override)
269 if have_toroids_override:
270 params['toroids_current'] = toroids_current_override
271 log.info("Using toroids_current=%.1f from command line override", toroids_current_override)
272
273 # Only fetch from IS if we need at least one value
274 if not (have_solenoid_override and have_toroids_override):
275 try:
276 url = f"{webdaq_base}/info/current/{partition}/is/Magnets/Magnets.Magnets?format=compact"
277 log.debug("Fetching Magnets from: %s", url)
278
279 response = requests.get(url, timeout=10)
280 if response.status_code == 200:
281 response_data = response.json()
282 log.debug("Magnets response from IS: %s", response_data)
283
284 magnets = response_data[3] if isinstance(response_data, list) and len(response_data) >= 4 else response_data
285 log.debug("Magnets data: %s", magnets)
286
287 # Magnets structure: { "SolenoidCurrent": {"value": ..., "ts": ...},
288 # "ToroidsCurrent": {"value": ..., "ts": ...} }
289 if not have_solenoid_override:
290 params['solenoid_current'] = float(magnets['SolenoidCurrent']['value'])
291 if not have_toroids_override:
292 params['toroids_current'] = float(magnets['ToroidsCurrent']['value'])
293
294 log.info("Got magnet currents from IS: solenoid=%s, toroids=%s",
295 params.get('solenoid_current'), params.get('toroids_current'))
296 elif strict:
297 raise RuntimeError(f"Magnets not available from IS: HTTP {response.status_code} "
298 "(required for --online-environment, use --solenoid-current and --toroids-current to override)")
299 else:
300 log.debug("Magnets not available from IS: HTTP %d", response.status_code)
301
302 except requests.exceptions.RequestException as e:
303 if strict:
304 raise RuntimeError(f"Error fetching Magnets from IS: {e} "
305 "(required for --online-environment, use --solenoid-current and --toroids-current to override)")
306 log.debug("Error fetching Magnets from IS: %s", e)
307 except (ValueError, KeyError, TypeError) as e:
308 if strict:
309 raise RuntimeError(f"Error parsing Magnets from IS: {e} "
310 "(required for --online-environment, use --solenoid-current and --toroids-current to override)")
311 log.debug("Error parsing Magnets from IS: %s", e)
312
313 # In strict mode, verify we got at least run_number from IS
314 if strict and 'run_number' not in params:
315 raise RuntimeError("Failed to get run_number from IS (required for --online-environment)")
316
317 return cls(**params)
318
319

◆ to_dict()

athenaEF.RunParams.to_dict ( self)
Return run parameters as a dictionary for prepareForStart.

Definition at line 112 of file athenaEF.py.

112 def to_dict(self):
113 """Return run parameters as a dictionary for prepareForStart."""
114 return {
115 'run_number': self.run_number,
116 'lb_number': self.lb_number,
117 'detector_mask': self.detector_mask,
118 'sor_time': self.sor_time,
119 'solenoid_current': self.solenoid_current,
120 'toroids_current': self.toroids_current,
121 'beam_type': self.beam_type,
122 'beam_energy': self.beam_energy,
123 'run_type': self.run_type,
124 'trigger_type': self.trigger_type,
125 'recording_enabled': self.recording_enabled,
126 'T0_project_tag': self.T0_project_tag,
127 'stream': self.stream,
128 'lumiblock': self.lumiblock,
129 }
130

Member Data Documentation

◆ beam_energy

athenaEF.RunParams.beam_energy = beam_energy if beam_energy is not None else self.DEFAULT_BEAM_ENERGY

Definition at line 104 of file athenaEF.py.

◆ beam_type

athenaEF.RunParams.beam_type = beam_type if beam_type is not None else self.DEFAULT_BEAM_TYPE

Definition at line 103 of file athenaEF.py.

◆ DEFAULT_BEAM_ENERGY

int athenaEF.RunParams.DEFAULT_BEAM_ENERGY = 0
static

Definition at line 76 of file athenaEF.py.

◆ DEFAULT_BEAM_TYPE

int athenaEF.RunParams.DEFAULT_BEAM_TYPE = 0
static

Definition at line 75 of file athenaEF.py.

◆ DEFAULT_DETECTOR_MASK

str athenaEF.RunParams.DEFAULT_DETECTOR_MASK = 'f' * 32
static

Definition at line 71 of file athenaEF.py.

◆ DEFAULT_LB_NUMBER

int athenaEF.RunParams.DEFAULT_LB_NUMBER = 0
static

Definition at line 70 of file athenaEF.py.

◆ DEFAULT_RECORDING_ENABLED

bool athenaEF.RunParams.DEFAULT_RECORDING_ENABLED = False
static

Definition at line 79 of file athenaEF.py.

◆ DEFAULT_RUN_NUMBER

int athenaEF.RunParams.DEFAULT_RUN_NUMBER = 0
static

Definition at line 69 of file athenaEF.py.

◆ DEFAULT_RUN_TYPE

str athenaEF.RunParams.DEFAULT_RUN_TYPE = "Physics"
static

Definition at line 77 of file athenaEF.py.

◆ DEFAULT_SOLENOID_CURRENT

float athenaEF.RunParams.DEFAULT_SOLENOID_CURRENT = 7730.0
static

Definition at line 73 of file athenaEF.py.

◆ DEFAULT_SOR_TIME

athenaEF.RunParams.DEFAULT_SOR_TIME = None
static

Definition at line 72 of file athenaEF.py.

◆ DEFAULT_TOROIDS_CURRENT

float athenaEF.RunParams.DEFAULT_TOROIDS_CURRENT = 20400.0
static

Definition at line 74 of file athenaEF.py.

◆ DEFAULT_TRIGGER_TYPE

int athenaEF.RunParams.DEFAULT_TRIGGER_TYPE = 0
static

Definition at line 78 of file athenaEF.py.

◆ detector_mask

athenaEF.RunParams.detector_mask = detector_mask if detector_mask is not None else self.DEFAULT_DETECTOR_MASK

Definition at line 99 of file athenaEF.py.

◆ lb_number

athenaEF.RunParams.lb_number = lb_number if lb_number is not None else self.DEFAULT_LB_NUMBER

Definition at line 98 of file athenaEF.py.

◆ lumiblock

athenaEF.RunParams.lumiblock = lumiblock

Definition at line 110 of file athenaEF.py.

◆ recording_enabled

athenaEF.RunParams.recording_enabled = recording_enabled if recording_enabled is not None else self.DEFAULT_RECORDING_ENABLED

Definition at line 107 of file athenaEF.py.

◆ run_number

athenaEF.RunParams.run_number = run_number if run_number is not None else self.DEFAULT_RUN_NUMBER

Definition at line 97 of file athenaEF.py.

◆ run_type

athenaEF.RunParams.run_type = run_type if run_type is not None else self.DEFAULT_RUN_TYPE

Definition at line 105 of file athenaEF.py.

◆ solenoid_current

athenaEF.RunParams.solenoid_current = solenoid_current

Definition at line 101 of file athenaEF.py.

◆ sor_time

athenaEF.RunParams.sor_time = sor_time if sor_time is not None else dt.now().strftime('%d/%m/%y %H:%M:%S.%f')

Definition at line 100 of file athenaEF.py.

◆ stream

athenaEF.RunParams.stream = stream

Definition at line 109 of file athenaEF.py.

◆ T0_project_tag

athenaEF.RunParams.T0_project_tag = T0_project_tag

Definition at line 108 of file athenaEF.py.

◆ toroids_current

athenaEF.RunParams.toroids_current = toroids_current

Definition at line 102 of file athenaEF.py.

◆ trigger_type

athenaEF.RunParams.trigger_type = trigger_type if trigger_type is not None else self.DEFAULT_TRIGGER_TYPE

Definition at line 106 of file athenaEF.py.


The documentation for this class was generated from the following file: