diff --git a/doc/src/pair_style.rst b/doc/src/pair_style.rst index f2afe959f3..f90a718d95 100644 --- a/doc/src/pair_style.rst +++ b/doc/src/pair_style.rst @@ -67,20 +67,34 @@ If the pair_style command has a cutoff argument, it sets global cutoffs for all pairs of atom types. The distance(s) can be smaller or larger than the dimensions of the simulation box. -Typically, the global cutoff value can be overridden for a specific -pair of atom types by the :doc:`pair_coeff ` command. The -pair style settings (including global cutoffs) can be changed by a -subsequent pair_style command using the same style. This will reset -the cutoffs for all atom type pairs, including those previously set -explicitly by a :doc:`pair_coeff ` command. The exceptions -to this are that pair_style *table* and *hybrid* settings cannot be -reset. A new pair_style command for these styles will wipe out all -previously specified pair_coeff values. +In many cases, the global cutoff value can be overridden for a +specific pair of atom types by the :doc:`pair_coeff ` +command. + +If a new pair_style command is specified with a new style, all +previous :doc:`pair_coeff ` and :doc:`pair_modify +` command settings are erased; those commands must be +re-specified if necessary. + +If a new pair_style command is specified with the same style, then +only the global settings in that command are reset. Any previous +doc:`pair_coeff ` and :doc:`pair_modify ` +command settings are preserved. The only exception is that if the +global cutoff in the pair_style command is changed, it will override +the corresponding cutoff in any of the previous doc:`pair_modify +` commands. + +Two pair styles which do not follow this rule are the pair_style +*table* and *hybrid* commands. A new pair_style command for these +styles will wipe out all previously specified doc:`pair_coeff +` and :doc:`pair_modify ` settings, including +for the sub-styles of the *hybrid* command. ---------- Here is an alphabetic list of pair styles defined in LAMMPS. They are -also listed in more compact form on the :doc:`Commands pair ` doc page. +also listed in more compact form on the :doc:`Commands pair +` doc page. Click on the style to display the formula it computes, any additional arguments specified in the pair_style command, and coefficients