graphicle.data.MomentumArray.delta_R(other: MomentumArray, pseudo: bool = True, threads: int = 1) ndarray[Any, dtype[float64]][source]

Calculates the Euclidean inter-particle distances, \(\Delta R_{ij}\), in the \(\eta-\phi\) plane between this set of particles and a provided other set. Produces a mxn matrix, where m is number of particles in this MomentumArray, and n is the number of particles in other.

Changed in version 0.1.5: Computes 2D matrix of inter-particle distances, enabling comparisons between arbitrary length MomentumArray instances.

Changed in version 0.2.11: Added pseudo and threads parameters.

Parameters:
other : MomentumArray

Four-momenta of the particle set to compute \(\Delta R_{ij}\) against.

pseudo : bool

If False, will use the true rapidity to calculate the inter-particle distances. Default is True.

threads : int

Number of threads over which to parallelise the calculation. Default is 1.

Returns:

Matrix representing the Euclidean distance between the two sets of particles in the \(\eta-\phi\) plane. Rows represent particles in this particle set, and columns particles in the other set.

Return type:

ndarray[float64]

Notes

Infinite values may be encountered if comparing with particles not present on the \(\eta-\phi\) plane, ie. travelling parallel to the beam axis.

Currently multithreading is only enabled for computing distances between particles within the same point cloud, ie. when passing the same instance to the other parameter.


Last update: Jun 27, 2025