Skip to main content

SEAMM Atomic Charges Plug-in

GitHub pull requests Build Status Code Coverage Code Quality Documentation Status PyPi VERSION

A SEAMM plug-in for computing atomic (partial) charges from a converged electron density.

Features

This plug-in is a post-processing step: it runs after a quantum-chemistry step (VASP, Gaussian, Psi4, ORCA, …) that has produced an electron density, reads that density, and uses a real-space density-partitioning program to assign a partial charge to each atom. The charges are written back into the configuration as a labeled charge set (e.g. charges_DDEC6) so several schemes can coexist on the same structure.

Supported methods

  • DDEC6 (via the Chargemol program) – ESP-faithful, chemically transferable charges that work for molecular and periodic systems, including metals. The recommended general-purpose / force-field charge.

  • Bader / QTAIM (via the Henkelman bader code) – a rigorous topological partition of the density, the charge solid-state users expect.

Both consume a real-space density grid (or cube), so they apply equally to periodic and molecular calculations. They need the all-electron density from the upstream step (for VASP, CHGCAR plus AECCAR0/AECCAR2 via LAECHG=.TRUE.).

Acknowledgements

Developed by the Molecular Sciences Software Institute (MolSSI), which receives funding from the National Science Foundation under award CHE-2136142.

History

2026.7.13 – Option to set the charges on the structure
  • New Set as the atomic charges on the structure option (default off). When on, the computed charges are also written to the structure’s standard per-atom charge attribute (in addition to the labeled charges_<label> column), so they travel with the structure – e.g. to write them to an extended-XYZ (extxyz) file for machine-learning training.

2026.6.29 – Run Chargemol from a dedicated conda environment
  • The installer now creates a ‘seamm-chargemol’ conda environment containing Chargemol (for DDEC6), and the step runs Chargemol in that environment – no hand-built installation or PATH setup is needed. Run ‘atomic-charges-step-installer install’ to set it up.

  • The reference atomic densities are found automatically inside the seamm-chargemol environment; the ‘DDEC reference densities’ setting is now needed only to point at a different copy.

2026.6.28 – Citations, charge normalization, and GUI fixes
  • The DDEC6 (Manz & Limas) and Bader (Henkelman) methodology papers are now cited for the charge method that is run.

  • The charges are normalized to the known net charge of the system with a small, reported uniform shift; this can be turned off.

  • Accepts an analytic wavefunction (.wfx) from a preceding ORCA step, in addition to Gaussian, for molecular DDEC6.

  • Fixed: the Results tab in the GUI was empty and selected results were not saved. The atomic charges, net charge, residual, and method are now listed and stored.

  • The charge method now offers Bader only when a density grid is available (a periodic/VASP density or explicit files); molecular densities offer DDEC6. Bader reports a clear message that it awaits periodic support.

2026.6.27 – Initial release of the Atomic Charges step
  • Computes DDEC6 atomic charges (via Chargemol) from a molecular Gaussian wavefunction (.wfx), storing them as a labeled charge set on the structure.

Download files

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

Source Distribution

atomic_charges_step-2026.7.13.tar.gz (318.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

atomic_charges_step-2026.7.13-py2.py3-none-any.whl (28.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file atomic_charges_step-2026.7.13.tar.gz.

File metadata

  • Download URL: atomic_charges_step-2026.7.13.tar.gz
  • Upload date:
  • Size: 318.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for atomic_charges_step-2026.7.13.tar.gz
Algorithm Hash digest
SHA256 c6070856427b48042454f1fcde0112a3c4d8f23d9b023737d0084362bf245dbb
MD5 d2d539a15298b2f786f1cc39c454b4bb
BLAKE2b-256 56c2904c0268dcc0949f364b6c34f358d7cd504e8a783a3acaa91b99ed5594a0

See more details on using hashes here.

File details

Details for the file atomic_charges_step-2026.7.13-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for atomic_charges_step-2026.7.13-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 9700f1b56b93ca5a3506fe1e5c784ca2b594c70f5a2245ddd7ec1c66e93fb1cd
MD5 9f8daaf48e02aa9f351ec81f90783d60
BLAKE2b-256 aca074f67fbf5d14f28b526618b9c570646b6d58d648c46f6523d9dd72d08643

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page