README.md

metadata

title: ColliderML Event Display
emoji: 🔭
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.50.0
python_version: '3.12'
app_file: app.py
pinned: false
license: apache-2.0

ColliderML Event Display

Interactive 3D visualisation of single events from the ColliderML datasets.

Pick a physics process and an event ID to see the tracker hits, reconstructed tracks, and truth particles inside the OpenDataDetector geometry.

Local development

pip install -r requirements.txt
python app.py
# Open http://localhost:7860

Caching

The app pre-caches a small set of events per dataset on first load via colliderml.load(). Subsequent loads are instant. To populate the on-disk cache ahead of deploy, run:

python cache_events.py

Cached parquets land under _cached_events/<dataset>/*.parquet and are picked up automatically at runtime.

Deployment

Synced automatically from spaces/event-display/ on the OpenDataDetector/ColliderML repo via the sync-spaces.yml workflow (see commit B7 of the v0.4.0 migration).