forked from lijiext/lammps
93 lines
3.7 KiB
HTML
93 lines
3.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>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>
|