====== XCFunctional ====== ;;# New in 0.9.1 ;;# ### //e, dedn, dedsigma = XCFunctional(method, n, sigma)// evaluates an exchange-correlation functional of density functional theory at one point: the exchange-correlation energy per volume $e(n, \sigma)$ of a spin-unpolarized electron density $n$ with $\sigma = |\nabla n|^2$, and its two derivatives $\partial e/\partial n$ and $\partial e/\partial \sigma$. The exchange-correlation energy of a density $n(\mathbf{r})$ is $$ E_{xc} = \int e\big(n(\mathbf{r}), \sigma(\mathbf{r})\big) \, \mathrm{d}^3 r. $$ These are the functionals of the density functional methods of [[documentation:language_reference:functions:calculateatomicbasisfunctions|]] (option //"Method"//). ### ### For the local density approximations (LDA) $e$ depends on $n$ only and $\partial e/\partial n$ is the exchange-correlation potential $V_{xc}$. For the gradient corrected functionals (PBE) the potential is $$ V_{xc}(\mathbf{r}) = \frac{\partial e}{\partial n} - 2 \nabla \cdot \left( \frac{\partial e}{\partial \sigma} \nabla n \right). $$ All quantities are in Hartree atomic units. ### ===== Input ===== * //method// : String, the functional (upper or lower case): * //"LDA"// : Slater exchange and the correlation of Perdew and Wang (1992). * //"LDA-VWN"// : Slater exchange and the correlation of Vosko, Wilk and Nusair (VWN5). This is the LDA of the NIST atomic reference data. * //"RLDA-MV"// : as //"LDA-VWN"//, with the relativistic correction of MacDonald and Vosko to the exchange. This is the RLDA of the NIST atomic reference data. It uses the speed of light //PhysicalConstants.cAU.value//, see [[documentation:language_reference:constants:physical_constants|]]. * //"PBE"// : the gradient corrected functional of Perdew, Burke and Ernzerhof. * //"PBE-VWN"// : PBE with the VWN5 correlation in place of the Perdew-Wang correlation under the gradient correction. * //n// : Real, the electron density in electrons per bohr$^3$. * //sigma// : (optional) Real, $\sigma = |\nabla n|^2$ in bohr$^{-8}$. Default value is 0. Only //"PBE"// and //"PBE-VWN"// use it. ===== Output ===== * //e// : Real, the exchange-correlation energy per volume in Hartree per bohr$^3$. //e/n// is the energy per electron. * //dedn// : Real, $\partial e/\partial n$ in Hartree. For the LDAs this is the exchange-correlation potential. * //dedsigma// : Real, $\partial e/\partial \sigma$ in Hartree bohr$^5$. It is 0 for the LDAs. ### For $n \le 0$ all three are 0. ### ===== Example ===== ### The uniform electron gas in LDA. Its density is given by the Wigner-Seitz radius $r_s$, $n = 3/(4\pi r_s^3)$. The exchange energy per electron is known in closed form, $\epsilon_x = -\frac{3}{4\pi} \left(\frac{9\pi}{4}\right)^{1/3} \frac{1}{r_s} = -0.458165/r_s$ Hartree, and is equal to the exchange part of //e/n//; the rest is the correlation energy per electron $\epsilon_c$. The Perdew-Wang and the VWN correlation are two fits to the same quantum Monte Carlo energies of Ceperley and Alder and agree to better than $10^{-3}$ Hartree. ### ==== Input ==== -- the exchange-correlation energy of the uniform electron gas in LDA -- rs is the Wigner-Seitz radius in bohr, n = 3/(4 pi rs^3) the density in bohr^-3 print(" rs n eps_xc eps_x eps_c eps_c(VWN) v_xc") for _, rs in ipairs({0.5, 1, 2, 5, 10}) do local n = 3/(4*math.pi*rs^3) local e, dedn = XCFunctional("LDA", n) local eVWN = XCFunctional("LDA-VWN", n) local epsx = -3/(4*math.pi)*(9*math.pi/4)^(1/3)/rs -- Slater exchange per electron print(string.format("%5.1f %9.6f %9.6f %9.6f %9.6f %9.6f %9.6f", rs, n, e/n, epsx, e/n - epsx, eVWN/n - epsx, dedn)) end ==== Result ==== rs n eps_xc eps_x eps_c eps_c(VWN) v_xc 0.5 1.909859 -0.992950 -0.916331 -0.076619 -0.077063 -1.306883 1.0 0.238732 -0.517939 -0.458165 -0.059774 -0.060019 -0.678346 2.0 0.029842 -0.273842 -0.229083 -0.044760 -0.044783 -0.356936 5.0 0.001910 -0.119849 -0.091633 -0.028216 -0.028134 -0.155654 10.0 0.000239 -0.064389 -0.045817 -0.018572 -0.018545 -0.083667 ### All functionals without a density gradient. With $\sigma = 0$ //"PBE"// is equal to //"LDA"// and //"PBE-VWN"// to //"LDA-VWN"//. The relativistic correction of //"RLDA-MV"// depends on $k_F/c$, with the Fermi wave vector $k_F = (3\pi^2 n)^{1/3}$. It is small at ordinary densities. At the very high densities near the nucleus of the heaviest atoms it reduces the exchange energy to a few percent of its nonrelativistic value, and the potential becomes positive. ### ==== Input ==== -- all functionals without a gradient (sigma = 0), at a low and at a very high density print(string.format("c = %.6f, the speed of light used by RLDA-MV", PhysicalConstants.cAU.value)) for _, n in ipairs({1, 1e6}) do local kF = (3*math.pi^2*n)^(1/3) print(string.format("n = %g bohr^-3, kF/c = %.4f", n, kF/PhysicalConstants.cAU.value)) for _, method in ipairs({"LDA", "LDA-VWN", "RLDA-MV", "PBE", "PBE-VWN"}) do local e, dedn = XCFunctional(method, n) print(string.format(" %-8s e/n = %11.6f de/dn = %11.6f", method, e/n, dedn)) end end ==== Result ==== c = 137.035999, the speed of light used by RLDA-MV n = 1 bohr^-3, kF/c = 0.0226 LDA e/n = -0.809759 de/dn = -1.064202 LDA-VWN e/n = -0.810151 de/dn = -1.064683 RLDA-MV e/n = -0.809901 de/dn = -1.064182 PBE e/n = -0.809759 de/dn = -1.064202 PBE-VWN e/n = -0.810151 de/dn = -1.064683 n = 1e+06 bohr^-3, kF/c = 2.2576 LDA e/n = -74.060819 de/dn = -98.689730 LDA-VWN e/n = -74.060913 de/dn = -98.689799 RLDA-MV e/n = -5.103448 de/dn = 7.862728 PBE e/n = -74.060819 de/dn = -98.689730 PBE-VWN e/n = -74.060913 de/dn = -98.689799 ### PBE with a density gradient, given by the reduced gradient $s = |\nabla n|/(2 k_F n)$, so $\sigma = (2 k_F n s)^2$. The gradient lowers the energy below that of the LDA. The derivative //dedsigma// is compared with a finite difference. At $\sigma = 0$ it is 0: in PBE the gradient corrections of exchange and correlation cancel for a slowly varying density. ### ==== Input ==== -- PBE at n = 0.1 bohr^-3 for a few reduced gradients s = |grad n|/(2 kF n) n = 0.1 kF = (3*math.pi^2*n)^(1/3) eLDA = XCFunctional("LDA", n) e, dedn, dedsigma = XCFunctional("PBE", n, 0) print(string.format("sigma = 0: e/e_LDA = %.5f, de/dn = %.6f, de/dsigma = %.6f", e/eLDA, dedn, dedsigma)) print(" s sigma e/e_LDA de/dn de/dsigma finite difference") for _, s in ipairs({0.5, 1, 2, 5}) do local sigma = (2*kF*n*s)^2 local e, dedn, dedsigma = XCFunctional("PBE", n, sigma) local h = 1e-4*sigma local fd = (XCFunctional("PBE", n, sigma + h) - XCFunctional("PBE", n, sigma - h))/(2*h) print(string.format("%4.1f %8.5f %9.5f %10.6f %10.6f %10.6f", s, sigma, e/eLDA, dedn, dedsigma, fd)) end ==== Result ==== sigma = 0: e/e_LDA = 1.00000, de/dn = -0.517632, de/dsigma = 0.000000 s sigma e/e_LDA de/dn de/dsigma finite difference 0.5 0.02062 1.00778 -0.508824 -0.025290 -0.025290 1.0 0.08248 1.06191 -0.472618 -0.037525 -0.037525 2.0 0.32991 1.23769 -0.483475 -0.019197 -0.019197 5.0 2.06196 1.47286 -0.696504 -0.001477 -0.001477 ===== Table of contents ===== {{indexmenu>.#1}}