All of the styles define point particles, except the ellipsoid and +granular and peri styles. These define finite-size particles. +For ellipsoidal systems, the shape command is used to +specify the size and shape of particles, which can be spherical or +aspherical. For granular systems, the particles are spherical and +each has a specified diameter. For peri systems, the particles are +spherical and each has a specified volume. +
+All of the styles assign mass to particles on a per-type basis, using +the mass command, except the granular and peri styles. +For granular systems, the specified diameter and density are used to +calculate each particle's mass. For peri systems, the speficied +volume and density are used to calculate each particle's mass. +
+Only the dpd and granular styles communicate velocities with ghost +atoms; the others do not. This is because the pairwise interactions +calculated by the pair_style dpd and pair_style +granular commands require velocities. +
+Typically, simulations require only a single (non-hybrid) atom style. If some atoms in the simulation do not have all the properties defined by a particular style, use the simplest style that defines all the @@ -74,8 +95,8 @@ simulation are charged, but others are not, use the charge style. If some atoms have bonds, but others do not, use the bond style.
The only scenario where the hybrid style is needed is if there is no -single style which defines all needed properties of all atoms. -E.g. if you want charged DPD particles, you would need to use +single style which defines all needed properties of all atoms. For +example, if you want charged DPD particles, you would need to use "atom_style hybrid dpd charge". When a hybrid style is used, atoms store and communicate the union of all quantities implied by the individual styles. diff --git a/doc/atom_style.txt b/doc/atom_style.txt index ed7a57a224..497f790b1d 100644 --- a/doc/atom_style.txt +++ b/doc/atom_style.txt @@ -62,6 +62,27 @@ quantities. {molecular} | bonds, angles, dihedrals, impropers | uncharged molecules | {peri} | density, volume | mesocopic Peridynamic models :tb(c=3,s=|) +All of the styles define point particles, except the {ellipsoid} and +{granular} and {peri} styles. These define finite-size particles. +For {ellipsoidal} systems, the "shape"_shape.html command is used to +specify the size and shape of particles, which can be spherical or +aspherical. For {granular} systems, the particles are spherical and +each has a specified diameter. For {peri} systems, the particles are +spherical and each has a specified volume. + +All of the styles assign mass to particles on a per-type basis, using +the "mass"_mass.html command, except the {granular} and {peri} styles. +For {granular} systems, the specified diameter and density are used to +calculate each particle's mass. For {peri} systems, the speficied +volume and density are used to calculate each particle's mass. + +Only the {dpd} and {granular} styles communicate velocities with ghost +atoms; the others do not. This is because the pairwise interactions +calculated by the "pair_style dpd"_pair_dpd.html and "pair_style +granular"_pair_gran.html commands require velocities. + +:line + Typically, simulations require only a single (non-hybrid) atom style. If some atoms in the simulation do not have all the properties defined by a particular style, use the simplest style that defines all the @@ -70,8 +91,8 @@ simulation are charged, but others are not, use the {charge} style. If some atoms have bonds, but others do not, use the {bond} style. The only scenario where the {hybrid} style is needed is if there is no -single style which defines all needed properties of all atoms. -E.g. if you want charged DPD particles, you would need to use +single style which defines all needed properties of all atoms. For +example, if you want charged DPD particles, you would need to use "atom_style hybrid dpd charge". When a hybrid style is used, atoms store and communicate the union of all quantities implied by the individual styles.