Skip to main content

SEAMM Composite Plug-in

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

A SEAMM plug-in for composite methods: energies from recipes of ordinary calculations

Features

  • Composite methods as model chemistries, SEAMM:CMP@<recipe>, from recipes: short YAML files that say how the energy is made from ordinary calculations.

  • A small, checked language for combining the energies: basis-set extrapolations (inverse power, exponential HF, Schwenke), scaling and empirical terms.

  • Components are ordinary calculations with their own settings fingerprints, so the fragment store reuses them.

  • The shipped recipes r2SCAN-3c-HO and revDSD-r2SCAN-3c-HO, the Thermochemistry step’s quick and default presets.

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.11.12.3 – Quasi-restricted orbitals for open-shell species
  • Recipes can say which reference their correlated components use for open-shell species, open_shell_reference: QRO (quasi-restricted orbitals) or UHF, and a component can override it. Both halves of a difference must use the same reference.

  • The three tier-A recipes use QRO. Closed-shell species are not affected: their calculations, fingerprints and stored results are unchanged.

  • Needs orca-step 2026.11.12.2 or later for QRO.

2026.11.12.2 – Core-valence and relativistic corrections, and the tier-A recipes
  • Recipe components can be given their frozen core (named sets of frozen orbitals per element), a scalar-relativistic Hamiltonian with its nucleus model, and a decontracted basis, so recipes can add core-valence and scalar-relativistic corrections. A difference of two components must change one thing only, or the recipe is refused.

  • Three shipped recipes give accurate reference values after W4: CCSD(T)-F12 (H-Ar), CCSD(T) extrapolated from triple and quadruple zeta (H-Ar, Ga-Br), and the same with a decontracted relativistic correction for species with calcium. Their core-valence and relativistic corrections agree with W4’s to 0.13 and 0.01 kJ/mol on test reactions.

  • Components of one model chemistry with different settings are kept apart, in the job and the fragment store.

  • Needs orca-step 2026.11.12.1 or later for these settings.

2026.11.12.1 – Recipes that use the parts of an energy
  • Recipes can use the parts of a component’s energy: part(c, "name") for the HF energy, the CABS singles, the correlation energies and the triples that the program reports, and parts derived from them (the CCSD-F12 correlation, the scaled triples (T*), …). hf_part(c) is the HF energy and corr_part(c) the correlation alone, so a recipe can, for example, extrapolate the correlation energy and not the HF energy.

  • A recipe that splits an F12 calculation into HF and correlation must account for its CABS singles, and the HF parts of components with different references cannot be combined unless the recipe allows it; such recipes are refused when they are read.

  • A stored energy without the parts a recipe needs is computed again; parts are never derived.

2026.11.12 – Recipes that combine several calculations run in every step
  • A composite recipe that combines several calculations now runs wherever a model chemistry is used: the Energy step, the Thermochemistry step’s CBH approach, and the others that run model chemistries through seamm-exec’s Evaluator. Each component runs as one batch of its own program over all the structures, the cheapest first, with that program’s own memory and cores.

  • A structure that fails one component is not sent to the later ones, and its result names the component that failed.

  • Every result carries the composite record: the recipe’s fingerprint and every component’s settings fingerprint, in the same form whether the recipe has one component or several, and whether a component was computed or found in a store.

  • A user’s or a job’s own recipe (in a recipes directory of SEAMM’s data path) is found wherever its model chemistry runs.

  • Needs seamm-exec 2026.11.12 or later for recipes with several components.

2026.11.11 – First release: composite methods as model chemistries
  • Composite methods are described by recipes, short YAML files that say how the energy is made from ordinary calculations: the geometry and frequency level, single points at that geometry, and a formula that combines them, with basis-set extrapolations, scaling and empirical terms.

  • Every recipe is a model chemistry, SEAMM:CMP@<recipe>, for the steps that take one. Its components are ordinary calculations with their own settings fingerprints, so the fragment store reuses them.

  • The recipes r2SCAN-3c-HO and revDSD-r2SCAN-3c-HO are shipped; they are the Thermochemistry step’s quick and default presets.

  • The Composite step itself does nothing yet and is not offered in the editor.

Metadata

Release files for composite-step 2026.11.12.3

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

Source distribution (sdist)

Source distribution for composite-step 2026.11.12.3
File Size Uploaded Provenance Actions
composite_step-2026.11.12.3.tar.gz 351.8 kB Without provenance Details for composite_step-2026.11.12.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for composite-step 2026.11.12.3
File Interpreter ABI Platform Actions
composite_step-2026.11.12.3-py2.py3-none-any.whl Python 3, Python 2 none any Details for composite_step-2026.11.12.3-py2.py3-none-any.whl

Total release size: 398.6 kB

Release files / composite_step-2026.11.12.3.tar.gz

Download URL composite_step-2026.11.12.3.tar.gz
Size 351.8 kB
Tags Source
SHA-256 checksum
How to use checksums
681d7506a736981ba92ffcc8afd69492d967b113e7a4a603c6075f4b5dfd74b1
BLAKE2b-256 checksum
How to use checksums
fc5a489b8587722ba1c24769785fc67a62086b0a99cbd83df772ef6aa8b79e73
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / composite_step-2026.11.12.3-py2.py3-none-any.whl

Download URL composite_step-2026.11.12.3-py2.py3-none-any.whl
Size 46.8 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
15c856e06672521815d11354e2726102071c0186ad8350bea6a36de574cdf6c2
BLAKE2b-256 checksum
How to use checksums
4f6b8cf899dca7f68161acd40b177011ec052227caf264d1a43c79573b467c80
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for composite-step 2026.11.12.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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