Skip to main content

pycolvars

Python tools to post-process and analyze collective variable (CV) data from metadynamics and umbrella sampling simulations: reading colvars/PLUMED-style trajectory files, reconstructing free energy surfaces (PMF), and finding minimum energy paths across them.

This package was originally developed alongside sea_urchin and later split out as a standalone tool.

Installation

pip install -e .

Minimum energy path algorithm

pycolvars.min_energy_path finds the path between two basins on an energy surface that minimises the maximum energy barrier crossed (the minimax / bottleneck path). It uses the Minimum Spanning Tree of the grid connectivity graph (edge weight = max endpoint energy), which provably yields the optimal minimax path. k-th alternative paths are found by iteratively removing the bottleneck edge of the previous best path and recomputing.

This is a native implementation using networkx. It replaces an earlier vendored copy of MEPSAnd by Marcos-Alcalde et al.

Metadata

Release files for pycolvars 0.1.0

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

Source distribution (sdist)

Source distribution for pycolvars 0.1.0
File Size Uploaded
pycolvars-0.1.0.tar.gz 19.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pycolvars 0.1.0
File Interpreter ABI Platform
pycolvars-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 40.1 kB

Release files / pycolvars-0.1.0.tar.gz

Download URL pycolvars-0.1.0.tar.gz
Size 19.2 kB
Tags Source
SHA-256 checksum
How to use checksums
29011f2ea5ae0b303ef0b4a03fdf679ca37516078c0ebb0e7adc5985d42df7c7
BLAKE2b-256 checksum
How to use checksums
16b30a7bbdf2ee7910553e512d6fa4c04f76c62ee8effb25f66a2dc3976077df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.

Transparency log

Release files / pycolvars-0.1.0-py3-none-any.whl

Download URL pycolvars-0.1.0-py3-none-any.whl
Size 20.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f9d01d0587709e4828b957ef30167e104fd0c52eaa4775967d287c6af807bcea
BLAKE2b-256 checksum
How to use checksums
81f171c9cf7ea5eb9ddbd39af4f414bf91ca219e2a6cb50c5afb0c87a08ace12
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

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