> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/cuda/cupotential/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/cuda/cupotential/_mcp/server.

# OpenMM plugin changelog

> Release history for the cuPotential OpenMM plugin.

## 0.3.5

* Updated the SETTLE and SHAKE constraint solvers and Langevin integration
  kernels in `LangevinMiddleIntegrator`.
* Mixed-precision integration uses native double precision on GPUs with fast
  FP64 support and float-float arithmetic on other GPUs. Override the automatic
  choice with `CUPO_PLUGIN_MIXED_COMPUTE=double` or
  `CUPO_PLUGIN_MIXED_COMPUTE=fltflt`.
* Other Python threads can now run while `LangevinMiddleIntegrator.step()`
  advances the simulation.
* Further `NonbondedForce` performance improvements.
* Fixed reciprocal-space exclusion corrections for distant exception pairs
  in triclinic boxes. They now use the same periodic image as the exception
  interaction.
* Built with CUDA 13.4; requires NVIDIA driver R615 or newer. Supported data
  center GPUs can use older drivers with CUDA 13.4's forward compatibility
  package. See [Installation requirements](/cuda/cupotential/install#requirements).

## 0.3.4

* The pip wheel now requires `openmm[cuda13]>=8.4,<8.5`, matching the OpenMM
  series it is built against. The conda package already requires
  `openmm >=8.4,<8.5`. In a virtual environment with a different PyPI OpenMM
  version, installing the wheel updates both OpenMM and OpenMM-CUDA-13 to 8.4.
  An existing conda OpenMM 8.4 installation satisfies the requirement.
* Added support for triclinic boxes under the standard reduced lattice convention.
* Improved `NonbondedForce` performance and added support for custom expressions
  directly in the force, without a separate `CustomNonbondedForce`.
* Added global parameters and particle/exception offsets that can be updated in
  an existing `Context`. Native LJ tails follow effective parameters by default; use
  `setDispersionCorrectionFollowsParameters(False)` for stock OpenMM's policy.
* Added native and custom paths for LJPME with independently configured Coulomb and
  dispersion lattice terms using either Ewald or Prolate (default) splitting.
* Physical Coulomb/LJ exceptions now default to nonperiodic distances (`False`),
  matching OpenMM. Conversion preserves the source flag and no longer requires
  `setExceptionsUsePeriodicBoundaryConditions(True)`. In the plugin, this flag
  controls only the physical splitting-independent contribution. Stock OpenMM
  also applies the flag to reciprocal-space exclusion corrections. With `False`,
  results can therefore differ for exception pairs whose raw and periodically wrapped
  distances differ, such as some NBFix constructions across a periodic boundary.
* Fixed exception mapping after atom reordering in systems that enable OpenMM's
  atom-reordering machinery, such as those mixing plugin `NonbondedForce` with
  stock OpenMM `NonbondedForce` or `CustomNonbondedForce` terms using a cutoff.
* Improved FP32 Ewald Coulomb exclusion-energy accuracy in custom interactions
  and reference calculations.
* Added XML serialization and cloning for plugin forces, integrators, and
  barostats. Object access and deserialization preserve plugin Python types and
  ownership; thermodynamic getters return quantities with units. `NonbondedForce`
  XML uses schema version 2 and rejects older formats.
* Binary checkpoints now preserve the plugin integrator's random number generator
  state, enabling exact NVT continuation. NPT restart is supported with stock and
  plugin components, but exact NPT replay is not guaranteed because barostat
  bookkeeping follows OpenMM semantics.
* Added a self-contained TYK2 RBFE alchemical sample combining stock PME and custom
  softcore LJ in one plugin force in `samples/alchemical/sample.py`.
  This functionality is experimental, and the API may change in future releases.
* Added explicit Coulomb and dispersion lattice definitions and selectable cutoff
  tail corrections (`NoTail` / `HomogeneousTail`).

## 0.3.3

* Switched prolate electrostatics to the C2 Prolate splitting with refitted C2O3
  spreading and calibrated grid sizing.
* Retired legacy C0 prolate implementations and bandwidth tables.

## 0.3.2

* Additional performance improvements for `NonbondedForce`.

## 0.3.1

* `NonbondedForce` now requires `setExceptionsUsePeriodicBoundaryConditions(True)`
  on the source force and rejects conversion otherwise, to match its minimum-image
  evaluation of exceptions.
* `LangevinMiddleIntegrator` now supports virtual sites (e.g. TIP4P water models).
* `NonbondedForce` now rejects triclinic boxes. Previously, it discarded the
  off-diagonal box components and evaluated a rectangular cell.
* Fixed pressure unit conversion in `MonteCarloBarostat`. Previously, a pressure
  of `1.0*unit.bar` reached the barostat as `1e-25` because it was converted to MD
  units rather than bar.