Skip to main content

Collection of Python modules & functions to perform and process solid-state defect calculations

Project description

Defect Oriented Python Environment Distribution (DOPED)

This is a (mid-development) Python package for managing solid-state defect calculations, geared toward VASP. Much of it is a modified version of the excellent PyCDT.
See this link for the original PyCDT paper.

Defect formation energy plots are templated from AIDE and follow the aesthetics philosopy of sumo, both developed by the dynamic duo Adam Jackson and Alex Ganose.

This code is still being customised, so in the spirit of efficiency and avoiding redundant work, I've provided an example Jupyter notebook of the code functionality and usage, so please look at that. (Better to open in Jupyter, after installing, rather than with GitHub preview).

If I reach a final product at some point (likely integrating things like CPLAP, SC-Fermi etc.), I'll make a detailed README then.


doped requires pymatgen (and its dependencies).


  1. Download the doped source code using the command:
  git clone
  1. Navigate to root directory:
  cd doped
  1. Install the code, using the command:
  python install

This command tries to obtain the required packages and their dependencies and install them automatically. Access to root may be needed if virtualenv is not used.

  1. (If not set) Set the VASP pseudopotential directory in $HOME/.pmgrc.yaml as follows::
  PMG_VASP_PSP_DIR: <Path to VASP pseudopotential top directory>

Within your VASP pseudopotential top directory, you should have a folder named POT_GGA_PAW_PBE which contains the POTCAR.X(.gz) files (in this case for PBE POTCARs).

(Necessary to generate POTCAR files, auto-determine INCAR settings such as NELECT for charged defects...)

  1. (Optional) Set the Materials Project API key in $HOME/.pmgrc.yaml as follows::
  MAPI_KEY: <Your mapi key obtained from>

(For pulling structures and comparing properties with the Materials Project database).

Word of Caution

There is quite possibly a couple of bugs in this code, as it is very much still experimental and in development. If you find any, please let me know!

Download files

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

Files for doped, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size doped-0.0.5-py3-none-any.whl (123.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size doped-0.0.5.tar.gz (106.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page