energy

Calculate simple bond, angle, dihedral, and non-bonded energy terms (no PME).

energy [<name>] [<mask1>] [out <filename>] [nobondstoh] [openmm [<mdopts>]] 
   [bond] [angle] [dihedral] {[nb14]|[e14]|[v14]} {[nonbond]|[elec] [vdw]} 
   [{nokinetic|kinetic [ketype {vel|vv}] [dt <dt>]}] 
   [ etype { simple | directsum [npoints <N>] | ewald [cut <cutoff>] 
      [dsumtol <dtol>] [ewcoeff <coeff>] [erfcdx <dx>] [skinnb <skinnb>] 
      [ljswidth <width>] [rsumtol <rtol>] [maxexp <max>] 
      [mlimits <X>,<Y>,<Z>] | pme [cut <cutoff>] 
      [dsumtol <dtol>] [ewcoeff <coeff>] [erfcdx <dx>] [skinnb <skinnb>] 
      [ljswidth <width>] [order <order>] [nfft <nfft1>,<nfft2>,<nfft3>] 
      [ljpme [ewcoefflj <ljcoeff>]] } ]

[<name>] Data set name.
[<mask1>] Mask of atoms to calculate energy for.
[out <filename>] File to write results to.
[nobondstoh] Skip calculating the energy of bonds to hydrogen.
[bond] Calculate bond energy.
[openmm] If specified and CPPTRAJ is compiled with OpenMM support, use OpenMM to calculate energy.
Note: this will only calculate total energy; any keywords pertaining to individual energy components are not available. For a list of potential options that can be used with ‘openmm’ see emin
[angle] Calculate angle energy.
[dihedral] Calculate dihedral energy.
[nb14] Calculate nonbonded 1-4 energy.
[e14] Calculate 1-4 electrostatics.
[v14] Calculate 1-4 van der Waals.
[nonbond] Calculate nonbonded energy (electrostatics and van der Waals).
[elec] Calculate electrostatic energy.
[vdw] Calculate van der Waals energy.
[nokinetic] Do not calculate kinetic energy even if velocity/force information present.
[kinetic] Attempt to calculate kinetic energy. Requires force and/or velocity information.
ketype {vel|vv} Specify kinetic energy type. If not specified, if velocity and force information use a velocity verlet-type calculation (vv), i.e. assume velocities are a half-step ahead of the forces. If only velocity information is present, calculate from on-step velocities (vel).
dt <dt> Time step for vv calculation in ps.
[etype <type>] Calculate electrostatics via specified type.
[simple] Use simple Coulomb term for electrostatics, no cutoff.
[directsum] Use direct summation method for electrostatics.
[npoints <N>] Number of cells in each direction to calculate the direct sum.
[ewald] Use Ewald summation for electrostatics. If van der Waals energy will be calculated a long-range correction for periodicity will be applied.
cut <cutoff> Direct space cutoff in Angstroms (default 8.0).
dsumtol <dtol> Direct sum tolerance (default 0.00001). Used to determine Ewald coefficient.
rsumtol <rtol> Reciprocal sum tolerance (default 0.00005). Used to determine number of reciprocal space vectors.
ewcoeff <coeff> Ewald coefficient in 1/Ang.
skinnb Used to determine pairlist atoms (added to cut, so pairlist cutoff is cut + skinnb); included in order to maintain consistency with results from sander.
mlimits <X>,<Y>,<Z> Explicitly set the number of reciprocal space vectors in each dimension.
[pme] Use particle mesh Ewald for electrostatics. If van der Waals energy will be calculated a long-range correction for periodicity will be applied.
cut <cutoff> Direct space cutoff in Angstroms (default 8.0).
dsumtol <dtol> Direct sum tolerance (default 0.00001). Used to determine Ewald coefficient.
ewcoe<coe> Ewald coefficient in 1/Ang.
erfcdx <dx> Spacing to use for the ERFC splines (default 0.0002 Ang.).
skinnb Used to determine pairlist atoms (added to cut, so pairlist cutoff is cut + skinnb); included in order to maintain consistency with results from sander.
ljswidth <width> If specified, use a force-switching form for the Lennard-Jones calculation from <cutoff>-<width> to <cutoff>.
order <order> Spline order for charges.
nfft <nt1>,<nt2>,<nt3> Explicitly set the number of FFT grid points in each dimension. Will be determined automatically if not specified.
ljpme If specified use particle mesh Ewald for calculating Lennard-Jones interactions.
ewcoej Ewald coefficient for Lennard-Jones PME (implies ljpme)

DataSet Aspects:
[bond] Bond energy.
[angle] Angle energy.
[dih] Dihedral energy.
[vdw14] 1-4 van der Waals energy.
[elec14] 1-4 electrostatic energy.
[vdw] van der Waals energy.
[elec] Electrostatic energy.
[total] Total energy.

Calculate the energy for atoms in <mask>. If no terms are specified, all terms are calculated. Note that the nonbonded energy terms for ’simple’ do not take into account periodicity and there is no distance cut-off. Electrostatics can also be determined via the direct sum, Ewald, or particle-mesh Ewald summation procedures. The particle
mesh Ewald functionality requires that CPPTRAJ be compiled with FFTW and a C++11 compliant compiler.

Calculation of energy terms requires that the associated topology file have parameters for any of the calculated terms, so for example angle calculations are not possible when using a PDB file as a topology, etc. All nonbonded calculations methods other than simple require unit cell parameters.

For example, to calculate all energy terms and write to a Grace-format file:

parm DPDP.parm7
trajin DPDP.nc
energy DPDP out ene.agr