diff --git a/doc/src/pair_body_rounded_polygon.txt b/doc/src/pair_body_rounded_polygon.txt index 5ef4a9104b..55bd8e51d4 100644 --- a/doc/src/pair_body_rounded_polygon.txt +++ b/doc/src/pair_body_rounded_polygon.txt @@ -18,8 +18,6 @@ mu = normal friction coefficient during gross sliding delta_ua = multiple contact scaling factor cutoff = global separation cutoff for interactions (distance units), see below for definition :pre -NOTE: what does gross sliding mean? - [Examples:] pair_style body/rounded/polygon 20.0 5.0 0.0 1.0 0.5 @@ -38,7 +36,7 @@ body particles. This pairwise interaction between rounded polygons is described in "Fraige"_#Fraige, where a polygon does not have sharp corners, but is rounded at its vertices by circles centered on each vertex with a -specified diameter. The edges of the polygon are defined bewteen +specified diameter. The edges of the polygon are defined between pairs of adjacent vertices. The circle diameter for each polygon is specified in the data file read by the "read data"_read_data.html command. This is a 2d discrete element model (DEM) which allows for @@ -47,7 +45,7 @@ multiple contact points. Note that when two particles interact, the effective surface of each polygon particle is displaced outward from each of its vertices and edges by half its circle diameter. The interaction forces and -energies bewteen two particles are defined with respect to the +energies between two particles are defined with respect to the separation of their respective rounded surfaces, not by the separation of the vertices and edges themselves. @@ -65,7 +63,15 @@ explains how contact is defined? Do we need an equation(s) that explain what the params in pair style and coeff mean, for damping and spring constants? Or do we just want to reference the paper for that? -NOTE: say something about no frictional history ? +In "Fraige"_#Fraige, the tangential friction force between two particles +that are in contact is modeled differently prior to gross sliding +(i.e. static friction) and during gross-sliding (kinetic friction). +The latter takes place when the tangential deformation exceeds +the Coulomb frictional limit. In the current implementation, however, +we do not take into account frictional history, i.e. we do not keep track +of how many time steps the two particles have been in contact +nor calculate the tangential deformation. We assume that gross sliding +takes place right when two particles are in contact. The following coefficients must be defined for each pair of atom types via the "pair_coeff"_pair_coeff.html command as in the examples above, diff --git a/doc/src/pair_body_rounded_polyhedron.txt b/doc/src/pair_body_rounded_polyhedron.txt index 81c69fdd62..5f43ebee63 100644 --- a/doc/src/pair_body_rounded_polyhedron.txt +++ b/doc/src/pair_body_rounded_polyhedron.txt @@ -16,9 +16,7 @@ c_n = normal damping coefficient c_t = tangential damping coefficient mu = normal friction coefficient during gross sliding delta_ua = multiple contact scaling factor -cutoff = global sepration cutoff for interactions (distance units), see below for definition :pre - -NOTE: what does gross sliding mean? +cutoff = global separation cutoff for interactions (distance units), see below for definition :pre [Examples:] @@ -39,16 +37,16 @@ This pairwise interaction between rounded polyhedra is described in "Wang"_#Wang, where a polyhedron does not have sharp corners and edges, but is rounded at its vertices and edges by spheres centered on each vertex with a specified diameter. The edges if the polyhedron -are defined bewteen pairs of adjacent vertices. Its faces are defined +are defined between pairs of adjacent vertices. Its faces are defined by a loop of edges. The sphere diameter for each polygon is specified in the data file read by the "read data"_read_data.html command. This is a discrete element model (DEM) which allows for multiple contact points. -Note that when two particles interaact, the effective surface of each +Note that when two particles interact, the effective surface of each polyhedron particle is displaced outward from each of its vertices, edges, and faces by half its sphere diameter. The interaction forces -and energies bewteen two particles are defined with respect to the +and energies between two particles are defined with respect to the separation of their respective rounded surfaces, not by the separation of the vertices, edges, and faces themselves. @@ -66,7 +64,15 @@ explains how contact is defined? Do we need an equation(s) that explain what the params in pair style and coeff mean, for damping and spring constants? Or do we just want to reference the paper for that? -NOTE: say something about no frictional history ? +In "Wang"_#Wang, the tangential friction force between two particles +that are in contact is modeled differently prior to gross sliding +(i.e. static friction) and during gross-sliding (kinetic friction). +The latter takes place when the tangential deformation exceeds +the Coulomb frictional limit. In the current implementation, however, +we do not take into account frictional history, i.e. we do not keep track +of how many time steps the two particles have been in contact +nor calculate the tangential deformation. We assume that gross sliding +takes place right when two particles are in contact. The following coefficients must be defined for each pair of atom types via the "pair_coeff"_pair_coeff.html command as in the examples above,