LHECompleter

class madspace.LHECompleter(self: madspace._madspace_py.LHECompleter, subproc_args: collections.abc.Sequence[madspace._madspace_py.SubprocArgs], bw_cutoff: SupportsFloat)

Bases: pybind11_object

Fills in the non-kinematic data of an LHEEvent from sampled indices.

The matrix element only returns momenta and the sampled diagram, color, flavor and helicity indices; a LHECompleter turns those into the PDG ids, color flow, mother/daughter structure, mass and spin of every LHEParticle, per subprocess. Built once from the topology and color/flavor bookkeeping of every subprocess (SubprocArgs), then reused for every event via complete_event_data.

Parameters:

  • subproc_args – Bookkeeping for every subprocess, indexed like subprocess_index in complete_event_data.

  • bw_cutoff – Number of widths within which a propagator is sampled on its Breit-Wigner resonance.

complete_event_data(self: madspace._madspace_py.LHECompleter, event: madspace._madspace_py.LHEEvent, subprocess_index: SupportsInt, diagram_index: SupportsInt, color_index: SupportsInt, flavor_index: SupportsInt, helicity_index: SupportsInt, rand_gen: madspace._madspace_py.MixMaxRandom) → None

Fill in event’s PDG ids, color flow, mother/daughter links, masses and spins from the sampled indices.

event.particles must already hold the momenta, one entry per particle.

Parameters:

  • event – The event to complete, modified in place.

  • subprocess_index – Index into the subproc_args passed to the constructor.

  • diagram_index – Sampled diagram.

  • color_index – Sampled color configuration.

  • flavor_index – Sampled flavor assignment.

  • helicity_index – Sampled helicity configuration.

  • rand_gen – RNG stream, used to sample resonance masses.

static load(file: str) → madspace._madspace_py.LHECompleter

Load a completer previously written with save.

property max_particle_count

Largest particle count over every subprocess.

save(self: madspace._madspace_py.LHECompleter, file: str) → None

Serialize this completer’s bookkeeping to file.