FCC-ee PyWIT Model

This repository contains the Impedance/Wake (I/W) model of the FCC-ee collider.

The intent of this package is to provide the infrastructure needed to develop and maintain the model.

---

Overview

This repository contains the necessary tools to develop the FCC-ee Impedance/Wake Model for the FCC-ee project.

---

🚀 Getting Started

Install PyWIT / xwakes to begin working with the model.

🛠️ PyWIT / xwakes

Toolbox to build and manipulate impedance and wake function models, usable in Xsuite, DELPHI, and others.

📦 Installation

Under a conda environment with Python 3.8+, install via PyPI:

pip install xwakes

🔗 Coupling Xwakes to IW2D

Xwakes can be coupled to IW2D using the executables obtained from compiling the C++ code. Once the Python interface for IW2D is completed, this will no longer be necessary.

Some folders need to be created in the user’s home directory. This can be automatically done after installing Xwakes:

python -c 'import xwakes; xwakes.initialize_pywit_directory()'

⚙️ Building IW2D Executables

Follow the IW2D README.md (https://gitlab.cern.ch/IRIS/IW2D/) to produce the executables:

• flatchamber.x
• roundchamber.x
• wake_flatchamber.x
• wake_roundchamber.x

After building, copy them to your PyWIT IW2D bin folder:

cp /path/to/iw2d/IW2D/cpp/*.x ~/pywit/IW2D/bin

📂 Get the FCC-ee Repository

git clone https://github.com/ImpedanCEI/fcc_ee_pywit_model/fcc_ee_pywit_model

📚 Examples & Hands-on Material

git clone https://github.com/ImpedanCEI/fcc_ee_pywit_model/tree/main/CEI_section_meeting

📁 Contents

• Different optics have been analyzed:

  • 📄GHC V23 by K. Oide: FCCWeek_Optics_Oide_230606
  • 📄GHC V24.4 by K. Oide: Optics_Oide_241106
  • 📄GHC V25.2 by K. Oide: Optics_Oide_bx*:techi_250424
  • 📄LCC by P. Raimondi: LCC optics developments.pdf

• 💡 Various examples demonstrating how the code works are available,

• 🎯 The collimators group has been specialized to give the possibility to have different emittances in x/y.