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

Uploaded Source

Built Distributions

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

Uploaded CPython 3.6m Windows x86-64

pymatgen-2017.11.9-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.9-cp35-cp35m-macosx_10_6_x86_64.whl (1.9 MB view details)

Uploaded CPython 3.5m macOS 10.6+ x86-64

pymatgen-2017.11.9-cp27-cp27m-macosx_10_6_x86_64.whl (1.9 MB view details)

Uploaded CPython 2.7m macOS 10.6+ x86-64

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.11.9.tar.gz
Algorithm Hash digest
SHA256 321e005c73d5537f77809acf11420e087a5fa728928cd912d79c50dc4eac9879
MD5 c1afa1cabffdb6cbfd55370a53af231b
BLAKE2b-256 07eb943faa8df3bd9251cc05fc7e5ba03470dc6aaffde9a8aa26bb4e8b58fb89

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.11.9-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 5cde399cac45988e8e12d6604627217b0f21821d4b6d26c8bc9b633172e95f28
MD5 1cca44652bc89bae6834c5571680eabf
BLAKE2b-256 cccc4dca521822676331895df5953ac6c40529a8204d4bd009b8e539518ca922

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.11.9-cp36-cp36m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 453c0f1e97894e6e476866cfeb43a506f4c590030285b433f91d8302b1d03483
MD5 ee642d440c75a2095572b9c532921a0a
BLAKE2b-256 b575c7e23951e1105966fea67e247e1edb0a1d84a0a9a3cbe97bf1a07a36ed2d

See more details on using hashes here.

File details

Details for the file pymatgen-2017.11.9-cp35-cp35m-macosx_10_6_x86_64.whl.

File metadata

File hashes

Hashes for pymatgen-2017.11.9-cp35-cp35m-macosx_10_6_x86_64.whl
Algorithm Hash digest
SHA256 278cf85a7df98d39871eb18ac27e5c2d29541188220935766b2f23e7049ac4e7
MD5 9d716e07eeab0f8a9fafe1b34798cc2b
BLAKE2b-256 d27107ad7fa2c089434971af02da7f9cf0aa2b43673b0aa4ded9148166aed773

See more details on using hashes here.

File details

Details for the file pymatgen-2017.11.9-cp27-cp27m-macosx_10_6_x86_64.whl.

File metadata

File hashes

Hashes for pymatgen-2017.11.9-cp27-cp27m-macosx_10_6_x86_64.whl
Algorithm Hash digest
SHA256 fac079244422e12cbcc6c0063de9f7917d5b79467ffb841383d77f7b62cd5002
MD5 f1a7c683bdd8f52d3376c93a2853b579
BLAKE2b-256 1a8cf911e3d8db099b29925d4e5e50c1a6c3630a02b6445f10fe7eea032ebe80

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