Crystal symmetry and cell transformations

The symmetry command uses spglib to provide three distinct operations:

  • Analysis identifies the space group and leaves the structure unchanged.

  • Cell conversion finds a primitive or standardized conventional cell.

  • Idealization projects lattice metrics and atom positions onto the detected symmetry, preserving the original basis and atom ordering.

These operations can be requested independently or combined.

Examples

ase2sprkkr symmetry input.cif
ase2sprkkr symmetry input.cif --primitive -o primitive.cif
ase2sprkkr symmetry input.cif --standardize -o conventional.cif
ase2sprkkr symmetry input.cif --idealize -o idealized.cif
ase2sprkkr symmetry input.cif --primitive --idealize -o primitive_ideal.cif

Use --equivalence occupation when chemically equivalent sites should be compared by occupation rather than their current site types.

CIF-declared symmetry

For CIF input, the command reports both the declared space group (if present) and the symmetry calculated from the atomic positions. Different space-group numbers are highlighted. Use --operations to list symmetry operations, or save a JSON report:

ase2sprkkr symmetry input.cif --report report.json

Python API:

from ase.io import read
from ase2sprkkr.sprkkr.symmetry import analyze_symmetry

atoms = read("input.cif")
analysis = analyze_symmetry(atoms)
primitive = analysis.find_primitive(atoms)
conventional = analysis.standardize(atoms)
idealized_in_original_cell = analysis.idealize(atoms)
idealized_primitive = analysis.find_primitive(atoms, idealize=True)

The default site-types equivalence distinguishes SPR-KKR site types and magnetic information. Region identity is preserved when finding equivalent sites. The occupation mode can merge sites with identical chemical occupations even when their electronic site-type data differ; recheck the resulting electronic data before further calculations.

Extra ASE arrays use one of three transfer policies when converting cells:

  • require-equal (default): Values of atoms in the same primitive translation class must agree.

  • discard: Do not transfer additional arrays.

  • choose-first: Select the first source representative of each primitive site, and warn when values differ.

Extra arrays are checked when a cell is converted, and tensor/vector frame transformations are not performed automatically. Idealization by itself retains atom ordering and electronic data. If the geometry changes, a new SCF calculation is recommended before relying on an old potential.