Identifies groups of outgoing partons from the hard process which form color singlets.

Parameters:¶

leaves : MaskGroup[MaskArray]¶

Innermost nested MaskArray instances, obtained from calling hierarchy() followed by leaf_masks() on a Graphicle object.

status : StatusArray¶

The status codes for the event.

color : ColorArray¶

The color / anticolor pair values for the event.

invert : bool¶

If True, will invert the operation to find all colored particles in the hard process which are not grouped with other partons in the hard-process to form a color-singlet. Default is False.

Returns:¶

Tuples of keys, grouping the color-connected partons in the hard process.

Return type:¶

list[tuple[str, …]]

Notes

This function checks for color singlets formed from two color triplets (quarks), or two color triplets plus a color octet (gluon). It does not check for color singlets formed from three colour triplets. This functionality may be added in future.