dump decomposition/vtk command

Purpose

Dumps the current domain decomposition to a VTU file

Warning

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

Syntax

dump ID group-ID style N file

  • ID = user-assigned name for the dump

  • group-ID = ID of the group of atoms to be dumped

  • style = decomposition/vtk

  • N = dump every this many timesteps

  • file = name of file to write dump info to

Examples

dump dmp all decomposition/vtk 1000 post/decomposition_*.vtu

Description

The decomposition/vtk style dumps the processor grid decomposition into a series of VTK files. Additionally, each processor domain cell contains the number of particles on this specific processor.

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

None.