lammps/doc/fix_rdf.html

75 lines
2.7 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 rdf command
</H3>
<P><B>Syntax:</B>
</P>
<PRE>fix ID group-ID rdf N file Nbin itype1 jtype1 itype2 jtype2 ...
</PRE>
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
<LI>rdf = style name of this fix command
<LI>N = compute radial distribution function (RDF) every this many timesteps
<LI>file = filename to write radial distribution funtion info to
<LI>Nbin = number of RDF bins
<LI>itypeN = central atom type for RDF pair N
<LI>jtypeN = distribution atom type for RDF pair N
</UL>
<P><B>Examples:</B>
</P>
<PRE>fix 1 all rdf 500 rdf.out 100 1 1
fix 1 fluid rdf 10000 rdf.out 100 1 1 1 2 2 1 2 2
</PRE>
<P><B>Description:</B>
</P>
<P>Compute the radial distribution function (RDF), also known as g(r),
and coordination number every N steps. The RDF for each specified
atom type pair is histogrammed in Nbin bins from distance 0 to Rc,
where Rc = the maximum force cutoff for any pair of atom types. An
atom pair only contributes to the RDF if
</P>
<UL><LI>both atoms are in the fix group
<LI>the distance between them is within the maximum force cutoff
<LI>their interaction is stored in the neighbor list
</UL>
<P>Bonded atoms (1-2, 1-3, 1-4 interactions within a molecular topology)
with a pairwise weighting factor of 0.0 are not included in the RDF;
pairs with a non-zero weighting factor are included. The weighting
factor is set by the <A HREF = "special_bonds.html">special_bonds</A> command.
</P>
<P>The RDF statistics for each timestep are written to the specified
file, as are the RDF values averaged over all timesteps.
</P>
<P><B>Restart, fix_modify, thermo 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. No quantities calculated by this fix can be
output by the <A HREF = "thermo_style.html">thermo_style custom</A> command. 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 RDF is not computed for distances longer than the force cutoff,
since processors (in parallel) don't know atom coordinates for atoms
further away than that distance. If you want an RDF for larger <I>r</I>,
you'll need to post-process a dump file.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "pair_style.html">pair_style</A>
</P>
<P><B>Default:</B> none
</P>
</HTML>