IRSSG: An Open-Source Software Package for Spin Space Groups
Sheng Zhang, Ziyin Song, Zhong Fang, Hongming Weng, Zhijun Wang
TL;DR
IRSSG presents an open-source framework to determine irreducible corepresentations of magnetic states in spin space groups, bridging DFT wavefunctions with SSG symmetry analysis. It identifies SSG operations, assigns an international symbol, constructs $k$-point little groups, and computes traces of matrix representations to label magnetic energy bands with coirreps, integrating plane-wave and Wannier-based approaches. The tool is compatible with common DFT codes via Wannier90 interfaces and can handle all crystallographic symmetry settings (CSGs and MSGs) given an appropriate $ssg.data$. Demonstrated on systems like NpBi and Eu$_3$PbO, IRSSG reveals symmetry-protected band features such as fourfold nodal lines and EF-enforced degeneracies, enabling targeted $k\cdot p$ modeling and magnetic topology exploration. The method advances the study of magnons, altermagnetism, and high-degeneracy excitations by providing direct symmetry labels for magnetic energy bands from first-principles calculations.
Abstract
We present an open-source software package IRSSG for investigating magnetic systems with spin space groups (SSGs). The package works within the density functional theory (DFT) framework and requires wavefunctions from DFT codes, such as VASP, Quantum ESPRESSO, as well as any other code that has an interface to Wannier90. We introduce a set of compact SSG international symbols by combining non-crystallographic point groups with the 230 crystallographic space groups. The program first identifies all SSG operations and determines the SSG international symbol for a given magnetic system. It then generates the SSG character tables of little groups at any $k$ point. Finally, it computes the traces of matrix presentations of SSG operations and assigns irreducible corepresentation labels to magnetic energy bands. The program is not only timely but also essential for advancing research on the study of magnons, altermagnetism, magnetic topology, and novel high-degeneracy excitations in SSG systems.
