README.md

March 23, 2026 ยท View on GitHub

๐Ÿ”ฎ qcMol: a large-scale dataset of 1.2 million molecules
with DFT-level quantum chemical annotations
for molecular representation learning

Paper Website License


๐Ÿ“˜ Overview

qcMol is a large-scale and comprehensive dataset containing 1.2 million molecules collected from 95 curated sources.
It provides DFT-level quantum chemical annotations to advance molecular representation learning and molecular property prediction.

The dataset covers 247,448 unique molecular scaffolds, encompassing drug-like compounds, metabolites, and experimentally validated molecules, thus capturing a chemically diverse landscape suitable for AI-driven drug discovery.

Each molecule is annotated with detailed quantum-chemical descriptors derived from reliable B3LYP-D3/def2-SV(P)//GFN2-xTB calculations, combined with wavefunction analyses.
With multiple data formats and rich annotations, qcMol serves as both an ideal pretraining resource and a benchmark platform for deep learning models.


๐ŸŒŸ Dataset Highlights

  • ๐Ÿงฉ Scale: 1.2 million molecules from 95 datasets
  • ๐Ÿ”ฌ Quantum Calculations: B3LYP-D3/def2-SV(P)//GFN2-xTB
  • ๐Ÿ“Š Descriptors: NPA, ADCH, ELF, LI, LBO, DI, Mayer, and more
  • ๐Ÿ’Š Coverage: 247,448 molecular scaffolds across diverse drug-like and biological molecules
  • โš™๏ธ Formats: Basic information / Global information / Atom-level information / Bond-level information
  • ๐Ÿง  Applications: Pretraining, molecular property prediction, scaffold-level learning, and generative modeling

๐Ÿ“• Github Structure

qcMol/
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ env/                                             # Environment dependencies
โ”‚   โ”œโ”€โ”€ evaluation.md     
โ”‚   โ””โ”€โ”€ qc_calculation.md  
โ””โ”€โ”€ script/
    โ”œโ”€โ”€ evaluation/
    โ”‚   โ”œโ”€โ”€ descriptor_quality/                      # Experiment 1 - Features Quality
    โ”‚   โ”‚   โ”œโ”€โ”€ README.md             
    โ”‚   โ”‚   โ”œโ”€โ”€ gat_baseline/                        # Baseline setting
    โ”‚   โ”‚   โ”œโ”€โ”€ gat_conv6/
    โ”‚   โ”‚   โ”œโ”€โ”€ .....
    โ”‚   โ””โ”€โ”€ distribution_quality/                    # Experiment 2 - Distribution Quality
    โ”‚       โ”œโ”€โ”€ README.md
    โ”‚       โ”œโ”€โ”€ pretrain/                            # Pretrain with qcMol/QM9 data
    โ”‚       โ””โ”€โ”€ evaluation/                          # Evaluate the pretrained model
    โ””โ”€โ”€ qc_features_calculation/                     # The pipeline of quantum chemical calculation
        โ””โ”€โ”€ run_single/
            โ”œโ”€โ”€ ...
            โ”œโ”€โ”€ post_ana/
            โ””โ”€โ”€ result/   

๐Ÿ“‚ Access


๐Ÿ“š Citation

If you use qcMol in your research, please cite:

@article{HaoyuWang2025qcMol,
  title     = {qcMol: A Large-Scale Dataset of 1.2 Million Molecules with High-Quality Quantum Chemical Annotations for Molecular Representation Learning},
  author    = {Haoyu Wang and et al.},
  journal   = {bioRxiv},
  year      = {2025},
  doi       = {10.1101/2025.09.07.674462},
  url       = {https://www.biorxiv.org/content/10.1101/2025.09.07.674462v1}
}