README
The TBHubbard dataset is a collection of data with a tight-binding description of metal organic frameworks (MOFs). The structures are derived from the QMOF database, where first-principles calculations are performed to obtain the electronic density which is then projected onto a localized atomic basis set using PAOFLOW. The data collection is divided into two sub-sets: tight_binding_model and extended_hubbard_model.
Downloading the dataset
To facilite the download of this massive dataset, we provide the 2-DOWNLOAD.sh script for your convenience. Instead of downloading the compressed files from this page one by one, we suggest you download the script first and use it to obtain all the other files.
$ ./2-DOWNLOAD.sh -h
Usage: ./2-DOWNLOAD.sh -s {TB, EH} -c {aria2c, wget, curl} -d destination/
- You can use the
-c option to select a download client from these options: aria2c, wget and curl. For faster downloads supporting multiple parallel connections, we recommend aria2c.
- To download only the Tight-Binding (
TB) or the Extended Hubbard (EH) sub-set, please use the -s option.
- The script, by default, downloads all files to a destination folder named
TBHubbard/. You can change the destination folder using the -d option.
After downloading the files, use the following commands to decompress them:
cat tight_binding_model.tar.bz2.part-* | tar -I pbzip2 -xvf -
cat extended_hubbard_model.tar.bz2.part-* | tar -I pbzip2 -xvf -
The required storage for the extended_hubbard_model sub-set is 97GB (53GB when compressed) and 785G for the tight_binding_model sub-set (363G when compressed).
Sub-sets
Tight-Binding Model
The Tight-Binding Model offers a comprehensive dataset for 10,435 metal-organic frameworks (MOFs), providing key electronic structure data. The electronic density for each MOF is projected onto a localized atomic basis set, generating a tight-binding lattice Hamiltonian. This allows for the study of the electronic properties and interactions within the MOF structures. Additionally, Smooth Overlap of Atomic Positions (SOAP) descriptors are computed for 20,375 MOFs, enriching the dataset with detailed topology information about the local atomic environments.
tb_dft/: This directory contains the Quantum ESPRESSO (QE) calculations used for the tight-binding projections. It includes all relevant input and output files, the tight-binding Hamiltonian, and detailed results from PAOFLOW projections (e.g., arry.pkl, paoflow.out). The bader.out, ACF.dat, and other related files provide further insights into the charge distribution and electronic structure. SCF calculation outputs such as rho.cube and scf files are also included to allow for a deeper understanding of the electronic density. For detailed instructions on the tight-binding projection workflow, please refer to the tight_binding_model/README.md.
soap_of_mofs/: This folder includes the SOAP descriptors, which are essential for understanding the local atomic environments within the MOFs. SOAP descriptors come in two variations: SOAP-3 Å and SOAP-5 Å. These descriptors capture the atomic structure at different length scales, offering both detailed and broader topological information. The filenames are given appending to the MOFs name the suffix _soap.npz. Each file contains these descriptors and allows for easy extraction of essential data. For further information on computing SOAP descriptors, please refer to the tight_binding_model/scripts/compute_soap-descriptors/README.md.
scripts/: A collection of helper tools for visualizing the data and generating necessary inputs for further analysis. These scripts make it easier to manipulate, visualize, and utilize the tight-binding and SOAP data for subsequent computational studies and modeling. To learn how to compute tight-binding embeddings from QE, check the tight_binding_model/scripts/compute_tight-binding_embeddings_from_qe/README.md. To set up and run SCF calculations with QE, follow the instructions in tight_binding_model/scripts/setup_qe_scf/README.md.
For more detailed guidance, please refer to the appropriate README.md files in each directory.
Extended Hubbard Model
Electronic structure calculations for 242 MOFs. The electronic density is projected onto a localized atomic basis set, providing a tight-binding lattice Hamiltonian of MOFs. A set of 428 calculations are also provided for the self-consistent computation of Hubbard parameters U and V of 242 MOFs. The set is divided according to the manifold chosen for U and V, where d and s orbitals corresponds to ds_perturbations; and d and p orbitals corresponds to dp_perturbations. The tight-binding projection along with the Hubbard parameters constructs the Extended Hubbard model lattice Hamiltonian.
dp_perturbations and ds_perturbations: QE calculation with the tight-binding projection, including input and output files, as well as the tight-binding Hamiltonian (arry.pkl), the tight-binding embeddings (blocks_all_species_TB_embedding_cif_not_used.pkl) and the parsed U and V pickle file (block_UV_from_parsed_1st_atom.pkl). The Hubbard parameters computation inputs and outputs (hp.p) are also provided for dp and ds perturbations in each corresponding folder (Hubbard_parameters_full.dat and Hubbard_parameters_nn.dat).extend_hubb_data.json: Tabulated property containing the main input and output QE information for each MOF, divided in dp and ds perturbations.scripts/: helper tools for visualization of main properties and input generation.
License
All dataset files are distributed under the CDLA-Permissive-2.0 license, while the source code files are distributed under the BSD-3-Clause license.
Copyright (c) 2025, International Business Machines All rights reserved.
(2025-03-10)
