Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
# Copyright (c) Pymatgen Development Team.
# Distributed under the terms of the MIT License.
""" for pymatgen."""
import sys
import platform
import numpy
from setuptools import setup, find_namespace_packages, Extension
extra_link_args = []
if sys.platform.startswith("win") and platform.machine().endswith("64"):
long_desc = """
Official docs: [](
Pymatgen (Python Materials Genomics) is a robust, open-source Python library
for materials analysis. These are some of the main features:
1. Highly flexible classes for the representation of Element, Site, Molecule,
Structure objects.
2. Extensive input/output support, including support for
CIF, Gaussian, XYZ, and many other file formats.
3. Powerful analysis tools, including generation of phase diagrams, Pourbaix
diagrams, diffusion analyses, reactions, etc.
4. Electronic structure analyses, such as density of states and band structure.
5. Integration with the Materials Project REST API.
Pymatgen is free to use. However, we also welcome your help to improve this
library by making your own contributions. These contributions can be in the
form of additional tools or modules you develop, or feature requests and bug
reports. Please report any bugs and issues at pymatgen's [Github page]
( For help with any pymatgen
issues, please use the [Discourse page](
Why use pymatgen?
There are many materials analysis codes out there, both commerical and free,
but pymatgen offer several advantages:
1. **It is (fairly) robust.** Pymatgen is used by thousands of researchers,
and is the analysis code powering the [Materials Project](
The analysis it produces survives rigorous scrutiny every single day. Bugs
tend to be found and corrected quickly. Pymatgen also uses
[CircleCI]( and [Appveyor](
for continuous integration on the Linux and Windows platforms,
respectively, which ensures that every commit passes a comprehensive suite
of unittests.
2. **It is well documented.** A fairly comprehensive documentation has been
written to help you get to grips with it quickly.
3. **It is open.** You are free to use and contribute to pymatgen. It also means
that pymatgen is continuously being improved. We will attribute any code you
contribute to any publication you specify. Contributing to pymatgen means
your research becomes more visible, which translates to greater impact.
4. **It is fast.** Many of the core numerical methods in pymatgen have been
optimized by vectorizing in numpy/scipy. This means that coordinate
manipulations are extremely fast and are in fact comparable to codes
written in other languages. Pymatgen also comes with a complete system for
handling periodic boundary conditions.
5. **It will be around.** Pymatgen is not a pet research project. It is used in
the well-established Materials Project. It is also actively being developed
and maintained by the [Materials Virtual Lab](,
the ABINIT group and many other research groups.
include=["pymatgen.*", "pymatgen.analysis.*", "*", "pymatgen.ext.*"],
exclude=["pymatgen.*.tests", "pymatgen.*.*.tests", "pymatgen.*.*.*.tests"],
"ase": ["ase>=3.3"],
"vis": ["vtk>=6.0.0"],
"abinit": ["netcdf4"],
# All package data has to be explicitly defined. Do not use automated codes like last time. It adds
# all sorts of useless files like test files and is prone to path errors.
"pymatgen.analysis": ["*.yaml", "*.json", "*.csv"],
"pymatgen.analysis.chemenv": [
"pymatgen.analysis.structure_prediction": ["*.yaml", "data/*.json"],
"pymatgen.analysis.diffraction": ["*.json"],
"pymatgen.analysis.magnetism": ["default_magmoms.yaml"],
"": ["am1.5G.dat"],
"pymatgen.entries": ["py.typed", "*.json.gz", "*.yaml", "data/*.json"],
"pymatgen.core": ["py.typed", "*.json"],
"": ["*.yaml", "*.json"],
"": ["*.yaml"],
"": ["*.yaml"],
"": ["lobster_basis/*.yaml"],
"pymatgen.command_line": ["OxideTersoffPotentials"],
"pymatgen.util": ["structures/*.json", "*.json"],
"pymatgen.vis": ["*.yaml"],
"": ["CoeffsDataType.yaml", "templates/md.txt"],
"pymatgen.symmetry": ["*.yaml", "*.json", "*.sqlite"],
author="Pymatgen Development Team",
maintainer="Shyue Ping Ong, Matthew Horton",
description="Python Materials Genomics is a robust materials "
"analysis code that defines core object representations for "
"structures and molecules with support for many electronic "
"structure codes. It is currently the core analysis code "
"powering the Materials Project "
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Development Status :: 4 - Beta",
"Intended Audience :: Science/Research",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Topic :: Scientific/Engineering :: Information Analysis",
"Topic :: Scientific/Engineering :: Physics",
"Topic :: Scientific/Engineering :: Chemistry",
"Topic :: Software Development :: Libraries :: Python Modules",
Extension("pymatgen.util.coord_cython", ["pymatgen/util/coord_cython.pyx"], extra_link_args=extra_link_args),
"pymatgen.optimization.neighbors", ["pymatgen/optimization/neighbors.pyx"], extra_link_args=extra_link_args
"console_scripts": [
"pmg = pymatgen.cli.pmg:main",
"feff_plot_cross_section = pymatgen.cli.feff_plot_cross_section:main",
"feff_plot_dos = pymatgen.cli.feff_plot_dos:main",
"gaussian_analyzer = pymatgen.cli.gaussian_analyzer:main",
"get_environment = pymatgen.cli.get_environment:main",