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.10.16.tar.gz (1.6 MB view details)

Uploaded Source

Built Distributions

pymatgen-2017.10.16-cp36-cp36m-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.6m Windows x86-64

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

Uploaded CPython 3.6m macOS 10.7+ x86-64

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

Uploaded CPython 3.5m macOS 10.9+ x86-64

pymatgen-2017.10.16-cp27-cp27m-macosx_10_7_x86_64.whl (1.9 MB view details)

Uploaded CPython 2.7m macOS 10.7+ x86-64

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.10.16.tar.gz
Algorithm Hash digest
SHA256 f05ce838c7fe9cc37aae85083f45bf9503eda1292aa1d778bfcd4b5b3018cb1b
MD5 72b7e1b0f07110ab53bae28a718bf4ec
BLAKE2b-256 b394d07fe864a51cacee91da38cd3cf47cda807680bcef8d2608838024cfe6b4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.10.16-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 8d48bed6eefd07642006dc3ae7aedf18b6af5d079c1d2f8d03fb1cbcd200967c
MD5 b69e75abc0112bd1d9fb365173342910
BLAKE2b-256 d3bbaceed5a1b16d76d03457a297e6fbc74489aa0bb24a966458242025b9f4f5

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.10.16-cp36-cp36m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 d253db3694711bfb24b5bddd6471e2b971e9c087210283c1e698487eb25ac578
MD5 80a6807105f953d06a4799fd461543d6
BLAKE2b-256 5f021fa1aed3656ae7a8d744481558d4de63ccba49535aa5dd42eb5a21edb158

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.10.16-cp35-cp35m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 8f31465f0fc84de572a7f17046712c1fabef3f99790d1179eb6dc4f637775b50
MD5 d450a909c85a2f90a985b8040ef8e61b
BLAKE2b-256 76eb45113a48e5e08fd03f0cebbff04811f2116f7c9b9f2f8d945e54f0a1db34

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.10.16-cp27-cp27m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 2709c907d2cf5079671c8540374b6e5b3c87b37b3cb8931d262e181bd2f8eff0
MD5 3db7e8fc123458b32b16d21cb2bd5b0f
BLAKE2b-256 b8598abd88bf57934c7069153d8771624b271d9c761bb86d7d879a2cc7f9188b

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