NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #4199 most downloaded on PyPI
Python Materials Genomics is a robust materials analysis code that defines core object representations for structures
Last release 4 months ago
04 May 2026
Release timing varies
gaps range from 9 days to 6 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
9 versions withdrawn
withdrawn after publishing
15 years old
412 releases · first in 2011
Ensure correct monty version requirement in setup.py.
Rudimentary PWSCF output reading.
One column per quarter.
Move vasp.vasp_put to vasp._puts. Also, maintain backwards compatibility with vaspio.vasp_*put
Fix missing yaml files that have been moved.
All changes are backwards compatible for now. But deprecation messages have been included which states that the stubs will be removed in pymatgen 4.0.…
HHI Resource Analysis (by Anubhav Jain).
Bug fixes for SpacegroupAnalyzer and SlabGenerator.
Much improved surface generation algorithm that provides for orthogonality constraints.
Bug fix for parsing certain types of CIFs.
v3.0.11
Nothing published for this version
Lots of abinitio improvements (Matteo).
Fix cartesian coord parsing in Poscar class.
Major bug fixes for CIF parsing (Will Richards).
v3.0.8
Massive update to abinitio (Matteo).
v3.0.7
Powerful Slab generation algorithms (beta!).
Cost analysis module (Anubhav Jain)
v3.0.5
Completely revamped symmetry package. The finder.SymmetryFinder and pointgroup and spacegroup modules are now deprecated. Instead, all symmetry analys…
pymatgen.symmetry.analyzer_
module. There is also a completely rewritten support for symmetry groups in
:module:pymatgen.symmetry.groups_. Structure now supports a static
constructor to generate a structure from a spacegroup (see examples).v3.0.4
Fix missing structures json data.
v3.0.3
Updates to DiffusionAnalyzer for more fine
Consistent use of unicode throughout pymatgen.
v3.0.1
1. Minor bug fixes for cifio. 2. Py3k updates for abinitio.
All deprecated methods in pymatgen 2.x have been removed. E.g., pymatgen.core.structure_modifier is no longer available.
Bug fix for np1.9 incompatibility. Now works.
DiffusionAnalyzer now has non-smoothed option.
Nothing published for this version
MPRester.query now supports a simple but powerful string criteria syntax with support for wild cards.
Bug fix for Projected DOS parsing in new Vasprun.
Minor fix for monty requirements in setup.py.
Major update: MPRester now uses Materials API v2! Also major refactoring of MPRester.
Implements Structure.sort method. Both Structure.sort and the get_sorted_structure methods now supports all arguments supported by list .sort().
Urgent bug fix for missing compatibility yamls.
Defect transformations (Bharat).
Speed up XRD calculator by allowing specification of two theta ranges.
Bug fix for unequal coefficients sizes in XRD.
XRDCalculator now supports disordered structures.
Initial beta version of XRD pattern calculator.
Quick bug-fix release that provides a better solution to Structure handling of properties instead of sanitizing MPRester structures.
Patch to allow 1D phase diagrams (essentially finding the lowest energy phase).
Bug fix for linear assignment, which may sometimes affect Structure Matcher results.
Bug fix for Pourbaix Maker (Sai).
Bug fix release for printing TransformedStructures from Substitutor (Will Richards).
Bug fix release for DummySpecie, which failed when deserializing from json and had bad hash function.
Structure/Molecule now supports Pythonic list-like API for replacing and removing sites. See quick_start for examples.
Structure/Molecule now supports Pythonic list-like API for replacing and removing sites. See quick_start for examples.
Updates to support ABINIT 7.6.1 (by Matteo Giantomassi).
Monty package <https://pypi.python.org/pypi/monty>_, which is now a dependency
for pymatgen.Refactoring of qchemio module (by Xiaohui Qu).
qchemio module (by Xiaohui Qu).
Minor bug fix release for Structure species substitution methods.
Massive update to pymatgen.io.abinitio package (by Matteo Giantomassi).
Bug fix for VASP io set introduced by the default to sorting of structure sites when generating VASP input.
Nothing published for this version
Big fix release for json dumping for unitized floats.
Bug fix release to improve CIF parsing for more non-standard CIF files. In particular, non-ascii characters are removed and \_cgraph\* fields are remo
Bug fix release. Incorrect units assigned for ionic radii.
Units. Pymatgen now has a new system of managing units, defined in pymatgen.core.units. Typical energy, length, time, temperature and charge units are
Units. Pymatgen now has a new system of managing units, defined in pymatgen.core.units. Typical energy, length, time, temperature and charge units are supported. Units subclass float, which makes the usage transparent in all functions. The value that they being are in terms of conversions between different units and addition and subtraction of different units of the same type. Some basic quantities like ionic radii and atomic masses are now returned in unitized forms for easy conversion. Please see pymatgen.core.units and the examples for a demonstration of house to use units in pymatgen.
Minor backwards-incompatible change. Structures are now sorted by default when generating VASP input files using vaspio_set. Old behavior can be obtained by setting sort_structure=False in the constructor. This is typically the desired behavior and prevents the generation of large POTCARs when atomic species are not grouped together.
Bug fix for Molecule.substitute. Earlier algorithm was not detecting terminal atoms properly.
Additional conversion tools for ABINIT (by Matteo Giantomassi).
Minor bug fix release to fix pyhull dependencies to be more friendly.
Nothing published for this version
Beta new Gulp Caller and Zeo++ interface classes (Bharat . Zeo++ is an open source software for performing high-throughput geometry-based analysis of
Support for VTK 6.x in structure visualization.
Vastly improved Nwchem IO (by Shyue Ping Ong).
Added basic Nwchem ( ) IO support. (by: Shyue Ping Ong).
Your coding agent can read these notes before it upgrades. Set up the MCP server →