From 00a803f04b7af2c0e6008a25620d48c8246145ca Mon Sep 17 00:00:00 2001 From: sjplimp Date: Fri, 1 Aug 2014 23:37:52 +0000 Subject: [PATCH] git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@12244 f3b2605a-c512-4ea7-a41b-209d697bcdaa --- doc/dump_image.html | 46 +++++++++++++++++++++++++++++--------------- doc/dump_image.txt | 46 +++++++++++++++++++++++++++++--------------- doc/dump_modify.html | 8 +++++--- doc/dump_modify.txt | 8 +++++--- 4 files changed, 70 insertions(+), 38 deletions(-) diff --git a/doc/dump_image.html b/doc/dump_image.html index fbeec7648b..c2babe4f63 100644 --- a/doc/dump_image.html +++ b/doc/dump_image.html @@ -33,7 +33,7 @@
  • zero or more keyword/value pairs may be appended -
  • keyword = adiam or atom or bond or size or view or center or up or zoom or persp or box or axes or shiny or ssao +
  • keyword = adiam or atom or bond or size or view or center or up or zoom or persp or box or axes or subbox or shiny or ssao 
      adiam value = number = numeric value for atom diameter (distance units)
   atom = yes/no = do or do not draw atoms
@@ -68,6 +68,9 @@
     yes/no = do or do not draw xyz axes lines next to simulation box
     length = length of axes lines as fraction of respective box lengths
     diam = diameter of axes lines as fraction of shortest box length
+  subbox values = yes/no diam = draw outline of processor sub-domains
+    yes/no = do or do not draw sub-domain lines
+    diam = diameter of sub-domain lines as fraction of shortest box length
   shiny value = sfactor = shinyness of spheres and cylinders
     sfactor = shinyness of spheres and cylinders from 0.0 to 1.0
   ssao value = yes/no seed dfactor = SSAO depth shading
@@ -370,23 +373,33 @@ perspective.
 
    
 
    
 
-
    The box keyword determines how the simulation box boundaries are
-rendered as thin cylinders in the image.  If no is set, then the box
-boundaries are not drawn and the diam setting is ignored.  If yes
-is set, the 12 edges of the box are drawn, with a diameter that is a
-fraction of the shortest box length in x,y,z (for 3d) or x,y (for 2d).
-The color of the box boundaries can be set with the dump_modify
+
    The box keyword determines if and how the simulation box boundaries
+are rendered as thin cylinders in the image.  If no is set, then the
+box boundaries are not drawn and the diam setting is ignored.  If
+yes is set, the 12 edges of the box are drawn, with a diameter that
+is a fraction of the shortest box length in x,y,z (for 3d) or x,y (for
+2d).  The color of the box boundaries can be set with the dump_modify
 boxcolor command.
 
    
-
    The axes keyword determines how the coordinate axes are rendered as
-thin cylinders in the image.  If no is set, then the axes are not
-drawn and the length and diam settings are ignored.  If yes is
-set, 3 thin cylinders are drawn to represent the x,y,z axes in colors
-red,green,blue.  The origin of these cylinders will be offset from the
-lower left corner of the box by 10%.  The length setting determines
-how long the cylinders will be as a fraction of the respective box
-lengths.  The diam setting determines their thickness as a fraction
-of the shortest box length in x,y,z (for 3d) or x,y (for 2d).
+
    The axes keyword determines if and how the coordinate axes are
+rendered as thin cylinders in the image.  If no is set, then the
+axes are not drawn and the length and diam settings are ignored.
+If yes is set, 3 thin cylinders are drawn to represent the x,y,z
+axes in colors red,green,blue.  The origin of these cylinders will be
+offset from the lower left corner of the box by 10%.  The length
+setting determines how long the cylinders will be as a fraction of the
+respective box lengths.  The diam setting determines their thickness
+as a fraction of the shortest box length in x,y,z (for 3d) or x,y (for
+2d).
+
    
+
    The subbox keyword determines if and how processor sub-domain
+boundaries are rendered as thin cylinders in the image.  If no is
+set (default), then the sub-domain boundaries are not drawn and the
+diam setting is ignored.  If yes is set, the 12 edges of each
+processor sub-domain are drawn, with a diameter that is a fraction of
+the shortest box length in x,y,z (for 3d) or x,y (for 2d).  The color
+of the sub-domain boundaries can be set with the dump_modify
+boxcolor command.
 
    
 
    
 
@@ -546,6 +559,7 @@ mp4).
 
  • persp = 0.0
 
  • box = yes 0.02
 
  • axes = no 0.0 0.0
+
  • subbox no 0.0
 
  • shiny = 1.0
 
  • ssao = no 
 
diff --git a/doc/dump_image.txt b/doc/dump_image.txt
index 21de3f62a0..4b27d8c99e 100644
--- a/doc/dump_image.txt
+++ b/doc/dump_image.txt
@@ -21,7 +21,7 @@ file = name of file to write image to :l
 color = atom attribute that determines color of each atom :l
 diameter = atom attribute that determines size of each atom :l
 zero or more keyword/value pairs may be appended :l
-keyword = {adiam} or {atom} or {bond} or {size} or {view} or {center} or {up} or {zoom} or {persp} or {box} or {axes} or {shiny} or {ssao} :l
+keyword = {adiam} or {atom} or {bond} or {size} or {view} or {center} or {up} or {zoom} or {persp} or {box} or {axes} or {subbox} or {shiny} or {ssao} :l
   {adiam} value = number = numeric value for atom diameter (distance units)
   {atom} = yes/no = do or do not draw atoms
   {bond} values = color width = color and width of bonds
@@ -55,6 +55,9 @@ keyword = {adiam} or {atom} or {bond} or {size} or {view} or {center} or {up} or
     yes/no = do or do not draw xyz axes lines next to simulation box
     length = length of axes lines as fraction of respective box lengths
     diam = diameter of axes lines as fraction of shortest box length
+  {subbox} values = yes/no diam = draw outline of processor sub-domains
+    yes/no = do or do not draw sub-domain lines
+    diam = diameter of sub-domain lines as fraction of shortest box length
   {shiny} value = sfactor = shinyness of spheres and cylinders
     sfactor = shinyness of spheres and cylinders from 0.0 to 1.0
   {ssao} value = yes/no seed dfactor = SSAO depth shading
@@ -356,23 +359,33 @@ IMPORTANT NOTE: The {persp} keyword is not yet supported as an option.
 
 :line
 
-The {box} keyword determines how the simulation box boundaries are
-rendered as thin cylinders in the image.  If {no} is set, then the box
-boundaries are not drawn and the {diam} setting is ignored.  If {yes}
-is set, the 12 edges of the box are drawn, with a diameter that is a
-fraction of the shortest box length in x,y,z (for 3d) or x,y (for 2d).
-The color of the box boundaries can be set with the "dump_modify
+The {box} keyword determines if and how the simulation box boundaries
+are rendered as thin cylinders in the image.  If {no} is set, then the
+box boundaries are not drawn and the {diam} setting is ignored.  If
+{yes} is set, the 12 edges of the box are drawn, with a diameter that
+is a fraction of the shortest box length in x,y,z (for 3d) or x,y (for
+2d).  The color of the box boundaries can be set with the "dump_modify
 boxcolor"_dump_modify.html command.
 
-The {axes} keyword determines how the coordinate axes are rendered as
-thin cylinders in the image.  If {no} is set, then the axes are not
-drawn and the {length} and {diam} settings are ignored.  If {yes} is
-set, 3 thin cylinders are drawn to represent the x,y,z axes in colors
-red,green,blue.  The origin of these cylinders will be offset from the
-lower left corner of the box by 10%.  The {length} setting determines
-how long the cylinders will be as a fraction of the respective box
-lengths.  The {diam} setting determines their thickness as a fraction
-of the shortest box length in x,y,z (for 3d) or x,y (for 2d).
+The {axes} keyword determines if and how the coordinate axes are
+rendered as thin cylinders in the image.  If {no} is set, then the
+axes are not drawn and the {length} and {diam} settings are ignored.
+If {yes} is set, 3 thin cylinders are drawn to represent the x,y,z
+axes in colors red,green,blue.  The origin of these cylinders will be
+offset from the lower left corner of the box by 10%.  The {length}
+setting determines how long the cylinders will be as a fraction of the
+respective box lengths.  The {diam} setting determines their thickness
+as a fraction of the shortest box length in x,y,z (for 3d) or x,y (for
+2d).
+
+The {subbox} keyword determines if and how processor sub-domain
+boundaries are rendered as thin cylinders in the image.  If {no} is
+set (default), then the sub-domain boundaries are not drawn and the
+{diam} setting is ignored.  If {yes} is set, the 12 edges of each
+processor sub-domain are drawn, with a diameter that is a fraction of
+the shortest box length in x,y,z (for 3d) or x,y (for 2d).  The color
+of the sub-domain boundaries can be set with the "dump_modify
+boxcolor"_dump_modify.html command.
 
 :line
 
@@ -533,5 +546,6 @@ zoom = 1.0
 persp = 0.0
 box = yes 0.02
 axes = no 0.0 0.0
+subbox no 0.0
 shiny = 1.0
 ssao = no :ul
diff --git a/doc/dump_modify.html b/doc/dump_modify.html
index 148decd3a2..a8ab654d53 100644
--- a/doc/dump_modify.html
+++ b/doc/dump_modify.html
@@ -95,7 +95,7 @@
     type = bond type or range of types (see below)
     diam = diameter of bonds of that type (distance units)
   boxcolor arg = color
-    color = name of color for box lines
+    color = name of color for simulation box lines and processor sub-domain lines
   color args = name R G B
     name = name of color
     R,G,B = red/green/blue numeric values from 0.0 to 1.0
@@ -661,8 +661,10 @@ allow the bitrate to be set.  If not, the setting is silently ignored.
 
    
 
 
    The boxcolor keyword sets the color of the simulation box drawn
-around the atoms in each image.  See the "dump image box" command for
-how to specify that a box be drawn.  The color name can be any of the
+around the atoms in each image as well as the color of processor
+sub-domain boundaries.  See the "dump image box" command for how to
+specify that a box be drawn via the box keyword, and the sub-domain
+boundaries via the subbox keyword.  The color name can be any of the
 140 pre-defined colors (see below) or a color name defined by the
 dump_modify color option.
 
    
diff --git a/doc/dump_modify.txt b/doc/dump_modify.txt
index 452264f192..c5cbd2bff6 100644
--- a/doc/dump_modify.txt
+++ b/doc/dump_modify.txt
@@ -85,7 +85,7 @@ keyword = {acolor} or {adiam} or {amap} or {backcolor} or {bcolor} or {bdiam} or
     type = bond type or range of types (see below)
     diam = diameter of bonds of that type (distance units)
   {boxcolor} arg = color
-    color = name of color for box lines
+    color = name of color for simulation box lines and processor sub-domain lines
   {color} args = name R G B
     name = name of color
     R,G,B = red/green/blue numeric values from 0.0 to 1.0
@@ -648,8 +648,10 @@ allow the bitrate to be set.  If not, the setting is silently ignored.
 :line
 
 The {boxcolor} keyword sets the color of the simulation box drawn
-around the atoms in each image.  See the "dump image box" command for
-how to specify that a box be drawn.  The color name can be any of the
+around the atoms in each image as well as the color of processor
+sub-domain boundaries.  See the "dump image box" command for how to
+specify that a box be drawn via the {box} keyword, and the sub-domain
+boundaries via the {subbox} keyword.  The color name can be any of the
 140 pre-defined colors (see below) or a color name defined by the
 dump_modify color option.