Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

High throughput analysis of interfaces using VASP and Materials Project tools

Project Description

MPinterfaces is a python package that enables high throughput Density
Functional Theory(DFT) analysis of arbitrary material interfaces(ligand capped
nanoparticles, surfaces in the presence of solvents and hetero-structure
interfaces) using VASP_, VASPsol_ and materialsproject_ database as well
as their open source tools.

.. _materialsproject:

.. _VASPsol:

.. _VASP:


The following steps applies only to linux and OSX(with xcode) operating systems.


1. Make sure that you are using python>=2.7 (do a "python --version").

Note: ASE does not work with python3

2. It is highly recommended that you use gcc compiler. So type::

export CC=gcc

3. Unless you have admin privilege on the machine you are installing, it is
better to install this package and all its dependencies in a virtual environment.

- get the latest version from

- tar xvfz virtualenv-X.X.X.tar.gz

- cd virtualenv-X.X.X

- setup the virtual environment in ~/myvenv (or set to some other path and folder name)

* python ~/myvenv

- activate the virtual environment

* source ~/myvenv/bin/activate

For detailed instructions and documentation see

4. Install numpy::

pip install numpy

Install from PyPI

pip install mpinterfaces

Bleeding edge

If you already have a local copy, steps 1 and 2 of the following instructions
can be skipped. Just do a "git pull" from the MPInterfaces folder and go to
step 3(if the local copy was installed in the develop mode this step can be skipped too).

1. Clone the latest version from github

- git clone

2. cd MPInterfaces

3. python install(or develop)


A very minimal documentation is avaiable at the moment and work is underway
to improve it. We use the sphinx package to generate the documentation.
First install the package 'sphinx' and the theme package 'sphinx-rtd-theme'
using pip and then to generate the documentation either in html or pdf format
do the following:

* html format

- cd docs; make html

- open _build/html/index.html in a webbrowser to see the documentation

* pdf

- cd docs; make latexpdf

- The pdf will be in the _build/latex folder


The examples folder contain some sample scripts that demonstrate the
usage of mpinterfaces as well as materialsproject packages


Kiran Mathew

Joshua Gabriel

Arunima Singh

Richard G. Hennig

Release History

This version
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.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(49.1 kB) Copy SHA256 Hash SHA256
2.7 Wheel Aug 11, 2015
(124.1 kB) Copy SHA256 Hash SHA256
Source Aug 11, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting