CEI-meeting-hands-on

Wakis introduction and hands-on examples prepared for the CEI section meeting: https://indico.cern.ch/event/1558967/

Involving all our in-house python-packages of the impedance assessment workflow:

• Wakis for the 3D electromagnetic wakefield simulations,
• IDDEFIX for partially decayed wake extrapolation,
• BIHC for impedance-induced beam power loss, and
• neffint for impedance to wake function conversion for beam dynamics simulations.

Getting started

You can install wakis from GitHub to have the latest changes into your conda environment:

pip install wakis['notebook']
pip install bihc neffint iddefix # optional satellite packages

GPU setup

wakis uses cupy to access GPU acceleration with the supported NVIDIA GPUs (more info in Cupy's website). Provided a compatible NVIDIA CUDA GPU or AMD ROCm GPUs with the adequate drivers & Toolkit:

conda install -c conda-forge cupy cuda-version=11.8

MPI setup

To run multi-CPU parallelized simulations, Wakis needs the following packages:

• OpenMPI installed in your operating system:
• Python package mpi4py
• Python package ipyparallel to start a MPI kernel inside notebooks

The preferred install method is through conda-forge:

conda install -c conda-forge mpi4py openmpi
pip install ipyparallel