Skip to main content

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 (https://www.materialsproject.org).

Project description


.. image:: https://circleci.com/gh/materialsproject/pymatgen.svg?style=shield&circle-token=:circle-token

.. image:: https://ci.appveyor.com/api/projects/status/akdyke5jxg6gps45?svg=true

.. image:: https://anaconda.org/matsci/pymatgen/badges/downloads.svg

.. image:: https://coveralls.io/repos/github/materialsproject/pymatgen/badge.svg?branch=master

Official docs: `http://pymatgen.org <http://pymatgen.org/>`_

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 VASP
(http://cms.mpi.univie.ac.at/vasp/), ABINIT (http://www.abinit.org/), 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
<https://github.com/materialsproject/pymatgen>`_. If you wish to be notified
of pymatgen releases, you may become a member of `pymatgen's Google Groups page
<https://groups.google.com/forum/?fromgroups#!forum/pymatgen/>`_.

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 <https://circleci.com>`_ and `Appveyor <https://www.appveyor.com/>`_
for continuous integration on the Linux and Windows platforms,
respectively, which ensures that every commit passes a comprehensive suite
of unittests. The coverage of the unittests can be seen at
`here <coverage/index.html>`_.
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.

With effect from version 3.0, pymatgen now supports both Python 2.7 as well
as Python 3.x.


Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymatgen-2017.8.21.tar.gz (1.6 MB view details)

Uploaded Source

Built Distributions

pymatgen-2017.8.21-cp36-cp36m-win_amd64.whl (1.9 MB view details)

Uploaded CPython 3.6m Windows x86-64

pymatgen-2017.8.21-cp36-cp36m-macosx_10_7_x86_64.whl (1.9 MB view details)

Uploaded CPython 3.6m macOS 10.7+ x86-64

pymatgen-2017.8.21-cp35-cp35m-macosx_10_9_x86_64.whl (1.9 MB view details)

Uploaded CPython 3.5m macOS 10.9+ x86-64

pymatgen-2017.8.21-cp27-cp27m-macosx_10_7_x86_64.whl (2.0 MB view details)

Uploaded CPython 2.7m macOS 10.7+ x86-64

File details

Details for the file pymatgen-2017.8.21.tar.gz.

File metadata

File hashes

Hashes for pymatgen-2017.8.21.tar.gz
Algorithm Hash digest
SHA256 88148aa104d5d507abbf6ec6aa777cd7e100b45f04f7478e91eeec8eac07d06d
MD5 4f7a2f19314eb3ce4085856bb753e795
BLAKE2b-256 669ed9177a34009878731a81b5750ab37e06322d8356bcc5843f31368d10b1b4

See more details on using hashes here.

File details

Details for the file pymatgen-2017.8.21-cp36-cp36m-win_amd64.whl.

File metadata

File hashes

Hashes for pymatgen-2017.8.21-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 0107211d3762da10392e904c69a58a014d4506b618b2c034ef1f2fc31a30b0c0
MD5 1e87dc6fd462a184962f4f5fb52f830c
BLAKE2b-256 a4b9ae501147f68cc3a44d20b522bf24abe14233701f67b5cc9e546d6a8caa4b

See more details on using hashes here.

File details

Details for the file pymatgen-2017.8.21-cp36-cp36m-macosx_10_7_x86_64.whl.

File metadata

File hashes

Hashes for pymatgen-2017.8.21-cp36-cp36m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 be7a2700b4758a2dbbc05ad4f601bb7c4040f8785ab662f0cc3ab535b085ec40
MD5 30d0436a91fd48cad9a5c75be47dae9e
BLAKE2b-256 0d5d73ee86b9536e24eb27cb688c687780e892ed509d90321c42d84d40207d3c

See more details on using hashes here.

File details

Details for the file pymatgen-2017.8.21-cp35-cp35m-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for pymatgen-2017.8.21-cp35-cp35m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 f46d210a356d57353df073d798e6a27741175fa5ffde3e4f7428080350b32c44
MD5 b04a45e59663ccf7620baa938a068899
BLAKE2b-256 d2078403972bd78dbd1182c9f8ccbeeff9f22baf37bd25dd510217a121e66e8c

See more details on using hashes here.

File details

Details for the file pymatgen-2017.8.21-cp27-cp27m-macosx_10_7_x86_64.whl.

File metadata

File hashes

Hashes for pymatgen-2017.8.21-cp27-cp27m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 8426183a5b2b230b9c54245085a3df18bf226bc7b5c405a4fc5a5ee01b8fc8c0
MD5 e0626b29ea64643e712a3215b973326a
BLAKE2b-256 d27641d6e18c4ef733f8f073176ad7821e7ff80b9748a4ff71e5cf8a8d01f9bd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page