Bring your particle physics data to life! ✨
Colliderscope is a Python package for beautiful, interactive, and insightful visualisation of high-energy physics (HEP) data. Whether you're exploring complex event histories or slicing through pseudorapidity-azimuth space, colliderscope helps you understand your simulations and results visually and intuitively.
- Visualise entire Monte Carlo event histories as directed acyclic graphs (DAGs) using graphicle
- Nodes represent interactions; edges are particles flowing through the event
- Final state particles are displayed as ⭐️ star-shaped nodes and labelled (pi0, gamma, etc.)
- Hover to explore particle flows and interaction vertices
- Use boolean masks to highlight specific event chains or particle types
- Create rich interactive scatter plots of particles in pseudorapidity (η) vs azimuthal angle (ϕ) space using Plotly
- Group particles by ancestor, status, or custom logic using named masks
- Toggle group visibility in the legend, and zoom or pan effortlessly
- Apply flexible cuts on
$\eta$ ,$p_T$ , and control whether$\phi$ is shown in units of π - Supports labels, titles, and metadata for use in Dash or other callbacks
- Build memory-efficient 1D and 2D histograms with constant space usage
- Track overflow bins and compute normalised densities for visualisation
- Serialise and deserialise histograms easily for I/O or logging workflows
- Use plotly to render your histograms with options for:
- Bar or line plot styles
- Overlaid datasets or probability density functions
- Adjustable opacity for layered plots
- Full interactivity: tooltips, zoom, and legend toggling
Get started in seconds via PyPI:
pip install colliderscope
A full API reference is hosted in our documentation.