graphicle.select.partition_descendants(graph: Graphicle, hier: MaskGroup[MaskGeneric], pt_exp: float = -0.1) MaskGroup[MaskGeneric][source]

Partitions the final state descendants with mixed hard partonic heritage, by aligning them with their nearest ancestor.

New in version 0.1.11.

Parameters:
graph : Graphicle

The generation DAG of the event.

hier : MaskGroup

Nested MaskGroup tree structure representing the hierarchy of the hard process, obtained with hierarchy().

pt_exp : float

Exponent to raise the transverse momentum weighting on the distances. Passing pt_exp=0.0 will result in standard delta R distances from partons to hadrons. Setting this to a negative value ensures infrared safety. High negative values will bias high transverse momentum partons to claim all of the hadrons. Default is -0.1.

Returns:

Same nested tree structure as input, but with the final state hadrons partitioned to their nearest hard parton ancestor.

Return type:

MaskGroup


Last update: Jun 27, 2025