WorksPhysics and Astronomy
MagBerry: A Julia package for modeling magnon and phonon topology and transport
Abstract
We present MagBerry, a Julia package for studying the topology and transport of magnons, phonons, and their hybrid excitations. It combines magnetic models and linear spin-wave Hamiltonians from Sunny.jl with native modules for harmonic phonons and magnon–phonon coupling. These excitations are treated within a common bosonic Bogoliubov–de Gennes formulation. The package calculates bulk and boundary spectra, Berry curvature, and Chern numbers, and resolves the spin and phonon angular momentum carried by each mode. Transport calculations include thermal Hall, spin and orbital Nernst, and phonon angular momentum Hall responses. The package also evaluates the extended Berry curvature dipole contribution to nonlinear magnon thermal Hall transport. Relaxation-time Boltzmann theory gives heat and angular momentum currents. Examples based on published models reproduce topological magnon boundary spectra and illustrate phonon geometry and nonlinear transport. For an altermagnetic hybrid model, we extend a published study of the d-wave phonon angular momentum texture by calculating its Boltzmann transport coefficients. The resulting tensor describes how the longitudinal and transverse angular momentum currents vary with temperature and the direction of the temperature gradient.
Program summary
Program title: MagBerry.
Programming language: Julia; the reported calculations use Julia 1.11.3.
External libraries: Sunny 0.9.2, CairoMakie 0.15.13, and dependencies specified by the accompanying environment.
Version used: MagBerry 0.2.4.
Licensing provisions: MIT.
Nature of problem: Calculation of excitation spectra, geometric observables, and transport coefficients in quadratic models of magnons, phonons, and their coupled modes.
Solution method: Bosonic diagonalization with the commutation metric, Kubo and lattice-link calculations of Berry curvature, generalized-current response, relaxation-time Boltzmann transport, and direct diagonalization of finite geometries.
Restrictions: Harmonic phonons and linear spin-wave theory about a specified reference state. The generic boundary interface retains bulk onsite blocks. Free surfaces require explicit reconstruction and a reference-state check.
Developer’s repository: https://github.com/Raito-SHU/MagBerry.jl.
Documentation: http://renwei.group/softwares/MagBerry.jl/en/.
Introduction
Magnons and phonons are electrically neutral bosonic excitations of spins and the lattice, respectively. They carry energy and angular momentum without an accompanying charge current, enabling information transport in insulators. Their bands can also have nontrivial topology. Neutron scattering has provided evidence for topological magnon bands in Cu(1,3-bdc) and CrI [1, 2]. For phonons, inelastic X-ray scattering combined with theoretical calculations has identified double Weyl nodes in FeSi [3]. Both excitations can exhibit transverse thermal transport analogous to the electronic Hall effect. Strohm et al. discovered the phonon Hall effect in TbGaO in 2005 [4], and Onose et al. observed the magnon thermal Hall effect in the ferromagnetic insulator LuVO in 2010 [5]. Theory has also predicted transverse angular momentum transport driven by temperature gradients, including the magnon spin Nernst effect in collinear antiferromagnets [6] and the phonon angular momentum Hall effect in lattice systems [7].
Magnon–phonon coupling can produce hybrid excitations known as magnon polarons, which combine magnetic and lattice motion. In FePS, magneto-Raman measurements have revealed strong coupling [8], and terahertz pulses have enabled coherent excitation of magnon polarons [9]. Spectroscopy of FePSe has identified chirality-selective hybridization and chiral magnon polarons at zero magnetic field [10]. Neutron scattering combined with theoretical analysis has also identified topological magnon polarons in FeMoO [11]. In -wave altermagnets, theory predicts that the energy splitting between magnon branches of opposite chirality changes sign with momentum. Chirality-selective hybridization allows the phonon components of the hybrid modes to acquire a corresponding -wave angular momentum texture [12].
Studies of chiral phonons and altermagnetic magnons have increased the demand for calculations of band topology and angular momentum transport. SpinW and Sunny.jl are widely used to calculate magnetic excitation spectra and fit experimental data. SpinW computes linear spin-wave spectra from spin models [13], while Sunny.jl supports multiflavor spin-wave theory and dynamical simulations [14]. For phonons, PH-NODE searches for topological band nodes using first-principles results [15]. Calculating group velocities, Berry curvature, boundary states, and transport responses such as thermal and spin Hall effects from these models generally requires additional post-processing. Publicly available tools for both topology and transport in coupled magnon–phonon systems remain limited.
We developed MAGBERRY, a Julia package for calculating the topology and transport of magnons, phonons, and magnon polarons. The package treats all three types of excitation through quadratic bosonic Bogoliubov–de Gennes (BdG) Hamiltonians [16, 17]. Sunny.jl supplies the magnetic models and their linear spin-wave Hamiltonians. Native MAGBERRY modules construct harmonic phonon and magnon–phonon Hamiltonians and solve for the hybrid modes. Structures, force constants, and magnetic interaction parameters can be imported from first-principles outputs. The magnon routines calculate band dispersions and group velocities and resolve spin polarization, chirality, and wave-packet orbital moments. They also evaluate Berry curvature, Chern numbers, and boundary states. Bulk and boundary spectra and Berry curvature are available for phonon and hybrid models as well. For hybrid modes, MagBerry separates the magnetic and lattice components and resolves their spin and phonon angular momentum.
The transport routines evaluate linear thermal Hall, spin Nernst, magnon orbital Nernst, and phonon angular momentum Hall coefficients. They also compute the extended Berry curvature dipole contribution to nonlinear magnon thermal Hall transport. Within the relaxation-time approximation, Boltzmann calculations give heat, spin, and phonon angular momentum currents as functions of temperature and the direction of the temperature gradient. For hybrid modes, the spin and phonon angular momentum contributions to transport can be resolved separately.
Models and computational methods
Throughout this section, , label modes, , label atoms, and , , label Cartesian components. In a transport tensor, specifies the current direction, the temperature-gradient direction, and the polarization of the transported observable. We set in the formulas below and restore physical units in the numerical outputs.
Bosonic BdG Hamiltonians and eigenmodes
Magnon, phonon, and hybrid excitations are obtained by expanding the spin and lattice Hamiltonian to quadratic order about a reference configuration. The inputs are the magnetic interactions, reference spin configuration, atomic masses, force constants, and magnon–phonon coupling parameters. Additive constants are omitted from the Hamiltonians.
Sunny.jl constructs the magnetic model and its quadratic spin-wave Hamiltonian [14, 18]. Let be the column vector of magnon annihilation operators. In the Nambu basis , the Hamiltonian is . Its matrix has the block form
The blocks and collect number-conserving and pairing terms, respectively. MagBerry directly uses the Hermitian matrix supplied by Sunny. The Nambu commutator matrix is .
The phonon model uses atomic masses and harmonic force constants . These force constants couple displacement component of atom in the reference cell to component of atom in cell . Fourier transformation gives the mass-weighted dynamical matrix [19]
The canonical solver uses the squared-energy matrix , denoted by below. With , introduce mass-weighted coordinates and . For retained displacement coordinates per cell, define . The harmonic Hamiltonian has the matrix
The commutator matrix is . This coordinate–momentum representation is equivalent to a bosonic creation–annihilation basis.
Magnon–phonon coupling follows from the displacement dependence of magnetic interactions. Expanding the exchange tensor to first order in displacement gives
where labels a displaced atom. Terms linear in both displacement and spin fluctuation form the bilinear coupling matrix. The tensor derivatives include symmetric exchange and Dzyaloshinskii–Moriya contributions. Alternatively, an explicit magnetoelastic model can supply the coupling matrix [20]. In the combined basis , the quadratic Hamiltonian is , with
Here follows the displacement–momentum ordering of . Couplings obtained from displacement derivatives enter . Setting recovers the uncoupled models. The canonical commutator is . The excitation energies and mode vectors satisfy [16]
For a stable reference configuration, finite positive-energy modes have . The notation below selects these branches. Collecting the complete set of finite-frequency mode vectors as gives , the commutator in the mode basis.
Berry curvature, topology, and extended dipoles
For an isolated positive-energy band, the Berry connection is , and is its ordinary Berry curvature [21, 22]. Cartesian momentum derivatives include the phase factors associated with the atomic basis positions. In the mode basis, define the velocity matrix . The Kubo expression is
All energies and matrix elements in the Kubo expressions are evaluated at the same wave vector. The intermediate-state sum includes modes in both the positive- and negative-frequency sectors. For an isolated band over a two-dimensional Brillouin zone, the Chern number is [23]
MAGBERRY evaluates ordinary curvature and Chern numbers using either Eq. (7) or the discrete lattice-link method of Fukui, Hatsugai, and Suzuki [24].
To describe spin and angular momentum transport, let denote a selected Cartesian component, such as or . The laboratory-frame spin operator is assembled from the local spin coordinates. Mechanical phonon angular momentum (PAM) is [25]. If is the matrix of the quadratic observable in the canonical basis, its mode-basis matrix is . For , the symmetrized current matrix is . Its interband matrix elements give the current Berry curvature
The polarization index is , the current direction is , and the driving direction is . The interband matrix elements in these curvatures determine the spin Nernst and phonon angular momentum Hall responses [7, 26].
For orbital transport, is a component of the magnon wave-packet moment . Its mode-basis matrix is constructed from velocity matrix elements. We adopt the orbital-current matrix and the curvature convention of Go et al. [27]. The orbital-current Berry curvature is then
The corresponding thermal prefactors are specified in § 3.3. At degeneracies, the geometric quantities are evaluated through subspace traces [28].
The extended-dipole contribution to nonlinear magnon transport depends on the momentum derivative of the energy-weighted Berry curvature. With , the extended Berry curvature dipole field is [29]
Here labels the derivative direction and the curvature component. MagBerry evaluates this field on a periodic momentum grid and can weight it by or the mode spin expectation . The energy-weighted field enters the nonlinear thermal Hall coefficient [30].
Boltzmann and Hall transport coefficients
The thermal conductivity tensor relates the heat current to the temperature gradient,
For a selected observable , including its polarization as defined in § 3.2, we define the corresponding response tensor by
Superscripts B and H denote Boltzmann and intrinsic Hall contributions, respectively. For a fixed Hamiltonian, the Bose occupation is . Brillouin-zone integrals use the measure , where is the spatial dimension.
In the relaxation-time approximation, a temperature gradient produces the occupation correction [31]. Here is the common relaxation time and is the group velocity of a positive-norm mode.
Each mode carries an energy flux , giving the Boltzmann thermal conductivity
For spin or phonon angular momentum, , the mode current is , with the current matrix defined before Eq. (9). The resulting response coefficient is
The choice of observable resolves the spin and phonon angular momentum contributions of a hybrid mode. Within a degenerate subspace, operator traces replace the single-band products.
Intrinsic Hall responses use the thermal functions and . The ordinary curvature gives the thermal Hall coefficient [17, 32, 33],
The spin Nernst coefficient describes the transverse flow of spin component driven by a temperature gradient [26]. In terms of the spin-current curvature from Eq. (9), the coefficient is
The phonon angular momentum Hall response is determined by the current curvature associated with [7]. Its coefficient is
The magnon orbital Nernst response transports the wave-packet moment . With the orbital-current normalization and curvature in Eq. (10), its coefficient reads [27]
In the examples, we write for the intrinsic phonon response and for its Boltzmann contribution. Temperature scans reuse the calculated energies and current curvatures, updating only the Bose weights.
For the two-dimensional nonlinear magnon thermal Hall response, we define . The extended-dipole contribution in the relaxation-time approximation is [30]
where is defined by Eq. (11).
Boundary spectra and localization
We construct the Hamiltonian of a finite geometry by partially Fourier transforming the bulk BdG matrix. Strips retain one periodic direction and a finite width, while slabs retain two periodic directions and a finite thickness. MagBerry applies this construction to magnons, phonons, and their hybrid modes.
For one finite direction, denote reciprocal-lattice coordinates by . In the cell-periodic basis, the intercell matrix at integer separation is
The integral is evaluated on a discrete grid. Retaining cells gives for . Couplings across the sample edge are truncated, and the default termination retains the bulk onsite blocks. In cellwise basis ordering, . The finite-system modes follow from and are normalized by for positive-energy modes.
To characterize localization, let be the part of a mode vector in cell . A fixed local oscillator basis defines the positive weight matrix in the ordering, where is a diagonal matrix of positive reference frequencies. Only the blocks corresponding to sectors present in the model are retained. The normalized cell weight is
For an edge or surface region comprising selected outermost cells, . Its localization-weighted spectral intensity is
where is the energy broadening. The boundary dispersion and weights, together with bulk gaps and Chern numbers, characterize bulk–boundary correspondence [22].
Transforming two directions constructs finite two-dimensional samples or rods periodic along the third direction. Their eigenmodes resolve localization at corners or hinges. For hybrid modes, MagBerry also evaluates magnetic and lattice composition. The observable matrix elements defined in § 3.2 give the spatial distributions of spin and phonon angular momentum.
Software organization and use
Installation and runtime environment
MagBerry requires Julia 1.10 or later. Extract the source package and run the following commands in Julia, using the source directory that contains Project.toml.
using Pkg
Pkg.activate()
Pkg.develop(path="path/to/MagBerry.jl")
Pkg.add(["Sunny", "CairoMakie"])
Replace path/to/MagBerry.jl with that directory. The package manager installs the dependencies. To begin a calculation script, load the packages:
using Sunny, MagBerry, CairoMakie
Each input script constructs a model, specifies momentum sampling and calculation parameters, and calls the analysis functions.
Model construction and data input
Three model types represent magnons, phonons, and hybrid modes. Sunny constructs magnetic models and provides their spin-wave Hamiltonians through SpinWaveTheory [14]. Phonon models use a crystal structure, atomic masses, and force constants; hybrid models combine the magnetic and phonon models with their coupling. Table 1 lists the constructors and input interfaces. To map supercell force constants onto the model cell, the importer uses the structures of both cells [19].
| Function or constructor | Description |
| Sunny.SpinWaveTheory | Construct a spin-wave model from magnetic interactions and a reference spin configuration. |
| PhononSystem | Create a phonon model from a crystal structure and atomic masses. |
| HybridSystem | Combine spin waves, phonons, and magnon–phonon coupling. |
| set_force!, set_spring! | Set force-constant matrices or spring interactions. |
| read_poscar_crystal | Read a crystal structure from a POSCAR file. |
| read_phonopy_phonon | Build a phonon model from crystal and supercell structures and Phonopy force constants. |
Table 1. Model construction and data input interfaces.
Calculation interfaces and workflow
Each calculation takes a model, a momentum path or Brillouin-zone grid, and the selected bands or response components. Spectra, boundary modes, and Boltzmann transport are calculated directly from the model. Hall and Nernst calculations integrate the corresponding curvatures over the Brillouin zone, applying Bose weights at each requested temperature. Table 2 lists the main functions.
| Function | Description |
Sunny.dispersion | Calculate bulk magnon, phonon, and hybrid spectra, respectively. |
phonon_bands | |
hybrid_bands | |
berry_curvature | Calculate ordinary Berry curvature or the curvature associated with spin, orbital moment, and phonon angular momentum currents. |
chern_numbers | Calculate band Chern numbers for magnon, phonon, and hybrid models. |
phonon_angular_momentum | Evaluate phonon angular momentum and the composition and angular momenta of hybrid modes. |
hybrid_mode_observables | |
boltzmann_transport | Calculate heat, spin, and phonon angular momentum currents driven by a temperature gradient. |
thermal_hall_conductivity | Calculate the linear thermal Hall conductivity. |
spin_nernst_conductivity | Calculate spin Nernst and magnon orbital Nernst coefficients, respectively. |
orbital_nernst_conductivity | |
angular_momentum_nernst_conductivity | Calculate the phonon angular momentum Hall coefficient. |
magnon_extended_bcd | Construct the extended magnon Berry curvature dipole field. |
magnon_nonlinear_thermal_hall_conductivity | Calculate the extended-dipole contribution to nonlinear magnon thermal Hall transport. |
boundary_bands | Calculate boundary spectra for strips, slabs, finite two-dimensional samples, and rods. |
Table 2. Main analysis and transport functions.
The chern_numbers interface accepts a model or previously calculated ordinary Berry-curvature data. The boundary_bands interface selects the geometry through geometry, with values :strip, :surface, :finite2d, and :hinge. For phonon and hybrid models, the phonon angular momentum Hall interface offers native adaptive integration over a requested temperature range. Appendix § 11 gives a complete phonon input. Scripts for the four main examples are provided in examples/paper; further tutorials are available in the online documentation.
OpenAI Codex (OpenAI, used in October 2026) assisted development of the adaptive integration and boundary interfaces and preparation of example and plotting scripts. The numerical results and figures were generated by the Julia implementations and inputs supplied with the program.
Illustrative examples
Four examples based on published models demonstrate magnon topology and boundary states, linear and nonlinear thermal Hall responses, and phonon angular momentum transport in elastic and hybrid systems. The online documentation provides complete inputs and further examples, including spin Nernst transport in a rutile-inspired altermagnet [34], magnon orbital moments and the orbital Nernst effect in a honeycomb antiferromagnet [27], and topological magnon–phonon hybridization in square-lattice and models [11, 20].
Magnon topology, boundary states, and thermal Hall response
Dzyaloshinskii–Moriya interaction (DMI) opens a topological magnon gap in the honeycomb ferromagnet and supports chiral edge modes. We use the model of Pantaleón and Xian [35] to reproduce the published zigzag boundary spectrum and calculate the bulk Berry curvature, Chern numbers, and thermal Hall response. The spin Hamiltonian is
Here is the nearest-neighbor ferromagnetic exchange, and is the next-nearest-neighbor DMI. Each bond is counted once, with . For the oriented next-neighbor vectors , the input uses on sublattice A and on B. The vectors are primitive lattice vectors. The spins have and align along . Energies are measured in , and the nearest-neighbor distance is . The zigzag strips use the published parameters and and the outermost-site magnon potential with .
At , the lower and upper bulk bands carry Chern numbers in the convention of Eq. (8) [Fig. 1(a)]. Their Berry curvatures have opposite signs and concentrate near the corners of the hexagonal Brillouin zone [panels (b,c)]. The bulk spectrum retains its acoustic Goldstone point, while boundary modes appear in the gap between the two positive-frequency branches.
Without DMI, the gapless system has an approximately flat edge branch. Finite DMI opens a bulk gap traversed by branches localized on opposite edges. Panels (d,e) show zigzag strips with 64 layers for and 96 layers for , using the termination of Ref. [35]. The localized branches cross inside the bulk gap at , .
Thermal occupation weights the opposite Berry curvatures of the two bands unequally, producing the thermal Hall response in panel (f). The coefficient increases from zero over the plotted temperature range. With and , we obtain at .
Nonlinear magnon thermal Hall response
A magnetic field lifts the degeneracy of opposite-spin magnons in a honeycomb antiferromagnet and can activate a transverse heat current quadratic in the temperature gradient. We examine the extended Berry curvature dipole mechanism proposed by Ni et al. [30], using a realization with unequal nearest-neighbor exchange couplings. MagBerry calculates the dipole texture and the temperature and field dependence of the response. The spin Hamiltonian is
The sums count each bond once. For this model’s next-neighbor vectors , on A and on B, with the opposite sign for reversed bonds. The two sublattices carry moments along opposite directions. We use meV, easy-axis anisotropy meV, and nearest-neighbor exchanges meV, assigning the third value to the bond along . This bond anisotropy breaks threefold rotation. The Zeeman parameter is reported in energy units.
The local extended Berry curvature dipole is . Its energy-weighted form enters Eq. (20), which defines . The response combines the calculated curvature and its momentum derivative with the Bose thermal weight. We use the triangular Bravais lattice length Å and relaxation time ps, giving a two-dimensional sheet coefficient in W m K.
At meV, the field separates the otherwise degenerate conserved-spin sectors by 0.8 meV [Fig. 2(a)]. Panel (b) shows the lower-band extended dipole over the first Brillouin zone. The plot axes are orthonormal coordinates in the reciprocal plane, and the derivative is taken along Cartesian . The response integral covers one reciprocal primitive cell.
Figure 1. Magnon topology and thermal transport. (a) Bulk bands for , with Chern numbers in ascending energy order. (b,c) Berry curvature of the lower and upper bands, with the first Brillouin zone outlined. Here is the nearest-neighbor distance. (d,e) Finite-strip spectra reproducing the and cases of Fig. 2(a,b) in Ref. [35]. The zigzag strips have 64 and 96 layers and the published edge potential . Red and blue distinguish opposite edges, and gray denotes bulk-like modes. Here . (f) Thermal Hall coefficient of the same bulk model at .
At zero field, the contributions from the two spin sectors cancel. Reversing the field changes the sign of . Panel (c) shows the temperature dependence from 1 to 150 K at , 0, and meV with the same exchange parameters. At meV and 100 K, a midpoint grid gives W m K. The sign change between 59 and 60 K reflects the changing thermal weights of contributions across momentum space.
The field scans in panel (d) span meV at 20, 50, and 100 K. They use field steps of 0.1 meV and the same grids.
Phonon Berry curvature and angular momentum Hall response
Two elastic models illustrate phonon geometry and angular momentum transport. The honeycomb model exhibits valley angular momentum and Berry curvature, and the simple-cubic model gives the angular momentum Hall response. We calculate both with MagBerry using the harmonic bond Hamiltonian
where , is the unit vector along the equilibrium bond, and contains each undirected bond once. The longitudinal and transverse force constants are and .
We denote their numerical inputs by and after conversion to the model units through
For the honeycomb AB model of Zhang and Niu [36], contains the nearest-neighbor A–B bonds and . The primitive lattice constant is . Mass is measured in units of , with , and the numerical spring parameters are , . The energy unit is .
The two valleys carry opposite phonon angular momenta [Figure 3(a,Figure 3b)]. At , the second branch has , so its circular motion is carried by the B atom. The atomic contributions sum to the total mechanical PAM. The Berry curvatures of the two lowest branches, evaluated on a grid over the first Brillouin zone, also change sign between opposite valleys [panels (c,d)], as expected from time-reversal symmetry.
Figure 3. Phonon geometry and angular momentum Hall response. (a) Honeycomb AB bands [36] colored by mechanical PAM. (b) Atomic contributions to the second branch along the same path. (c,d) Ordinary Berry curvature of bands 1 and 2, with separate color scales and the first Brillouin zone outlined in black. (e) Bands of the simple-cubic model [7]. (f) Intrinsic PAM Hall coefficient of the simple-cubic model over 0–150 K, with the analytic zero-temperature limit included. The response in (f) is calculated from the angular momentum current curvature.
The simple-cubic model of Park and Yang [7] uses Eq. (26) with three displacement components per site. The set contains the six nearest neighbors and twelve face-diagonal next-nearest neighbors of each site, with each bond counted once in the energy. For unit mass, the effective spring parameters entering are for nearest neighbors and for next-nearest neighbors. The onsite force constants enforce the acoustic sum rule. Off-diagonal angular momentum matrix elements generate a finite Hall response through Eq. (15b), while the equilibrium diagonal PAM vanishes. Figure 3(e,f) shows the spectrum and Hall response, respectively.
The angular momentum Hall coefficient increases with temperature [panel (f)], reaching approximately at 100 K and at 150 K. The corresponding values read from Figure 2(b) of Ref. [7] are approximately and , respectively. We calculate the curve from 1 to 150 K with MagBerry’s native adaptive integration and cubic symmetry averaging, starting from a midpoint grid.
Figure 2. Nonlinear magnon thermal Hall response. (a) Bands at meV. (b) Lower-band extended dipole at the same field, in meV Å, with the first Brillouin zone outlined in black. (c) Temperature dependence at , 0, and meV for the same exchange parameters. (d) Field dependence at 20, 50, and 100 K. The field variable is the Zeeman energy in meV. Responses use ps and primitive-cell grids.
Phonon angular momentum transport in altermagnets
Magnon–phonon coupling in a -wave altermagnet can transfer the alternating magnon spin texture to the mechanical phonon angular momentum of the hybrid modes. Bendin et al. [12] calculated this texture in a square-lattice model and predicted a phonon angular momentum splitter effect from symmetry. That study did not evaluate the corresponding transport coefficients. We use MagBerry to calculate the Boltzmann response tensor and its temperature dependence. The tensor also gives the longitudinal and transverse currents as the temperature gradient rotates.
Using the notation of Ref. [12], the coupled model is . Its spin Hamiltonian, given in Eq. (A1) of that reference, is
Here couples nearest neighbors antiferromagnetically, while and describe the two directional next-neighbor bond families, interchanged between the opposite-spin sublattices. The bond sums follow the convention of the reference.
The phonon Hamiltonian follows Eq. (B1) of the same reference,
where , is the unit bond vector, and the displacements and momenta lie in the plane. The displacement-induced DMI coupling is the reference’s Eq. (2),
The coupling runs over same-sublattice next-neighbor bonds of length , with for the spin-up sublattice and for the spin-down sublattice. The full quadratic hybrid Hamiltonian retains anomalous terms.
The dimensionless model parameters are , , , , , , , and , with and . The ferromagnetic exchange coefficients used in Eq. (27) are , matching the published uncoupled magnon dispersion. They are twice the coefficients printed in Eq. (S.4b) of the source supplement.
Hybridization mixes two magnetic modes with four in-plane phonon modes to form six positive-frequency branches [Figure 4(a,Figure 4b)]. Band 4, numbered in ascending energy order, acquires the -wave mechanical PAM texture shown in panel (c). Across the anticrossing in panels (d–f), the decomposition shows the partial cancellation of the two sublattice contributions.
Figure 4. Phonon angular momentum currents in the square-lattice hybrid model. (a) Uncoupled modes colored by magnetic spin. (b) Six hybrid branches colored by mode character. (c) Mechanical PAM of band 4 over the magnetic Brillouin zone. (d–f) The anticrossing along , colored by the total PAM and its sublattice and contributions. The total and sublattice color ranges are and , respectively. (g) Boltzmann coefficients obtained from the conventional symmetrized current, per common relaxation time. (h) Longitudinal and transverse coefficients at , with directions defined in the text. The transport curves use a grid.
The boltzmann_transport interface uses the conventional symmetrized current to evaluate Eq. (13b). The sum includes all six bands and retains the full normalization of each hybrid mode. We report the response per common relaxation time. With and , the coefficient gives
The Boltzmann tensor is diagonal and satisfies , producing opposite angular momentum responses along the two crystal axes [xref]panel (g)]. At , for the symmetrized current. The semiclassical current gives . The calculation covers the full magnetic Brillouin zone with a midpoint grid and 31 temperatures from to 8.
The opposite diagonal tensor entries determine the angular momentum splitter response in panel (h), shown at . For a temperature gradient along and transverse direction , the projections are and , with . Both current components are proportional to the common relaxation time.
Conclusions
MagBerry calculates spectra, topology, and transport for magnons, phonons, and their hybrid modes with a consistent bosonic normalization. Native phonon and spin–lattice modules complement Sunny spin-wave models. The examples reproduce published magnon boundary spectra and show how a magnetic field controls the nonlinear magnon thermal Hall response. They also illustrate phonon band geometry and angular momentum Hall transport.
For the altermagnetic model, we calculate transport coefficients associated with the published -wave phonon angular momentum texture. The original study [12] predicted the corresponding splitter effect from symmetry but did not evaluate these coefficients. Within the relaxation-time approximation, the native Boltzmann interface gives the temperature-dependent response tensor and its longitudinal and transverse projections.
Acknowledgements
This work was supported by the National Natural Science Foundation of China (Grant No. 52130204).
CRediT authorship contribution statement
Xiaonong Shen: Software, Validation, Visualization, Writing – original draft. Wei Ren: Supervision, Funding acquisition, Writing – review & editing.
Declaration of competing interest
The authors declare no competing interests.
Data and code availability
The source code of MagBerry v0.2.4 and the model inputs used to reproduce the figures are provided in the accompanying software archive.
Example input: phonon angular momentum Hall response
The following input constructs the simple-cubic model in § 5.3 and plots its bands. It also plots the angular momentum current curvature on the plane. Adaptive three-dimensional integration then gives the Hall response as a function of temperature.
using Sunny, MagBerry, CairoMakie
crystal = Crystal(lattice_vectors(1,1,1,90,90,90),
[[0,0,0]], 221)
phonon = PhononSystem(crystal, [1.0])
set_spring!(phonon, 50, Bond(1,1,[1,0,0]); transverse=20)
set_spring!(phonon, 20, Bond(1,1,[1,1,0]); transverse=10)
enforce_asr!(phonon)
path = q_space_path(crystal,
[[0,0,0],[.5,0,0],[.5,.5,0],[0,0,0],[.5,.5,.5]],301;
labels=["Γ","X","M","Γ","R"])
plot_bands(phonon, path)
bc = berry_curvature(phonon; kmesh=(40,40), observable=:pam)
plot_berry_curvature(bc; band=3)
plot_angular_momentum_nernst_conductivity(phonon;
kmesh=10, temperatures=1:150, adaptive_refinement=true)
Declaration of generative AI use
OpenAI Codex was used to assist drafting and language revision of this manuscript. The authors reviewed the resulting text, made the necessary revisions, and are responsible for the final content.
References
- [1]R. Chisnell, J. S. Helton, D. E. Freedman, D. K. Singh, R. I. Bewley, D. G. Nocera, Y. S. Lee, Topological magnon bands in a kagome lattice ferromagnet, Phys. Rev. Lett. 115 (2015) 147201. doi:10.1103/PhysRevLett.115.147201.DOI
- [2]L. Chen, J.-H. Chung, B. Gao, T. Chen, M. B. Stone, A. I. Kolesnikov, Q. Huang, P. Dai, Topological spin excitations in honeycomb ferromagnet CrI₃, Phys. Rev. X 8 (2018) 041028. doi:10.1103/PhysRevX.8.041028.DOI
- [3]H. Miao, T. T. Zhang, L. Wang, D. Meyers, A. H. Said, Y. L. Wang, Y. G. Shi, H. M. Weng, Z. Fang, M. P. M. Dean, Observation of double Weyl phonons in parity-breaking FeSi, Phys. Rev. Lett. 121 (2018) 035302. doi:10.1103/PhysRevLett.121.035302.DOI
- [4]C. Strohm, G. L. J. A. Rikken, P. Wyder, Phenomenological evidence for the phonon Hall effect, Phys. Rev. Lett. 95 (2005) 155901. doi:10.1103/PhysRevLett.95.155901.DOI
- [5]Y. Onose, T. Ideue, H. Katsura, Y. Shiomi, N. Nagaosa, Y. Tokura, Observation of the magnon Hall effect, Science 329 (5989) (2010) 297–299. doi:10.1126/science.1188260.DOI
- [6]R. Cheng, S. Okamoto, D. Xiao, Spin Nernst effect of magnons in collinear antiferromagnets, Phys. Rev. Lett. 117 (2016) 217202. doi:10.1103/PhysRevLett.117.217202.DOI
- [7]S. Park, B.-J. Yang, Phonon angular momentum Hall effect, Nano Lett. 20 (2020) 7694–7699. doi:10.1021/acs.nanolett.0c03220.DOI
- [8]S. Liu, A. Granados del Águila, D. Bhowmick, C. K. Gan, T. Thu Ha Do, M. A. Prosnikov, D. Sedmidubský, Z. Sofer, P. C. M. Christiansen, P. Sengupta, Q. Xiong, Direct observation of magnon-phonon strong coupling in two-dimensional antiferromagnet at high magnetic fields, Phys. Rev. Lett. 127 (2021) 097401. doi:10.1103/PhysRevLett.127.097401.DOI
- [9]T. Luo, H. Ning, B. Ilyas, A. von Hoegen, E. Viñas Boström, J. Park, J. Kim, J.-G. Park, D. M. Juraschek, A. Rubio, N. Gedik, Terahertz control of linear and nonlinear Magno-phononics, Nat. Commun. 16 (2025) 6863. doi:10.1038/s41467-025-62091-4.DOI
- [10]J. Cui, E. V. Boström, M. Ozerov, F. Wu, Q. Jiang, J.-H. Chu, C. Li, F. Liu, X. Xu, A. Rubio, Q. Zhang, Chirality selective magnon-phonon hybridization and magnon-induced chiral phonons in a layered zigzag antiferromagnet, Nat. Commun. 14 (2023) 3396. doi:10.1038/s41467-023-39123-y.DOI
- [11]S. Bao, Z.-L. Gu, Y. Shangguan, Z. Huang, J. Liao, X. Zhao, B. Zhang, Z.-Y. Dong, W. Wang, R. Kajimoto, M. Nakamura, T. Fennell, S.-L. Yu, J.-X. Li, J. Wen, Direct observation of topological magnon polarons in a multiferroic material, Nat. Commun. 14 (2023) 6093. doi:10.1038/s41467-023-41791-9.DOI
- [12]H. Bendin, A. Mook, I. Mertig, R. R. Neumann, D-wave phonon angular momentum texture in altermagnets by magnon-phonon hybridization, Phys. Rev. Lett. 137 (2026) 056701. doi:10.1103/r43h-ch8r.DOI
- [13]S. Toth, B. Lake, Linear spin wave theory for single-Q incommensurate magnetic structures, J. Phys.: Condens. Matter 27 (16) (2015) 166002. doi:10.1088/0953-8984/27/16/166002.DOI
- [14]D. Dahlbom, H. Zhang, C. Miles, S. Quinn, A. Niraula, B. Thipe, M. Wilson, S. Matin, H. Mankad, S. Hahn, D. Pajerowski, S. Johnston, Z. Wang, H. Lane, Y. W. Li, X. Bai, M. Mouirad, C. D. Batista, K. E. Barros, Sunnyjl: A Julia package for spin dynamics, J. Open Source Softw. 10 (116) (2025) 8138. doi:10.21105/joss.08138.DOI
- [15]P. Pandey, S. K. Pandey, PH-NODE: A DFPT and finite displacement supercell based Python code for searching nodes in topological phononic materials, Comput. Phys. Commun. 303 (2024) 109281. doi:10.1016/j.cpc.2024.109281.DOI
- [16]J. H. P. Colpa, Diagonalization of the quadratic boson Hamiltonian, Physica A 93 (1978) 327–353. doi:10.1016/0378-4371(78)90160-7.DOI
- [17]R. Matsumoto, R. Shindou, S. Murakami, Thermal Hall effect of magnons in magnets with dipolar interaction, Phys. Rev. B 89 (2014) 054420. doi:10.1103/PhysRevB.89.054420.DOI
- [18]T. Holstein, H. Primakoff, Field dependence of the intrinsic domain magnetization of a ferromagnet, Phys. Rev. 58 (1940) 1098–1113. doi:10.1103/PhysRev.58.1098.DOI
- [19]A. Togo, L. Chaput, T. Tadano, I. Tanaka, Implementation strategies in phonopy and phono3py, J. Phys.: Condens. Matter 35 (35) (2023) 353001. doi:10.1088/1361-648X/acd831.DOI
- [20]G. Go, S. K. Kim, K.-J. Lee, Topological magnon-phonon hybrid excitations in two-dimensional ferromagnets with tunable Chern numbers, Phys. Rev. Lett. 123 (2019) 237207. doi:10.1103/PhysRevLett.123.237207.DOI
- [21]M. V. Berry, Quantal phase factors accompanying adiabatic changes, Proc. R. Soc. Lond. A 392 (1802) (1984) 45–57. doi:10.1098/rspa.1984.0023.DOI
- [22]R. Shindou, R. Matsumoto, S. Murakami, J.-i. Ohe, Topological chiral magnonic edge mode in a magnonic crystal, Phys. Rev. B 87 (2013) 174427. doi:10.1103/PhysRevB.87.174427.DOI
- [23]D. J. Thouless, M. Kohmoto, M. P. Nightingale, M. den Nijs, Quantized Hall conductance in a two-dimensional periodic potential, Phys. Rev. Lett. 49 (1982) 405–408. doi:10.1103/PhysRevLett.49.405.DOI
- [24]T. Fukui, Y. Hatsugai, H. Suzuki, Chern numbers in discretized Brillouin zone: Efficient method of computing (spin) Hall conductances, J. Phys. Soc. Jpn. 74 (2005) 1674–1677. doi:10.1143/JPSJ.74.1674.DOI
- [25]L. Zhang, Q. Niu, Angular momentum of phonons and the Einstein–de Haas effect, Phys. Rev. Lett. 112 (2014) 085503. doi:10.1103/PhysRevLett.112.085503.DOI
- [26]V. A. Zyuzin, A. A. Kovalev, Magnon spin Nernst effect in antiferromagnets, Phys. Rev. Lett. 117 (2016) 217203. doi:10.1103/PhysRevLett.117.217203.DOI
- [27]G. Go, D. An, H.-W. Lee, S. K. Kim, Magnon orbital Nernst effect in honeycomb antiferromagnets without spin–orbit coupling, Nano Lett. 24 (20) (2024) 5968–5974. doi:10.1021/acs.nanolett.4c00430.DOI
- [28]F. Wilczek, A. Zee, Appearance of gauge structure in simple dynamical systems, Phys. Rev. Lett. 52 (1984) 2111–2114. doi:10.1103/PhysRevLett.52.2111.DOI
- [29]H. Kondo, Y. Akagi, Nonlinear magnon spin Nernst effect in antiferromagnets and strain-tunable pure spin current, Phys. Rev. Research 4 (2022) 013186. doi:10.1103/PhysRevResearch.4.013186.DOI
- [30]J. Ni, Y. Jin, Q. Du, G. Chang, Magnon nonlinear Hall effect in two-dimensional antiferromagnetic insulators, Phys. Rev. B 112 (2025) 054424. doi:10.1103/72sf-6km4.DOI
- [31]B. Flebus, K. Shen, T. Kikkawa, K.-i. Uchida, Z. Qiu, E. Saitoh, R. A. Duine, G. E. W. Bauer, Magnon-polaron transport in magnetic insulators, Phys. Rev. B 95 (2017) 144420. doi:10.1103/PhysRevB.95.144420.DOI
- [32]R. Matsumoto, S. Murakami, Theoretical prediction of a rotating magnon wave packet in ferromagnets, Phys. Rev. Lett. 106 (2011) 197202. doi:10.1103/PhysRevLett.106.197202.DOI
- [33]R. Matsumoto, S. Murakami, Rotational motion of magnons and the thermal Hall effect, Phys. Rev. B 84 (2011) 184406. doi:10.1103/PhysRevB.84.184406.DOI
- [34]R. Hoyer, R. Jaeschke-Ubiergo, K.-H. Ahn, L. Šmejkal, A. Mook, Spontaneous crystal thermal Hall effect in insulating altermagnets, Phys. Rev. B 111 (2025) L020412. doi:10.1103/PhysRevB.111.L020412.DOI
- [35]P. A. Pantaleón, Y. Xian, Analytical study of the edge states in the bosonic Haldane model, J. Phys.: Condens. Matter 29 (29) (2017) 295701, corrected manuscript: arXiv:1704.07746v3. doi:10.1088/1361-648X/aa75bf.DOI
- [36]L. Zhang, Q. Niu, Chiral phonons at high-symmetry points in monolayer hexagonal lattices, Phys. Rev. Lett. 115 (2015) 115502. doi:10.1103/PhysRevLett.115.115502.DOI



