Skip to main content

SEAMM Thermal Conductivity Plug-in

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

A SEAMM plug-in for Thermal Conductivity

Features

  • Please edit this section!

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.10.15.2 – Analyze MD run earlier in the flowchart
  • New “MD to analyze” choice: run the MD in the sub-flowchart (as before), the last MD run earlier in the flowchart, the last MD run of each loop iteration, or md.h5md files, including other jobs’. A single run is divided into blocks to estimate the errors.

  • Before the job runs, the step checks that the MD will sample the heat flux every two timesteps, and the job does not start if it does not.

  • The dialog shows only the settings that apply, and hides the sub-flowchart when it is not used.

  • When the run (or block) is too short to fit the Helfand moments, the output now says so; before, those rows were silently missing.

2026.10.15.1 – Reads the H5MD files; needs a periodic system
  • Reads the heat flux, temperature and volume from the md.h5md files that the LAMMPS step now writes, and from the older text files for runs made before.

  • Stops before running any MD if the system is not periodic, since the heat flux is divided by the volume of the cell.

  • The temperature is now averaged over the same samples as the heat flux, the whole run. It was averaged only after the equilibration detected in the run, while the heat flux was used whole. The thermal conductivity changes very little, e.g. by 0.05% for liquid argon.

  • Bugfix: a run whose temperature and volume were missing stopped with an obscure error; the message now says what is missing. The sampling interval was taken to be in fs even when the file gave it in ps.

2026.10.15 – Bugfix: crash with coarse sampling; unreliable fits
  • The Green–Kubo fit failed when the heat flux was sampled less often than every 0.4 ps. It no longer fails.

  • The Green–Kubo fit could accept a second exponential with a negative amplitude, or one too slow to level off within the data, and give a value far from the plateau of the integral. Such fits are now rejected in favour of a single exponential. The error of a two-exponential fit, which could be enormous when the two time constants were nearly equal, now accounts for their correlation.

  • The errors were from the fits to the curves averaged over the runs, which treat their strongly correlated points as independent: the Green-Kubo and Helfand-moment errors were far too small (e.g. +/- 0.0004 W/m/K where the runs differed by 0.03), and the Helfand-derivative errors too large. The error of each value is now the standard error of the values fitted to each run, and the 95% interval is twice that.

  • With a single run the Helfand-moment fits failed and printed 1.00; they now give the slope. With a single run there is no spread between runs to estimate errors from, so none are printed.

  • The slope of the Helfand moments (“Helfand Derivative”) was shifted by one sample, and its errors were in the wrong units. Both are corrected.

  • The analysis now uses the shared seamm_md_analysis library, also used by the Diffusivity step, instead of its own copy. The Helfand moments are computed much faster (by FFT): for a million samples, 0.4 s instead of about 2 minutes.

  • Thermal conductivities from the LAMMPS Heat Flux sub-step need lammps-step 2026.10.15 or later: earlier versions computed the heat flux wrongly.

  • The step no longer needs pandas or statsmodels, and its tests run with uv in CI using the package’s declared dependencies.

2026.3.1 – Internal: switching from deprecated library pkg_resources to importlib

2024.6.3 – Bugfix: handling of options for subflowchart
  • Fixed a bug where the options for the subflowchart were not being parsed correctly.

2024.3.22 – Updated for new scheme for running background tasks.

2024.1.5 – Bugfix: Thermal conductivity
  • If the Helfand moments fit in the thermal conductivity step failed it stopped the entire job. This is fixed, as well as some of the underlying causes for convergence issues.

2023.5.29 – Converged with general approach for trajectory analysis

2023.5.6 – Bugfix
  • Fixed an error handling Nan’s and Inf’s that caused a crash

  • Added the predictions from the derivatives of the Helfand moments to the output to give a better feel for the quality of the results.

2023.5.5 – Improved analysis
  • Considerable improvements to the analysis, results now seem solid

  • Fixed issues with fitting the linear portion of the Helfand moments

  • Added plot of the slope from the Helfand moments, which is similar to the Green-Kubo integral.

  • Cleaned up both the output and graphs.

2023.4.24 – Initial working version
  • Initial tests seem to work but needs more thorough testing.

  • Needs documentation!

2023.4.18 (2023-04-18)
  • Plug-in created using the SEAMM plug-in cookiecutter.

Metadata

Release files for thermal-conductivity-step 2026.10.15.2

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

Source distribution (sdist)

Source distribution for thermal-conductivity-step 2026.10.15.2
File Size Uploaded Provenance Actions
thermal_conductivity_step-2026.10.15.2.tar.gz 319.2 kB Without provenance Details for thermal_conductivity_step-2026.10.15.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for thermal-conductivity-step 2026.10.15.2
File Interpreter ABI Platform Actions
thermal_conductivity_step-2026.10.15.2-py2.py3-none-any.whl Python 2, Python 3 none any Details for thermal_conductivity_step-2026.10.15.2-py2.py3-none-any.whl

Total release size: 345.7 kB

Release files / thermal_conductivity_step-2026.10.15.2.tar.gz

Download URL thermal_conductivity_step-2026.10.15.2.tar.gz
Size 319.2 kB
Tags Source
SHA-256 checksum
How to use checksums
ef090ba182dc995f5f6c7da773d7e5004f99394861e2942d16b39cf0a1f02a07
BLAKE2b-256 checksum
How to use checksums
41a63ca8eed9a9b69899900c0debb0facd9329079cf77758136ba4d081495108
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / thermal_conductivity_step-2026.10.15.2-py2.py3-none-any.whl

Download URL thermal_conductivity_step-2026.10.15.2-py2.py3-none-any.whl
Size 26.5 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
51e2b24022390c53bb829112b8ea5b64ae3f4cffc5bcd570fed6c8c7ce403b03
BLAKE2b-256 checksum
How to use checksums
5a6e7cc3448caa1c7bdeae0b840cfa986d451f2c15661d77bcf45ed81bb7d30b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for thermal-conductivity-step 2026.10.15.2

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