- graphicle.select.clusters(graph: Graphicle, radius: float) MaskGroup[MaskArray][source]
Cluster and tag the final state particles in an event represented by a
Graphicleobject. These clusters are formed by considering the topology of the directed acyclic graph (DAG) generating the event, tracking descendants of hard partons, and the momenta of the hard partons compared against the final state particles.New in version 0.2.8.
The steps defining this algorithm are summarised:
Find descendants of all hard partons within DAG
Remove final state radiation from descendants
Where descendants of multiple hard partons annihilate color with each other, assign exclusive parentage of subsequent color neutral particles to closest hard parton in the pseudorapidity-azimuth (\(\eta-\phi\)) plane
Where background is used to annihilate color of hard parton descendants, remove all final state particles beyond a distance of
radiusfrom the position of the hard parton in the \(\eta-\phi\) plane
- Parameters:¶
- Returns:¶
Flat
MaskGroup, containingMaskArrayinstances which reconstruct the hard partons from the final state particles.- Return type:¶
Notes
Hard partons may be color connected with each other, or with the underlying event. eg. for a hierarchical clustering:
MaskGroup(agg_op=OR) ├── t │ ├── b │ └── W+ │ ├── c │ └── s~ └── t~ ├── b~ └── W- ├── s └── c~the quarks decaying from the W bosons are color-connected to each other, as they form from a color-singlet. This means they will almost certainly annihilate their color with each other during hadronisation. However, the top quarks are color connected to the underlying event, and therefore will almost certainly annihilate their color with partons that do not descend from the hard process. This is done via proxy of the bottom quark, which inherits its color from the top. This results in background radiation in the descendants tree of the bottom quark, spread over a wide region of the \(\eta-\phi\) plane. This is when the
radiusparameter is applied, excluding all final state descendants whose distance from the hard bottom quark exceeds the value passed, cleaning up the signal.
Last update:
Jun 27, 2025