forked from lijiext/lammps
234 lines
14 KiB
HTML
234 lines
14 KiB
HTML
<HTML>
|
|
<CENTER><A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LAMMPS Documentation</A> - <A HREF = "Section_commands.html#comm">LAMMPS Commands</A>
|
|
</CENTER>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<HR>
|
|
|
|
<H3>pair_coeff command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>pair_coeff I J args
|
|
</PRE>
|
|
<UL><LI>I,J = atom types (see asterisk form below)
|
|
<LI>args = coefficients for one or more pairs of atom types
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>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>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>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 <A HREF = "read_data.html">read_data</A> command or in a restart file.
|
|
</P>
|
|
<P>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.
|
|
</P>
|
|
<P>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.
|
|
</P>
|
|
<P>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:
|
|
</P>
|
|
<PRE>pair_coeff * * 1.0 1.0 2.5
|
|
pair_coeff 2 3 2.0 1.0 1.12
|
|
</PRE>
|
|
<P>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
|
|
</P>
|
|
<PRE>2 1.0 1.0 2.5
|
|
</PRE>
|
|
<P>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
|
|
<A HREF = "pair_modify.html">pair_modify</A> command for a discussion. Details on
|
|
this option as it pertains to individual potentials are described on
|
|
the doc page for the potential.
|
|
</P>
|
|
<P>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.
|
|
</P>
|
|
<P>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
|
|
</P>
|
|
<PRE>csh, tcsh:
|
|
% setenv LAMMPS_POTENTIALS /path/to/lammps/potentials
|
|
</PRE>
|
|
<PRE>bash:
|
|
% export LAMMPS_POTENTIALS=/path/to/lammps/potentials
|
|
</PRE>
|
|
<PRE>Windows:
|
|
% set LAMMPS_POTENTIALS="C:\Path to LAMMPS\Potentials
|
|
</PRE>
|
|
<HR>
|
|
|
|
<P>Here is an alphabetic list of pair styles defined in LAMMPS. Click on
|
|
the style to display the formula it computes, arguments specified in
|
|
the pair_style command, and coefficients specified by the associated
|
|
<A HREF = "pair_coeff.html">pair_coeff</A> command.
|
|
</P>
|
|
<P>Note that there are also additional pair styles 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 <A HREF = "Section_commands.html#cmd_5">this
|
|
page</A>.
|
|
</P>
|
|
<P>There are also additional accelerated pair styles 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 <A HREF = "Section_commands.html#cmd_5">this page</A>.
|
|
</P>
|
|
<UL><LI><A HREF = "pair_hybrid.html">pair_style hybrid</A> - multiple styles of pairwise interactions
|
|
<LI><A HREF = "pair_hybrid.html">pair_style hybrid/overlay</A> - multiple styles of superposed pairwise interactions
|
|
</UL>
|
|
<UL><LI><A HREF = "pair_adp.html">pair_style adp</A> - angular dependent potential (ADP) of Mishin
|
|
<LI><A HREF = "pair_airebo.html">pair_style airebo</A> - AIREBO potential of Stuart
|
|
<LI><A HREF = "pair_beck.html">pair_style beck</A> - Beck potential
|
|
<LI><A HREF = "pair_body.html">pair_style body</A> - interactions between body particles
|
|
<LI><A HREF = "pair_bop.html">pair_style bop</A> - BOP potential of Pettifor
|
|
<LI><A HREF = "pair_born.html">pair_style born</A> - Born-Mayer-Huggins potential
|
|
<LI><A HREF = "pair_born.html">pair_style born/coul/long</A> - Born-Mayer-Huggins with long-range Coulombics
|
|
<LI><A HREF = "pair_born.html">pair_style born/coul/msm</A> - Born-Mayer-Huggins with long-range MSM Coulombics
|
|
<LI><A HREF = "pair_born.html">pair_style born/coul/wolf</A> - Born-Mayer-Huggins with Coulombics via Wolf potential
|
|
<LI><A HREF = "pair_brownian.html">pair_style brownian</A> - Brownian potential for Fast Lubrication Dynamics
|
|
<LI><A HREF = "pair_brownian.html">pair_style brownian/poly</A> - Brownian potential for Fast Lubrication Dynamics with polydispersity
|
|
<LI><A HREF = "pair_buck.html">pair_style buck</A> - Buckingham potential
|
|
<LI><A HREF = "pair_buck.html">pair_style buck/coul/cut</A> - Buckingham with cutoff Coulomb
|
|
<LI><A HREF = "pair_buck.html">pair_style buck/coul/long</A> - Buckingham with long-range Coulombics
|
|
<LI><A HREF = "pair_buck.html">pair_style buck/coul/msm</A> - Buckingham long-range MSM Coulombics
|
|
<LI><A HREF = "pair_buck.html">pair_style buck/long/coul/long</A> - long-range Buckingham with long-range Coulombics
|
|
<LI><A HREF = "pair_colloid.html">pair_style colloid</A> - integrated colloidal potential
|
|
<LI><A HREF = "pair_comb.html">pair_style comb</A> - charge-optimized many-body (COMB) potential
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/cut</A> - cutoff Coulombic potential
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/debye</A> - cutoff Coulombic potential with Debye screening
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/dsf</A> - Coulombics via damped shifted forces
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/long</A> - long-range Coulombic potential
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/msm</A> - long-range MSM Coulombics
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/wolf</A> - Coulombics via Wolf potential
|
|
<LI><A HREF = "pair_dipole.html">pair_style dipole/cut</A> - point dipoles with cutoff
|
|
<LI><A HREF = "pair_dpd.html">pair_style dpd</A> - dissipative particle dynamics (DPD)
|
|
<LI><A HREF = "pair_dpd.html">pair_style dpd/tstat</A> - DPD thermostatting
|
|
<LI><A HREF = "pair_dsmc.html">pair_style dsmc</A> - Direct Simulation Monte Carlo (DSMC)
|
|
<LI><A HREF = "pair_eam.html">pair_style eam</A> - embedded atom method (EAM)
|
|
<LI><A HREF = "pair_eam.html">pair_style eam/alloy</A> - alloy EAM
|
|
<LI><A HREF = "pair_eam.html">pair_style eam/fs</A> - Finnis-Sinclair EAM
|
|
<LI><A HREF = "pair_eim.html">pair_style eim</A> - embedded ion method (EIM)
|
|
<LI><A HREF = "pair_gauss.html">pair_style gauss</A> - Gaussian potential
|
|
<LI><A HREF = "pair_gayberne.html">pair_style gayberne</A> - Gay-Berne ellipsoidal potential
|
|
<LI><A HREF = "pair_gran.html">pair_style gran/hertz/history</A> - granular potential with Hertzian interactions
|
|
<LI><A HREF = "pair_gran.html">pair_style gran/hooke</A> - granular potential with history effects
|
|
<LI><A HREF = "pair_gran.html">pair_style gran/hooke/history</A> - granular potential without history effects
|
|
<LI><A HREF = "pair_hbond_dreiding.html">pair_style hbond/dreiding/lj</A> - DREIDING hydrogen bonding LJ potential
|
|
<LI><A HREF = "pair_hbond_dreiding.html">pair_style hbond/dreiding/morse</A> - DREIDING hydrogen bonding Morse potential
|
|
<LI><A HREF = "pair_kim.html">pair_style kim</A> - interface to potentials provided by KIM project
|
|
<LI><A HREF = "pair_lcbop.html">pair_style lcbop</A> - long-range bond-order potential (LCBOP)
|
|
<LI><A HREF = "pair_line_lj.html">pair_style line/lj</A> - LJ potential between line segments
|
|
<LI><A HREF = "pair_charmm.html">pair_style lj/charmm/coul/charmm</A> - CHARMM potential with cutoff Coulomb
|
|
<LI><A HREF = "pair_charmm.html">pair_style lj/charmm/coul/charmm/implicit</A> - CHARMM for implicit solvent
|
|
<LI><A HREF = "pair_charmm.html">pair_style lj/charmm/coul/long</A> - CHARMM with long-range Coulomb
|
|
<LI><A HREF = "pair_charmm.html">pair_style lj/charmm/coul/msm</A> - CHARMM with long-range MSM Coulombics
|
|
<LI><A HREF = "pair_class2.html">pair_style lj/class2</A> - COMPASS (class 2) force field with no Coulomb
|
|
<LI><A HREF = "pair_class2.html">pair_style lj/class2/coul/cut</A> - COMPASS with cutoff Coulomb
|
|
<LI><A HREF = "pair_class2.html">pair_style lj/class2/coul/long</A> - COMPASS with long-range Coulomb
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut</A> - cutoff Lennard-Jones potential with no Coulomb
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/cut</A> - LJ with cutoff Coulomb
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/debye</A> - LJ with Debye screening added to Coulomb
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/dsf</A> - LJ with Coulombics via damped shifted forces
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/long</A> - LJ with long-range Coulombics
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/msm</A> - LJ with long-range MSM Coulombics
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/tip4p/cut</A> - LJ with cutoff Coulomb for TIP4P water
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/tip4p/long</A> - LJ with long-range Coulomb for TIP4P water
|
|
<LI><A HREF = "pair_lj_expand.html">pair_style lj/expand</A> - Lennard-Jones for variable size particles
|
|
<LI><A HREF = "pair_gromacs.html">pair_style lj/gromacs</A> - GROMACS-style Lennard-Jones potential
|
|
<LI><A HREF = "pair_gromacs.html">pair_style lj/gromacs/coul/gromacs</A> - GROMACS-style LJ and Coulombic potential
|
|
<LI><A HREF = "pair_lj_long.html">pair_style lj/long/coul/long</A> - long-range LJ and long-range Coulombics
|
|
<LI><A HREF = "pair_lj_long.html">pair_style lj/long/tip4p/long</A> - long-range LJ and long-range Coulomb for TIP4P water
|
|
<LI><A HREF = "pair_lj_smooth.html">pair_style lj/smooth</A> - smoothed Lennard-Jones potential
|
|
<LI><A HREF = "pair_lj_smooth_linear.html">pair_style lj/smooth/linear</A> - linear smoothed Lennard-Jones potential
|
|
<LI><A HREF = "pair_lj96.html">pair_style lj96/cut</A> - Lennard-Jones 9/6 potential
|
|
<LI><A HREF = "pair_lubricate.html">pair_style lubricate</A> - hydrodynamic lubrication forces
|
|
<LI><A HREF = "pair_lubricate.html">pair_style lubricate/poly</A> - hydrodynamic lubrication forces with polydispersity
|
|
<LI><A HREF = "pair_lubricateU.html">pair_style lubricateU</A> - hydrodynamic lubrication forces for Fast Lubrication Dynamics
|
|
<LI><A HREF = "pair_lubricateU.html">pair_style lubricateU/poly</A> - hydrodynamic lubrication forces for Fast Lubrication with polydispersity
|
|
<LI><A HREF = "pair_meam.html">pair_style meam</A> - modified embedded atom method (MEAM)
|
|
<LI><A HREF = "pair_mie.html">pair_style mie/cut</A> - Mie potential
|
|
<LI><A HREF = "pair_morse.html">pair_style morse</A> - Morse potential
|
|
<LI><A HREF = "pair_peri.html">pair_style peri/lps</A> - peridynamic LPS potential
|
|
<LI><A HREF = "pair_peri.html">pair_style peri/pmb</A> - peridynamic PMB potential
|
|
<LI><A HREF = "pair_reax.html">pair_style reax</A> - ReaxFF potential
|
|
<LI><A HREF = "pair_airebo.html">pair_style rebo</A> - 2nd generation REBO potential of Brenner
|
|
<LI><A HREF = "pair_resquared.html">pair_style resquared</A> - Everaers RE-Squared ellipsoidal potential
|
|
<LI><A HREF = "pair_soft.html">pair_style soft</A> - Soft (cosine) potential
|
|
<LI><A HREF = "pair_sw.html">pair_style sw</A> - Stillinger-Weber 3-body potential
|
|
<LI><A HREF = "pair_table.html">pair_style table</A> - tabulated pair potential
|
|
<LI><A HREF = "pair_tersoff.html">pair_style tersoff</A> - Tersoff 3-body potential
|
|
<LI><A HREF = "pair_tersoff_zbl.html">pair_style tersoff/zbl</A> - Tersoff/ZBL 3-body potential
|
|
<LI><A HREF = "pair_tri_lj.html">pair_style tri/lj</A> - LJ potential between triangles
|
|
<LI><A HREF = "pair_yukawa.html">pair_style yukawa</A> - Yukawa potential
|
|
<LI><A HREF = "pair_yukawa_colloid.html">pair_style yukawa/colloid</A> - screened Yukawa potential for finite-size particles
|
|
</UL>
|
|
<HR>
|
|
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P>This command must come after the simulation box is defined by a
|
|
<A HREF = "read_data.html">read_data</A>, <A HREF = "read_restart.html">read_restart</A>, or
|
|
<A HREF = "create_box.html">create_box</A> command.
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "pair_style.html">pair_style</A>, <A HREF = "pair_modify.html">pair_modify</A>,
|
|
<A HREF = "read_data.html">read_data</A>, <A HREF = "read_restart.html">read_restart</A>,
|
|
<A HREF = "pair_write.html">pair_write</A>
|
|
</P>
|
|
<P><B>Default:</B> none
|
|
</P>
|
|
</HTML>
|