vtk command

Purpose

Dumps meshes defined by fix mesh/volume/vtk to files

Warning

GPU support for this command has not been tested and may not work as expected.

Syntax

dump ID group-ID style N file mesh mesh-id

ID = user-assigned name for the dump
group-ID = ID of the group of atoms to be dumped
style = mesh/volume/vtk
N = dump every this many timesteps
file = name of file to write dump info to
mesh = mandatory keyword
mesh-id = id of a fix mesh/volume/vtk

Examples

dump dmpVolumeMesh all mesh/volume/vtk 100 post/meshDump_*.vtk mesh my_volume_mesh_id

Description

mesh/volume/vtk dumps a single mesh held by a fix mesh/volume/vtk. The id of this fix needs to be given after the mesh keyword.

Dumps are performed on timesteps that are a multiple of N (including timestep 0) and on the last timestep of a minimization if the minimization converges. Note that this means a dump will not be performed on the initial timestep after the dump command is invoked, if the current timestep is not a multiple of N. This behavior can be changed via the dump_modify first command, which can also be useful if the dump command is invoked after a minimization ended on an arbitrary timestep. N can be changed between runs by using the dump_modify every command. The dump_modify every command also allows a variable to be used to determine the sequence of timesteps on which dump files are written. In this mode a dump on the first timestep of a run will also not be written unless the dump_modify first command is used.

The specified filename determines how the dump file(s) is written. The default is to write one large text file, which is opened when the dump command is invoked and closed when an undump command is used or when Aspherix® exits.

Dump filenames can contain one wildcard character. 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, tmp.dump.20000, etc. Note that the dump_modify pad command can be used to ensure all timestep numbers are the same length (e.g. 00010), which can make it easier to read a series of dump files in order with some post-processing tools.

Dump_modify:

This keyword can be influenced by several dump_modify options.

Restrictions

None.

Default