Magesty.jl

Magesty.jl (MAGnetic model ESTimator) is a Julia package for construction of Spin-Cluster Expansion (SCE) [1] model. It provides comprehensive tools for:

  • Construction of symmetry-adapted SCE basis set
  • Derivation of SCE coefficients
  • Tools for spin configuration sampling

Documentation

PageDescription
InstallationPackage installation and PATH setup for CLI tools
TutorialStep-by-step guide for first-time users
ExamplesCode examples for common tasks
Input KeysFull reference for TOML configuration keys
API ReferenceDetailed documentation of all exported functions and types
ToolsUtility scripts in the tools/ directory
Technical NotesTheory behind the SCE formalism
TipsPractical tips

Tools

Magesty.jl includes a comprehensive set of utility tools in the tools/ directory for:

  • Data Processing: Convert between different file formats (VASP, TOML, XML)
  • Analysis: Compare energies, perform cross-validation, analyze magnetic moments
  • Visualization: Create scatter plots for energy/torque fit quality
  • Sampling: Generate spin configurations using Mean-Field Approximation
  • Advanced Analysis: Calculate micromagnetics parameters

See the Tools page for detailed documentation of all available tools.

Citation

If you use Magesty.jl in your research, please cite:

Tomonori Tanaka and Yoshihiro Gohda, "General spin models from noncollinear spin density functional theory and spin-cluster expansion", arXiv:2512.04458

References

  1. R. Drautz and M. Fähnle, "Spin-cluster expansion: Parametrization of the general adiabatic magnetic energy surface with ab initio accuracy", Phys. Rev. B 69, 104404 (2004). DOI: 10.1103/PhysRevB.69.104404