U-HamGNN: a universal model for magnetic Hamiltonians conditioned on spin and Hubbard U

Hongyu Yu, Yinze Hu, Yizhou Chen, Yang Cheng, Yingwei Chen, Xingao Gong, Yang Zhong, Hongjun XiangarXiv 2026 · arXiv

TL;DR

U-HamGNN is a universal, equivariant graph neural network that predicts the electronic Hamiltonians of magnetic crystals by taking both spin configurations and the Hubbard $U$ parameter as direct inputs. By bypassing the expensive iterative cycles of traditional DFT+U calculations, it enables researchers to screen for exotic magnetic states, like altermagnetism, with orders-of-magnitude speedups and high precision.

What Problem Does This Paper Address?

In the world of computational materials science, understanding magnetism is a "many-headed hydra." The electronic structure of a magnetic material doesn't just depend on where the atoms are; it depends on how their spins are aligned (ferromagnetic, antiferromagnetic, etc.) and the strength of the Hubbard $U$ correction—a parameter used in Density Functional Theory (DFT+U) to account for strongly correlated electrons in $d$ and $f$ shells.

Because $U$ isn't a fundamental constant and varies by chemical environment, researchers often have to "scan" multiple $U$ values for every possible magnetic configuration. This creates a massive computational bottleneck: a single high-throughput survey might require thousands of self-consistent DFT calculations, each of which is notoriously difficult to converge for magnetic systems. Existing machine learning models were either limited to specific material families, ignored magnetism entirely, or treated $U$ as a fixed constant. U-HamGNN aims to be the first "universal" model that treats both spin and $U$ as flexible inputs across the periodic table.

Methods

The authors built U-HamGNN upon the Uni-HamGNN architecture, utilizing equivariant neural networks (via the e3nn framework). This ensures the model respects the fundamental rotational symmetries of atomic orbitals.

Key technical innovations include:

  • Dual-Conditioning: The model takes the crystal graph, a collinear spin direction ($s_i \in \{+1, -1, 0\}$), and the Hubbard $U$ value for each site. $U$ is processed through a Gaussian expansion embedding, allowing the network to learn how the Hamiltonian "responds" to changes in electron correlation.
  • Physics-Informed Assembly: Instead of predicting the full spin-polarized Hamiltonian directly, the model predicts a spin-independent base ($H^{nm}$) and learned exchange-like couplings ($J$) and weights ($W$). These are then combined with the input spins to construct the final spin-up and spin-down channels.
  • Spectral-Hybrid Optimizer: Training large GNNs on Hamiltonians is difficult because the gradients for the dense radial-weight matrices often drift or become noisy. The authors developed a new optimizer that maintains a streaming rank-$r$ basis of the momentum, weighting update directions by their consistency. This proved significantly more stable than industry standards like AdamW.

Datasets

The model was trained on a massive, diverse dataset:

  • 154,546 training graphs derived from 35,632 magnetic crystal structures sourced from the Materials Project and MAGNDATA.
  • The data covers 71 elements and includes structures calculated at multiple $U$ settings (up to 8 eV) and various collinear magnetic states.
  • Evaluation was performed on a test set of 1,577 graphs and a "calibration set" of 43 candidates from the GNoME database.

Key Insights and Ideas

  • The "Response" Learner: By including $U$ as an input, the model doesn't just memorize Hamiltonians; it learns the physical trend of how gaps open and bands split as correlation increases. It even showed a surprising ability to generalize to $U=10$ eV, which was outside its training range.
  • Optimizer Matters: The spectral-hybrid optimizer was a crucial "aha" moment. By damping noisy gradient directions and amplifying persistent ones, it reached much lower error rates than Muon or AdamW, suggesting that standard optimizers might be a bottleneck for complex equivariant architectures.
  • Altermagnetism Screening: The model is particularly adept at identifying altermagnets—a recently discovered class of magnets that have zero net magnetization but exhibit large, momentum-dependent spin splitting. This is a "needle in a haystack" problem that U-HamGNN is uniquely suited to solve.

Key Results

  • High Accuracy: The model achieved a Mean Absolute Error (MAE) of just 1.80 meV across 1.48 billion Hamiltonian matrix elements.
  • Efficiency: For a 32-atom Ag$_3$RuO$_4$ cell, the model's forward pass takes roughly 2.5 seconds on a single GPU. In contrast, a traditional self-consistent DFT+U calculation takes about 316 seconds on 55 CPU cores.
  • Discovery Power: The authors used the model to rank candidates from the GNoME database. Out of the top 24 candidates, they successfully validated 5 new altermagnets using ground-truth DFT+U, confirming the model's utility as a high-fidelity screening tool.
  • Magnetic Order: The model correctly predicted the binary magnetic order (ferromagnetic vs. antiferromagnetic) in 17 out of 20 test cases.

Limitations and Future Work

  • Collinear Only: The current model is restricted to collinear magnetism (spins are either up or down along a single axis). It cannot yet handle non-collinear textures like skyrmions.
  • No Spin-Orbit Coupling (SOC): While the authors have previously worked on SOC in non-magnetic systems, this specific model lacks SOC. Combining the two is a stated goal for future versions to capture magnetic anisotropy.
  • Ground State Search: The model predicts the Hamiltonian for a given configuration. It does not automatically find the magnetic ground state, though it provides the exchange couplings ($J_{ij}$) necessary to find it via secondary methods like simulated annealing.

Summary updated

Abstract

The electronic structure of a magnetic crystal depends jointly on its spin configuration and the on-site Hubbard correction U, requiring a separate DFT+U calculation for each combination. We introduce U-HamGNN, an equivariant network that takes these two inputs directly and predicts spin-resolved Hamiltonians across diverse crystal chemistries. A spectral-hybrid optimizer that weights each update direction by how consistently the gradient points along it reaches 8% lower Hamiltonian error than Muon and 26% lower than AdamW in a ten-epoch benchmark. The predicted bands reproduce U-dependent gap opening and altermagnetic spin splitting within the trained window and beyond it; exchange couplings and magnetic-order calls derived from the Hamiltonian agree with DFT+U on a calibration set. This universal model provides a new tool for magnetic research.
BibTeX
@misc{yu2026u,
  author = {Hongyu Yu and Yinze Hu and Yizhou Chen and Yang Cheng and Yingwei Chen and Xingao Gong and Yang Zhong and Hongjun Xiang},
  title = {{U-HamGNN: a universal model for magnetic Hamiltonians conditioned on spin and Hubbard U}},
  year = {2026},
  eprint = {2611.20035},
  archivePrefix = {arXiv},
  url = {https://arxiv.org/abs/2611.20035},
}
Figure