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

Development Team

  • Paul Saxe <psaxe@molssi.org> (Lead)

  • Why don’t you join the team? Become a contributor!

Versions of this Documentation