qdmag: A Python package for simulating nonequilibrium magnetization of molecules using quantum master equations
Abstract
We present qdmag, a computational utility for calculating the magnetization of magnetic molecules in a time-varying external magnetic field by solving a generalized Lindblad quantum master equation with spin-phonon coupling treated as a dissipation term. The package relies on the spin Hamiltonian formalism, which includes both the magnetic exchange interactions and the zero-field splitting (ZFS) interaction. Different types of magnetic exchange interaction and ZFS terms up to 12th order, which are written in terms of the extended Stevens operators, are supported. qdmag enables long-time evolution of magnetization for up to a few milliseconds, which is achieved through a staircase approximation of the magnetic field as a function of time. For high-dimensional spin Hamiltonians, a lower-dimensional effective Hamiltonian is constructed to make the calculations computationally feasible. Three case studies of one-spin, two-spin, and three-spin systems are presented to demonstrate the usage of qdmag. Our work offers a computational tool to bridge the gap between theoretical development and numerical calculations of spin dynamics in the presence of spin-phonon coupling.
Related
- axionbloch: an Open-Source Python Package for Simulating Axion-Induced Spin Dynamics
- QwaveMPS: An efficient open-source Python package for simulating non-Markovian waveguide-QED using matrix product states
- COMPLAX: A Python Tool Package for Automated Microsolvation of Organic Molecules
- Nonequilibrium Thermodynamics of Semilinear Stochastic Partial Differential Equations
- Variational study of the magnetization plateaus in the spin-1/2 kagome Heisenberg antiferromagnet: An approach from vision transformer neural quantum states
BibTeX
@misc{liu2026qdmag,
title = {{qdmag: A Python package for simulating nonequilibrium magnetization of molecules using quantum master equations}},
author = {Shuanglong Liu and Xiao Chen and Andrew Cupo and James N. Fry and Hai-Ping Cheng},
howpublished = {arXiv},
year = {2026},
month = sep,
doi = {10.48550/arxiv.2609.16352},
eprint = {2609.16352},
archivePrefix = {arXiv},
url = {https://arxiv.org/abs/2609.16352},
note = {CC BY 4.0},
}
RIS
TY - UNPB
TI - qdmag: A Python package for simulating nonequilibrium magnetization of molecules using quantum master equations
AU - Shuanglong Liu
AU - Xiao Chen
AU - Andrew Cupo
AU - James N. Fry
AU - Hai-Ping Cheng
PY - 2026
DA - 2026/09/14
PB - arXiv
DO - 10.48550/arxiv.2609.16352
UR - https://arxiv.org/abs/2609.16352
AB - We present qdmag, a computational utility for calculating the magnetization of magnetic molecules in a time-varying external magnetic field by solving a generalized Lindblad quantum master equation with spin-phonon coupling treated as a dissipation term. The package relies on the spin Hamiltonian formalism, which includes both the magnetic exchange interactions and the zero-field splitting (ZFS) interaction. Different types of magnetic exchange interaction and ZFS terms up to 12th order, which are written in terms of the extended Stevens operators, are supported. qdmag enables long-time evolution of magnetization for up to a few milliseconds, which is achieved through a staircase approximation of the magnetic field as a function of time. For high-dimensional spin Hamiltonians, a lower-dimensional effective Hamiltonian is constructed to make the calculations computationally feasible. Three case studies of one-spin, two-spin, and three-spin systems are presented to demonstrate the usage of qdmag. Our work offers a computational tool to bridge the gap between theoretical development and numerical calculations of spin dynamics in the presence of spin-phonon coupling.
ER -