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

Uploaded Source

Built Distributions

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

Uploaded CPython 3.6m Windows x86-64

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

Uploaded CPython 3.6m macOS 10.7+ x86-64

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

Uploaded CPython 3.5m macOS 10.9+ x86-64

pymatgen-2017.11.6-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.11.6.tar.gz.

File metadata

File hashes

Hashes for pymatgen-2017.11.6.tar.gz
Algorithm Hash digest
SHA256 df7acee1caf2b8070460333f54b59db20d062b0c8792a775ad1301f3164c986e
MD5 87a4611895d3264b085a7cd33674167a
BLAKE2b-256 1f2885cb0eb50e8d272988d653a67e28d550dab7a5145678d6296a0592a9bde4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.11.6-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 a33c7f9cee30f7c21cbdac14f57f201f8b9f33315678b4f977f3ef8b4e2c932c
MD5 df2f4606aed03bb3548a17fdeccd0910
BLAKE2b-256 26df0c8543b81d5c2136366be0160692f9996b79e6bc042c605c1b688d5c90b9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.11.6-cp36-cp36m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 119b5000a2b2255d5bdb3443d0ae2e44025ae7a9f6b71f5263ef85ec38908d6e
MD5 eb6fd9ab3cd9bbc38a5a306255df6b52
BLAKE2b-256 c39b1db86215102c4860629b8bf4651eb7be13224a5809feb2ca077755587ffa

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.11.6-cp35-cp35m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 c37368c2814613a5b7c70ba28dd2795a4d02acdbb7534f6fddeccdcf5e529748
MD5 6fe35f9f1a4ae48a788f6e2c7b8dba88
BLAKE2b-256 8f76c8d595efed5c7654709cb85e1d9f3cab7956820501877ee28f7d02b55756

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.11.6-cp27-cp27m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 96aec86c3e4af4472c321b16c129e19b22abcc3e774d67a1d88a86e0c6749dbe
MD5 09d6f31dfec7f2461b3f4ff960213755
BLAKE2b-256 205791a6e806ac37593e501e43a421c9034e4f572186f90acb8ae1dcd9194dd5

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