Skip to main content
Help us improve Python packaging – donate today!

Python Framework for Materials Discovery and Design

Project Description


Python Materials Discovery Framework

PyChemia is an open-source Python Library for materials structural search. The purpose of the initiative is to create a method agnostic framework for materials discovery and design using a variety of methods from Minima Hoping to Soft-computing based methods. PyChemia is also a library for data-mining, using several methods to discover interesting candidates among the materials already processed.

The core of the library is the Structure python class, it is able to describe periodic and non-periodic structures. As the focus of this library is structural search the class defines extensive capabilities to modify atomic structures.

The library includes capability to read and write in several ab-initio codes. At the level of DFT, PyChemia support VASP, ABINIT and Octopus. At Tight-binding level development is in process to support DFTB+ and Fireball. This allows the library to compute electronic-structure properties using state-of-the-art ab-initio software packages and extract properties from those calculations.

PyChemia requirements

Before installing PyChemia, you may need to first install a few critical dependencies


  1. Python >= 2.7 or Python >= 3.5 The library is tested on Travis for versions of Python 2.7, 3.5 and 3.6

  2. Numpy >= 1.12 NumPy is a fundamental package for any Python scientific library. Numpy arrays are essential for efficient array manipulation. Many distributions come with relatively old version of numpy, so you should install a more recent version.

  3. SciPy >= 0.18 SciPy is used for many linear algebra and FFT calls Most distros comes with scipy 0.13 or below. PyChemia uses scipy.spatial that have been actively developed since version 0.15, we have tested PyChemia on 0.17.

  4. Spglib >= 1.9.9 Spglib is used to determine symmetry groups for structures

  5. future This is a library that offers some easy hacks to support python 2.7 and python 3 on the same code source. The library is easy to install with pip

    pip install future


    pip install future –user

  6. PyMongo >= 3.4 At least for structural search PyChemia relies strongly in MongoDB and its python driver. For the MongoDB server, any version beyond 3.0 should be fine. We have tested pychemia on MongoDB 3.2

    pip install pymongo


    pip install pymongo –user


  1. Pandas Library for Data Analysis used by the datamining modules

  2. PyMC PyMC is a python module that implements Bayesian statistical models and fitting algorithms Important for the datamining capabilities of PyChemia

  3. Mayavi >= 4.1 Some basic visualization tools are incorporated using this library

  4. ScientificPython >2.6 This library is used for reading and writing NetCDF files

  5. pymatgen >= 2.9 pymatgen is an excellent library for materials analysis

  6. ASE Atomic Simulation Environment is another good library for ab-initio calculations. Quite impressive for the number of ab-initio packages supported

  7. qmpy The Python library behind the Open Quantum Materials Database. The OQMD is a database of DFT calculated structures. For the time being the database contains more than 300000 structures, with more than 90% of them with the electronic ground-state computed.

  8. [coverage] ( >= 4.0.1 Provides code coverage analysis

  9. python-coveralls To submit coverage information to


Instructions for installation, using and programming scripts with PyChemia can be found on two repositories for documentation:

  • Read The Docs:

  • Python Hosted:


  1. Prof. Aldo H. Romero [West Virginia University] (Project Director)
  2. Guillermo Avendaño-Franco [West Virginia University] (Basic Infrastructure)
  3. Adam Payne [West Virginia University] (Bug fixes (Populations, Relaxators, and KPoints) )
  4. Irais Valencia Jaime [West Virginia University] (Simulation and testing)
  5. Sobhit Singh [West Virginia University] (Data-mining)
  6. Francisco Muñoz [Universidad de Chile] (PyPROCAR)
  7. Wilfredo Ibarra Hernandez [West Virginia University] (Interface with MAISE)

Release history Release notifications

This version
History Node

History Node

History Node

History Node

History Node

History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pychemia- (369.9 kB) Copy SHA256 hash SHA256 Wheel py3 Feb 21, 2018
pychemia- (24.7 MB) Copy SHA256 hash SHA256 Source None Feb 21, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page