\(\renewcommand{\AA}{\text{Å}}\)

bond_style command

Syntax

bond_style style args
  • style = none or zero or hybrid or bpm/rotational or bpm/spring or class2 or fene or fene/expand or fene/nm or gaussian or gromos or harmonic or harmonic/restrain harmonic/shift or harmonic/shift/cut or lepton or morse or nonlinear or oxdna/fene or oxdena2/fene or oxrna2/fene or quartic or special or table

  • args = none for any style except hybrid

    • hybrid args = list of one or more styles

Examples

bond_style harmonic
bond_style fene
bond_style hybrid harmonic fene

Description

Set the formula(s) LAMMPS uses to compute bond interactions between pairs of atoms. In LAMMPS, a bond differs from a pairwise interaction, which are set via the pair_style command. Bonds are defined between specified pairs of atoms and remain in force for the duration of the simulation (unless new bonds are created or existing bonds break, which is possible in some fixes and bond potentials). The list of bonded atoms is read in by a read_data or read_restart command from a data or restart file. By contrast, pair potentials are typically defined between all pairs of atoms within a cutoff distance and the set of active interactions changes over time.

Hybrid models where bonds are computed using different bond potentials can be setup using the hybrid bond style.

The coefficients associated with a bond style can be specified in a data or restart file or via the bond_coeff command.

All bond potentials store their coefficient data in binary restart files which means bond_style and bond_coeff commands do not need to be re-specified in an input script that restarts a simulation. See the read_restart command for details on how to do this. The one exception is that bond_style hybrid only stores the list of sub-styles in the restart file; bond coefficients need to be re-specified.

Note

When both a bond and pair style is defined, the special_bonds command often needs to be used to turn off (or weight) the pairwise interaction that would otherwise exist between 2 bonded atoms.

In the formulas listed for each bond style, r is the distance between the 2 atoms in the bond.


Here is an alphabetic list of bond styles defined in LAMMPS. Click on the style to display the formula it computes and coefficients specified by the associated bond_coeff command.

Click on the style to display the formula it computes, any additional arguments specified in the bond_style command, and coefficients specified by the associated bond_coeff command.

There are also additional accelerated pair styles included in the LAMMPS distribution for faster performance on CPUs, GPUs, and KNLs. The individual style names on the Commands bond doc page are followed by one or more of (g,i,k,o,t) to indicate which accelerated styles exist.

  • none - turn off bonded interactions

  • zero - topology but no interactions

  • hybrid - define multiple styles of bond interactions

  • bpm/rotational - breakable bond with forces and torques based on deviation from reference state

  • bpm/spring - breakable bond with forces based on deviation from reference length

  • class2 - COMPASS (class 2) bond

  • fene - FENE (finite-extensible non-linear elastic) bond

  • fene/expand - FENE bonds with variable size particles

  • fene/nm - FENE bonds with a generalized Lennard-Jones potential

  • gaussian - multicentered Gaussian-based bond potential

  • gromos - GROMOS force field bond

  • harmonic - harmonic bond

  • harmonic/restrain - harmonic bond to restrain to original bond distance

  • harmonic/shift - shifted harmonic bond

  • harmonic/shift/cut - shifted harmonic bond with a cutoff

  • lepton - bond potential from evaluating a string

  • mesocnt - Harmonic bond wrapper with parameterization presets for nanotubes

  • mm3 - MM3 anharmonic bond

  • morse - Morse bond

  • nonlinear - nonlinear bond

  • oxdna/fene - modified FENE bond suitable for DNA modeling

  • oxdna2/fene - same as oxdna but used with different pair styles

  • oxrna2/fene - modified FENE bond suitable for RNA modeling

  • quartic - breakable quartic bond

  • special - enable special bond exclusions for 1-5 pairs and beyond

  • table - tabulated by bond length


Restrictions

Bond styles can only be set for atom styles that allow bonds to be defined.

Most bond styles are part of the MOLECULE package. They are only enabled if LAMMPS was built with that package. See the Build package page for more info. The doc pages for individual bond potentials tell if it is part of a package.

Default

bond_style none