Skip to main content

AtomDB is a database of atomic and ionic properties.

Project description

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:

git clone git@github.com:theochem/grid.git
cd qc-grid
pip install .

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 {v}an Zyl, Maximilian and
                   Pujal, Leila and Tehrani, Alireza and Bianchi, Julianna 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/},
    }

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qc_atomdb-0.0.2.post2.tar.gz (63.6 MB view hashes)

Uploaded Source

Built Distribution

qc_AtomDB-0.0.2.post2-py3-none-any.whl (62.0 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page