Skip to main content

SEAMM Energy Plug-in

GitHub pull requests Build Status Code Coverage Code Quality Documentation Status Updates for Dependencies PyPi VERSION

A SEAMM plug-in for calculating the energy and forces of one or many structures with the current Model Chemistry, driven as a resident MDI engine.

Features

  • Evaluates the energy, gradients (forces) and, for periodic systems, the stress of the current configuration, every configuration of a system, or a selection by name.

  • Uses whatever Model Chemistry precedes it in the flowchart – a machine-learned force field from the xnn plug-in, MOPAC, xTB, ORCA, … – provided it can be driven as an MDI engine.

  • Starts the program once and feeds it the structures over the warm MDI connection, so labelling hundreds or thousands of structures (e.g. the ensembles from the Normal Mode Sampling, Dimer Builder or Extract Clusters steps) costs one start-up: ~14 ms per water molecule with an xnn MACE model on a laptop CPU.

  • Stores the results on each configuration – energy#Energy#<model>, gradients#Energy#<model>, stress#Energy#<model> – and the gradients on the atoms, so the Write Structure step’s extended XYZ output carries REF_energy and REF_forces for training.

  • Writes energies.csv (energy, max/RMS force and timing per structure) in the step’s directory and can save any result to variables or tables.

Acknowledgements

This package was created with Cookiecutter and the molssi-seamm/cookiecutter-seamm-plugin project template.

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

History

2026.9.19 (2026-09-19)

  • Structure selection now uses SEAMM’s standard block (systems and configurations, by name or from a variable), so the Energy step can e.g. evaluate all configurations of every system, or the systems matching a pattern.

  • The output states exactly what was stored on each configuration (energy, gradients, stress) and mentions forces only when they were calculated; the CSV summary is secondary.

  • The output names the model file used when the provider reports one, e.g. personal:xnn/water.pt, so a personal model shadowing a machine one is visible.

  • Requires seamm 2026.9.18.1 or later.

2026.9.18 (2026-09-18)

  • Initial release. Evaluates the energy, gradients and (periodic) stress of one or many configurations with the upstream Model Chemistry driven as a resident MDI engine; results stored per configuration and on the atoms, with energies.csv and table/variable output. Validated with an xnn MACE model (1000 water configurations in 14 s) and with MOPAC PM6-ORG.

  • Plug-in created using the SEAMM plug-in cookiecutter.

Metadata

Release files for energy-step 2026.9.19

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

Source distribution (sdist)

Source distribution for energy-step 2026.9.19
File Size Uploaded
energy_step-2026.9.19.tar.gz 45.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for energy-step 2026.9.19
File Interpreter ABI Platform
energy_step-2026.9.19-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 65.5 kB

Release files / energy_step-2026.9.19.tar.gz

Download URL energy_step-2026.9.19.tar.gz
Size 45.9 kB
Tags Source
SHA-256 checksum
How to use checksums
bca1ac462a786727abe7bfb0cb4c0deaf3721060b616b71d55a82ede324efb87
BLAKE2b-256 checksum
How to use checksums
2fc79d7aa41f3e058b36879fc4a0855b4261ac69a454122ceb5294bca3976555
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / energy_step-2026.9.19-py2.py3-none-any.whl

Download URL energy_step-2026.9.19-py2.py3-none-any.whl
Size 19.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
9353b64f245dcb016f2fc7b6df71d8e4b35831e48865ad569b691b088f885dce
BLAKE2b-256 checksum
How to use checksums
b8686e82d90d32e2d1ce811e3f26e7c1dd96ad832340e668fb3dcd3b23bfed93
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

2026.9.19 This release

2 release files

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