showerpipe¶

Pythia¶

class showerpipe.generator.PythiaEvent(showerpipe.base.EventAdapter)[source]

Interface wrapping Pythia8 events, providing access to the event data via NumPy arrays.

class showerpipe.generator.PythiaGenerator(showerpipe.base.GeneratorAdapter)[source]

Wrapper of Pythia8 generator. Provides an iterator over successive showered events in a PythiaEvent instance, whose properties expose the data via NumPy arrays.

showerpipe.generator.repeat_hadronize(...) → Generator[PythiaEvent, None, None][source]

Takes a PythiaGenerator instance with an unhadronised event already generated, and repeatedly hadronises the current event.

Les Houches¶

showerpipe.lhe.source_adapter(source) → Iterator[BufferedIOBase][source]

Context manager to provide a consistent adapter interface for LHE data stored in various formats.

showerpipe.lhe.load_lhe(path: Path | str) → bytes[source]

Load Les Houches file into a bytestring object.

showerpipe.lhe.count_events(source: Path | str | bytes) → int[source]

Returns the number of LHE events stored in source.

showerpipe.lhe.split(source, ...) → Iterator[bytes][source]

Generator, splitting LHE file content into separate bytestrings representing LHE files, with maximum number of events per bytestring equal to stride.

class showerpipe.lhe.LheData[source]

Container for the Les Houches file content.

showerpipe.lhe.event_iter_text(source) → Iterator[str][source]

Iterates over a LHE file, yielding the text contained within an event block. See https://arxiv.org/abs/hep-ph/0109068 for the data layout.

showerpipe.lhe.event_iter(source) → Iterator[LheEvent][source]

Iterates over a LHE file, yielding LheEvent objects, providing attribute access to numpy arrays, containing particle data.