From 5aebb237fcb855dcd9ca5d5fa7871b3dd6dea214 Mon Sep 17 00:00:00 2001
From: sjplimp <sjplimp@f3b2605a-c512-4ea7-a41b-209d697bcdaa>
Date: Fri, 25 Jul 2008 14:42:02 +0000
Subject: [PATCH] git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@1968
 f3b2605a-c512-4ea7-a41b-209d697bcdaa

---
 doc/pair_peri_pmb.html | 25 ++++++++++++++++---------
 doc/pair_peri_pmb.txt  | 24 +++++++++++++++---------
 doc/read_data.html     |  2 +-
 doc/read_data.txt      |  2 +-
 4 files changed, 33 insertions(+), 20 deletions(-)

diff --git a/doc/pair_peri_pmb.html b/doc/pair_peri_pmb.html
index 3835444a61..46474745c6 100644
--- a/doc/pair_peri_pmb.html
+++ b/doc/pair_peri_pmb.html
@@ -24,11 +24,12 @@ pair_coeff * * 1.6863e22 0.0015001 0.0005 0.25
 </P>
 <P>Style <I>peri/pmb</I> style implements the Peridynamic bond-based prototype
 microelastic brittle (PMB) model, which can be used to model materials
-at the mesoscopic or macroscopic scale.  The implementation of
+at the mesoscopic or macroscopic scale.  The canonical paper on
+Peridynamics is <A HREF = "#Silling">(Silling)</A>.  The implementation of
 Peridynamics in LAMMPS is described in <A HREF = "#Parks">(Parks)</A>.  Also see the
 <A HREF = "http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf">PDLAMMPS user
 guide</A> for more
-details about this particular potential.
+details about this particular potential and using it in LAMMPS.
 </P>
 <P>The following coefficients must be defined for each pair of atom
 types via the <A HREF = "pair_coeff.html">pair_coeff</A> command as in the examples
@@ -36,15 +37,17 @@ above, or in the data file or restart files read by the
 <A HREF = "read_data.html">read_data</A> or <A HREF = "read_restart.html">read_restart</A>
 commands, or by mixing as described below:
 </P>
-<UL><LI>K (energy/distance^2 units)
+<UL><LI>c (energy/distance/volume^2 units)
 <LI>horizon (distance units)
-<LI>s00 (?? units)
-<LI>alpha (?? units) 
+<LI>s00 (unitless)
+<LI>alpha (unitless) 
 </UL>
-<P>K is the spring constant for Peridynamic bonds, the horizon is a
-cutoff distance for truncating interactions, and s00 and alpha are
-used as a bond breaking criteria.  See the users guide for more
-details.
+<P>C is the effectively a spring constant for Peridynamic bonds, the
+horizon is a cutoff distance for truncating interactions, and s00 and
+alpha are used as a bond breaking criteria.  The units of c are such
+that c/distance = stiffness/volume^2, where stiffness is
+energy/distance^2 and volume is distance^3.  See the users guide for
+more details.
 </P>
 <HR>
 
@@ -88,4 +91,8 @@ LAMMPS</A> section for more info.
 <P><B>(Parks)</B> Parks, Lehoucq, Plimpton, Silling, to appear in Comp Phys
 Comm, (2008).
 </P>
+<A NAME = "Silling"></A>
+
+<P><B>(Silling)</B> Silling, J Mech Phys Solids, 48, 175-209 (2000).
+</P>
 </HTML>
diff --git a/doc/pair_peri_pmb.txt b/doc/pair_peri_pmb.txt
index d07ea487b2..b38bdcc6ce 100644
--- a/doc/pair_peri_pmb.txt
+++ b/doc/pair_peri_pmb.txt
@@ -21,11 +21,12 @@ pair_coeff * * 1.6863e22 0.0015001 0.0005 0.25 :pre
 
 Style {peri/pmb} style implements the Peridynamic bond-based prototype
 microelastic brittle (PMB) model, which can be used to model materials
-at the mesoscopic or macroscopic scale.  The implementation of
+at the mesoscopic or macroscopic scale.  The canonical paper on
+Peridynamics is "(Silling)"_#Silling.  The implementation of
 Peridynamics in LAMMPS is described in "(Parks)"_#Parks.  Also see the
 "PDLAMMPS user
 guide"_http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf for more
-details about this particular potential.
+details about this particular potential and using it in LAMMPS.
 
 The following coefficients must be defined for each pair of atom
 types via the "pair_coeff"_pair_coeff.html command as in the examples
@@ -33,15 +34,17 @@ above, or in the data file or restart files read by the
 "read_data"_read_data.html or "read_restart"_read_restart.html
 commands, or by mixing as described below:
 
-K (energy/distance^2 units)
+c (energy/distance/volume^2 units)
 horizon (distance units)
-s00 (?? units)
-alpha (?? units) :ul
+s00 (unitless)
+alpha (unitless) :ul
 
-K is the spring constant for Peridynamic bonds, the horizon is a
-cutoff distance for truncating interactions, and s00 and alpha are
-used as a bond breaking criteria.  See the users guide for more
-details.
+C is the effectively a spring constant for Peridynamic bonds, the
+horizon is a cutoff distance for truncating interactions, and s00 and
+alpha are used as a bond breaking criteria.  The units of c are such
+that c/distance = stiffness/volume^2, where stiffness is
+energy/distance^2 and volume is distance^3.  See the users guide for
+more details.
 
 :line
 
@@ -83,3 +86,6 @@ LAMMPS"_Section_start.html#2_3 section for more info.
 :link(Parks)
 [(Parks)] Parks, Lehoucq, Plimpton, Silling, to appear in Comp Phys
 Comm, (2008).
+
+:link(Silling)
+[(Silling)] Silling, J Mech Phys Solids, 48, 175-209 (2000).
diff --git a/doc/read_data.html b/doc/read_data.html
index d3b7f50cbb..34f9e03af9 100644
--- a/doc/read_data.html
+++ b/doc/read_data.html
@@ -270,7 +270,7 @@ of analysis.
 <TR><TD >full</TD><TD > atom-ID molecule-ID atom-type q x y z</TD></TR>
 <TR><TD >granular</TD><TD > atom-ID atom-type diameter density x y z</TD></TR>
 <TR><TD >molecular</TD><TD > atom-ID molecule-ID atom-type x y z</TD></TR>
-<TR><TD >peri</TD><TD > atom-ID atom-type x y z volume density</TD></TR>
+<TR><TD >peri</TD><TD > atom-ID atom-type volume density x y z</TD></TR>
 <TR><TD >hybrid</TD><TD > atom-ID atom-type x y z sub-style1 sub-style2 ...  
 </TD></TR></TABLE></DIV>
 
diff --git a/doc/read_data.txt b/doc/read_data.txt
index 8078742911..4f5675dc7f 100644
--- a/doc/read_data.txt
+++ b/doc/read_data.txt
@@ -248,7 +248,7 @@ ellipsoid: atom-ID atom-type x y z quatw quati quatj quatk
 full: atom-ID molecule-ID atom-type q x y z
 granular: atom-ID atom-type diameter density x y z
 molecular: atom-ID molecule-ID atom-type x y z
-peri: atom-ID atom-type x y z volume density
+peri: atom-ID atom-type volume density x y z
 hybrid: atom-ID atom-type x y z sub-style1 sub-style2 ...  :tb(s=:)
 
 The keywords have these meanings: