Skip to main content

SEAMM QuickMin Plug-in

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

A SEAMM plug-in for simple, quick minimization

Features

QuickMin provides quick, simple optimization of molecular structures using one of a number of forcefields. It is intended for small systems, with no more than about 300 atoms. Beyond that size it will be rather slow, but more importantly larger systems typically have many local minima, often close to each other energetically, so the concept of the minimum structure is not very useful.

QuickMin uses OpenBabel for the minimization. There are currently five forcefields available:

  1. GAFF – the general AMBER force field

  2. MMFF94 – the Merck molecular force field

  3. MMFF94s – the Merck molecular force field for energy minimization

  4. Ghemical

  5. UFF – Universal force field

The first four have parameters for organic and biomolecular systems, while UFF attempts to cover the entire periodic table with reasonable accuracy. The more specialized forcefields tend to be more accurate, roughly in the order listed (though the two MMFF94 are essentially similar). By default QuickMin will try each of the forcefields in the order given until it finds one that can handle the given molecule. You can specify the forcefield to use; however, if it does not have parameters for your molecule, QuickMin will throw an error.

Acknowledgements

This package was created with the molssi-seamm/cookiecutter-seamm-plugin tool, which is based on the excellent Cookiecutter.

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

History

2026.3.1 – Internal: switching from deprecated library pkg_resources to importlib

2025.2.24 – Changed structure option to “Discard the structure”

2025.2.23 – Add RMSD and other properties to the output and available results.
  • Calculate the RMSD between the initial and final structures, and made it available in the results and also reported to the output.

  • Added control over where to place the optimized structure.

2024.5.7 – Bugfix: Corrected sign on gradients.
  • OpenBabel calls “forces” “gradients”, so needed to take the negative to get the actual gradients.

2024.5.3 – Added single point energy and Results.json
  • Added control to allow a single point energy as well as optimization. This supports using QuickMin with e.g energy scans.

  • Standardized the name of the energy to simply “energy” to better support other plug-ins and codes understanding the results.

2023.11.15 – Bugfix: structure handling

Error putting the coordinates into a newly created configuration.

2023.10.30 – Enhanced structure handling.

Switched to standard handling of structures, which adds ability to name with the IUPAC name, InCHI, and InChIKey in addition to previous methods.

2023.1.14 – Changed documentation to new style and theme.

Switched the documentation to the MolSSI theme and diátaxis layout, though more work is needed.

2022.11.7 – Internal Release

Switching from LGTM code analysis to GitHub Actions using CodeQL, since LGTM is shutting down!

2022.10.23 – Properties added

Added a single property, ‘total energy#QuickMin#<forcefield>’, to store the final energy in the database. Also added ‘total energy’ as a result for tables or variables.

2022.10.22 – Documentation!

Got the documentation into reasonable shape.

2022.10.20 – Initial Release!

Provides quick minimization for smaller molecules, using OpenBabel. Probably reasonable for some few hundred atoms. Supports the following forcefields:

  1. GAFF

  2. MMFF94 & MMFF94s (which is optimized for minimization)

  3. Ghemical

  4. UFF

The default is the “best available” forcefield, which tries them in the order given above until it finds one that can handle the molecule.

Metadata

Release files for quickmin-step 2026.3.1

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

Source distribution (sdist)

Source distribution for quickmin-step 2026.3.1
File Size Uploaded
quickmin_step-2026.3.1.tar.gz 312.1 kB Details

Built distribution (wheel)

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

Total release size: 333.9 kB

Release files / quickmin_step-2026.3.1.tar.gz

Download URL quickmin_step-2026.3.1.tar.gz
Size 312.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a983b03fb1adabfa03fdfe699888861daa47def1c32eeb24ce35fe2cb225ba69
BLAKE2b-256 checksum
How to use checksums
20651b9e6955013a508d20e686c1fcfb97feeef5faaf21e7ee05197ba918c764
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / quickmin_step-2026.3.1-py2.py3-none-any.whl

Download URL quickmin_step-2026.3.1-py2.py3-none-any.whl
Size 21.8 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
84419ebfa117b48e0b91b7ef30cf7f31f8e6736a2436ba7016061b378b474cf3
BLAKE2b-256 checksum
How to use checksums
cea136ed33080898e34b83cc9e463c5b405eaf6fc3659ad779d36d2411cea6e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7
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