2006-09-22 00:22:34 +08:00
|
|
|
<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>
|
2008-02-20 05:47:37 +08:00
|
|
|
<UL><LI>I,J = atom types (see asterisk form below)
|
2006-09-22 00:22:34 +08:00
|
|
|
<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>
|
2008-02-20 05:47:37 +08:00
|
|
|
<P>A wild-card asterisk can be used in place of or in conjunction with the
|
2006-09-22 00:22:34 +08:00
|
|
|
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
|
2008-02-20 05:47:37 +08:00
|
|
|
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
|
2006-09-22 00:22:34 +08:00
|
|
|
(inclusive). Note that only type pairs with I <= J are considered; if
|
2008-02-20 05:47:37 +08:00
|
|
|
asterisks imply type pairs where J < I, they are ignored.
|
2006-09-22 00:22:34 +08:00
|
|
|
</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 =
|
2008-02-20 05:47:37 +08:00
|
|
|
the number of atom types. For this reason, the wild-card asterisk
|
2006-09-22 00:22:34 +08:00
|
|
|
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>
|
2007-06-20 20:56:17 +08:00
|
|
|
<P>For many potentials, if coefficients for type pairs with I != J are
|
2008-02-20 05:47:37 +08:00
|
|
|
not set explicitly by a pair_coeff command, the values are inferred
|
2007-06-20 20:56:17 +08:00
|
|
|
from the I,I and J,J settings by mixing rules; see the
|
2007-06-25 22:36:36 +08:00
|
|
|
<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.
|
2006-09-22 00:22:34 +08:00
|
|
|
</P>
|
|
|
|
|
<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>
|
2009-11-05 06:12:52 +08:00
|
|
|
<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
|
2007-10-03 05:55:02 +08:00
|
|
|
</UL>
|
2007-06-25 22:36:36 +08:00
|
|
|
<UL><LI><A HREF = "pair_airebo.html">pair_style airebo</A> - AI-REBO potential
|
2009-06-05 00:56:59 +08:00
|
|
|
<LI><A HREF = "pair_born.html">pair_style born/coul/long</A> - Born-Mayer-Huggins with long-range Coulomb
|
2007-06-25 22:36:36 +08:00
|
|
|
<LI><A HREF = "pair_buck.html">pair_style buck</A> - Buckingham potential
|
2008-02-20 05:47:37 +08:00
|
|
|
<LI><A HREF = "pair_buck.html">pair_style buck/coul/cut</A> - Buckingham with cutoff Coulomb
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_buck.html">pair_style buck/coul/long</A> - Buckingham with long-range Coulomb
|
2007-06-20 20:56:17 +08:00
|
|
|
<LI><A HREF = "pair_colloid.html">pair_style colloid</A> - integrated colloidal potential
|
2007-10-03 05:55:02 +08:00
|
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/cut</A> - cutoff Coulombic potential
|
2008-02-20 05:47:37 +08:00
|
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/debye</A> - cutoff Coulombic potential with Debye screening
|
2007-10-03 05:55:02 +08:00
|
|
|
<LI><A HREF = "pair_coul.html">pair_style coul/long</A> - long-range Coulombic potential
|
2008-10-01 23:02:48 +08:00
|
|
|
<LI><A HREF = "pair_dipole.html">pair_style dipole/cut</A> - point dipoles with cutoff
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_dpd.html">pair_style dpd</A> - dissipative particle dynamics (DPD)
|
2009-11-07 01:05:06 +08:00
|
|
|
<LI><A HREF = "pair_dsmc.html">pair_style dsmc</A> - Direct Simulation Monte Carlo (DSMC)
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_eam.html">pair_style eam</A> - embedded atom method (EAM)
|
2007-10-03 05:55:02 +08:00
|
|
|
<LI><A HREF = "pair_eam.html">pair_style eam/opt</A> - optimized version of EAM
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_eam.html">pair_style eam/alloy</A> - alloy EAM
|
2008-01-19 02:16:21 +08:00
|
|
|
<LI><A HREF = "pair_eam.html">pair_style eam/alloy/opt</A> - optimized version of alloy EAM
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_eam.html">pair_style eam/fs</A> - Finnis-Sinclair EAM
|
2008-01-19 02:16:21 +08:00
|
|
|
<LI><A HREF = "pair_eam.html">pair_style eam/fs/opt</A> - optimized version of Finnis-Sinclair EAM
|
2007-04-20 07:25:27 +08:00
|
|
|
<LI><A HREF = "pair_gayberne.html">pair_style gayberne</A> - Gay-Berne ellipsoidal potential
|
2009-08-13 00:45:55 +08:00
|
|
|
<LI><A HREF = "pair_gayberne.html">pair_style gayberne/gpu</A> - GPU-enabled Gay-Berne ellipsoidal potential
|
2009-01-09 08:14:52 +08:00
|
|
|
<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
|
2007-02-10 05:37:30 +08:00
|
|
|
<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
|
2007-10-03 05:55:02 +08:00
|
|
|
<LI><A HREF = "pair_charmm.html">pair_style lj/charmm/coul/long/opt</A> - optimized version of CHARMM with long-range Coulomb
|
2007-02-10 05:37:30 +08:00
|
|
|
<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
|
2009-08-13 00:45:55 +08:00
|
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/gpu</A> - GPU-enabled version of cutoff LJ
|
2007-10-03 05:55:02 +08:00
|
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/opt</A> - optimized version of cutoff LJ
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/cut</A> - LJ with cutoff Coulomb
|
2008-02-20 05:47:37 +08:00
|
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/debye</A> - LJ with Debye screening added to Coulomb
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/long</A> - LJ with long-range Coulomb
|
|
|
|
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/coul/long/tip4p</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
|
2008-05-16 04:48:06 +08:00
|
|
|
<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
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_lj_smooth.html">pair_style lj/smooth</A> - smoothed Lennard-Jones potential
|
2009-08-11 04:13:44 +08:00
|
|
|
<LI><A HREF = "pair_lj96_cut.html">pair_style lj96/cut</A> - Lennard-Jones 9/6 potential
|
2007-10-12 07:52:34 +08:00
|
|
|
<LI><A HREF = "pair_lubricate.html">pair_style lubricate</A> - hydrodynamic lubrication forces
|
2007-02-10 05:37:30 +08:00
|
|
|
<LI><A HREF = "pair_meam.html">pair_style meam</A> - modified embedded atom method (MEAM)
|
|
|
|
|
<LI><A HREF = "pair_morse.html">pair_style morse</A> - Morse potential
|
2008-01-19 02:16:21 +08:00
|
|
|
<LI><A HREF = "pair_morse.html">pair_style morse/opt</A> - optimized version of Morse potential
|
2008-07-24 07:26:28 +08:00
|
|
|
<LI><A HREF = "pair_peri_pmb.html">pair_style peri/pmb</A> - peridynamic PMB potential
|
2009-02-07 00:12:07 +08:00
|
|
|
<LI><A HREF = "pair_reax.html">pair_style reax</A> - ReaxFF potential
|
2007-10-23 05:43:55 +08:00
|
|
|
<LI><A HREF = "pair_resquared.html">pair_style resquared</A> - Everaers RE-Squared ellipsoidal potential
|
2007-02-10 05:37:30 +08:00
|
|
|
<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
|
2009-11-07 06:39:50 +08:00
|
|
|
<LI><A HREF = "pair_tersoff_zbl.html">pair_style tersoff/zbl</A> - Tersoff/ZBL 3-body potential
|
2009-11-07 05:01:28 +08:00
|
|
|
<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
|
2006-09-22 00:22:34 +08:00
|
|
|
</UL>
|
2007-10-03 06:56:45 +08:00
|
|
|
<P>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#3_5">this
|
|
|
|
|
page</A>.
|
|
|
|
|
</P>
|
2006-09-22 00:22:34 +08:00
|
|
|
<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>
|
