Go Back to: C++ Manual General Site

LDMX.EventBuilder package

Submodules

LDMX.EventBuilder.eventbuilder module

Module for configuring the EventBuilder producer

class LDMX.EventBuilder.eventbuilder.EventBuilder(instance_name: str = 'EventBuilder', histograms: list[Histogram] = <factory>, dat_file: str = '', output_name: str = 'PhysicsEventData', verbose_parse: bool = True, coherence_window_ns: float = 5000000.0, reorder_window_ns: float = 0.0, min_subsystems: int = 2, binary_file: str = 'events.bin', performance_file: str = 'event_performance.csv')

Bases: Processor

Configuration for the eventbuilder::EventBuilder producer.

dat_file

Path to the input raw dat file.

Type:

str

output_name

Name for the output product placed on the event bus.

Type:

str

verbose_parse

Enable verbose parsing output.

Type:

bool

coherence_window_ns

Coherence window in nanoseconds for collecting fragments from the same physics event.

Type:

float

reorder_window_ns

How much later than the coherence window a fragment must be before the oldest event is closed, so that fragments arriving out of order (contributors interleaved at high trigger rate) still join their event. Same units as the RoR timestamps. Default 0.

Type:

float

min_subsystems

Minimum number of distinct subsystems required within the coherence window to assemble an event. Default 2 (e.g. Run 182 has only ts + tracker); set higher for runs that read out more subsystems.

Type:

int

binary_file

Binary event output, empty to disable.

Type:

str

performance_file

Performance metrics CSV, empty to disable.

Type:

str

binary_file: str = 'events.bin'
class_name: str = 'eventbuilder::EventBuilder'
coherence_window_ns: float = 5000000.0
dat_file: str = ''
instance_name: str = 'EventBuilder'
min_subsystems: int = 2
module_name: str = 'EventBuilder'
output_name: str = 'PhysicsEventData'
performance_file: str = 'event_performance.csv'
reorder_window_ns: float = 0.0
verbose_parse: bool = True
LDMX.EventBuilder.eventbuilder.from_dat_file(dat_file, output_name='PhysicsEventData', verbose_parse=True, coherence_window_ns=5000000.0, reorder_window_ns=0.0, min_subsystems=2, instance_name=None)

Convenience factory to create a configured EventBuilder.

Example

evb = from_dat_file(‘data.dat’) p.sequence = [ evb ]

Module contents