The OPALX Universe

User guide, physics manual, reference, and developer handbook

Main Developers & Institutions

Andreas Adelmann (PSI); Ryan Ammann (PSI/ETH); Yuanjie Bi (Sun Yat-sen University); John Biddiscombe (CSCS/ETH); Pedro Calvo (CIEMAT); Carl Jolly (RAL); Severin A. T. Klapproth (PSI/ETH); Alexander Liemen (PSI/ETH); Sriramkrishnan Muralikrishnan (JSC); Chris Rogers (RAL); Mohsen Sadr (PSI/MIT); Jochem Snuverink (PSI); Jonathan Thompson (RAL); Daniel Winklehner (MIT); Michail Zampetakis (PSI)

Paul Scherrer Institute (PSI)
ETH Zurich
CIEMAT
UK Research and Innovation Science and Technology Facilities Council
Massachusetts Institute of Technology (MIT)
Forschungszentrum Jülich
Sun Yat-sen University
Swiss National Supercomputing Centre (CSCS)

News

Release news ·

OPALX 1.1.0 released 15.11.2026

New FFA and cyclotron capabilities, faster space-charge calculations, bunch-train support, and temperature diagnostics.

Read the release notes
1 / 4

PSI MuE4

Download movie (MP4, 121 MB)

Latest Changes to the Manual

Date Change
2026-11-17 Use the verified download URL for the FFA26 course ZIP
2026-11-17 Add Schools catalog and the FFA26 Melbourne course page
2026-11-15 Announce OPALX 1.1.0 as the first News item

View full commit history

Simulate charged-particle accelerators across CPUs and GPUs

OPALX brings high-statistics, three-dimensional beam dynamics to CPUs and GPUs. Find the user guide, physics models, command reference, and developer handbook in one searchable manual.

Find your path

Start here

Getting Started

Build OPALX, choose a platform backend, and run a first input file.

Get started

Run simulations

User Guide

Learn the input language, beam definitions, runtime options, tracking workflow, elements, reusable structures, field solvers, and outputs.

Read the user guide

Understand the models

Physics

Follow coordinate conventions, equations of motion, element fields, collective effects, decay, spin, and photon physics.

Explore the physics

Look something up

Reference

See the commands and elements registered by the current executable, build configuration, file formats, and external API documentation.

Open the reference

Contribute

Developer Guide

Understand the architecture, build and test workflows, and how to add features without losing GPU portability.

Read the developer guide

Resolve a problem

Troubleshooting

Diagnose build and runtime failures, prepare reproducible bug reports, and check known limitations.

Troubleshoot OPALX

Acknowledgments and citation

OPALX builds on the original OPAL project and is developed across PSI and its international accelerator-science partners. Use the publications and citation guidance when citing the software. The original OPAL manual remains available as a separate historical resource.