Phoenix API Docs
  1. Miscellaneous
  2. Variables

Index

src/helpers/kinematics-config.ts

ATLAS_KINEMATICS
Type : KinematicsConfig
Default value : { title: 'Track Momenta', collectionType: 'Tracks', defaultSort: 'pT', defaultSortDirection: 'desc', filterColumn: 'pT', columns: [ { id: 'pT', label: 'pT', unit: 'GeV', tooltip: 'Transverse momentum', getter: (t) => (t.pT ?? 0) / 1000, precision: 1, }, { id: 'eta', label: '\u03B7', tooltip: 'Pseudorapidity', getter: (t) => t.eta ?? 0, precision: 2, }, { id: 'phi', label: '\u03C6', tooltip: 'Azimuthal angle', getter: (t) => t.phi ?? 0, precision: 2, }, { id: 'charge', label: 'q', tooltip: 'Electric charge', getter: (t) => { if (t.charge != null) return t.charge; const qOverP = t.dparams?.[4]; return qOverP ? Math.sign(qOverP) : 0; }, precision: 0, }, { id: 'p', label: '|p|', unit: 'GeV', tooltip: 'Total momentum', getter: (t) => { const qOverP = t.dparams?.[4]; if (!qOverP || !isFinite(1 / qOverP)) return 0; return Math.abs(1 / qOverP) / 1000; }, precision: 1, }, ], }

Default ATLAS track kinematics config for JiveXML/PHYSLITE data.

src/helpers/invariant-mass.ts

ATLAS_MASTERCLASS_CONFIG
Type : MasterclassConfig
Default value : { title: 'Masterclass: Invariant Mass', particleTags: [ { id: 'electron', label: 'Electron', symbol: 'e\u00B1', color: '#f0c040', mass: 0.511, }, { id: 'muon', label: 'Muon', symbol: '\u03BC\u00B1', color: '#40c060', mass: 105.658, }, { id: 'photon', label: 'Photon', symbol: '\u03B3', color: '#e04040', mass: 0, }, ], hints: [ 'Z boson \u2248 91 GeV', 'Higgs \u2248 125 GeV', 'J/\u03C8 \u2248 3.1 GeV', ], classifyEvent: atlasClassifyEvent, }

Default masterclass configuration for ATLAS Z-path exercises.

src/loaders/physlite-loader.ts

DEFAULT_COLLECTIONS
Type : PHYSLITECollectionDef[]
Default value : [ { prefix: 'AnalysisElectronsAuxDyn', fields: ['pt', 'eta', 'phi', 'm'], phoenixType: 'Electrons', collectionName: 'AnalysisElectrons', }, { prefix: 'AnalysisMuonsAuxDyn', fields: ['pt', 'eta', 'phi'], phoenixType: 'Muons', collectionName: 'AnalysisMuons', }, { prefix: 'AnalysisPhotonsAuxDyn', fields: ['pt', 'eta', 'phi', 'm'], phoenixType: 'Photons', collectionName: 'AnalysisPhotons', }, { prefix: 'AnalysisJetsAuxDyn', fields: ['pt', 'eta', 'phi', 'm'], phoenixType: 'Jets', collectionName: 'AnalysisJets', }, { prefix: 'AnalysisLargeRJetsAuxDyn', fields: ['pt', 'eta', 'phi', 'm'], phoenixType: 'Jets', collectionName: 'AnalysisLargeRJets', }, { prefix: 'InDetTrackParticlesAuxDyn', fields: ['d0', 'z0', 'theta', 'phi', 'qOverP'], phoenixType: 'Tracks', collectionName: 'InDetTrackParticles', }, { prefix: 'MuonSpectrometerTrackParticlesAuxDyn', fields: ['d0', 'z0', 'theta', 'phi', 'qOverP'], phoenixType: 'Tracks', collectionName: 'MuonSpectrometerTrackParticles', }, { prefix: 'CombinedMuonTrackParticlesAuxDyn', fields: ['d0', 'z0', 'theta', 'phi', 'qOverP'], phoenixType: 'Tracks', collectionName: 'CombinedMuonTrackParticles', }, { prefix: 'ExtrapolatedMuonTrackParticlesAuxDyn', fields: ['d0', 'z0', 'theta', 'phi', 'qOverP'], phoenixType: 'Tracks', collectionName: 'ExtrapolatedMuonTrackParticles', }, { prefix: 'GSFTrackParticlesAuxDyn', fields: ['d0', 'z0', 'theta', 'phi', 'qOverP'], phoenixType: 'Tracks', collectionName: 'GSFTrackParticles', }, { prefix: 'MET_Core_AnalysisMETAuxDyn', fields: ['mpx', 'mpy'], phoenixType: 'MissingEnergy', collectionName: 'MET', }, { prefix: 'PrimaryVerticesAuxDyn', fields: ['x', 'y', 'z'], phoenixType: 'Vertices', collectionName: 'PrimaryVertices', }, { prefix: 'egammaClustersAuxDyn', fields: ['calE', 'calEta', 'calPhi'], phoenixType: 'CaloClusters', collectionName: 'egammaClusters', }, ]

Default PHYSLITE branch mapping for ATLAS Open Data. Branch names verified against the official get_json_phoenix.py script.

src/helpers/eta-phi-config.ts

DEFAULT_ETA_PHI_CONFIG
Type : Required<EtaPhiConfig>
Default value : { etaRange: [-5, 5], phiRange: [-Math.PI, Math.PI], etaBins: 100, phiBins: 63, energyThreshold: 0, logScale: true, }

Default ATLAS-style eta-phi configuration.

src/managers/ui-manager/index.ts

defaultAnimationPresets
Type : AnimationPreset[]
Default value : [ { name: 'Cavern to ID', positions: [ { position: [66388.95051168812, 5264.228603228927, -46910.7848593543], duration: 1000, }, { position: [12834.18729094943, 677.7571205763458, 135.68755273443463], duration: 2000, }, { position: [312.02688693297375, 25.884223757326, 270.10019006776236], duration: 3500, }, { position: [263.3640855132258, 19.874838262525053, -318.16541790248885], duration: 3000, }, { position: [5534.140362338047, 234.03507981484574, -2933.619479808285], duration: 2000, }, { position: [2681.277288705242, 646.5795158318147, 5628.5248735111745], duration: 1000, }, { position: [-6062.586283740076, 790.5876682946184, 1381.1675900848818], duration: 1000, }, { position: [-1766.7693725879053, 1007.1048030984678, -5928.901341784575], duration: 1000, }, { position: [12814.982506255355, 2516.987185037266, -22891.902734328327], duration: 1000, }, ], animateEventAfterInterval: 5000, collisionDuration: 6000, }, ]

If animation presets not passed in configuration, we will use this.

src/helpers/event-summary.ts

DETECTOR_LEVEL_TYPES
Type : unknown
Default value : new Set([ 'CaloCells', 'Hits', 'PlanarCaloCells', 'IrregularCaloCells', ])

Detector-level types that are fixed per detector, not per event.
OBJECT_COLLECTION_TYPES
Type : unknown
Default value : [ 'Tracks', 'Jets', 'Hits', 'CaloClusters', 'CaloCells', 'Muons', 'Photons', 'Electrons', 'Vertices', 'MissingEnergy', 'PlanarCaloCells', 'IrregularCaloCells', ] as const

Known collection types that hold arrays of physics objects.

src/helpers/constants.ts

EVENT_DATA_TYPE_COLORS
Type : object
Default value : { Hits: new Color(0xff0000), Tracks: new Color(0xff0000), Jets: new Color(0x2194ce), CaloClusters: new Color(0xffd166), MuonChambers: new Color(0xff0000), Vertices: new Color(0xffd166), MissingEnergy: new Color(0xffffff), PlanarCaloCells: new Color(0xfff69a), }

Colors of different event data types.

src/helpers/browser-storage.ts

getFromLocalStorage
Type : unknown
Default value : (item: string) => { try { return localStorage.getItem(item); } catch (exception) { console.warn('Exception in localStorage', exception); } }

Get an item from local storage.
setToLocalStorage
Type : unknown
Default value : (item: string, value: string) => { try { localStorage.setItem(item, value); } catch (exception) { console.warn('Exception in localStorage', exception); } }

Set item to local storage.

src/helpers/labels.ts

getLabelTitle
Type : unknown
Default value : ( eventDataType: string, collection: string, index: string | number, ) => `${eventDataType} > ${collection} > ${index}`

Get title of the label.

src/helpers/file.ts

loadFile
Type : unknown
Default value : ( onFileRead: (data: string) => void, contentType: string = 'application/json', ) => { // Create a mock input file element and use that to read the file const inputFile = document.createElement('input'); document.body.appendChild(inputFile); inputFile.type = 'file'; inputFile.accept = contentType; inputFile.onclick = (e: any) => { e.target.value = ''; }; inputFile.addEventListener('invalid', (e) => { console.log(JSON.stringify(e)); }); const fileSelected = (e: any) => { const configFile = e.target?.files[0]; const reader = new FileReader(); reader.onload = (e) => { if (e.target && e.target.result) { onFileRead?.(e.target.result.toString()); } inputFile.remove(); }; reader.readAsText(configFile); }; inputFile.oninput = fileSelected; // inputFile.onchange = fileSelected; inputFile.click(); }

Load a file from user by mocking an input element.
saveFile
Type : unknown
Default value : ( data: string, fileName: string, contentType: string = 'application/json', ) => { const blob = new Blob([data], { type: contentType }); const tempAnchor = document.createElement('a'); tempAnchor.style.display = 'none'; tempAnchor.href = URL.createObjectURL(blob); tempAnchor.download = fileName; tempAnchor.click(); tempAnchor.remove(); }

Save and download file with the given data.

src/managers/url-options-manager.ts

phoenixURLOptions
Type : object
Default value : { file: '', type: '', config: '', state: '', hideWidgets: false, embed: false, }

Model for Phoenix URL options.

src/helpers/zip.ts

readZipFile
Type : unknown
Default value : async (file: File | ArrayBuffer) => { const archive = new JSZip(); const filesWithData: { [fileName: string]: string } = {}; await archive.loadAsync(file); for (const filePath in archive.files) { const fileData = (await archive.file(filePath)?.async('string')) ?? 'Unable to read file'; filesWithData[filePath] = fileData; } return filesWithData; }

Read a zip file and return its contents as an object.

src/loaders/objects/tracks.ts

tracks_frag
Type : unknown
Default value : [ 'uniform float progress;', 'varying vec3 v_color;', 'varying float v_counter;', 'flat varying int v_track_id;', 'void main() {', ' if (v_counter > progress) discard;', ' gl_FragColor = vec4(v_color, 1.0);', '}', ].join('\n')

Custom fragment shadre for track.
tracks_vert
Type : unknown
Default value : [ 'attribute vec3 previous;', 'attribute vec3 next;', 'attribute int track_id;', 'attribute float side;', 'attribute vec3 color;', 'attribute float linewidth;', 'attribute float counter;', 'varying vec3 v_color;', 'varying float v_counter;', 'flat varying int v_track_id;', 'uniform vec2 resolution;', // 'uniform float lineWidth;', 'void main() {', ' vec2 aspect = vec2(resolution.x / resolution.y, 1.0);', '', ' v_color = color;', ' v_counter = counter;', ' v_track_id = track_id;', '', ' mat4 m = projectionMatrix * modelViewMatrix;', ' vec4 finalPosition = m * vec4(position, 1.0);', ' vec4 prevPos = m * vec4(previous, 1.0);', ' vec4 nextPos = m * vec4(next, 1.0);', '', ' vec2 curP = finalPosition.xy / finalPosition.w * aspect;', ' vec2 prevP = prevPos.xy / prevPos.w * aspect;', ' vec2 nextP = nextPos.xy / nextPos.w * aspect;', '', ' vec2 dir;', ' if (curP == prevP) dir = normalize(nextP - curP);', ' else if (curP == nextP) dir = normalize(curP - prevP);', ' else dir = normalize(curP - prevP);', '', ' vec2 normal = vec2(-dir.y, dir.x);', ' normal.xy *= .5 * linewidth;', ' normal.x /= aspect.x;', ' normal.xy *= finalPosition.w * 0.001;', ' finalPosition.xy += normal.xy * side;', ' gl_Position = finalPosition;', '}', ].join('\n')

Custom vertex shader for tracks.

results matching ""

    No results matching ""