Density Functional Theory ToolKit (DFTTK) to Automate First-Principles Thermodynamics via the Quasiharmonic Approximation
Nigel Lee En Hew, Luke Allen Myers, Axel van de Walle, Shun-Li Shang, Zi-Kui Liu · 2025
Read Density Functional Theory ToolKit (DFTTK) to Automate First-Principles Thermodynamics via the Quasiharmonic Approximation by Nigel Lee En Hew, Luke Allen Myers, Axel van de Walle, Shun-Li Shang, Zi-Kui Liu (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2504-17027.txt.
Introduction
Nigel Lee En Hew and co-authors release DFTTK, an open source toolkit that automates first principles thermodynamics for materials. Their 2025 paper targets a tedious gap. The theory for Helmholtz energy is settled, but each lab still hand builds its calculations. The Python package runs the quasiharmonic route end to end.
It sums the parts of the energy. The static term comes from energy volume curves. Vibration terms come from a Debye model and from phonons. The thermal electron term comes from the density of states. Gibbs energy and its properties follow at set temperature and pressure. Case studies cover plain aluminum and the magnetic alloy Invar, where the tool enumerates every magnetic arrangement with its weight. The code is free on GitHub.
Catalog record
| CREATOR | Nigel Lee En Hew, Luke Allen Myers, Axel van de Walle, Shun-Li Shang, Zi-Kui Liu |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 36 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2504-17027
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
Density Functional Theory ToolKit (DFTTK) to Automate First-Principles Thermodynamics via the Quasiharmonic Approximation Nigel Lee En Hew, Luke Allen Myers, Axel van de Walle, Shun-Li Shang, Zi-Kui Liu Abstract Abstract The Helmholtz energy is a key thermodynamic quantity representing available energy to do work at a constant temperature and volume. Despite a well-established methodology from first-principles calculations, a comprehensive tool and database are still lacking. To address this gap, we developed an open-source Density Functional Theory Tool Kit (DFTTK), which automates first-principles thermodynamics using the quasiharmonic approximation (QHA) for Helmholtz energy predictions. This Python-based package provides a solution for automating the calculation and analysis of various contributions to Helmholtz energy, including the static total energy contributions at 0 K in terms of DFT-based energy-volume curves, vibrational contributions from the Debye-Grüneisen model and phonons, and thermal electronic contributions via the electronic density of states. The QHA is also implemented to calculate the Gibbs energy and associated properties at constant temperature and pressure. The present work demonstrates DFTTK’s capabilities through case studies on a simple FCC Al and various collinear magnetic configurations of Invar \text{Fe}{\vphantom{\text{X}}}_{\smash[t]{\text{3}}}\text{Pt} , where DFTTK enumerates all unique configurations and their associated multiplicities. DFTTK is freely available on GitHub, and its modular design allows for the easy addition of new workflows. 1 Introduction Density functional theory (DFT) is widely used to calculate the Helmholtz energy for a given configuration k , F^{k}(V,T) [ 1 , 2 , 3 ] : F^{k}(V,T)=E^{k,0}(V)+F^{k,{vib}}(V,T)+F^{k,{el}}(V,T), (1) where E^{k,0}(V) represents the static total energy at 0 K without vibrational contribution, F^{k,{vib}}(V,T) is the vibrational contribution to the Helmholtz energy, and F^{k,{el}}(V,T) is the thermal electronic contribution to the Helmholtz energy [ 1 , 2 ] . Using Eq. 1 , various schemes of the quasiharmonic approximation (QHA) can be applied to calculate thermodynamic properties as a function of temperature and pressure, such as Gibbs energy, equilibrium volume, thermal expansion coefficient, entropy, specific heat capacity, enthalpy, and bulk modulus [ 3 ] . Multiple open-access databases, such as the Materials Project [ 4 ] , OQMD [ 5 , 6 ] , and AFLOW [ 7 ] , provide extensive datasets of material properties predicted through DFT calculations. However, these predictions are generally limited to high-symmetry configurations at equilibrium volume and 0 K temperature. For example, among the 153,902 materials available in the current Materials Project database, only 233 have energy-volume data fitted to equations of state (EOS) necessary to derive E^{k,0}(V) [ 8 ] , while the rest only have computed energies at their equilibrium volumes. For certain materials, both high-symmetry and symmetry-breaking configurations are essential to describe material properties at finite temperatures accurately [ 9 ] . These symmetry-breaking configurations, which include magnetic spin arrangements [ 10 , 11 , 12 , 13 ] and dipole configurations in ferroelectric materials [ 14 , 15 ] , are metastable and can be accessed at finite temperatures. Such configurations are crucial for accurately capturing phase transitions without relying on fitted parameters [ 9 ] . We have previously developed the Density Functional Theory ToolKit (DFTTK) [ 16 ] to accomplish two primary tasks to: (1) automate Helmholtz energy calculations using DFT with the widely-used Vienna Ab initio Simulation Package (VASP) [ 17 , 18 ] , and (2) store the Helmholtz energy of different configurations in a MongoDB database. The present paper presents a major revision of the previous DFTTK, focusing on updates to its core dependencies and the QHA scheme. These improvements were made to enhance DFTTK’s user-friendliness and flexibility. In this paper, we organize the sections as follows. Section 2 details the core software dependencies of DFTTK and the rationale behind changes from the previous version. Section 3 presents examples of running DFTTK for FCC Al and magnetic \text{Fe}{\vphantom{\text{X}}}_{\smash[t]{\text{3}}}\text{Pt} , along with a breakdown of its key workflow components and details of the newly implemented QHA scheme. Section 4 concludes the paper with a summary and discussion of future work. 2 Core dependencies The previous version of DFTTK [ 16 ] was primarily based on atomate [ 19 ] workflows, which in turn relied on the Python packages pymatgen [ 20 ] for handling VASP input/output and structure manipulation, Custodian [ 21 ] for running VASP jobs and error correction, and FireWorks [ 22 ] as a workflow manager to execute VASP jobs via Custodian and store results in a MongoDB database. In contrast, the current version of DFTTK no longer depends on atomate [ 19 ] , though it still relies on pymatgen [ 20 ] and Custodian [ 21 ] . Instead of FireWorks, PyMongo [ 23 ] is now used to manage the storage of results in a MongoDB database. The independent core dependencies of the current DFTTK package are pymatgen [ 20 ] , Custodian [ 21 ] , and PyMongo [ 23 ] , as illustrated in Figure 1 . The decision to remove the atomate [ 19 ] and FireWorks [ 22 ] dependencies was made to streamline installation, usage, and debugging. With fewer installation steps, setup is now more straightforward. By eliminating FireWorks, users can run VASP jobs using Custodian workflows without needing a MongoDB connection. Previously, DFTTK required a MongoDB connection to run jobs, which caused issues if a cluster or supercomputer couldn’t connect, preventing job execution. The new DFTTK adopts a modular "run first, store later" approach, allowing VASP jobs to run without MongoDB, with results stored later using PyMongo on any machine with MongoDB access. Of course, DFTTK and atomate can still be freely used in conjunction, for example, to generate data on a truly large scale. The current version of DFTTK simply removes the hard dependency between these packages. Figure 1: DFTTK independent core dependencies. This modular design simplifies debugging by isolating issues on the run and store sides. In addition, removing atomate [ 19 ] and some of its dependencies has significantly simplified the codebase. Since FireWorks [ 22 ] itself relies on PyMongo [ 23 ] , using PyMongo directly instead of FireWorks eliminates an additional layer of complexity, further streamlining the codebase. 3 Running DFTTK 3.1 Installation and Access DFTTK is publicly available on GitHub [ 24 ] , where users can access the latest source code, report issues, and contribute to its development. A step-by-step installation guide is provided to facilitate setup. Users can install DFTTK using pip install . The repository also includes automated testing to ensure reliability. While this paper highlights some applications of DFTTK, additional tutorials and usage examples can be found in the official documentation [ 25 ] . 3.2 Workflow Figure 2 illustrates the Helmholtz energy workflow utilized in DFTTK to determine F^{k} as described in Eq. 1 . The only required input is a VASP-based structure file (POSCAR file) and arguments for methods. For magnetic structures, the Icamag (Independent Cell Approximation for MAGnetic systems) class, based on the "independent cells" approximation [ 26 ] , generates all unique collinear magnetic spin configurations along with their respective multiplicities. The Configuration class then executes VASP jobs in series for each configuration to obtain the energy-volume data points, yielding E^{k,0}(V) . Subsequently, the Debye-Grüneisen model is applied to compute F^{k,{vib}}(V,T) . Phonon calculations can also