Integrator

class openmm.openmm.Integrator(*args, **kwargs)

An Integrator defines a method for simulating a System by integrating the equations of motion. This is an abstract class. Subclasses define particular integration methods.

Each Integrator object is bound to a particular Context which it integrates. This connection is specified by passing the Integrator as an argument to the constructor of the Context.

__init__(*args, **kwargs)

Methods

__init__(*args, **kwargs)

getConstraintTolerance(self)

Get the distance tolerance within which constraints are maintained, as a fraction of the constrained distance.

getIntegrationForceGroups(self)

Get which force groups to use for integration.

getStepSize(self)

Get the size of each time step, in picoseconds.

setConstraintTolerance(self, tol)

Set the distance tolerance within which constraints are maintained, as a fraction of the constrained distance.

setIntegrationForceGroups(groups)

Set which force groups to use for integration.

setStepSize(self, size)

Set the size of each time step, in picoseconds.

step(self, steps)

Advance a simulation through time by taking a series of time steps.

Attributes

thisown

The membership flag

property thisown

The membership flag

getStepSize(self) float

Get the size of each time step, in picoseconds. If this integrator uses variable time steps, the size of the most recent step is returned.

Returns:

the step size, measured in ps

Return type:

float

setStepSize(self, size)

Set the size of each time step, in picoseconds. If this integrator uses variable time steps, the effect of calling this method is undefined, and it may simply be ignored.

Parameters:

size (float) – the step size, measured in ps

getConstraintTolerance(self) float

Get the distance tolerance within which constraints are maintained, as a fraction of the constrained distance.

setConstraintTolerance(self, tol)

Set the distance tolerance within which constraints are maintained, as a fraction of the constrained distance.

step(self, steps)

Advance a simulation through time by taking a series of time steps.

Parameters:

steps (int) – the number of time steps to take

getIntegrationForceGroups(self) int

Get which force groups to use for integration. By default, all force groups are included. This is interpreted as a set of bit flags: the forces from group i will be included if (groups&(1<<i)) != 0.

setIntegrationForceGroups(groups)

Set which force groups to use for integration. By default, all force groups are included.

Parameters:

groups (set or int) – a set of indices for which force groups to include when integrating the equations of motion. Alternatively, the groups can be passed as a single unsigned integer interpreted as a bitmask, in which case group i will be included if (groups&(1<<i)) != 0.