ShakeNBreak (SnB)
ShakeNBreak is a defect structure-searching method employing chemically-guided bond distortions to locate ground-state
and metastable structures of point defects in solid materials.
ShakeNBreak is open-source, developed by members of the
Simulation of Advanced Materials lab at Cambridge,
the Scanlon group at Birmingham, the Walsh group at Imperial College and
contributors from across the globe.
Main features include:
- Defect structure generation:
- Automatic generation of distorted structures for input defects
- Optionally, input file generation for geometry optimisation with several codes (
VASP, CP2K, Quantum-Espresso, CASTEP & FHI-aims)
- Analysis:
- Parsing of geometry relaxation results
- Plotting of final energies versus distortion to demonstrate what energy-lowering reconstructions have been identified
- Coordination & bonding analysis to investigate the physico-chemical factors driving an energy-lowering distortion
- Magnetisation analysis (currently only supported for
VASP)
The code currently supports VASP, CP2K, Quantum-Espresso, CASTEP & FHI-aims. Code contributions to support additional solid-state packages are welcome.
Literature
We kindly ask that you cite the code and theory/method papers if you use ShakeNBreak in your work.
- Preview: Mosquera-Lois, I.; Kavanagh, S. R. In Search of Hidden Defects, Matter 4 (8), 2602-2605, 2021
- Code: Mosquera-Lois, I. & Kavanagh, S. R.; Walsh, A.; Scanlon, D. O. ShakeNBreak: Navigating the defect configurational landscape, Journal of Open Source Software 7 (80), 4817, 2022
- Theory/Method: Mosquera-Lois, I. & Kavanagh, S. R.; Walsh, A.; Scanlon, D. O. Identifying the Ground State Structures of Defects in Solids, npj Comput Mater 9, 25 2023
- News & Views: Mannodi-Kanakkithodi, A. The Devil is in the Defects, Nature Physics 2023 (Free-to-read link)
- YouTube Overview (10 mins): ShakeNBreak: Symmetry-Breaking and Reconstruction at Defects in Solids
- YouTube Seminar (35 mins): Seminar: Predicting the Atomic Structures of Defects
- DeepWiki Code Overview & Workflow
See the doped Literature section for recommended articles on
defect modelling in general.
Installation
ShakeNBreak can be installed using conda:
conda install -c conda-forge shakenbreak
or pip:
pip install shakenbreak
See the Installation docs if you encounter any issues (e.g. known issue with phonopy CMake build).
If using VASP, in order for ShakeNBreak to automatically generate the pseudopotential input files (POTCARs), your local VASP pseudopotential directory must be set in the pymatgen configuration file $HOME/.pmgrc.yaml as follows:
PMG_VASP_PSP_DIR: <Path to VASP pseudopotential top directory>
Within your VASP pseudopotential top directory, you should have a folder named POT_GGA_PAW_PBE
which contains the POTCAR.X(.gz) files (in this case for PBE POTCARs). Please refer to the doped Installation docs if you have
difficulty with this.
The font Montserrat (Open Font License) will be installed with the package, and will be used by default for plotting.
Usage
Python API
ShakeNBreak can be used through a Python API, as exemplified in the SnB Python API tutorial, with more info available on the docs.
Command line interface
Alternatively, the code can be used via the command line:
The functions provided include:
snb-generate: Generate distorted structures for a given defectsnb-generate_all: Generate distorted structures for all defects present in the specified/current directorysnb-run: Submit geometry relaxations to the HPC schedulersnb-parse: Parse the results of the geometry relaxations and write them to a yaml filesnb-analyse: Generate csv files with energies and structural differences between the final configurationssnb-plot: Generate plots of energy vs distortion, with the option to include a colorbar to quantify structural differencessnb-regenerate: Identify defect species undergoing energy-lowering distortions and test these distortions for the other charge states of the defectsnb-groundstate: Save the ground state structures to a Groundstate directory for continuation runs
More information about each function and its inputs/outputs are available from the CLI section of the docs or using -h help option (e.g. snb -h).
We recommend at least looking through the tutorials when first starting to use ShakeNBreak, to familiarise yourself with the full functionality and workflow.
You may also find the
YouTube Overview (10 mins),
YouTube Seminar (35 mins)
and/or papers listed in the Literature section above useful.
Studies using ShakeNBreak
- A. G. Squires, S. R. Kavanagh, A. Walsh and D. O. Scanlon Guidelines for robust and reproducible point defect simulations in crystals Nature Reviews Materials 2026
- X. Wang et al. Making atomistic materials calculations accessible with the AiiDAlab Quantum ESPRESSO app npj Computational Materials 2026
- D. J. Keeble Detection and identification of vacancy defects in antimony selenide Nature Communications 2026
- E. I. Jaffal et al. Investigating mechanical properties through defect chemistry in hard binary phosphide material Ta3P Solid State Communications 2026
- L. Tian et al. Optical Spectroscopic Determination of Photoexcited Small-Polaron Hopping in Transition Metal Oxide Photocatalysts Chemical Science 2026
- M. Biswas et al. Unified Graph-based Interatomic Potential for Perovskite Structure Optimization Journal of Chemical Information and Modeling 2026
- S. R. Kavanagh Identifying Split Vacancy Defects with Machine-Learned Foundation Models and Electrostatics JPhys Energy 2025
- R. Claes, A. G. Squires and D. O. Scanlon Establishing Doping Limits for ZnGa2O4 for Ultrawide-Band-Gap Semiconductor Applications ACS Applied Materials & Interfaces 2025
- Y. Liu, S. Chae and E. Kioupakis Origin of shallow n-type doping in AlN and Al-rich AlGaN arXiv 2025
- J. Zhou et al. Breaking the 800 mV open-circuit voltage barrier in antimony sulfide photovoltaics arXiv 2025
- K. Talit et al. Structural and electronic properties of Ti- and Ca-doped hexagonal TbInO3 Physical Review Materials 2025
- I. Mosquera-Lois, A. Walsh Dynamic Vacancy Levels in CsPbCl3 Obey Equilibrium Defect Thermodynamics PRX Energy 2025
- B. I. J. Johnston et al. Enhanced cycling stability of LiNiO2 cathodes through a Mg/W dual-cation modification strategy Journal of Materials Chemistry A 2025
- Z. Li and A. Walsh Thermodynamics of Sulfur Vacancy Formation in the Chalcogenide Perovskite BaZrS3 Journal of Physical Chemistry C 2025
- P. Russell et al. Computational prediction of Y-doped Cd2Sb2O7 as a competitive Sb-based n-type Transparent Conducting Oxide ChemRxiv 2025
- M. A. Fadla et al. Tailoring the Electronic Properties of Monoclinic (InxAl1-x)2O3 Alloys via Substitutional Donors and Acceptors Physical Review Materials 2025
- C. López et al. Chalcogen Vacancies Rule Charge Recombination in Pnictogen Chalcohalide Solar-Cell Absorbers ACS Energy Letters 2025
- K. Ogawa et al. Defect Tolerance via External Passivation in the Photocatalyst SrTiO3:Al Journal of the American Chemical Society 2025
- Y. Fu & H. Lohan et al. Factors Enabling Delocalized Charge-Carriers in Pnictogen-Based Solar Absorbers: In-depth Investigation into CuSbSe2 Nature Communications 2025
- Y. Liu Small hole polarons in yellow phase δ-CsPbI3 Physical Review Materials 2025
- S. R. Kavanagh et al. Intrinsic point defect tolerance in selenium for indoor and tandem photovoltaics Energy & Environmental Science 2025
- J. Huang et al. Manganese in β-Ga2O3: a deep acceptor with a large nonradiative electron capture cross-section Journal of Physics D: Applied Physics 2025
- J. Hu et al. Enabling ionic transport in Li3AlP2 the roles of defects and disorder Journal of Materials Chemistry A 2025
- X. Zhao et al. Trace Yb doping-induced cationic vacancy clusters enhance thermoelectrics in p-type PbTe Applied Physics Letters 2025
- Z. Cai & C. Ma Origin of oxygen partial pressure-dependent conductivity in SrTiO3 Applied Physics Letters 2025
- R. Desai et al. Exploring the Defect Landscape and Dopability of Chalcogenide Perovskite BaZrS3 Journal of Physical Chemistry C 2025
- G. Kalemai et al. Flexible Inorganic/Organic Memristor Based on W-Doped MoOx/Poly(methyl methacrylate) Heterostructure Nanomaterials 2025
- C. Kaewmeechai, J. Strand & A. Shluger Structure and Migration Mechanisms of Oxygen Interstitial Defects in β-Ga2O3 Physica Status Solidi B 2025
- Y. Gong Wang et al. Influence of Vanadium and Chromium Doping on the Thermoelectric Performance of AgSbTe2 Physica Scripta 2025
- W. Gierlotka et al. Thermodynamics of point defects in the AlSb phase and its influence on phase equilibrium Computational Materials Science 2025
- P. Panagis Filippatos et al. Ab initio investigation of the Cr substitutional defect in α-quartz for quantum applications Journal of Applied Physics 2025
- P. Panagis Filippatos, T. J. P. Irons and K. Inzani Revisiting intrinsic spin defects in hexagonal boron nitride with r2SCAN arXiv 2025
- P. Panagis Filippatos, A. Chroneos and N. Kelaidis A first-principles investigation of halogen doped diamond and its application to quantum technologies Journal of Applied Physics 2025
- W. D. Neilson et al. Oxygen Potential, Uranium Diffusion, and Defect Chemistry in UO2±x: A Density Functional Theory Study Journal of Physical Chemistry C 2024
- X. Wang et al. Sulfur Vacancies Limit the Open-circuit Voltage of Sb2S3 Solar Cells ACS Energy Letters 2024
- Z. Yuan & G. Hautier First-principles study of defects and doping limits in CaO Applied Physics Letters 2024
- B. E. Murdock et al. Li-Site Defects Induce Formation of Li-Rich Impurity Phases: Implications for Charge Distribution and Performance of LiNi0.5-xMxMn1.5O4 Cathodes (M = Fe and Mg; x = 0.05–0.2) Advanced Materials 2024
- A. G. Squires et al. Oxygen dimerization as a defect-driven process in bulk LiNiO22 ACS Energy Letters 2024
- X. Wang et al. Upper efficiency limit of Sb2Se3 solar cells Joule 2024
- I. Mosquera-Lois et al. Machine-learning structural reconstructions for accelerated point defect calculations npj Computational Materials 2024
- S. R. Kavanagh et al. doped: Python toolkit for robust and repeatable charged defect supercell calculations Journal of Open Source Software 2024
- K. Li et al. Computational Prediction of an Antimony-based n-type Transparent Conducting Oxide: F-doped Sb2O5 Chemistry of Materials 2024
- S. Hachmioune et al. Exploring the Thermoelectric Potential of MgB4: Electronic Band Structure, Transport Properties, and Defect Chemistry Chemistry of Materials 2024
- X. Wang et al. Four-electron negative-U vacancy defects in antimony selenide Physical Review B 2023
- Y. Kumagai et al. Alkali Mono-Pnictides: A New Class of Photovoltaic Materials by Element Mutation PRX Energy 2023
- A. T. J. Nicolson et al. Cu2SiSe3 as a promising solar absorber: harnessing cation dissimilarity to avoid killer antisites Journal of Materials Chemistry A 2023
- J. Willis, K. B. Spooner, D. O. Scanlon On the possibility of p-type doping in barium stannate Applied Physics Letters 2023
- J. Cen et al. Cation disorder dominates the defect chemistry of high-voltage LiMn1.5Ni0.5O4 (LMNO) spinel cathodes Journal of Materials Chemistry A 2023
- J. Willis & R. Claes et al. Limits to Hole Mobility and Doping in Copper Iodide Chemistry of Materials 2023
- I. Mosquera-Lois & S. R. Kavanagh, A. Walsh, D. O. Scanlon Identifying the ground state structures of point defects in solids npj Computational Materials 2023
- B. Peng et al. Advancing understanding of structural, electronic, and magnetic properties in 3d-transition-metal TM-doped α-Ga₂O₃ (TM = V, Cr, Mn, and Fe) Journal of Applied Physics 2023
- Y. T. Huang & S. R. Kavanagh et al. Strong absorption and ultrafast localisation in NaBiS2 nanocrystals with slow charge-carrier recombination Nature Communications 2022
- S. R. Kavanagh, D. O. Scanlon, A. Walsh, C. Freysoldt Impact of metastable defect structures on carrier recombination in solar cells Faraday Discussions 2022
- Y-S. Choi et al. Intrinsic Defects and Their Role in the Phase Transition of Na-Ion Anode Na2Ti3O7 ACS Applied Energy Materials 2022 (Early version)
- S. R. Kavanagh, D. O. Scanlon, A. Walsh Rapid Recombination by Cadmium Vacancies in CdTe ACS Energy Letters 2021
- C. J. Krajewska et al. Enhanced visible light absorption in layered Cs3Bi2Br9 through mixed-valence Sn(II)/Sn(IV) doping Chemical Science 2021 (Early version)
- (News & Views): A. Mannodi-Kanakkithodi The devil is in the defects Nature Physics 2023 (Free-to-read link)
License and Citation
ShakeNBreak is made available under the MIT License.
If you use it in your research, please cite:
- Code: Mosquera-Lois, I. & Kavanagh, S. R.; Walsh, A.; Scanlon, D. O. ShakeNBreak: Navigating the defect configurational landscape. Journal of Open Source Software 7 (80), 4817, 2022
- Theory/Method: Mosquera-Lois, I. & Kavanagh, S. R.; Walsh, A.; Scanlon, D. O. Identifying the Ground State Structures of Defects in Solids npj Comput Mater 9, 25 2023
You may also find this Preview paper useful, which discusses the general problem of defect structure prediction:
BibTeX entries for these papers are provided in the CITATIONS.md file.
Code Compatibility
ShakeNBreak is built to natively function using doped / pymatgen Defect objects and be compatible with the most recent version of pymatgen.
If you are receiving pymatgen-related errors when using ShakeNBreak, you may need to update pymatgen and/or ShakeNBreak, which can be done with:
pip install -U pymatgen shakenbreak
ShakeNBreak is compatible with a variety of inputs (to then generate the trial distorted structures), including doped / pymatgen Defect objects, pymatgen Structure objects or structure files
(e.g. POSCARs for VASP). As such, it should be compatible with any defect code
(such as doped, pydefect,
PyCDT, PyLada,
DASP, Spinney,
DefAP, PyDEF…) or manual defect supercell generation.
Please let us know if you have any issues with compatibility, or if you would like to see any additional features added to ShakeNBreak to make it more compatible with your code.
Acknowledgements
ShakeNBreak has benefitted from feedback from many members of the Walsh and Scanlon research groups who have used / are using it in their work, including Adair Nicolson, Xinwei Wang, Katarina Brlec, Joe Willis, Zhenzhu Li, Jiayi Cen, Lavan Ganeshkumar, Daniel Sykes, Luisa Herring-Rodriguez, Alex Squires, Sabrine Hachmioune and Chris Savory.
Further code contributions have been added by Wei Bo Ng (@hwbng).
Contributing
Bugs reports, feature requests and questions
Please use the Issue Tracker to report bugs or request new features.
Contributions to extend this package are very welcome! Please use the
“Fork and Pull”
workflow to do so and follow the PEP8 style guidelines.
See the Contributing Documentation for detailed instructions.
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)
评论