diff --git a/doc/dump.html b/doc/dump.html index fcab28e210..fad0888e9a 100644 --- a/doc/dump.html +++ b/doc/dump.html @@ -208,7 +208,7 @@ be cut and pasted directly into a data file read by the extended CFG format files, as used by the AtomEye visualization package. Since the extended CFG format uses a single snapshot of the -system per file, a wild-card "*" must be included in the filename, as +system per file, a wildcard "*" must be included in the filename, as discussed below. The list of atom attributes for style cfg must begin with "id type xs ys zs", since these quantities are needed to write the CFG files in the appropriate format (though the "id" and @@ -276,7 +276,7 @@ dump command is invoked and closed when an undump command is used or when LAMMPS exits. For the dcd and xtc styles, this is a single large binary file.
-Dump filenames can contain two wild-card characters. If a "*" +
Dump filenames can contain two wildcard characters. 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.* becomes tmp.dump.0, tmp.dump.10000, diff --git a/doc/dump_modify.html b/doc/dump_modify.html index a13295d400..21f0943757 100644 --- a/doc/dump_modify.html +++ b/doc/dump_modify.html @@ -33,6 +33,7 @@ image arg = yes or no label arg = string string = character string (e.g. BONDS) to use in header of dump local file + pad arg = Nchar = # of characters to convert timestep to precision arg = power-of-10 value from 10 to 1000000 region arg = region-ID or "none" scale arg = yes or no @@ -153,6 +154,16 @@ ITEM: ENTRIES ...
The word "ENTRIES" will be replaced with the string specified, e.g. BONDS or ANGLES.
+The pad keyword only applies when the dump filename is specified +with a wildcard "*" character which becomes the timestep. If pad is +0, which is the default, the timestep is converted into a string of +unpadded length, e.g. 100 or 12000 or 2000000. When pad is +specified with Nchar > 0, the string is padded with leading zeroes +so they are all the same length = Nchar. For example, pad 7 would +yield 0000100, 0012000, 2000000. This can be useful so that +post-processing programs can easily read the files in ascending +timestep order. +
The precision keyword only applies to the dump xtc style. A specified value of N means that coordinates are stored to 1/N nanometer accuracy, e.g. for N = 1000, the coordinates are written to @@ -227,6 +238,7 @@ box size stored with the snapshot.