Metadata-Version: 2.4
Name: liquid_structure_step
Version: 2026.10.18
Summary: A SEAMM plug-in for Liquid Structure
Home-page: https://github.com/molssi-seamm/liquid_structure_step
Author: Paul Saxe
Author-email: psaxe@molssi.org
License: BSD-3-Clause
Keywords: SEAMM,SEAMMplugin,flowchart
Platform: Linux
Platform: Mac OS-X
Platform: Unix
Platform: Windows
Classifier: Environment :: Plugins
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: MDAnalysis>=2.8
Requires-Dist: numpy
Requires-Dist: seamm>=2026.10.17.1
Requires-Dist: seamm-md-analysis[structure]>=2026.10.17.4
Requires-Dist: seamm-util
Requires-Dist: seamm-widgets
Requires-Dist: tabulate
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

==============================
SEAMM Liquid Structure Plug-in
==============================

.. image:: https://img.shields.io/github/issues-pr-raw/molssi-seamm/liquid_structure_step
   :target: https://github.com/molssi-seamm/liquid_structure_step/pulls
   :alt: GitHub pull requests

.. image:: https://github.com/molssi-seamm/liquid_structure_step/workflows/CI/badge.svg
   :target: https://github.com/molssi-seamm/liquid_structure_step/actions
   :alt: Build Status

.. image:: https://codecov.io/gh/molssi-seamm/liquid_structure_step/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/molssi-seamm/liquid_structure_step
   :alt: Code Coverage

.. image:: https://github.com/molssi-seamm/liquid_structure_step/workflows/CodeQL/badge.svg
   :target: https://github.com/molssi-seamm/liquid_structure_step/security/code-scanning
   :alt: Code Quality

.. image:: https://github.com/molssi-seamm/liquid_structure_step/workflows/Release/badge.svg
   :target: https://molssi-seamm.github.io/liquid_structure_step/index.html
   :alt: Documentation Status

.. image:: https://img.shields.io/pypi/v/liquid_structure_step.svg
   :target: https://pypi.python.org/pypi/liquid_structure_step
   :alt: PyPi VERSION

A SEAMM plug-in for the structure of liquids and solutions from molecular dynamics:
radial distribution functions, coordination numbers, ion pairing and solvation shells.

* Free software: BSD-3-Clause
* Documentation: https://molssi-seamm.github.io/liquid_structure_step/index.html
* Code: https://github.com/molssi-seamm/liquid_structure_step

Features
--------

* Partial radial distribution functions with errors, their first peaks and minima, and
  coordination numbers, with fixed cutoffs where the minima mislead.
* The pairing of ions: free, solvent-separated (SSIP), contact (CIP) and aggregated
  (AGG) pairs, also for clusters.
* Solvation shells: coordination numbers per solvent, the most common shells, pairing,
  and residence times.
* Analyzes the MD earlier in the flowchart -- independent runs in a Loop -- or the H5MD
  files of earlier runs, with 95% confidence intervals from the runs or from blocks of
  one run, and reports the state of the runs (temperature, pressure, density).

Acknowledgements
----------------

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

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`molssi-seamm/cookiecutter-seamm-plugin`: https://github.com/molssi-seamm/cookiecutter-seamm-plugin

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

.. _MolSSI: https://molssi.org
.. _`National Science Foundation`: https://www.nsf.gov


=======
History
=======
2026.10.18 -- Bugfix: frames more often than needed were all analyzed
    * The step analyzed every frame the MD wrote, so positions written every 0.1 ps were
      all used even when nothing needed them: a 1000-atom argon run spent half of a
      12-minute job here. Frames are now skipped down to the interval needed: every 0.1
      ps when residence times are computed, which needs solutes, else about every
      'Longest interval between frames'.

2026.10.17 -- Analyze MD run before the step; labelled errors for every table
    * The step analyzes MD run before it in the flowchart -- the runs of a Loop around
      the MD, as independent replicas ("the last MD run of each loop iteration", the
      default) -- or md.h5md files; it no longer runs its own MD in a sub-flowchart.
      Older flowcharts that stored its settings for that can still be read; the check
      before the job runs says what replaces them.
    * The check before the job runs also warns when the analysis is inside the loop
      holding its MD, when the loop changes the temperature or pressure, and when the
      thermostat does not suit the analysis, with fixes; the step warns before the MD
      when the system is small.
    * Errors are the 95% confidence interval, Student's t for the number of runs or
      blocks, and the output says so; stored errors are standard errors.
    * The state of the runs -- temperature, pressure, volume and density with their
      errors, and the equilibrium density where an NPT run before them gives the bulk
      modulus -- is reported and stored. The values of each run or block are in
      step.out.
    * The peaks and minima of g(r), coordination numbers, ion pairing, solvation shells
      and residence times have 95% intervals from the runs (or blocks); residence times
      are computed per run.
    * Bugfix: the description claimed residence times, ion pairing or shells even when
      they were turned off.


2026.10.16 -- First release: the structure of liquids and solutions
    * Radial distribution functions of pairs of sites, with errors, their first peaks
      and minima, and coordination numbers, with fixed cutoffs where the minima
      mislead.
    * The pairing of ions: each cation free, in a solvent-separated (SSIP) or contact
      (CIP) pair, or in an aggregate (AGG).
    * The solvation shells of solutes: the coordination number of each solvent, the
      most common shells, pairing, and residence times.
    * Runs its own MD or analyzes the MD earlier in the flowchart, and checks before
      the job runs that the MD samples the positions often enough.
