Files
lammps/doc/pair_body_rounded_polygon.txt

108 lines
3.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_style body/rounded/polygon command :h3
[Syntax:]
pair_style body/rounded/polygon cutoff_global cutoff_inner delta_ua c_n :pre
cutoff_global = global cutoff for COM interactions (distance units)
cutoff_inner = cutoff for vertex-vertex and vertex-edge interactions (distance units)
delta_ua = characteristic contact length (distance units)
c_n = normal friction coefficient (energy time/distance^2) :ul
[Examples:]
pair_style body/rounded/polygon 6.0 0.5 0.5 0.1
pair_coeff 1 1 1.0 100.0 12.0 :pre
[Description:]
Style {body/rounded/polygon} implements the pairwise body/body
interactions between 2D convex polygons, as described
in "Fraige"_#Fraige. This pair style is designed for use with
the "rounded/polygon" body style, which is specified as
an argument to the "atom-style body/rounded/polygon" command.
See the "body"_body.html doc page for more details about the body
styles LAMMPS supports.
The "rounded/polygon" style treats a body particle as a discrete
element model (DEM) polygon composed of N vertices.
The coordinates of a body particle are its center-of-mass (COM).
The initial position of the vertices are specified the data file.
The current implementation follows the multiple contact points model as
described in "Fraige"_#Fraige, but neglects and the contact history
the tangential contact forces for now.
The parameters {delta_ua} and {c_n} are the characteristic contact length
and the normal friction coefficient, respectively. See Eqs. (1) and (5)
in "Fraige"_#Fraige for more details.
For style {body/rounded/polygon}, the following coefficients
must be defined for each pair of atoms types via the "pair_coeff"_pair_coeff.html
command as in the examples above:
sigma = vertex rounded diameter (distance units)
k_n = normal repulsion strength (energy/distance^2)
k_na = normal attraction strength (energy/distance^2)
cutoff = cutoff for COM interactions (distance units) :ul
The last parameter is optional. If not specified, the global
cutoff specified in the pair_style command is used.
Note that the current implementation assumes that the edge length
of the polygons (L) should be at least twice greater than
the vertex rounded radius (sigma) so as to distinguish vertex-vertex from
vertex-edge contacts.
NOTE: Because this pair style requires the body velocities to compute
the friction component of the forces, users should specify
{comm_modify vel yes} in the input script with this pair style.
:line
[Mixing, shift, table, tail correction, restart, rRESPA info]:
For atom type pairs I,J and I != J, the epsilon and sigma coefficients
and cutoff distance for all of this pair style can be mixed. The
default mix value is {geometric}. See the "pair_modify" command for
details.
This pair style does not support the "pair_modify"_pair_modify.html
shift, table, and tail options.
This pair style does not write its information to "binary restart
files"_restart.html.
This pair style can only be used via the {pair} keyword of the
"run_style respa"_run_style.html command. It does not support the
{inner}, {middle}, {outer} keywords.
:line
[Restrictions:]
This style is part of the BODY package. It is only enabled if LAMMPS
was built with that package. See the "Making
LAMMPS"_Section_start.html#2_3 section for more info.
Defining particles to be bodies so they participate in body/body or
body/particle interactions requires the use of the "atom_style
body"_atom_style.html command.
[Related commands:]
"pair_coeff"_pair_coeff.html
[Default:] none
:link(Fraige)
[(Fraige)] F. Y. Fraige, P. A. Langston, A. J. Matchett, J. Dodds,
Particuology, 6, 455 (2008).