Skip to content

force_evaluation

Composable force evaluation independent of integration policy.

import mlx_atomistic.force_evaluation

class ForceTerm(Protocol)

Protocol for composable force terms.

Methods

def energy_forces(positions: mx.array, cell: Cell | None = None, pairs: object | None = None) -> tuple[mx.array, mx.array]

Return potential energy and forces.

Parameters

NameTypeDefaultDescription
positionsmx.arrayParticle coordinates, shape (n_particles, 3).
cellCell | NoneNoneOptional periodic cell for minimum-image distances. Defaults to None.
pairsobject | NoneNoneOptional precomputed neighbor/pair structure. Defaults to None.

Returns

  • tuple[mx.array, mx.array] — An (energy, forces) tuple: scalar potential energy and forces of shape (n_particles, 3).