git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@14950 f3b2605a-c512-4ea7-a41b-209d697bcdaa

doc/src/compute_damage_atom.txt

@@ -0,0 +1,63 @@
+"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
+
+compute damage/atom command :h3
+
+[Syntax:]
+
+compute ID group-ID damage/atom :pre
+
+ID, group-ID are documented in "compute"_compute.html command
+damage/atom = style name of this compute command :ul
+
+[Examples:]
+
+compute 1 all damage/atom :pre
+
+[Description:]
+
+Define a computation that calculates the per-atom damage for each atom
+in a group.  This is a quantity relevant for "Peridynamics
+models"_pair_peri.html.  See "this document"_PDF/PDLammps_overview.pdf
+for an overview of LAMMPS commands for Peridynamics modeling.
+
+The "damage" of a Peridymaics particles is based on the bond breakage
+between the particle and its neighbors.  If all the bonds are broken
+the particle is considered to be fully damaged.
+
+See the "PDLAMMPS user
+guide"_http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf for a formal
+definition of "damage" and more details about Peridynamics as it is
+implemented in LAMMPS.
+
+This command can be used with all the Peridynamic pair styles.
+
+The damage value will be 0.0 for atoms not in the specified compute
+group.
+
+[Output info:]
+
+This compute calculates a per-atom vector, which can be accessed by
+any command that uses per-atom values from a compute as input.  See
+"Section_howto 15"_Section_howto.html#howto_15 for an overview of
+LAMMPS output options.
+
+The per-atom vector values are unitlesss numbers (damage) >= 0.0.
+
+[Restrictions:]
+
+This compute is part of the PERI package.  It is only enabled if
+LAMMPS was built with that package.  See the "Making
+LAMMPS"_Section_start.html#start_3 section for more info.
+
+[Related commands:]
+
+"compute dilatation"_compute_dilatation.html, "compute
+plasticity"_compute_plasticity.html
+
+[Default:] none