Metadata-Version: 2.0
Name: mpinterfaces
Version: 1.1.1
Summary: High throughput analysis of interfaces using VASP and Materials Project tools
Home-page: https://matk86@bitbucket.org/matk86/vasp_automation.git
Author: Kiran Mathew, Joshua Gabriel, Richard G. Hennig
Author-email: km468@cornell.edu
License: GPL
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Requires-Dist: numpy (>=1.8)
Requires-Dist: scipy (>=0.10)
Requires-Dist: pymatgen (>=3.1.0)
Requires-Dist: fireworks (>=1.07)
Requires-Dist: custodian (>=0.8.2)
Requires-Dist: pymatgen-db (>=0.4.6)
Requires-Dist: ase (>=3.9.0)
Provides-Extra: babel
Requires-Dist: openbabel; extra == 'babel'
Requires-Dist: pybel; extra == 'babel'
Provides-Extra: documentation
Requires-Dist: sphinx (>=1.3.1); extra == 'documentation'
Requires-Dist: sphinx-rtd-theme (>=0.1.8); extra == 'documentation'
Provides-Extra: plotting
Requires-Dist: matplotlib (>=1.4.2); extra == 'plotting'
Provides-Extra: remote_launch
Requires-Dist: fabric; extra == 'remote_launch'

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: https://github.com/materialsproject

.. _VASPsol: https://github.com/henniggroup/VASPsol

.. _VASP: http://www.vasp.at/


Requirements
==============

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

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 https://pypi.python.org/pypi/virtualenv#downloads

   - 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 virtualenv.py ~/myvenv

   For detailed instructions and documentaion see
   http://virtualenv.readthedocs.org/en/latest/installation.html

4. Install numpy::

   pip install numpy


Installation
==============

Using pip
----------

pip install mpinterfaces


Bleeding edge
-------------

- Clone the latest version from github

- cd MPInterfaces

- python setup.py install(or develop)


Documentation
==============

A very minimal documentation is avaiable at the moment and work in 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 


Examples
==========

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


Authors
=========

Kiran Mathew

Joshua Gabriel

Richard G. Hennig



