Essentials for Quantum Chemistry.
Project description
QCElemental
QCElemental is a resource module for quantum chemistry containing physical constants and periodic table data from NIST and molecule handlers.
Periodic Table and Physical Constants data are pulled from NIST srd144 and srd121, respectively (details) in a renewable manner (class around NIST-published JSON file).
This project also contains a generator, validator, and translator for Molecule QCSchema.
It is intended to keep the QCElemental code compatible with Python 3.6+ as long as dependencies allow. Packages are assured for Python 3.8+.
Periodic Table
A variety of periodic table quantities are available using virtually any alias:
>>> import qcelemental as qcel
>>> qcel.periodictable.to_E('KRYPTON')
'Kr'
>>> qcel.periodictable.to_element(36)
'Krypton'
>>> qcel.periodictable.to_Z('kr84')
36
>>> qcel.periodictable.to_A('Kr')
84
>>> qcel.periodictable.to_A('D')
2
>>> qcel.periodictable.to_mass('kr', return_decimal=True)
Decimal('83.9114977282')
>>> qcel.periodictable.to_mass('kr84')
83.9114977282
>>> qcel.periodictable.to_mass('Kr86')
85.9106106269
Physical Constants
Physical constants can be acquired directly from the NIST CODATA:
>>> import qcelemental as qcel
>>> qcel.constants.Hartree_energy_in_eV
27.21138602
>>> qcel.constants.get('hartree ENERGY in ev')
27.21138602
>>> pc = qcel.constants.get('hartree ENERGY in ev', return_tuple=True)
>>> pc.label
'Hartree energy in eV'
>>> pc.data
Decimal('27.21138602')
>>> pc.units
'eV'
>>> pc.comment
'uncertainty=0.000 000 17'
Alternatively, with the use of the Pint unit conversion package, arbitrary conversion factors can be obtained:
>>> qcel.constants.conversion_factor("bohr", "miles")
3.2881547429884475e-14
Covalent Radii
Covalent radii are accessible for most of the periodic table from Alvarez, Dalton Transactions (2008) doi:10.1039/b801115j (details).
>>> import qcelemental as qcel
>>> qcel.covalentradii.get('I')
2.626719314386381
>>> qcel.covalentradii.get('I', units='angstrom')
1.39
>>> qcel.covalentradii.get(116)
Traceback (most recent call last):
...
qcelemental.exceptions.DataUnavailableError: ('covalent radius', 'Lv')
>>> qcel.covalentradii.get(116, missing=4.0)
4.0
>>> qcel.covalentradii.get('iodine', return_tuple=True).dict()
{'numeric': True, 'label': 'I', 'units': 'angstrom', 'data': Decimal('1.39'), 'comment': 'e.s.d.=3 n=451', 'doi': 'DOI: 10.1039/b801115j'}
van der Waals Radii
Van der Waals radii are accessible for tmost of the periodic table from Mantina, J. Phys. Chem. A (2009) doi: 10.1021/jp8111556 (details).
>>> import qcelemental as qcel
>>> qcel.vdwradii.get('I')
3.7416577284064996
>>> qcel.vdwradii.get('I', units='angstrom')
1.98
>>> qcel.vdwradii.get(116)
Traceback (most recent call last):
...
qcelemental.exceptions.DataUnavailableError: ('vanderwaals radius', 'Lv')
>>> qcel.vdwradii.get('iodine', return_tuple=True).dict()
{'numeric': True, 'label': 'I', 'units': 'angstrom', 'data': Decimal('1.98'), 'doi': 'DOI: 10.1021/jp8111556'}
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file qcelemental-0.25.1.tar.gz.
File metadata
- Download URL: qcelemental-0.25.1.tar.gz
- Upload date:
- Size: 295.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.1 importlib_metadata/4.11.3 pkginfo/1.8.3 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.10.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e3e0e53fe047d14756718441040a5d737135f0bdb33efb1d63a1935b95821a74 |
|
| MD5 | 824e95d1fddb339919022d0f40dda8b8 |
|
| BLAKE2b-256 | c179a8f4cdab0f2dcf75988236b421951fc63c57b6899a50b12abea730a92b31 |
File details
Details for the file qcelemental-0.25.1-py3-none-any.whl.
File metadata
- Download URL: qcelemental-0.25.1-py3-none-any.whl
- Upload date:
- Size: 334.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.1 importlib_metadata/4.11.3 pkginfo/1.8.3 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.10.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c923616ba29b50b9a99ea4fa1b6a1ad26d0f6070fc2b891e6e91f3df1de6d2ae |
|
| MD5 | 4000ce1d023ee0a6ed8f927d3aa1adad |
|
| BLAKE2b-256 | e71ee25ad69a5a097ddfc2f800cf7ae1f6fca0d4fc4714b4dd0f7c175376eac0 |
