Skip to main content
CI Status https://codecov.io/gh/materialsvirtuallab/pymatgen-analysis-diffusion/graph/badge.svg?token=4lH4UZcXye

pymatgen-analysis-diffusion

Formerly pymatgen-diffusion, this is an add-on to pymatgen for diffusion analysis that is developed by the Materials Virtual Lab. Note that it relies on pymatgen for structural manipulations, file io, and preliminary analyses. This is and will always be, a scientific work in progress. Pls check back regularly for more details.

Documentation available via Github Pages.

Major Update (v2021.3.5)

pymatgen-analysis-diffusion is now released as a namespace package pymatgen-analysis-diffusion on PyPI. It should be imported via pymatgen.analysis.diffusion instead pymatgen_diffusion. To install this package via pip:

pip install pymatgen-analysis-diffusion

Features (non-exhaustive!)

  1. Van-Hove analysis

  2. Probability density

  3. Clustering (e.g., k-means with periodic boundary conditions).

  4. Migration path finding and IDPP.

Citing

If you use pymatgen-diffusion in your research, please cite the following work:

Deng, Z.; Zhu, Z.; Chu, I.H.; Ong, S. P. Data-Driven First-Principles
Methods for the Study and Design of Alkali Superionic Conductors,
Chem. Mater., 2016, acs.chemmater.6b02648, doi:10.1021/acs.chemmater.6b02648.

You should also include the following citation for the pymatgen core package given that it forms the basis for most of the analyses:

Shyue Ping Ong, William Davidson Richards, Anubhav Jain, Geoffroy Hautier,
Michael Kocher, Shreyas Cholia, Dan Gunter, Vincent Chevrier, Kristin A.
Persson, Gerbrand Ceder. *Python Materials Genomics (pymatgen) : A Robust,
Open-Source Python Library for Materials Analysis.* Computational
Materials Science, 2013, 68, 314-319. doi:10.1016/j.commatsci.2012.10.028.

In addition, some of the analyses may also have relevant publications that you should cite. Please consult the documentation of each module.

Contributing

We welcome contributions in all forms. If you’d like to contribute, please fork this repository, make changes and send us a pull request!

Acknowledgments

We gratefully acknowledge funding from the following agencies for the development of this code:

  1. US National Science Foundation’s Designing Materials to Revolutionize and Engineer our Future (DMREF) program under Grant No. 1436976 for the AIMD analysis package.

  2. US Department of Energy, Office of Science, Basic Energy Sciences under Award No. DE-SC0012118 for the NEB analysis package.

Metadata

Release files for pymatgen-analysis-diffusion 2026.9.23

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pymatgen-analysis-diffusion 2026.9.23
File Size Uploaded
pymatgen_analysis_diffusion-2026.9.23.tar.gz 68.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pymatgen-analysis-diffusion 2026.9.23
File Interpreter ABI Platform
pymatgen_analysis_diffusion-2026.9.23-py3-none-any.whl Python 3 none any Details

Total release size: 142.2 kB

Release files / pymatgen_analysis_diffusion-2026.9.23.tar.gz

Download URL pymatgen_analysis_diffusion-2026.9.23.tar.gz
Size 68.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2ed4df937606156df3866df25638d04fc4349516abd5258cdb9701d81bd4d9b7
BLAKE2b-256 checksum
How to use checksums
d7109cd74e677b27d2aa67fad94ddc9d55670e26b5e0fc33628c87cd40e2c8c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / pymatgen_analysis_diffusion-2026.9.23-py3-none-any.whl

Download URL pymatgen_analysis_diffusion-2026.9.23-py3-none-any.whl
Size 73.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a43ec181cf335c5fefb8d113220435305c39eeeab90c3613e2b57928d6afa0cd
BLAKE2b-256 checksum
How to use checksums
16f16be9a927c898cf6dbed3290e6e8fbdfcd3971c61e88e90028f7b688c52a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

2026.9.23 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page