MESS - MAD-X Example Study Scripts

This repository is a collection of MAD-X scripts used for various studies in the optics measurements and corrections group (OMC).

Getting Started

The scripts can be browsed via github or the full repository can be obtained either via git clone https://github.com/pylhc/MESS.git or downloading the zipped repository.

Prerequisites

To run the scripts, MAD-X is required. If not otherwise stated, all scripts have been tested using MAD-X > 5.05.02.

Documentation

• Each script directory contains a README, outlining the basic functionality and notes on possible pitfalls.
• Excessive use of comments in the MAD-X scripts itself is encouraged.
• General documentation of the OMC Team is located at https://pylhc.github.io/.

Maintainability

• The main scripts should be named job.madx and placed in an accordingly named directory in the directory tree.
• Supporting files should be uploaded in the script directory. Links to external afs directories should be avoided as files might be modified there or removed.
• Running with the minimum amount of unavoidable MAD-X errors is prefered.

Studies

• LHC - The flagship collider of the 21st century
  • Coupling RDT Bump - Creates closed coupling bumps in the LHC IR2 and Arc12. For Beam2, a model twiss for clockwise orientation is created and then tracking is performed using the correct counterclockwise sequence of Beam2.
  • Sextupole RDT Bump - Creates closed sextupole RDT bump in Arc12.
  • Injectionenergy with misaligments and correction - Realistic model of the LHC at injection energy with misaligments and nonlinear correction.
  • Kmod simulation - Simulating K-Modulation in one Q1 quadrupole.
  • Tracking with ACD - Setup for AC-dipole in LHC and subsequent tracking.
  • Model Creation with ACD - Setup for twiss outputs taking in consideration the effect of AC dipoles.
• FODO Testlattice - Small FODO lattice for benchmarking theories and scripts
  • Lattice Setup - Setting up basic lattice and return twiss.
  • Phase Trombone - Setting up basic lattice, match tunes via a phase trombone and return twiss.
  • Phase Error Propagation - Setting up basic lattice, examine phase error under different boundary conditions
• PETRA3 - PETRA III, DESY's brilliant X-ray light source
  • Model Creation - Creates model twiss files with AC-dipole and tune selection.

Authors

• pyLHC/OMC-Team - Working Group - pyLHC

License

This project is licensed under the MIT License - see the LICENSE file for details