Ionic Substitution

Goal

To discover new crystal structures using data-mined ionic substitution (Hautier et al. 2011). Two modes:

1. Forward (propose): Given an existing structure, propose all high-probability ion-substituted variants. E.g., input NaCoO₂ → get LiCoO₂, KCoO₂, NaNiO₂, etc.
2. Reverse (find): Given a target composition, find all known crystal structures that can be ion-substituted to create it, plus direct matches from Materials Project.

The substitution probability model is trained on the ICSD (Inorganic Crystal Structure Database) and captures empirical chemical rules about which ions commonly substitute for each other.

[!TIP] After generating candidate structures, relax them with an MLIP and compute their stability (E_hull) to prioritize the most thermodynamically viable candidates.

Instructions

Mode 1: Forward — Propose substitutions from a structure

1. Prepare a source structure (CIF or POSCAR). Ensure it is an ordered structure.