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

Uploaded Source

Built Distributions

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

Uploaded CPython 3.6m Windows x86-64

pymatgen-2017.9.1-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.1-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.1-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.1.tar.gz.

File metadata

File hashes

Hashes for pymatgen-2017.9.1.tar.gz
Algorithm Hash digest
SHA256 f57a2b9305b8645f22c8169c5776ab74b004212084f32e6e6de7e2b1b5daefac
MD5 a450beb59b5259221819d601e034181b
BLAKE2b-256 9542783f9f330473600da4a85a9bf08dcdd07d2447cc6190016ceefa9beb4dd0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.1-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 492e182af51b0ca48301b1072379b3bdbcfd0895b44ebaa5c8af3bf122031c9c
MD5 0f8cd736570b8c94381f7d6d9713eae4
BLAKE2b-256 dafcbbc5cbab9f8c3f3bea5b0fdb8879f758adcaafbf9d6b097b563211a5579d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.1-cp36-cp36m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 9d67e906bd381a0a7267f2e77a8f869ccb1696e4553fe1cc42b552289cb89d5d
MD5 99f1bfa3bd1f20f330c966281eeeb863
BLAKE2b-256 16ba26cc8788172acc3bcca8dd45ac75c52bbf20390eb49c1cd3d05eb4c69a56

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.1-cp35-cp35m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 70c067f06f8ddbdad275c1a2a60562f27d8d50498111477e7d85b1c433d5e5ff
MD5 daeab4bdc7658b638faaf73b5937b08c
BLAKE2b-256 f5595a23191d270db3287ba86657d71ecf0fb3892228829289cde1d647e5c472

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pymatgen-2017.9.1-cp27-cp27m-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 64997e5ce9752a03179afabbfab0fde446d8eb20839b3858ac6bb72c5418d74d
MD5 ef4ef93cd1aea8393a756e5cf2884ff4
BLAKE2b-256 0de414f6a838992b266d81cdede4c739cfcf0d7a1ab77736bf00bc450f9ebd63

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