git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@16053 f3b2605a-c512-4ea7-a41b...
[lammps.git] / doc / src / compute_ackland_atom.txt
blobb75d100112b9f3a9a5e49d1ec282f275e56a9014
1 "LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
3 :link(lws,http://lammps.sandia.gov)
4 :link(ld,Manual.html)
5 :link(lc,Section_commands.html#comm)
7 :line
9 compute ackland/atom command :h3
11 [Syntax:]
13 compute ID group-ID ackland/atom :pre
15 ID, group-ID are documented in "compute"_compute.html command
16 ackland/atom = style name of this compute command :ul
18 [Examples:]
20 compute 1 all ackland/atom :pre
22 [Description:]
24 Defines a computation that calculates the local lattice structure
25 according to the formulation given in "(Ackland)"_#Ackland.
27 In contrast to the "centro-symmetry
28 parameter"_compute_centro_atom.html this method is stable against
29 temperature boost, because it is based not on the distance between
30 particles but the angles.  Therefore statistical fluctuations are
31 averaged out a little more.  A comparison with the Common Neighbor
32 Analysis metric is made in the paper.
34 The result is a number which is mapped to the following different
35 lattice structures:
37 0 = UNKNOWN
38 1 = BCC
39 2 = FCC
40 3 = HCP
41 4 = ICO :ul
43 The neighbor list needed to compute this quantity is constructed each
44 time the calculation is performed (i.e. each time a snapshot of atoms
45 is dumped).  Thus it can be inefficient to compute/dump this quantity
46 too frequently or to have multiple compute/dump commands, each of
47 which computes this quantity.-
49 [Output info:]
51 This compute calculates a per-atom vector, which can be accessed by
52 any command that uses per-atom values from a compute as input.  See
53 "Section 6.15"_Section_howto.html#howto_15 for an overview of
54 LAMMPS output options.
56 [Restrictions:]
58 This compute is part of the USER-MISC package.  It is only enabled if
59 LAMMPS was built with that package.  See the "Making
60 LAMMPS"_Section_start.html#start_3 section for more info.
62 The per-atom vector values will be unitless since they are the
63 integers defined above.
65 [Related commands:]
67 "compute centro/atom"_compute_centro_atom.html
69 [Default:] none
71 :line
73 :link(Ackland)
74 [(Ackland)] Ackland, Jones, Phys Rev B, 73, 054104 (2006).