Returns a MaskGroup instance to select particle descendants of target hard partons (by PDG code).

Parameters:¶

graph : Graphicle¶

Particle graph containing at least PdgArray and StatusArray.

target : Iterable[int], optional¶

PDG codes referring to the hard particles for which descendants are obtained. If None, will obtain masks for all intermediate and outgoing hard partons. Default is None.

sign_sensitive : bool¶

Indicates whether sign of PDG code should be used when selecting hard partons, ie. if set to False both particle and anti-particle partons will be masked, whereas if True only the partons explicitly matching the target sign will be considered. Default is False.

strict : bool¶

If True all PDGs in target must be present in the hard process. If False, only a subset need be present. Default is True.

Returns:¶

Collection of masks over the event indicating the descendants of partons from within the hard process.

Return type:¶

MaskGroup[MaskArray]

Raises:¶

ValueError – If PDG codes required by target and strict are absent from the partons in the hard process.