forked from lijiext/lammps
149 lines
5.7 KiB
Plaintext
149 lines
5.7 KiB
Plaintext
"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
|
|
|
|
:link(lws,http://lammps.sandia.gov)
|
|
:link(ld,Manual.html)
|
|
:link(lc,Section_commands.html#comm)
|
|
|
|
:line
|
|
|
|
pair_coeff command :h3
|
|
|
|
[Syntax:]
|
|
|
|
pair_coeff I J args :pre
|
|
|
|
I,J = atom types (see asterisk form below)
|
|
args = coefficients for one or more pairs of atom types :ul
|
|
|
|
[Examples:]
|
|
|
|
pair_coeff 1 2 1.0 1.0 2.5
|
|
pair_coeff 2 * 1.0 1.0
|
|
pair_coeff 3* 1*2 1.0 1.0 2.5
|
|
pair_coeff * * 1.0 1.0
|
|
pair_coeff * * nialhjea 1 1 2
|
|
pair_coeff * 3 morse.table ENTRY1
|
|
pair_coeff 1 2 lj/cut 1.0 1.0 2.5 (for pair_style hybrid) :pre
|
|
|
|
[Description:]
|
|
|
|
Specify the pairwise force field coefficients for one or more pairs of
|
|
atom types. The number and meaning of the coefficients depends on the
|
|
pair style. Pair coefficients can also be set in the data file read
|
|
by the "read_data"_read_data.html command or in a restart file.
|
|
|
|
I and J can be specified in one of two ways. Explicit numeric values
|
|
can be used for each, as in the 1st example above. I <= J is
|
|
required. LAMMPS sets the coefficients for the symmetric J,I
|
|
interaction to the same values.
|
|
|
|
A wildcard asterisk can be used in place of or in conjunction with the
|
|
I,J arguments to set the coefficients for multiple pairs of atom
|
|
types. This takes the form "*" or "*n" or "n*" or "m*n". If N = the
|
|
number of atom types, then an asterisk with no numeric values means all
|
|
types from 1 to N. A leading asterisk means all types from 1 to n
|
|
(inclusive). A trailing asterisk means all types from n to N
|
|
(inclusive). A middle asterisk means all types from m to n
|
|
(inclusive). Note that only type pairs with I <= J are considered; if
|
|
asterisks imply type pairs where J < I, they are ignored.
|
|
|
|
Note that a pair_coeff command can override a previous setting for the
|
|
same I,J pair. For example, these commands set the coeffs for all I,J
|
|
pairs, then overwrite the coeffs for just the I,J = 2,3 pair:
|
|
|
|
pair_coeff * * 1.0 1.0 2.5
|
|
pair_coeff 2 3 2.0 1.0 1.12 :pre
|
|
|
|
A line in a data file that specifies pair coefficients uses the exact
|
|
same format as the arguments of the pair_coeff command in an input
|
|
script, with the exception of the I,J type arguments. In each line of
|
|
the "Pair Coeffs" section of a data file, only a single type I is
|
|
specified, which sets the coefficients for type I interacting with
|
|
type I. This is because the section has exactly N lines, where N =
|
|
the number of atom types. For this reason, the wild-card asterisk
|
|
should also not be used as part of the I argument. Thus in a data
|
|
file, the line corresponding to the 1st example above would be listed
|
|
as
|
|
|
|
2 1.0 1.0 2.5 :pre
|
|
|
|
For many potentials, if coefficients for type pairs with I != J are
|
|
not set explicitly by a pair_coeff command, the values are inferred
|
|
from the I,I and J,J settings by mixing rules; see the
|
|
"pair_modify"_pair_modify.html command for a discussion. Details on
|
|
this option as it pertains to individual potentials are described on
|
|
the doc page for the potential.
|
|
|
|
Many pair styles, typically for many-body potentials, use tabulated
|
|
potential files as input, when specifying the pair_coeff command.
|
|
Potential files provided with LAMMPS are in the potentials directory
|
|
of the distribution. For some potentials, such as EAM, other archives
|
|
of suitable files can be found on the Web. They can be used with
|
|
LAMMPS so long as they are in the format LAMMPS expects, as discussed
|
|
on the individual doc pages.
|
|
|
|
When a pair_coeff command using a potential file is specified, LAMMPS
|
|
looks for the potential file in 2 places. First it looks in the
|
|
location specified. E.g. if the file is specified as "niu3.eam", it
|
|
is looked for in the current working directory. If it is specified as
|
|
"../potentials/niu3.eam", then it is looked for in the potentials
|
|
directory, assuming it is a sister directory of the current working
|
|
directory. If the file is not found, it is then looked for in the
|
|
directory specified by the LAMMPS_POTENTIALS environment variable.
|
|
Thus if this is set to the potentials directory in the LAMMPS distro,
|
|
then you can use those files from anywhere on your system, without
|
|
copying them into your working directory. Environment variables are
|
|
set in different ways for different shells. Here are example settings
|
|
for
|
|
|
|
csh, tcsh:
|
|
|
|
% setenv LAMMPS_POTENTIALS /path/to/lammps/potentials :pre
|
|
|
|
bash:
|
|
|
|
% export LAMMPS_POTENTIALS=/path/to/lammps/potentials :pre
|
|
|
|
Windows:
|
|
|
|
% set LAMMPS_POTENTIALS="C:\Path to LAMMPS\Potentials" :pre
|
|
|
|
:line
|
|
|
|
The alphabetic list of pair styles defined in LAMMPS is given on the
|
|
"pair_style"_pair_style.html doc page. They are also given in more
|
|
compact form in the pair section of "this
|
|
page"_Section_commands.html#cmd_5.
|
|
|
|
Click on the style to display the formula it computes, arguments
|
|
specified in the pair_style command, and coefficients specified by the
|
|
associated "pair_coeff"_pair_coeff.html command.
|
|
|
|
Note that there are also additional pair styles (not listed on the
|
|
"pair_style"_pair_style.html doc page) submitted by users which are
|
|
included in the LAMMPS distribution. The list of these with links to
|
|
the individual styles are given in the pair section of "this
|
|
page"_Section_commands.html#cmd_5.
|
|
|
|
There are also additional accelerated pair styles (not listed on the
|
|
"pair_style"_pair_style.html doc page) included in the LAMMPS
|
|
distribution for faster performance on CPUs and GPUs. The list of
|
|
these with links to the individual styles are given in the pair
|
|
section of "this page"_Section_commands.html#cmd_5.
|
|
|
|
:line
|
|
|
|
[Restrictions:]
|
|
|
|
This command must come after the simulation box is defined by a
|
|
"read_data"_read_data.html, "read_restart"_read_restart.html, or
|
|
"create_box"_create_box.html command.
|
|
|
|
[Related commands:]
|
|
|
|
"pair_style"_pair_style.html, "pair_modify"_pair_modify.html,
|
|
"read_data"_read_data.html, "read_restart"_read_restart.html,
|
|
"pair_write"_pair_write.html
|
|
|
|
[Default:] none
|