lammps/doc/write_data.html

93 lines
3.7 KiB
HTML
Raw Normal View History

<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>write_data command
</H3>
<P><B>Syntax:</B>
</P>
<PRE>write_data file
</PRE>
<UL><LI>file = name of data file to write out
</UL>
<P><B>Examples:</B>
</P>
<PRE>write_data data.polymer
write_data data.*
</PRE>
<P><B>Description:</B>
</P>
<P>Write a data file in text format of the current state of the
simulation. Data files can be read by the <A HREF = "read_data.html">read data</A>
command to begin a simulation. The <A HREF = "read_data.html">read_data</A> command
also describes their format.
</P>
<P>Similar to <A HREF = "dump.html">dump</A> files, the data filename can contain a "*"
wild-card character. The "*" is replaced with the current timestep
value.
</P>
<P>IMPORTANT NOTE: The write-data command is not yet fully implemented in
two respects. First, most pair, bond, angle, dihedral, improper
styles do not yet write their coefficient information into the data
file. This means you will need to specify that information in your
input script that reads the data file, e.g. with the
<A HREF = "pair_coeff.html">pair_coeff</A> command. Second, a few of the <A HREF = "atom_style.html">atom
styles</A> (body, ellipsoid, line, tri) that store
auxiliary "bonus" information about aspherical particles, do not yet
write the bonus info into the data file. Both these functionalities
will be added to the write_data command later.
</P>
<P>Because a data file is in text format, if you use a data file written
out by this command to restart a simulation, the initial state of the
new run will be slightly different than the final state of the old run
(when the file was written) which was represented internally by LAMMPS
in binary format. A new simulation which reads the data file will
thus typically diverge from a simulation that continued in the
original input script.
</P>
<P>If you want to do more exact restarts, using binary files, see the
<A HREF = "restart.html">restart</A>, <A HREF = "write_restart.html">write_restart</A>, and
<A HREF = "read_restart.html">read_restart</A> commands. You can also convert
binary restart files to text data files, after a simulation has run,
using the <A HREF = "Section_tools.html#restart2data">restart2data</A> tool in the
tools directory. When the write_data command is fully implemented
(see NOTE above), the restart2data command will be obsolete and will
be removed from the LAMMPS distribution.
</P>
<P>IMPORTANT NOTE: Only limited information about a simulation is stored
in a data file. For example, no information about atom
<A HREF = "group.html">groups</A> and <A HREF = "fix.html">fixes</A> are stored. <A HREF = "read_restart.html">Binary restart
files</A> store more information.
</P>
<P>Bond interactions (angle, etc) that have been turned off by the <A HREF = "fix_shake.html">fix
shake</A> or <A HREF = "delete_bonds.html">delete_bonds</A> command will
be written to a data file as if they are turned on. This means they
will need to be turned off again in a new run after the data file is
read.
</P>
<P>Bonds that are broken (e.g. by a bond-breaking potential) are not
written to the data file. Thus these bonds will not exist when the
data file is read.
</P>
<P><B>Restrictions:</B>
</P>
<P>This command requires inter-processor communication to migrate atoms
before the data file is written. This means that your system must be
ready to perform a simulation before using this command (force fields
setup, atom masses initialized, etc).
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "read_data.html">read_data</A>, <A HREF = "write_restart.html">write_restart</A>
</P>
<P><B>Default:</B> none
</P>
</HTML>