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)
| File | Size | Uploaded | |
|---|---|---|---|
| qc_atomdb-1.0.0.tar.gz | 63.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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