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

Uploaded Source

Built Distributions

pymatgen-2017.9.23-cp36-cp36m-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.6m Windows x86-64

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

Uploaded CPython 3.6m macOS 10.7+ x86-64

pymatgen-2017.9.23-cp35-cp35m-macosx_10_9_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.5m macOS 10.9+ x86-64

pymatgen-2017.9.23-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.9.23.tar.gz.

File metadata

File hashes

Hashes for pymatgen-2017.9.23.tar.gz
Algorithm Hash digest
SHA256 61d95ea4459f4c98b70d77adc17443bbab043c2f1d1a53e45d7b9df0c4782bd8
MD5 eec804f8b3a9b749798649cb136f7e8b
BLAKE2b-256 6aeddf25257f6dcacb5e5cd9da928fc7ff8e1ed4f0d31e4f77e54e67b081f3b6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.23-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 907d723d8656e9c964fc670467b97b772ee7786dbd2150eef591475406a2fbfb
MD5 1bf8866c0bc9f877c7f3c08297b1901c
BLAKE2b-256 e19412d511d6c01f4401bdf24910dbd4d68da1361c64f2e61f8bca1d1c4c38d5

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.23-cp36-cp36m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 2fb4e1516663ce09896dc9f653dc55656550fec5fc7aba34e15a1d0033538dfd
MD5 42a828b5d1be8ca663ba1d8a36a628c1
BLAKE2b-256 882b07fad54448b7d6aeeddc232355f029347306cadb567c29965b8ea5a3f758

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.23-cp35-cp35m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 adcf2a1d1a008ea3d93d46f14f94d8131c621eb347851d17bc12828f0e84d04d
MD5 ed4af6f44c4d08ffa380e033ac4d8286
BLAKE2b-256 3a992efd1e4af08af62ff506dcc534c49fdd2a586cc4d55570f89d4e62a44f41

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.23-cp27-cp27m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 d197c201020e0dc1b79420e41049d1f6b5de4959ba4b50cac3c9fe1097fc3a57
MD5 a01ff6df05fe059f7ff0e41fa233c4f8
BLAKE2b-256 f9ff79318939b85a0f2759d46b10760d1fa61306fd3d2a9944487e66ef39d8ee

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