Tutorials

In addition to reading the documentation, we have prepared several examples to highlight the usage and capabilities of PyRETIS. The cards below point to the user-facing tutorial folders that ship with the source tree. Larger published-result packages that regenerate figures from validation studies are collected on the results page. The complete tutorial list is in the example section.

The examples below are grouped by what you are most likely to change: the potential, the sampling method, the external dynamics engine, or the molecular dynamics workflow. Each card links to the rendered documentation and to the matching source folder under examples/tutorials/.

Potentials

1D double well

The smallest TIS/RETIS model: one particle in the van Erp double-well benchmark.

Tutorial source

1D triple well

RETIS on a three-state landscape, including the zero_left shortcut for the [0-] ensemble.

Tutorial source

2D hysteresis

A two-dimensional internal potential where the best order parameter is deliberately less obvious.

Tutorial source

2D WCA bond

Bond breaking in the WCA model from van Erp, Moroni and Bolhuis (2003), with low- and high-barrier variants.

Tutorial source

Sampling methods

TIS and flux

Initial flux plus TIS crossing probabilities for the 1D double-well system.

Tutorial source

RETIS

Replica exchange between path ensembles for the same double-well benchmark.

Tutorial source

Subtrajectory moves

Stone skipping, web throwing and wire fencing from Riccardi et al. (2017) and Zhang et al. (2023).

Tutorial source

Umbrella sampling

Monte Carlo umbrella sampling for free-energy estimation alongside the rate-constant tutorials.

Tutorial source

Permeability

A path-sampling setup using permeability = True for membrane-style transport calculations.

Tutorial source

Particle swarm

Particle-swarm optimisation for finding useful initial paths before path sampling.

Tutorial source

REPPTIS

Replica-exchange partial-path TIS on the 1D double well, with the Markov-state-model kinetics analysis.

Tutorial source

Exploring the landscape

Free-energy landscape exploration to generate a first valid initial path before path sampling.

Tutorial source

External engines

GROMACS

Methane transport in an sI hydrate structure with a custom Python order parameter.

Tutorial source

LAMMPS

The 2D WCA bond-breaking model driven by LAMMPS instead of the internal engine.

Tutorial source

CP2K

A small hydrogen bond-breaking example using CP2K for the dynamics.

Tutorial source

OpenMM

RETIS for an argon model with OpenMM providing the molecular dynamics.

Tutorial source

Compiled extensions

C and FORTRAN extensions for custom integrators, potentials and order parameters.

Tutorial source

Molecular dynamics

pyretisrun MD

Plain molecular dynamics from an input file and from the PyRETIS Python API.

Tutorial source

Flux paths

Forward and backward MD utilities for generating path-sampling starting points.

Tutorial source