Electron-phonon potential from supercells

   Warning: This page is under construction!
   
   This page contains information about the upcoming VASP 6.5.0 release.
   Content on this page is subject to change and may be missing important information.

The computation of the electron-phonon potential, $\partial_{\nu \mathbf{q}} V(\mathbf{r})$, is a prerequisite for the calculation of the electron-phonon matrix element:

$g_{mn \mathbf{k}, \nu \mathbf{q}} \equiv \langle \psi_{m \mathbf{k} - \mathbf{q}} | \partial_{\nu \mathbf{q}} V | \psi_{n \mathbf{k}} \rangle .$

In the direct interpolation approach, $\partial_{\nu \mathbf{q}} V$ is computed from a supercell calculation by means of Fourier interpolation while the Bloch orbitals, $\psi_{n \mathbf{k}}(\mathbf{r})$, are computed directly in the primitive cell. Naturally, this process involves multiple VASP calculations in different cells, which can introduce additional complexities compared to just a single execution of VASP. This page tries to give a high-level overview of the general workflow associated with electron-phonon calculations using the direct interpolation approach.

Tip: The entire workflow of initializing a calculation, computing the electron-phonon potential in the supercell and performing subsequent electron-phonon calculations in the primitive cell can be facilitated by velph. velph is a command-line tool included in the phelel python package. It helps guide you through the process step by step and ensures a certain level of consistency between the required VASP calculations.

Finite displacements in the supercell

The electron-phonon potential is computed from finite atomic displacements in a sufficiently large supercell. In this case, sufficient means that the effects of an atomic displacement become negligible at about half the supercell size. Usually, converging the phonon frequencies is a good way of finding a supercell that is sufficiently large. Polar materials can exhibit long-range electrostatic interactions that go beyond reasonable supercell sizes. In this case, a correction scheme exists that explicitly treats the long-range dipole interactions and works with smaller cells. More information can be found on the theory page.

Currently, there are two complementary ways to calculate the electron-phonon potential. One relies solely on VASP, while the other uses VASP in combination with phelel. Both approaches calculate the derivative of the Kohn-Sham potential in real space via the displacement of atoms. However, they may differ in terms of flexibility and computational performance. Below, we describe the general workflow of each approach and highlight their advantages and disadvantages.

Regardless of which approach is chosen, the output is always written to the phelel_params.hdf5 binary file. This file can then be read during a VASP calculation in the primitive unit cell to compute electron-phonon interactions. For more information on how to perform specific electron-phonon calculations, visit missing.

VASP internal driver

This way of calculating the electron-phonon potential is activated by setting PHELEL_WRITE = True in the INCAR file. It utilizes the VASP-internal finite-difference driver that is activated by setting IBRION = 6 in the INCAR file. The atomic displacement directions are automatically determined by VASP. As usual, POTIM and NFREE can be used to control the displacement amount and finite-difference stencil, respectively. This is the same procedure used to calculate phonons from finite differences and many of the same considerations regarding performance and accuracy apply in this case. Therefore, phonon frequencies are a great way to test the convergence with respect to supercell size.

Mind: Currently, VASP generates more displacements with PHELEL_WRITE = True and IBRION = 6 than would be required in principle. This will be improved in a future version of the code.

Once the electron-phonon potential is obtained, it is automatically mapped to the primitive cell. The results are stored in the phelel_params.hdf5 file. By default, the primitive cell is the one determined by VASP during the supercell calculation. You can find this information in the OUTCAR file. For example, here is the relevant section for a diamond structure:

----------------------------------------------------------------------------------------

                                     Primitive cell

  volume of cell :      11.1771

  direct lattice vectors                    reciprocal lattice vectors
     1.774598550  1.774598550  0.000000000     0.281753865  0.281753865 -0.281753865
     0.000000000  1.774598550  1.774598550    -0.281753865  0.281753865  0.281753865
     1.774598550  0.000000000  1.774598550     0.281753865 -0.281753865  0.281753865

  length of vectors
     2.509661338  2.509661338  2.509661338     0.488012009  0.488012009  0.488012009

  position of ions in fractional coordinates (direct lattice)
     0.000000000  0.000000000  0.000000000
     0.250000000  0.250000000  0.250000000

  ion indices of the primitive-cell ions
   primitive index   ion index
                 1           1
                 2           9

----------------------------------------------------------------------------------------

It is possible to choose a different primitive unit cell by explicitly specifying its lattice vectors using the PHELEL_LATTICE INCAR tag.

Mind: The cell specified via PHELEL_LATTICE must be a valid primitive cell of the underlying lattice.

In order to map the electron-phonon potential from the supercell to the primitive cell, it is currently necessary to specify the FFT grid dimensions (NGX, NGY, NGZ) of the primitive cell that will be used in the final electron-phonon calculation. Once a suitable FFT grid has been determined for the primitive cell, it can be supplied via PHELEL_FFT_MESH. The electron-phonon potential is then Fourier interpolated onto the supplied FFT grid.

VASP and phelel

In this approach to calculating the electron-phonon potential, the ionic displacements are determined externally using phelel. For people who are familiar with phonon calculations using VASP and phonopy, this workflow will look very familiar. In general, this allows for greater flexibility. Here, we demonstrate a common workflow that suffices for most purposes. For a complete list of features, we refer to the documentation of phelel.

As an example,

phelel -d --dim 2 2 2 -c POSCAR-unitcell --pm

automatically determines displacement directions for a 2x2x2 supercell based on symmetry considerations.

Tip: We recommend the use of the --pm option, which generates positive and negative displacements for each displacement direction.

For each displacement, phelel creates a corresponding supercell POSCAR file (POSCAR-XXX, where XXX labels the different displacements). In addition, the file SPOSCAR is created which contains the supercell geometry in equilibrium.

For each of the generated POSCAR files, create a separate directory and run VASP there with LWAP = True set in the INCAR file. This setting instructs VASP to write the potential as well as other important information to disk. Finally, run phelel to combine all the data from the individual directories to obtain the electron-phonon potential, for example,

phelel --fft-mesh 18 18 18 --cd perfect/ disp-001/ disp-002/

Here, perfect, disp-001 and disp-002 are the directories corresponding to the equilibrium and displaced supercell calculations, respectively. --fft-mesh specifies the FFT grid dimensions (NGX, NGY, NGZ) to be used in the final electron-phonon calculation in the primitive cell. The electron-phonon potential is Fourier interpolated from the FFT grid in the supercell to the supplied grid via a non-uniform FFT. The results are written to the phelel_params.hdf5 file.