forked from lijiext/lammps
200 lines
8.0 KiB
HTML
200 lines
8.0 KiB
HTML
<HTML>
|
|
<CENTER><A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LAMMPS Documentation</A> - <A HREF = "Section_commands.html#comm">LAMMPS Commands</A>
|
|
</CENTER>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<HR>
|
|
|
|
<H3>fix saed/vtk command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>fix ID group-ID saed/vtk Nevery Nrepeat Nfreak c_ID attribute args ... keyword args ...
|
|
</PRE>
|
|
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
|
|
|
|
<LI>saed/vtk = style name of this fix command
|
|
|
|
<LI>Nevery = use input values every this many timesteps
|
|
|
|
<LI>Nrepeat = # of times to use input values for calculating averages
|
|
|
|
<LI>Nfreq = calculate averages every this many timesteps
|
|
|
|
<LI>c_ID = saed compute ID
|
|
|
|
<PRE>keyword = <I>file</I> or <I>ave</I> or <I>start</I> or <I>file</I> or <I>overwrite</I>:l
|
|
<I>ave</I> args = <I>one</I> or <I>running</I> or <I>window M</I>
|
|
one = output a new average value every Nfreq steps
|
|
running = output cumulative average of all previous Nfreq steps
|
|
window M = output average of M most recent Nfreq steps
|
|
<I>start</I> args = Nstart
|
|
Nstart = start averaging on this timestep
|
|
<I>file</I> arg = filename
|
|
filename = name of file to output time averages to
|
|
<I>overwrite</I> arg = none = overwrite output file with only latest output
|
|
</PRE>
|
|
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>compute 1 all saed 0.0251 Al O Kmax 1.70 Zone 0 0 1 dR_Ewald 0.01 c 0.5 0.5 0.5
|
|
compute 2 all saed 0.0251 Ni Kmax 1.70 Zone 0 0 0 c 0.05 0.05 0.05 manual echo
|
|
</PRE>
|
|
<PRE>fix saed/vtk 1 1 1 c_1 file Al2O3_001.saed
|
|
fix saed/vtk 1 1 1 c_2 file Ni_000.saed
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>Time average computed intensities from <A HREF = "compute_saed.txt">compute_saed</A> and
|
|
write output to a file in the 3rd generation vtk image data format for
|
|
visualization directly in parallelized visualization software packages
|
|
like ParaView and VisIt. Note that if no time averaging is done, this
|
|
command can be used as a convenient way to simply output diffraction
|
|
intensities at a single snapshot.
|
|
</P>
|
|
<P>To produce output in the image data vtk format ghost data is added
|
|
outside the <I>Kmax</I> range assigned in the compute saed. The ghost data is
|
|
assigned a value of -1 and can be removed setting a minimum isovolume
|
|
of 0 within the vizualiziton software. SAED images can be created by
|
|
visualizing a spherical slice of the data that is centered at
|
|
R_Ewald*[h k l]/norm([h k l]), where R_Ewald=1/lambda.
|
|
</P>
|
|
<P>The group specified within this command is ignored. However, note that
|
|
specified values may represent calculations performed by saed computes
|
|
which store their own "group" definitions.
|
|
</P>
|
|
<P>Fix saed/vtk is designed to work only with <A HREF = "compute_saed.txt">compute_saed</A>
|
|
values, e.g.
|
|
</P>
|
|
<PRE>compute 3 top saed 0.0251 Al O
|
|
fix saed/vtk 1 1 1 c_3 file Al2O3_001.saed
|
|
</PRE>
|
|
<HR>
|
|
|
|
<P>The <I>Nevery</I>, <I>Nrepeat</I>, and <I>Nfreq</I> arguments specify on what
|
|
timesteps the input values will be used in order to contribute to the
|
|
average. The final averaged quantities are generated on timesteps
|
|
that are a multiple of <I>Nfreq</I>. The average is over <I>Nrepeat</I>
|
|
quantities, computed in the preceding portion of the simulation every
|
|
<I>Nevery</I> timesteps. <I>Nfreq</I> must be a multiple of <I>Nevery</I> and
|
|
<I>Nevery</I> must be non-zero even if <I>Nrepeat</I> is 1. Also, the timesteps
|
|
contributing to the average value cannot overlap, i.e. Nfreq >
|
|
(Nrepeat-1)*Nevery is required.
|
|
</P>
|
|
<P>For example, if Nevery=2, Nrepeat=6, and Nfreq=100, then values on
|
|
timesteps 90,92,94,96,98,100 will be used to compute the final average
|
|
on timestep 100. Similarly for timesteps 190,192,194,196,198,200 on
|
|
timestep 200, etc. If Nrepeat=1 and Nfreq = 100, then no time
|
|
averaging is done; values are simply generated on timesteps
|
|
100,200,etc.
|
|
</P>
|
|
<HR>
|
|
|
|
<P>The output for fix ave/time/saed is a file writen with the 3rd generation
|
|
vtk image data formatting. The filename assigned by the <I>file</I> keyword is
|
|
appended with _N.vtk where N is an index (0,1,2...) to account for multiple
|
|
diffraction intensity outputs.
|
|
</P>
|
|
<P>By default the header contains the following information (with example data):
|
|
</P>
|
|
<PRE># vtk DataFile Version 3.0 c_SAED
|
|
Image data set
|
|
ASCII
|
|
DATASET STRUCTURED_POINTS
|
|
DIMENSIONS 337 219 209
|
|
ASPECT_RATIO 0.00507953 0.00785161 0.00821458
|
|
ORIGIN -0.853361 -0.855826 -0.854316
|
|
POINT_DATA 15424827
|
|
SCALARS intensity float
|
|
LOOKUP_TABLE default
|
|
...data
|
|
</PRE>
|
|
<P>In this example, kspace is sampled across a 337 x 219 x 209 point mesh
|
|
where the mesh spacing is approximately 0.005, 0.007, and 0.008
|
|
inv(length) units in the k1, k2, and k3 directions, respectively.
|
|
The data is shifted by -0.85, -0.85, -0.85 inv(length) units so that
|
|
the origin will lie at 0, 0, 0. Here, 15,424,827 kspace points are
|
|
sampled in total.
|
|
</P>
|
|
<HR>
|
|
|
|
<P>Additional optional keywords also affect the operation of this fix.
|
|
</P>
|
|
<P>The <I>ave</I> keyword determines how the values produced every <I>Nfreq</I>
|
|
steps are averaged with values produced on previous steps that were
|
|
multiples of <I>Nfreq</I>, before they are accessed by another output
|
|
command or written to a file.
|
|
</P>
|
|
<P>If the <I>ave</I> setting is <I>one</I>, then the values produced on timesteps
|
|
that are multiples of <I>Nfreq</I> are independent of each other; they are
|
|
output as-is without further averaging.
|
|
</P>
|
|
<P>If the <I>ave</I> setting is <I>running</I>, then the values produced on
|
|
timesteps that are multiples of <I>Nfreq</I> are summed and averaged in a
|
|
cumulative sense before being output. Each output value is thus the
|
|
average of the value produced on that timestep with all preceding
|
|
values. This running average begins when the fix is defined; it can
|
|
only be restarted by deleting the fix via the <A HREF = "unfix.html">unfix</A>
|
|
command, or by re-defining the fix by re-specifying it.
|
|
</P>
|
|
<P>If the <I>ave</I> setting is <I>window</I>, then the values produced on
|
|
timesteps that are multiples of <I>Nfreq</I> are summed and averaged within
|
|
a moving "window" of time, so that the last M values are used to
|
|
produce the output. E.g. if M = 3 and Nfreq = 1000, then the output
|
|
on step 10000 will be the average of the individual values on steps
|
|
8000,9000,10000. Outputs on early steps will average over less than M
|
|
values if they are not available.
|
|
</P>
|
|
<P>The <I>start</I> keyword specifies what timestep averaging will begin on.
|
|
The default is step 0. Often input values can be 0.0 at time 0, so
|
|
setting <I>start</I> to a larger value can avoid including a 0.0 in a
|
|
running or windowed average.
|
|
</P>
|
|
<P>The <I>file</I> keyword allows a filename to be specified. Every <I>Nfreq</I>
|
|
steps, the vector of saed intensity data is written to a new file using
|
|
the 3rd generation vtk format. The base of each file is assigned by
|
|
the <I>file</I> keyword and this string is appended with _N.vtk where N is
|
|
an index (0,1,2...) to account for situations with multiple diffraction
|
|
intensity outputs.
|
|
</P>
|
|
<P>The <I>overwrite</I> keyword will continuously overwrite the output file
|
|
with the latest output, so that it only contains one timestep worth of
|
|
output. This option can only be used with the <I>ave running</I> setting.
|
|
</P>
|
|
<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
|
|
</P>
|
|
<P>No information about this fix is written to <A HREF = "restart.html">binary restart
|
|
files</A>. None of the <A HREF = "fix_modify.html">fix_modify</A> options
|
|
are relevant to this fix.
|
|
</P>
|
|
<P>No parameter of this fix can be used with the <I>start/stop</I> keywords of
|
|
the <A HREF = "run.html">run</A> command. This fix is not invoked during <A HREF = "minimize.html">energy
|
|
minimization</A>.
|
|
</P>
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P>The attributes for fix_saed_vtk must match the values assigned in the
|
|
associated <A HREF = "compute_saed.html">compute_saed</A> command.
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "compute_saed.html">compute_saed</A>
|
|
</P>
|
|
<P><B>Default:</B>
|
|
</P>
|
|
<P>The option defaults are ave = one, start = 0, no file output.
|
|
</P>
|
|
<HR>
|
|
|
|
<A NAME = "Coleman"></A>
|
|
|
|
<P><B>(Coleman)</B> Coleman, Spearot, Capolungo, MSMSE, 21, 055020
|
|
(2013).
|
|
</P>
|
|
</HTML>
|