colliderscope.eta_phi_network(pmu: Iterable[tuple[float, float, float, float]], radius: float | None = None, adj_matrix: ndarray[Any, dtype[bool_]] | ndarray[Any, dtype[float64]] | None = None, title: str | None = None, color: Iterable[float] | None = None, colorbar_title: str | None = None, marker_symbols: Iterable[str | int] | None = None, pi_units: bool = True) PlotlyFigure

Produces a Plotly figure which calculates interparticle distance, and connects particles in a network visualisation when they are within radius of each other.

New in version 0.2.3.

Parameters:
pmu : iterable[tuple[float, float, float, float]]

Representing the four-momenta of the particles, in the order \(x, y, z, E\). Numpy arrays with four columns, or graphicle MomentumArrays may be passed.

radius : float, optional

Interparticle angular distance on the \(\eta-\phi\) plane below which nodes in the network will be considered adjacent. Default is None.

adj_matrix: ndarray[Any, dtype[bool_]] | ndarray[Any, dtype[float64]] | None = None

Alternatively to passing radius, adj_matrix can specify the neighbourhood directly. Default is None.

title : str, optional

Main heading for the figure. Default is None.

color : iterable[float], optional

If passed, will add a colorbar to the figure, and the values provided here will be used to define the color of each node. Default is None.

colorbar_title : str, optional

String label used to annotate the colorbar. Default is None.

marker_symbols : iterable[int | str], optional

Symbols defining the shape of markers. Must be of same length as pmu. For symbol names / codes, see: https://plotly.com/python/marker-style/#custom-marker-symbols. Default is None.

pi_units : bool

If True, will rescale the \(\phi\)-axis to range \([-1, 1]\), by putting it in units of \(\pi\). Default is True.

Returns:

Plotly figure of particles on the \(\eta-\phi\) plane, with edges connecting adjacent particles, defined by radius.

Return type:

PlotlyFigure


Last update: Jun 27, 2025