Default event classifier for ATLAS Z-path masterclass. Classifies events by electron/muon/photon counts.

Extract a 4-momentum vector from a calorimeter cluster. Clusters have energy, eta, phi (treated as massless).

Extract a 4-momentum vector from track userData. Tracks have pT, eta/phi (or dparams), and we assign mass from the tag definition.

Compute the invariant mass of a set of particles in MeV. M² = (ΣE)² - (Σpx)² - (Σpy)² - (Σpz)²

Pre-scan all events and build a summary index. This is the main entry point for the event browser.

Compute missing transverse energy magnitude from MET collections. Returns NaN if no MET data is present.

Count all physics objects in a single event. Each collection type (Tracks, Jets, etc.) can have multiple named sub-collections.

Get all unique collection type names across all events. Reconstructed physics objects are listed first, detector-level types last.

Build a summary for a single event.

Decode a base64 deflate-compressed session payload, validate it, and cap the decompressed output to defend against compression bombs.

Validated SessionV1.

Parse a raw JSON .phnxreplay file payload and validate it.

Validated SessionV1.

Encode a session as a URL-safe base64 string of deflate-compressed JSON. Mirrors the share-link-dialog state encoding so the decoder can use the existing DecompressionStream('deflate') plumbing.

Base64 string suitable for ?replay= URLs.

Serialize a session to a downloadable JSON Blob (compact, uncompressed) for sharing as a .phnxreplay file. Compact (not pretty-printed) keeps the file small while staying valid JSON that the ?session= loader can re-read.

Blob with MIME type application/json.

Pipe a Uint8Array through a transform stream and collect the output. Avoids Blob.stream() and Response, both of which jsdom lacks.

Concatenated output bytes.

Extract a human-readable message from an unknown thrown value.

The error message string.

Returns default configs for all built-in Phoenix object types.

Get the colors of the materials of an object, which are the colors it is drawn with.

Most materials have a color, but some - like the shader material jets are drawn with - keep it in a uniform instead.

The colors of the object's materials, as references which can be changed to recolor the object.

Get the colour an object is currently drawn with.

This is the counterpart of setColorForObject and has to stay in step with it: it is used to show the collection's real colour in the UI, rather than guessing it from the event data.

The colour of the first coloured object found, or undefined if there is none.

Change colour of object.

Linear interpolation between two numbers.

The interpolated value.

Parse a colour as it may appear in event data.

Event data is written by many different producers, so the same colour turns up as ff0000, #ff0000 or 0xff0000. All three are accepted here, along with a number, an existing Color, and any style Color.set understands (rgb(...), hsl(...), or a named colour).

Anything unrecognised gives undefined rather than a silently wrong colour, so callers can fall back to a sensible default of their own - see EVENT_DATA_TYPE_COLORS.

The parsed colour, or undefined if it could not be parsed.

Validate that an arbitrary value is a structurally-valid SessionV1. Defensive against malformed JSON, untrusted URL payloads and version skew from older or newer producers.

The value typed as SessionV1, or null when invalid.