ALBuMS

ALBuMS (Algorithms for Longitudinal Multibunch Beam Stability) is an open-source Python package for double rf system stability analysis.

Double rf systems are critical for achieving the parameters of 4th-generation light sources. These systems, comprising both main and harmonic rf cavities, relax statistical collective effects but also introduce instabilities, such as Robinson and periodic transient beam loading (PTBL) instabilities.

ALBuMS semi-analytical algorithms are designed to predict and analyze these instabilities.

The algorithms leverage recent advancements in the field, offering a computationally efficient and accurate complement to multibunch tracking simulations.

These algorithms can optimize rf cavity parameters in high-dimensional parameter spaces, thereby maximizing the Touschek lifetime.

Usage

A few examples of how to use ALBuMS are provided in the examples and benchmark_aladdin folders:

benchmark_aladdin

• Passive harmonic cavity case w/ standard Aladdin lattice
• Active harmonic cavity case w/ standard Aladdin lattice
• Active harmonic cavity case w/ LF20 Aladin lattice
• Passive harmonic cavity case w/ LF20 Aladdin lattice

examples

• SOLEIL II instability map
• SOLEIL II optimize RoQ/Q0
• Instabilities in single RF systems

Installation

Using docker

A docker image is available:

docker pull gitlab-registry.synchrotron-soleil.fr/pa/collective-effects/albums:latest

References

If used in a publication, please cite both:

• ALBuMS (using the Zenodo archive and DOI)
• The following article:

Gamelin, A., Gubaidulin, V., Alves, M. B., & Olsson, T. (2024). Semi-analytical algorithms to study longitudinal beam instabilities in double rf systems. arXiv preprint arXiv:2412.06539.