SpinWaveToolkit: Python package for (semi-)analytical calculations in the field of spin-wave physics Publication type: Paper

Jan Klíma 1 \orcid 0009-0002-1838-5546, Ondřej Wojewoda 1,2,∗ \orcid 0000-0002-4276-520X, Jakub Krčma 3 \orcid 0009-0001-8647-1692, Martin Hrtoň 1,3 \orcid 0000-0002-3264-4025, Dominik Pavelka 1 \orcid 0009-0001-9253-5365, Jakub Holobrádek 1 \orcid 0000-0003-4632-2067, and Michal Urbánek 1,3 \orcid · 2026

Read SpinWaveToolkit: Python package for (semi-)analytical calculations in the field of spin-wave physics Publication type: Paper by Jan Klíma 1 \orcid 0009-0002-1838-5546, Ondřej Wojewoda 1,2,∗ \orcid 0000-0002-4276-520X, Jakub Krčma 3 \orcid 0009-0001-8647-1692, Martin Hrtoň 1,3 \orcid 0000-0002-3264-4025, Dominik Pavelka 1 \orcid 0009-0001-9253-5365, Jakub Holobrádek 1 \orcid 0000-0003-4632-2067, and Michal Urbánek 1,3 \orcid (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2601-23227.txt.

Introduction

Jan Klíma and co-authors present SpinWaveToolkit, an open-source Python package for spin-wave physics. Spin waves are ripples in the magnetization of magnetic materials, key to future fast, low-power devices. The package models them in thin ferromagnetic films and coupled magnetic bilayers.

It combines classic Kalinikos-Slavin theory with a semi-analytical dynamic-matrix method. Users can compute dispersion relations, group velocities, decay lengths, mode profiles, and equilibrium states. A shared toolkit lets labs compare results and design magnonic devices faster. Static equilibrium magnetization states are among the computed outputs, giving device designers the full operating picture of a film.

Catalog record

CREATORJan Klíma 1 \orcid 0009-0002-1838-5546, Ondřej Wojewoda 1,2,∗ \orcid 0000-0002-4276-520X, Jakub Krčma 3 \orcid 0009-0001-8647-1692, Martin Hrtoň 1,3 \orcid 0000-0002-3264-4025, Dominik Pavelka 1 \orcid 0009-0001-9253-5365, Jakub Holobrádek 1 \orcid 0000-0003-4632-2067, and Michal Urbánek 1,3 \orcid
YEAR2026
COLLECTIONPAPERS
FORMATTXT
FILE SIZE40 KB
VERSION1.0
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2601-23227

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

SpinWaveToolkit: Python package for (semi-)analytical calculations in the field of spin-wave physics Publication type: Paper Jan Klíma 1 \orcid 0009-0002-1838-5546, Ondřej Wojewoda 1,2,∗ \orcid 0000-0002-4276-520X, Jakub Krčma 3 \orcid 0009-0001-8647-1692, Martin Hrtoň 1,3 \orcid 0000-0002-3264-4025, Dominik Pavelka 1 \orcid 0009-0001-9253-5365, Jakub Holobrádek 1 \orcid 0000-0003-4632-2067, and Michal Urbánek 1,3 \orcid 0000-0003-0072-2073 Abstract We present an open-source Python package, SpinWaveToolkit (SWT), for (semi-)analytical modeling of spin-wave dynamics in thin ferromagnetic films and exchange-coupled magnetic bilayers. SWT combines analytical models based on the Kalinikos-Slavin theory with a semi-analytical dynamic-matrix approach, enabling the calculation of dispersion relations, group velocities, decay lengths, mode profiles, and static equilibrium magnetization states. In addition, SWT implements a quantitative model of micro-focused Brillouin light scattering (BLS) that incorporates vectorial optical focusing, spin-wave Bloch functions, magneto-optical coupling, and Green-function propagation to simulate experimentally measured BLS spectra. The package is validated against finite-element dynamic-matrix simulations performed with TetraX for Damon-Eshbach, backward-volume, forward-volume, and oblique-field geometries, showing excellent agreement while reducing computation times by nearly two orders of magnitude in comparison to the numerical simulations. Thanks to the easiness of the use and fast calculation times, SWT can be used not only for exploratory mapping of the parameter space, but also for the fitting of the measured dispersion relations and related parameters. Thus, it provides a versatile and efficient framework for experiment design, interpretation, and parameter optimization for magnonics research. keywords Spin wave, Magnonics, modeling, Python 1 Introduction Almost all magnetic phenomena can be described by the Landau-Lifshitz-Gilbert (LLG) equation. This equation describes the damped precessional motion of the magnetization. Depending on the geometry and the set of interactions involved, a wide variety of physical phenomena can arise, such as spin waves, solitons, chaos, or resonances [ 23 ] . Due to the complicated nature of these interactions, LLG equation can be solved analytically only for a limited number of experimental geometries. This limitation has been addressed by the development of micromagnetic simulation tools, which allow one to define complex sample and experimental geometries [ 1 , 24 ] . However, since the LLG equation is a nonlinear partial integro-differential equation, these simulations usually require significant computational time. Substantial progress in this area has been achieved through advances in computational hardware, improved numerical algorithms, and the use of graphical processing units for selected steps of the calculation [ 32 , 33 , 8 , 26 , 4 , 25 ] . In spin-wave research, one of the most important characteristics of a magnetic system is its dispersion relation. In order to extract the dispersion from space–time simulations, one must excite broadband magnetic dynamics and simulate the system over a relatively long time interval in order to achieve the desired frequency resolution [ 2 , 34 ] . This challenge was addressed by the dynamic-matrix approach, which allows the dispersion relation to be obtained directly [ 19 , 21 ] . Within this framework, the LLG equation is not solved solely in the space-time domain, but along the direction of spin wave propagation in the frequency-wavevector domain. This significantly speeds up the calculation and allows fast design and optimization of various sample geometries and material parameters. Nevertheless, since this method still partially relies on solving the LLG equation in the spatial domain (typically in the waveguide cross-section), it remains computationally demanding for systematic exploration of large parameter spaces or for fitting the experimental results. Here, we address this challenge by introducing an open-source Python package, SpinWaveToolkit (SWT), which provides a collection of analytical and semi-analytical models for spin-wave physics, and is accompanied with online documentation and examples [ 18 ] . These include dispersion relation calculations of the thin-film geometries under arbitrary external-field orientations based on the theory developed by Kalinikos and Slavin [ 15 , 14 ] , semi-analytical evaluation of dispersion relations for in-plane and out-of-plane magnetized layers [ 29 ] , magnetic bilayers coupled via the Ruderman-Kittel-Kasuya-Yosida (RKKY) interaction [ 10 , 37 , 35 , 11 ] , and modeling of micro-focused Brillouin light scattering spectra [ 39 , 40 , 38 ] . Due to the easiness of the use and fast calculation times, this Python package can be used not only for the design of experiments by the exploratory mapping of the parameter space, but also for fitting the measured dispersion relation, group velocity, decay length or even Brillouin light scattering (BLS) spectra [ 31 , 22 , 30 , 17 , 9 ] . 2 Modeling of thin ferromagnetic films and bilayers SWT contains two models for infinite thin ferromagnetic film: a fully analytical one based on the zeroth perturbation (class SingleLayer ) and a semi-analytical approach which implements numerical calculation of the eigenvalues of the interaction matrix (class SingleLayerNumeric ). The analytical model is slightly faster and can calculate dispersion relation for any in-plane and out-of-plane angle of the magnetization. However, depending on the parameters, this model can be inaccurate if the modes get into the vicinity of each other in the wavevector–frequency space, or in the region between dipolar and exchange dominated regimes. In contrast, the numerical model in its current state can be used only for an arbitrarily in-plane-magnetized and completely out-of-plane-magnetized layer. To address the rising interest in interfacially-coupled magnetic bilayers, e.g., synthetic antiferromagnets, SWT makes use of a two-macrospin model (class DoubleLayerNumeric ) which semi-analytically solves the micromagnetic energy equilibrium and then solves the eigenvalues of the system matrix to retrieve the dispersion relation. To handle the materials, SWT introduces a convenience class Material , which stores most of the magnetic material parameters relevant to the calculations (in SI units), such as saturation magnetization M_{\mathrm{s}} , gyromagnetic ratio \gamma , exchange stiffness constant A_{\mathrm{ex}} , Gilbert damping constant \alpha , and inhomogeneous broadening \Delta H_{0} , see Listing 1. The objects of this class can be then directly used in the dispersion models as input. Listing 1: SWT import and material definition. 2.1 Fully analytical modeling – SingleLayer For homogeneous thin films, the approach based on the zeroth-perturbation can be used to obtain the explicit expression for the spin-wave dispersion relation [ 15 ] \omega^{2}_{n}=\left(\omega_{\mathrm{H}}+\omega_{\mathrm{M}}l_{\mathrm{ex}}^{2}k^{2}\right)\left(\omega_{\mathrm{H}}+\omega_{\mathrm{M}}l_{\mathrm{ex}}^{2}k^{2}+\omega_{\mathrm{M}}F_{n}\right), (1) where \omega_{\mathrm{H}}=\mu_{0}\gamma H_{\mathrm{ext}} , H_{\mathrm{ext}} is externally applied magnetic field, \omega_{\mathrm{M}}=\mu_{0}\gamma M_{\mathrm{s}} , l_{\mathrm{ex}}^{2}=2A_{\mathrm{ex}}\left(M_{\mathrm{s}}^{2}\mu_{0}\right)^{-1} is the squared exchange length, k is the wavevector, and n is the quantization number across film thickness. The function F_{n} contains the magnetostatic contributions and depends on the propagation direction and film thickness. Our implementation allows for totally pinned, totally unpinned, and partially pinned (symmetric) boundary conditions. Moreover, one can define arbitrary direction of the propagation within the plane of the sample, calculate quantized modes along the film thickness ( n>0 ) and define arbitrary demagnetizing and uniaxial anisotropy matrices. Even though the fully analytical implementation in SWT has a possibility to calculate spin-wave dispersion around the degeneracy points by using second perturbation correction, for simplicity we omit this in the following examples. In case of high-symmetry geometries, simple analytical formulas can be derived. However, in the case when the the external magnetic field is applied at an arbitrary angle, the calculations become more complicated as it is necessary to find the equilibrium position of the magnetization and the resulting effective magnetic field via energy minimization. The presented module

Read the complete text