CAPSChain Assembly and Packing Suite

Theory · 5 methods

Integrators

What CAPS computes, as it computes it: the equation, its symbols with CAPS's defaults, when to use the method, the source file, the tests that check it, and any departure from the cited method.

Velocity Verlet

Positions and velocities advance together with half-step kicks around a full drift. The scheme is time-reversible and symplectic, so the energy of an unthermostatted run fluctuates without drifting when the time step is small enough.

$$\begin{gathered}v(t+\tfrac{1}{2}\Delta t) = v(t) + \frac{\Delta t}{2}\,\frac{F(t)}{m} \\ x(t+\Delta t) = x(t) + \Delta t\,v(t+\tfrac{1}{2}\Delta t) \\ v(t+\Delta t) = v(t+\tfrac{1}{2}\Delta t) + \frac{\Delta t}{2}\,\frac{F(t+\Delta t)}{m}\end{gathered}$$

Swope et al. 1982

SymbolMeaningIn CAPS
Δttime stepdt · 1 fs by default
Fforce from the force fieldField, else GAFF (C, H) or UFF
matomic massfrom the element or the data file

When to use it

Every molecular-dynamics run in CAPS. All-atom models with hydrogens need Δt ≤ 1 fs, or 2 fs with the bonds to hydrogen constrained (SHAKE/RATTLE or LINCS).

Source
core/src/dynamics.cpp
Tested by
Dynamics.NveConservesEnergy · Dynamics.SameSeedSameTrajectory
Departure from the reference
none

References

  1. Swope, W. C., Andersen, H. C., Berens, P. H., Wilson, K. R., "A computer simulation method for the calculation of equilibrium constants for the formation of physical clusters of molecules: application to small water clusters", J. Chem. Phys. 76, 637–649 (1982). doi:10.1063/1.442716

Multiple time steps (r-RESPA)

The forces are split into fast bonded terms and slow non-bonded ones. Each outer step kicks the velocities with half the slow force, then advances n inner velocity-Verlet steps with the bonded force alone, and closes with the second half kick of the slow force. The propagator is a symmetric Trotter factorisation, so the scheme stays time-reversible and symplectic while the costly non-bonded forces are evaluated n times less often.

$$e^{iL\Delta t} \approx e^{iL_{\mathrm{slow}}\,\Delta t/2}\,\left[e^{iL_{\mathrm{fast}}\,\delta t}\right]^{n}\,e^{iL_{\mathrm{slow}}\,\Delta t/2}, \qquad \delta t = \frac{\Delta t}{n}$$

Tuckerman, Berne & Martyna 1992

SymbolMeaningIn CAPS
Δtouter time stepDynamics · Δt
ninner steps per outer stepDynamics · r-RESPA (1 … 16)
δtinner time step the bonded forces seeΔt / n
L_fastLiouvillian of the bonded forces (bonds, angles, torsions, impropers)the force field's bonded terms
L_slowLiouvillian of the non-bonded forces (Lennard-Jones, Coulomb)the force field's pair terms

When to use it

Long runs of all-atom models without bond constraints: a 2–4 fs outer step with a 0.5–1 fs inner step keeps the fast C–H stretches resolved. It is an alternative to constraining the bonds (SHAKE/RATTLE, LINCS), not used together with them; it runs with the Bussi thermostat or none, the barostats acting on the outer step.

Source
core/src/dynamics.cpp
Tested by
Dynamics.RespaConservesEnergyWithLongOuterSteps
Departure from the reference
none

References

  1. Tuckerman, M., Berne, B. J., Martyna, G. J., "Reversible multiple time scale molecular dynamics", J. Chem. Phys. 97, 1990–2001 (1992). doi:10.1063/1.463137

Electric field during MD

A uniform external field on the partial charges during Dynamics: poling of polar rubbers, field-driven ion drift, the dielectric response at finite field. The LAMMPS input carries the same field (fix efield).

$$\mathbf F_i = -\nabla_i U + q_i\,\mathbf E,\qquad 1\ e\cdot\mathrm{V/\AA} = 23.0605\ \mathrm{kcal\,mol^{-1}\,\AA^{-1}}$$

E in V/Å as LAMMPS real units; under periodic boundaries the field does work no potential accounts for, so the conserved energy drifts; a thermostat takes the heat out

SymbolMeaningIn CAPS
q_ipartial charge of atom ie
EfieldV/Å
F_i(U)force from the force fieldkcal/mol/Å

When to use it

Strong fields, 0.01–1 V/Å (10⁸–10¹⁰ V/m), so the response shows above the thermal noise in nanoseconds; follow the cell dipole with the dielectric analysis (linear response: ⟨M⟩ = ε₀ V (ε − 1) E).

Source
core/src/dynamics.cpp
Tested by
tests/test_dynamics.cpp Dynamics.ElectricFieldAcceleratesACharge (a +1 e atom at rest moves ½at² along E; a neutral one stays)
Departure from the reference
no electronic polarisation (fixed charges)

Atoms held along some axes

Fixed atoms can be held along chosen axes only: a substrate held along z slides in its plane but cannot leave it; the held coordinates feel no force and keep no velocity in Relax, Dynamics and Equilibrate.

$$F_{i,k} = 0,\quad v_{i,k} = 0\quad (k\ \text{held}),\qquad N_{\mathrm{dof}} = 3(N - N_{\mathrm{held}}) - N_{\mathrm{coord}}$$

the held molecule always holds every coordinate; GROMACS: the group FrozenAxes with freezedim, VASP: selective dynamics per coordinate

SymbolMeaningIn CAPS
N_heldatoms held entirely—
N_coordsingle coordinates held—

When to use it

A fibre or filler surface allowed to relax in its plane but kept from drifting through the film; a wall that may breathe laterally; chain ends kept on a plane.

Source
core/src/dynamics.cpp
Tested by
tests/test_dynamics.cpp Dynamics.PartlyHeldAtoms (z held exactly while x and y move; a held x through a minimisation)
Departure from the reference
momentum is not conserved with held coordinates: the temperature counts the free coordinates

Rigid bodies in LAMMPS runs

Chosen molecules — filler particles, a rigid additive — move as rigid bodies in the LAMMPS files: their atoms keep their relative positions, the pairs inside a body are not computed, and the bodies have their own thermostat; the other atoms integrate as usual and an NPT barostat dilates only them.

$$M\,\ddot{\mathbf R} = \sum_i \mathbf F_i,\qquad \frac{d\mathbf L}{dt} = \sum_i (\mathbf r_i - \mathbf R)\times \mathbf F_i$$

LAMMPS fix rigid/nvt/small molecule (each molecule one body, Nosé–Hoover chains on the bodies; LAMMPS takes the bodies' constrained degrees of freedom out of the temperature); neigh_modify exclude molecule/intra; fix npt … dilate mobile

SymbolMeaningIn CAPS
R, Mcentre of mass and mass of a bodyÅ, g/mol
Lits angular momentum—
N_bodiesrigid bodies—

When to use it

Silica or carbon-black particles in a rubber matrix whose internal vibrations do not matter: longer time steps for the matrix are not affected, but the filler's thousands of internal bonds and pairs drop out of the cost.

Source
core/src/lammps_data.cpp
Tested by
tests/test_relax.cpp LammpsData.RigidBodiesBeforeTheBarostat (the group, the exclusion, the rigid fix before the barostat, velocities for the bodies; a held molecule never rigid); run in LAMMPS: 2 bodies of the polystyrene sample, 200 NPT steps
Departure from the reference
CAPS's own runs have no rigid-body integrator: there the molecules move as atoms (or hold them)