doc/src/compute_damage_atom.txt

   1 "LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
   2
   3 :link(lws,http://lammps.sandia.gov)
   4 :link(ld,Manual.html)
   5 :link(lc,Section_commands.html#comm)
   6
   7 :line
   8
   9 compute damage/atom command :h3
  10
  11 [Syntax:]
  12
  13 compute ID group-ID damage/atom :pre
  14
  15 ID, group-ID are documented in "compute"_compute.html command
  16 damage/atom = style name of this compute command :ul
  17
  18 [Examples:]
  19
  20 compute 1 all damage/atom :pre
  21
  22 [Description:]
  23
  24 Define a computation that calculates the per-atom damage for each atom
  25 in a group.  This is a quantity relevant for "Peridynamics
  26 models"_pair_peri.html.  See "this document"_PDF/PDLammps_overview.pdf
  27 for an overview of LAMMPS commands for Peridynamics modeling.
  28
  29 The "damage" of a Peridymaics particles is based on the bond breakage
  30 between the particle and its neighbors.  If all the bonds are broken
  31 the particle is considered to be fully damaged.
  32
  33 See the "PDLAMMPS user
  34 guide"_http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf for a formal
  35 definition of "damage" and more details about Peridynamics as it is
  36 implemented in LAMMPS.
  37
  38 This command can be used with all the Peridynamic pair styles.
  39
  40 The damage value will be 0.0 for atoms not in the specified compute
  41 group.
  42
  43 [Output info:]
  44
  45 This compute calculates a per-atom vector, which can be accessed by
  46 any command that uses per-atom values from a compute as input.  See
  47 "Section 6.15"_Section_howto.html#howto_15 for an overview of
  48 LAMMPS output options.
  49
  50 The per-atom vector values are unitlesss numbers (damage) >= 0.0.
  51
  52 [Restrictions:]
  53
  54 This compute is part of the PERI package.  It is only enabled if
  55 LAMMPS was built with that package.  See the "Making
  56 LAMMPS"_Section_start.html#start_3 section for more info.
  57
  58 [Related commands:]
  59
  60 "compute dilatation/atom"_compute_dilatation_atom.html,
  61 "compute plasticity/atom"_compute_plasticity_atom.html
  62
  63 [Default:] none