3D Electromagnetic Time-Domain wake and impedance solver
Project description
Wake and Impedance Solver
wakis
is a 3D Time-domain Electromagnetic solver that solves the Integral form of Maxwell's equations using the Finite Integration Technique (FIT) numerical method. It computes the longitudinal and transverse wake potential and beam-coupling impedance from the simulated electric and magnetic fields. It is also a multi-purpose solver, capable of simulating planewaves interaction with nano-structures, optical diffraction, and much more!
About
:rocket: Some of wakis
features:
- Wake potential and impedance calculations for particle beams with different relativistic $\beta$
- Material tensors: permittivity $\varepsilon$, permeability $\mu$, conductivity $\sigma$. Possibility of anisotropy.
- CAD geometry importer (
.stl
format) for definition of embedded boundaries and material regions, based on pyvista - Boundary conditions: PEC, PMC, Periodic, ABC-FOEXTRAP
- Different time-domain sources: particle beam, planewave, gaussian wavepacket
- 100% python, fully exposed API (material tensors, fields $E$, $H$, $J$). Matrix operators based on
numpy
andscipy.sparse
routines ensure fast calculations. - 1d, 2d, 3d built-in plotting on-the-fly
- Optimized memory consumption
- GPU acceleration using cupy/cupyx
- Perfect matching layer (PML) coming soon!
How to use
:book: Documentation, powered by sphinx
, is available at wakis.readthedocs.io
Check :file_folder: benchmarks/
for beam-coupling impedance calculations & comparisons to the commercial tool CST® Wakefield solver:
- PEC cubic cavity below cutoff (mm) and above cutoff (cm)
- Conductive cubic cavity below cutoff
- Lossy pillbox cavity (cylindrical) above cutoff
- Simulations using beams with different relativistic $\beta$
Check :file_folder: examples/
for different physical applications
- Planewave interacting with a PEC or dielectric sphere
- Gaussian wavepacket travelling through vacuum / dielectric
- Custom perturbation interacting with PEC geometry
For specific needs, please contact the developer :woman_technologist: :wave:
Motivation
The determination of electromagnetic wakefields and their impact on accelerator performance is a significant issue in current accelerator components. These wakefields, which are generated within the accelerator vacuum chamber as a result of the interaction between the structure and a passing beam, can have significant effects on the machine.
These effects can be characterized through the beam coupling impedance in the frequency domain and wake potential in the time domain. Accurate evaluation of these properties is essential for predicting dissipated power and maintaining beam stability.
wakis
is an open-source tool that can compute wake potential and impedance for both longitudinal and transverse planes for general 3D structures. wakis
was first presented at IPAC23 conference as a post-processing tool:
It has now evolved from a post-processing tool to a full 3D electromagnetic, time domain solver.
Installation
This section explains how to set up the environment to start using wakis
3d electromagnetic time domain simulations, and beam-coupling impedance computations
Developers: Download wakis repository from Github
# SSH:
git clone git@github.com:ImpedanCEI/wakis.git
# or HTTPS:
git clone https://github.com/ImpedanCEI/wakis.git
# Create python environment
cd wakis/
conda create --name wakis-env python=3.9
conda activate wakis-env
pip install -r requirements.txt
Users: pip install from PyPI
Coming soon
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file wakis-0.4.0.tar.gz
.
File metadata
- Download URL: wakis-0.4.0.tar.gz
- Upload date:
- Size: 55.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.10.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d4575ee5544e9eddd453ab892dcb966116cc58d8de20d6ce2ab1871ebc070501 |
|
MD5 | 2b6d0393245c672f9b1097e319411b10 |
|
BLAKE2b-256 | a3937fa7ca87a1640dcc381116a9cc5fcdeab22fa988baaaafc416a51ead563a |