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

Uploaded Source

Built Distributions

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

Uploaded CPython 3.6m Windows x86-64

pymatgen-2017.9.3-cp36-cp36m-macosx_10_7_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.6m macOS 10.7+ x86-64

pymatgen-2017.9.3-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.3-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.3.tar.gz.

File metadata

File hashes

Hashes for pymatgen-2017.9.3.tar.gz
Algorithm Hash digest
SHA256 fc7a56843329872c30441f03623e9607cb36f92a3cf2cac22b9c14d3a482d656
MD5 5369bc0ac400b23c7f88bc16d6e83c86
BLAKE2b-256 2433b0829dd57944e68483408436ecaa6b8efc2fbe0d38184fe554bb163e4b2f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.3-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 fbd62500e3f1be95bc280dc64785549ec708cf5fd159bb77578573919c970d1c
MD5 7ce8562fb957e36b39f819b447e23a0b
BLAKE2b-256 79ea9924887c5a44aaababd9fdc1e1be4f622903e416f1f004b56f1ea3ac5f58

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.3-cp36-cp36m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 da46dc6834fce2916f7b843c705b3af9d424917d9c2547d825200096fa7136ab
MD5 357818d5834dfc018d3a15693efa5b44
BLAKE2b-256 5897f0381bc003f43e7a6491b6138c4a2e29ef7fa39a07d997742f3581d0376b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.3-cp35-cp35m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 83f276f32a5ab2e1cb93aa72d8b23ea34ddf48a68af3bef7980b9540e270c76c
MD5 371453584dfeb6121d1d7921fc0d8fd0
BLAKE2b-256 758434cae54ccb2d17959faa0736b7ade1f828a9f08fc690942a123ef65d6894

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.3-cp27-cp27m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 81262586f288058edaad727475e3743b64cc5ec2ef7e7c62836a3da6e7b02067
MD5 4558e721ec50fbdc049bd241a7c2c839
BLAKE2b-256 15719231d86f6222fa316c9a5ee1ee6916ee666966853938e2a505a8cbea7122

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