Skip to main content
Logo

This project supports Python 3.9+ pytest PyPI License pages-build-deployment

AtomDB

About

AtomDB is a versatile, free, and open-source Python library for accessing and managing atomic and promolecular properties. It serves as an extended database or periodic table of neutral and charged atomic properties, offering accurate experimental and computational data for various atomic charge/multiplicity states. AtomDB is a QC-Devs project.

Documentation

AtomDB's documentation, including installation and usage instructions, as well as API documentation, is available at atomdb.qcdevs.org.

Functionality

  • Atomic scalar properties

    AtomDB provides a wide range of atomic properties for neutral and charged atoms, including: Atomic number, Atomic symbol, Atomic mass, Atomic radius, van der Waals radius, Covalent radius, Ionization potential, Electron affinity, Electronegativity, Atomic polarizability.

  • Point dependent properties

    AtomDB provides functions to calculate point-dependent properties, such as: Electron density $\rho(r)$, Electron density gradient $\nabla \rho(r)$, Electron density Laplacian $\nabla^2 \rho(r)$, Electron density Hessian $\nabla^2 \rho(r)$ (for these properties, only the radial part is provided), and Kinetic energy density $ked(r)$.

    The computation of contributions per orbital, set of orbitals, or spin to these properties is also supported.

  • Promolecular properties

    AtomDB provides the capabilities to create promolecular models, and then estimate molecular properties from the atomic properties.

  • Dumping and loading

    AtomDB provides the capability to dump and load atomic properties to and from JSON files.

For a complete list of available properties, see this table.

Installation

We recommend using Python 3.9 or later. The qc-grid is need to run AtomDB. You can install it from source for now:

pip install git+https://github.com/theochem/grid.git

Then, qc-AtomDB can be installed using pip:

pip install qc-AtomDB

Contributing

We welcome any contributions to the AtomDB library in accordance with our Code of Conduct. Please see our Contributing Guidelines. Please report any issues you encounter while using AtomDB on GitHub Issues.

For further information and inquiries, please contact us at qcdevs@gmail.com.

Citing AtomDB

Please use the following citation in any publication using AtomDB:

@Article{atomdb,
    author  = {S{\'a}nchez D{\'i}az, Gabriela and Richer, Michelle and
               Mart\'{i}nez Gonz\'{a}lez, Marco and van Zyl, Maximilian and
               Pujal, Leila and Tehrani, Alireza and Bianchi, Julianna and
               Chuiko, Valerii and Erhard, Jannis and Ayers, Paul W. and
               Heidar-Zadeh, Farnaz},
    title   = {{AtomDB: A Python Library for Atomic and Promolecular Properties}},
    journal = {-},
    year    = {2024},
    url     = {https://atomdb.qcdevs.org/},

Metadata

Release files for qc-AtomDB 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qc-AtomDB 1.0.0
File Size Uploaded
qc_atomdb-1.0.0.tar.gz 63.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for qc-AtomDB 1.0.0
File Interpreter ABI Platform
qc_atomdb-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 125.6 MB

Release files / qc_atomdb-1.0.0.tar.gz

Download URL qc_atomdb-1.0.0.tar.gz
Size 63.6 MB
Tags Source
SHA-256 checksum
How to use checksums
e9f81bc086c7b1f91cdcebf4fc73151a16db85ad09bb260b2baf89b1bfe87dc7
BLAKE2b-256 checksum
How to use checksums
4f50303b2b9eca7abb3d8e54982cd72a0339fb523ae30d2edc336314800290da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.

Transparency log

Release files / qc_atomdb-1.0.0-py3-none-any.whl

Download URL qc_atomdb-1.0.0-py3-none-any.whl
Size 62.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
86d4c8e1d0e2aeb37831c5b3ddfb01d3cc31d25735eba54eb41df01a24428364
BLAKE2b-256 checksum
How to use checksums
fb30c2ca6db57892127e81bb897fce233748718608ce213340e6b3c45ebfd962
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page