Application of canonical augmentation to the atomic substitution problem
Genki I. Prayogo, Andrea Tirelli, Keishu Utimula, Kenta Hongo, Ryo Maezono, Kousuke Nakano
TL;DR
This paper addresses the combinatorial explosion of atomic-substitution patterns in solid-state supercells by introducing SHRY, a Python implementation of canonical augmentation that yields symmetry-inequivalent structures efficiently. By framing substitutions in terms of group actions and orbit representatives, SHRY generates exactly one pattern per orbit without exhaustive enumeration, achieving linear scaling up to around $N\sim10^9$. The method integrates with CIF input/output and leverages invariants to accelerate the canonical augmentation, delivering performance competitive with established C++ tools on large problems. The approach enables practical high-throughput ab-initio investigations of disordered solids, vacancies, and related phenomena, with open-source availability to the community and potential extensions to multi-site, multi-Wyckoff, and periodic systems.
Abstract
A common approach for studying a solid solution or disordered system within a periodic ab-initio framework is to create a supercell in which a certain amount of target elements is substituted with other ones. The key to generating supercells is determining how to eliminate symmetry-equivalent structures from the large number of substitution patterns. Although the total number of substitutions is on the order of trillions, only symmetry-inequivalent atomic substitution patterns need to be identified, and their number is far smaller than the total. A straightforward solution would be to classify them after determining all possible patterns, but it is redundant and practically unfeasible. Therefore, to alleviate this drawback, we developed a new formalism based on the {\it canonical augmentation}, and successfully applied it to the atomic substitution problem. Our developed \verb|python| software package, which is called \textsc{SHRY} (\underline{S}uite for \underline{H}igh-th\underline{r}oughput generation of models with atomic substitutions implemented by p\underline{y}thon), enables us to pick up only symmetry-inequivalent structures from the vast number of candidates very efficiently. We demonstrate that the computational time required by our algorithm to find $N$ symmetry-inequivalent structures scales {\it linearly} with $N$ up to $\sim 10^9$. This is the best scaling for such problems.
