diff --git a/doc/doc2/Manual.html.html b/doc/doc2/Manual.html.html index 457f0160c6..c4c0509ea7 100644 --- a/doc/doc2/Manual.html.html +++ b/doc/doc2/Manual.html.html @@ -3,7 +3,7 @@
These are additional compute styles in USER packages, which can be diff --git a/doc/doc2/compute.html b/doc/doc2/compute.html index 56709a891b..fc5922bd60 100644 --- a/doc/doc2/compute.html +++ b/doc/doc2/compute.html @@ -202,6 +202,7 @@ page.
Syntax: +
+compute ID group-ID hexorder/atom keyword values ... ++
n value = degree of order parameter ++ +
Examples: +
+compute 1 all hexorder/atom +compute 1 all hexorder/atom n 4 ++
Description: +
+Define a computation that calculates qn the bond-orientational +order parameter for each atom in a group. The hexatic (n = 6) order +parameter was introduced by Nelson and Halperin as a way to detect +hexagonal symmetry in two-dimensional systems. For each atom, qn +is a complex number (stored as two real numbers) defined as follows: +
+
+where the sum is over the n nearest neighbors +of the central atom. The angle theta +is formed by the bond vector rij and the x axis. theta is calculated +only using the x and y components, whereas the distance from the +central atom is calculated using all three +x, y, and z components of the bond vector. +Neighbor atoms not in the group +are included in the order parameter of atoms in the group. +
+The optional keyword n sets the degree of the order parameter. +The default value is 6. For a perfect hexagonal lattice, +q6 = exp(6 i phi) for all atoms, where the constant 0 < phi < pi/3 +depends only on the orientation of the lattice relative to the x axis. +In an isotropic liquid, local neighborhoods may still exhibit +weak hexagonal symmetry, but because the orientational correlation +decays quickly with distance, the value of phi will be different for +different atoms, and |<q6>| << 1. +
+The value of qn will be zero for atoms not in the +specified compute group. If the atom has less than n neighbors (within +the potential cutoff), then qn is set to zero. +
+The neighbor list needed to compute this quantity is constructed each +time the calculation is performed (i.e. each time a snapshot of atoms +is dumped). Thus it can be inefficient to compute/dump this quantity +too frequently. +
+IMPORTANT NOTE: If you have a bonded system, then the settings of +special_bonds command can remove pairwise +interactions between atoms in the same bond, angle, or dihedral. This +is the default setting for the special_bonds +command, and means those pairwise interactions do not appear in the +neighbor list. Because this fix uses the neighbor list, it also means +those pairs will not be included in the order parameter. One way +to get around this, is to write a dump file, and use the +rerun command to compute the order parameter for snapshots +in the dump file. The rerun script can use a +special_bonds command that includes all pairs in +the neighbor list. +
+Output info: +
+This compute calculates a per-atom array with 2 columns, giving the +real and imaginary parts of qn, respectively. +
+These values can be accessed by any command that uses +per-atom values from a compute as input. See Section_howto +15 for an overview of LAMMPS output +options. +
+The per-atom array contain pairs of numbers representing the +real and imaginary parts of qn, a complex number subject to the +constraint |qn| <= 1. +
+Restrictions: none +
+Related commands: +
+compute coord/atom, compute centro/atom +
+Default: +
+The option default is n = 6. +
+(Nelson) Nelson, Halperin, Phys Rev B, 19, 2457 (1979). +
+ diff --git a/doc/doc2/compute_rdf.html b/doc/doc2/compute_rdf.html index 9d9ce71e6b..e711008099 100644 --- a/doc/doc2/compute_rdf.html +++ b/doc/doc2/compute_rdf.html @@ -139,13 +139,16 @@ also numbers >= 0.0. since processors (in parallel) don't know about atom coordinates for atoms further away than that distance. If you want an RDF for larger distances, you can use the rerun command to post-process -a dump file. The definition of g(r) used by LAMMPS is only appropriate +a dump file and set the cutoff for the potential to be longer in the +rerun script. Note that in the rerun context, the force cutoff is +arbitrary, since you aren't running dynamics and thus are not changing +your model. The definition of g(r) used by LAMMPS is only appropriate for characterizing atoms that are uniformly distributed throughout the simulation cell. In such cases, the coordination number is still correct and meaningful. As an example, if a large simulation cell contains only one atom of type itypeN and one of jtypeN, then g(r) will register an arbitrarily large spike at whatever distance they -happen to be at, and zero everywhere else. coord(r) will show a step +happen to be at, and zero everywhere else. Coord(r) will show a step change from zero to one at the location of the spike in g(r).Related commands: