{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "Back to the main [Index](index.ipynb) " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Analyzing wannier90 results with AbiPy" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This notebook shows how to use AbiPy to analyze the output files\n", "produced by [wannier90](http://www.wannier.org/) and how to use the `ABIWAN.nc` file\n", "produced by Abinit to interpolate band energies.\n", "\n", "As usual, one can use:\n", "\n", " abiopen.py FILE_ABIWAN.nc\n", " \n", "with the `--expose` or the `--print` option for a command line interface\n", "and `--notebook` to generate a jupyter notebook.\n", "\n", "Note: The code in this notebook requires abinit >= 8.9 and abipy >= 0.6\n", "\n", "\n", "## Table of Contents\n", "[[back to top](#top)]\n", "\n", "- [How to analyze the WOUT file](#How-to-analyze-the-WOUT-file)\n", "- [Using ABIWAN.nc to interpolate band energies](#Using-ABIWAN.nc-to-interpolate-band-energies)\n", "\n", "Let's start by importing the basic modules needed for this tutorial." ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "collapsed": true }, "outputs": [], "source": [ "# Use this at the beginning of your script so that your code will be compatible with python3\n", "from __future__ import print_function, division, unicode_literals\n", "\n", "import os\n", "\n", "import warnings \n", "warnings.filterwarnings(\"ignore\") # Ignore warnings\n", "\n", "from abipy import abilab\n", "abilab.enable_notebook() # This line tells AbiPy we are running inside a notebook\n", "import abipy.data as abidata\n", "\n", "# This line configures matplotlib to show figures embedded in the notebook.\n", "# Replace `inline` with `notebook` in classic notebook\n", "%matplotlib inline \n", "\n", "# Option available in jupyterlab. See https://github.com/matplotlib/jupyter-matplotlib\n", "#%matplotlib widget " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## How to analyze the WOUT file \n", "[[back to top](#top)]" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Use `abiopen` to open a `wout` file (the main output file produced by wannier90):" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "================================= File Info =================================\n", "Name: example01_gaas.wout\n", "Directory: /Users/gmatteo/git_repos/abipy/abipy/data/refs/wannier90\n", "Size: 31.64 kb\n", "Access Time: Mon Aug 6 12:54:06 2018\n", "Modification Time: Thu Jun 14 22:40:52 2018\n", "Change Time: Thu Jun 14 22:40:52 2018\n", "\n", "================================= Structure =================================\n", "Full Formula (Ga1 As1)\n", "Reduced Formula: GaAs\n", "abc : 4.016499 4.016499 4.016499\n", "angles: 60.000000 60.000000 60.000000\n", "Sites (2)\n", " # SP a b c\n", "--- ---- ---- ---- ----\n", " 0 Ga 0 0 0\n", " 1 As 0.25 0.25 0.25\n", "\n", "Wannier90 version: 2.1.0+git\n", "Number of Wannier functions: 4\n", "K-grid: [2 2 2]\n", "\n", "================================= WANNIERISE =================================\n", "iter delta_spread rms_gradient spread time O_D O_OD O_TOT\n", " 0 4.470000e+00 0.000000e+00 4.468812 0.00 0.00832 0.503629 4.468812\n", " 1 -1.930000e-03 6.679013e-02 4.466881 0.00 0.00803 0.501988 4.466881\n", " 2 -8.930000e-10 4.544940e-05 4.466881 0.01 0.00803 0.501988 4.466881\n", " 3 0.000000e+00 2.000000e-10 4.466881 0.01 0.00803 0.501988 4.466881\n", " 4 8.880000e-16 2.000000e-10 4.466881 0.01 0.00803 0.501988 4.466881\n", " 16 -8.880000e-16 0.000000e+00 4.466881 0.02 0.00803 0.501988 4.466881\n", " 17 8.880000e-16 0.000000e+00 4.466881 0.02 0.00803 0.501988 4.466881\n", " 18 0.000000e+00 0.000000e+00 4.466881 0.02 0.00803 0.501988 4.466881\n", " 19 8.880000e-16 0.000000e+00 4.466881 0.02 0.00803 0.501988 4.466881\n", " 20 0.000000e+00 0.000000e+00 4.466881 0.02 0.00803 0.501988 4.466881\n", "\n" ] } ], "source": [ "filepath = os.path.join(abidata.dirpath, \"refs\", \"wannier90\", \"example01_gaas.wout\")\n", "\n", "wout = abilab.abiopen(filepath)\n", "print(wout)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To plot the convergence of the wannier cycle use:" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "wout.plot();" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To plot the evolution of the Wannier centers and spread, use:" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "wout.plot_centers_spread();" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "Alternatively one can use `abiopen.py FILE_MDF.nc -nb` to generate a jupyter notebook directly from the terminal\n", "or `abiopen.py FILE_MDF.nc -e -sns` to produce matplotlib plots automatically.\n", "" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Using ABIWAN.nc to interpolate band energies\n", "[[back to top](#top)]\n", "\n", "\n", "`ABIWAN.nc` is a netcdf file produced by Abinit after having called *wannier90* in library mode.\n", "The file contains the unitary transformation and other important parameters associated to the calculations.\n", "This file can be read by AbiPy and can be used to interpolate band energies with the wannier method.\n", "\n", "As usual, use `abiopen` to open the file:" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "================================= File Info =================================\n", "Name: tw90_4o_DS3_ABIWAN.nc\n", "Directory: /Users/gmatteo/git_repos/abipy/abipy/data/refs/wannier90/tutoplugs_tw90_4\n", "Size: 205.47 kb\n", "Access Time: Mon Aug 6 12:54:09 2018\n", "Modification Time: Fri Jul 20 00:04:24 2018\n", "Change Time: Fri Jul 20 00:04:24 2018\n", "\n", "================================= Structure =================================\n", "Full Formula (Si2)\n", "Reduced Formula: Si\n", "abc : 3.840259 3.840259 3.840259\n", "angles: 60.000000 60.000000 60.000000\n", "Sites (2)\n", " # SP a b c\n", "--- ---- ---- ---- ----\n", " 0 Si 0 0 0\n", " 1 Si 0.25 0.25 0.25\n", "\n", "Abinit Spacegroup: spgid: 227, num_spatial_symmetries: 24, has_timerev: False, symmorphic: False\n", "\n", "============================== Electronic Bands ==============================\n", "Number of electrons: 8.0, Fermi level: 5.861 (eV)\n", "nsppol: 1, nkpt: 64, mband: 14, nspinor: 1, nspden: 1\n", "smearing scheme: none, tsmear_eV: 0.272, occopt: 1\n", "Direct gap:\n", " Energy: 2.519 (eV)\n", " Initial state: spin=0, kpt=[+0.000, +0.000, +0.000], weight: 0.016, band=3, eig=5.861, occ=2.000\n", " Final state: spin=0, kpt=[+0.000, +0.000, +0.000], weight: 0.016, band=4, eig=8.380, occ=0.000\n", "Fundamental gap:\n", " Energy: 0.635 (eV)\n", " Initial state: spin=0, kpt=[+0.000, +0.000, +0.000], weight: 0.016, band=3, eig=5.861, occ=2.000\n", " Final state: spin=0, kpt=[+0.500, +0.500, +0.000], weight: 0.016, band=4, eig=6.496, occ=0.000\n", "Bandwidth: 11.953 (eV)\n", "Valence maximum located at:\n", " spin=0, kpt=[+0.000, +0.000, +0.000], weight: 0.016, band=3, eig=5.861, occ=2.000\n", "Conduction minimum located at:\n", " spin=0, kpt=[+0.500, +0.500, +0.000], weight: 0.016, band=4, eig=6.496, occ=0.000\n", "\n", "================================== K-points ==================================\n", "K-mesh with divisions: [4, 4, 4], shifts: [0.0, 0.0, 0.0]\n", "kptopt: 3 (Do not take into account any symmetry)\n", "Number of points in the IBZ: 64\n", " 0) [+0.000, +0.000, +0.000], weight=0.016\n", " 1) [+0.250, +0.000, +0.000], weight=0.016\n", " 2) [+0.500, +0.000, +0.000], weight=0.016\n", " 3) [-0.250, +0.000, +0.000], weight=0.016\n", " 4) [+0.000, +0.250, +0.000], weight=0.016\n", " 5) [+0.250, +0.250, +0.000], weight=0.016\n", " 6) [+0.500, +0.250, +0.000], weight=0.016\n", " 7) [-0.250, +0.250, +0.000], weight=0.016\n", " 8) [+0.000, +0.500, +0.000], weight=0.016\n", " 9) [+0.250, +0.500, +0.000], weight=0.016\n", " 10) [+0.500, +0.500, +0.000], weight=0.016\n", " ... (More than 10 k-points)\n", "\n", "============================= Wannier90 Results =============================\n", "No of Wannier functions: 8, No bands: 14, Number of k-point neighbours: 8\n", "Disentanglement: True, exclude_bands: no\n", "\n", "WF_index Center Spread\n", "0 [1.12195 1.59353 1.59353] 2.767\n", "1 [1.59353 1.59353 1.12195] 2.767\n", "2 [1.12195 1.12195 1.12195] 2.767\n", "3 [1.59353 1.12195 1.59353] 2.767\n", "4 [0.23579 0.23579 0.23579] 2.767\n", "5 [0.23579 2.47968 2.47968] 2.767\n", "6 [2.47968 0.23579 2.47968] 2.767\n", "7 [2.47968 2.47968 0.23579] 2.767\n", "\n" ] } ], "source": [ "filepath = os.path.join(abidata.dirpath, \"refs\", \"wannier90\", \"tutoplugs_tw90_4\", \"tw90_4o_DS3_ABIWAN.nc\")\n", "abiwan = abilab.abiopen(filepath)\n", "print(abiwan)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To plot the matrix elements of the KS Hamiltonian in real space in the Wannier Gauge, use:" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "HWanR built in 0.061 (s)\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "abiwan.hwan.plot(title=\"Matrix elements in real space\");" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To interpolate the KS energies along a high-symmetry k-path and construct \n", "a new `ElectronBands` object, use:" ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Interpolation completed in 0.108 [s]\n" ] } ], "source": [ "ebands_kpath = abiwan.interpolate_ebands()" ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ebands_kpath.plot(title=\"Wannier-interpolated\");" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "If you need an IBZ sampling instead of a k-path, for instance a 36x36x36 k-mesh, use:" ] }, { "cell_type": "code", "execution_count": 11, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Interpolation completed in 0.237 [s]\n" ] } ], "source": [ "ebands_kmesh = abiwan.interpolate_ebands(ngkpt=(36, 36, 36))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "As we are dealing with AbiPy objects, we can easily reuse the AbiPy API to plot bands + DOS:" ] }, { "cell_type": "code", "execution_count": 12, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ebands_kpath.plot_with_edos(ebands_kmesh.get_edos(), title=\"Wannier-interpolated bands and DOS\");" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can also compare an ab-initio band structure with the Wannier-interpolated results.\n", "This is useful to understand if our wannier functions are well localized and if the \n", "k-mesh used with wannier90 is dense enough.\n", "\n", "In this case, it is just a matter of passing the path to the netcdf file \n", "containing the ab-initio band structure to the `get_plotter_from_ebands` method of `abiwan`.\n", "The function interpolates the band energies using the k-path found in the netcdf file \n", "and returns a plotter object:" ] }, { "cell_type": "code", "execution_count": 14, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Interpolation completed in 0.002 [s]\n" ] } ], "source": [ "import abipy.data as abidata\n", "gsr_path = abidata.ref_file(\"si_nscf_GSR.nc\")\n", "\n", "plotter = abiwan.get_plotter_from_ebands(gsr_path)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Then we call `combiplot` to plot the two band structures on the same figure:" ] }, { "cell_type": "code", "execution_count": 15, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "plotter.combiplot();" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "As we can see, the interpolated band structures is not completely on top of the ab-initio\n", "results. To improve the agreement we should try to reduced the spread and/or increase \n", "the density of the k-mesh used in the wannierization procedure." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Back to the main [Index](index.ipynb)" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "kernelspec": { "display_name": "Python [default]", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.6.1" }, "latex_envs": { "bibliofile": "biblio.bib", "cite_by": "apalike", "current_citInitial": 1, "eqLabelWithNumbers": true, "eqNumInitial": 0 } }, "nbformat": 4, "nbformat_minor": 2 }