<PRE>dump ID group-ID image N file keyword value ...
</PRE>
<UL><LI>ID = user-assigned name for the dump
<LI>group-ID = ID of the group of atoms to be imaged
<LI>image = style of dump command (other styles <I>atom</I> or <I>cfg</I> or <I>dcd</I> or <I>xtc</I> or <I>xyz</I> or <I>local</I> or <I>custom</I> are discussed on the <A HREF = "dump.html">dump</A> doc page)
<LI>N = dump every this many timesteps
<LI>file = name of file to write image to
<LI>zero or more keyword/value pairs may be appended
<LI>keyword = <I>atom</I> or <I>bond</I> or <I>size</I> or <I>view</I> or <I>center</I> or <I>up</I> or <I>zoom</I> or <I>persp</I> or <I>box</I> or <I>dynamic</I> or <I>box</I> or <I>axes</I> or <I>shiny</I> or <I>ssao</I>
<PRE> <I>atom</I> values = color diam
color = <I>none</I> or <I>type</I> or <I>element</I> or atom-attribute
diam = D or <I>type</I> or <I>element</I> or <I>radius</I> or <I>shape</I> or atom-attribute
D = numeric value for atom diameter (distance units)
<I>bond</I> values = color diam
color = <I>none</I> or <I>atom</I> or <I>type</I>
diam = D or <I>type</I>
D = numeric value for bond diameter (distance units)
<I>size</I> values = width height
width = width of image in # of pixels
height = height of image in # of pixels
<I>view</I> values = theta phi
theta = view angle from +z axis (degrees)
phi = azimuthal view angle (degrees)
theta or phi can be a variable (see below)
<I>center</I> values = flag Cx Cy Cz = center point of image (distance units)
flag = "s" for static, "d" for dynamic
Cx,Cy,Cz can be variables (see below)
<I>up</I> values = Ux Uy Uz = components of up vector
Ux,Uy,Uz can be variables (see below)
<I>zoom</I> value = factor = scale image size by this factor
factor can be a variable (see below)
<I>persp</I> value = factor = perspective setting
factor can be a variable (see below)
<I>box</I> values = yes/no diam
yes/no = do or do not draw simulation box lines
diam = diameter of box lines as fraction of shortest box length
<I>axes</I> values = yes/no length diam
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
<I>shiny</I> value = factor
factor = shinyness of spheres and cylinders from 0.0 to 1.0
<I>ssao</I> value = yes/no
yes/no = turn on/off SSAO depth shading
</PRE>
</UL>
<P><B>Examples:</B>
</P>
<PRE>dump myDump all image 100 dump.*.jpg
</PRE>
<P><B>Description:</B>
</P>
<P>Dump an image (picture) of the atom configuration every N timesteps as
either a JPG or PPM file. A series of such images can easily be
converted into an animated movie of your simulation; see further
details below. Other dump styles store snapshots of atom quantities
in various formats, as discussed on the <A HREF = "dump.html">dump</A> doc page.
</P>
<P>Only atoms in the specified group are rendered in the image. The
<A HREF = "dump_modify.html">dump_modify region and thresh</A> commands can also
alter what atoms are included in the image.
</P>
<P>The filename suffix determines whether a JPG or PPM file is created.
If the suffix is ".jpg" or ".jpeg", then a JPG file is created, else a
PPM file is created. To write out JPG files, you must build LAMMPS
with a JPEG library. See <A HREF = "Section_start.html#2_2_4">this section</A> of
the manual for instructions on how to do this.
</P>
<P>IMPORTANT NOTE: Because periodic boundary conditions are enforced only
on timesteps when neighbor lists are rebuilt, the coordinates of an
atom image may be slightly outside the simulation box.
</P>
<HR>
<P>Dumps are performed on timesteps that are a multiple of N (including
timestep 0) and on the last timestep of a minimization if the
minimization converges. Note that this means a dump will not be
performed on the initial timestep after the dump command is invoked,
if the current timestep is not a multiple of N. This behavior can be
changed via the <A HREF = "dump_modify.html">dump_modify first</A> command, which
can be useful if the dump command is invoked after a minimization
ended on an arbitrary timestep. N can be changed between runs by
using the <A HREF = "dump_modify.html">dump_modify every</A> command (not allowed
for <I>dcd</I> style).
</P>
<P>Dump image filenames must contain a wildcard character "*". If a "*"
character appears in the filename, then one file per snapshot is
written and the "*" character is replaced with the timestep value.
For example, tmp.dump.*.jpg becomes tmp.dump.0.jpg,
tmp.dump.10000.jpg, tmp.dump.20000.jpg, etc. Note that the
<A HREF = "dump_modify.html">dump_modify pad</A> command can be used to insure all
timestep numbers are the same length (e.g. 00010), which can make it
easier to convert a series of images into a movie in the correct
ordering.
</P>
<HR>
<P>The kewords listed above control how the image is rendered. As listed
below, all of the keywords have defaults, most of which you will
likely not need to change. The <A HREF = "dump_modify.html">dump modify</A> also
has options specific to the dump image style, particularly for
assigning colors to atoms, bonds, and other image features.
</P>
<HR>
<P>The <I>atom</I> keyword determines the color and size of atoms rendered in
the image. If <I>none</I> is specified for the color value (with any diam
value), then no atoms are drawn.
</P>
<P>The color value can be <I>type</I> or <I>element</I> or an atom-attribute.
</P>
<P>If <I>type</I> is specified for the color
value, then the color of each atom is determined by its atom type.
By default the mapping of types to colors is as follows:
</P>
<UL><LI>type 1 = red
<LI>type 2 = green
<LI>type 3 = blue
<LI>type 4 = yellow
<LI>type 5 = aqua
<LI>type 6 = cyan
</UL>
<P>and repeats itself for types > 6. This mapping can be changed by the