fix packing/prepare command

Warning

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

Syntax

fix ID group-ID packing/prepare file filename fix_insert fix_id insert_extend value keyword value

  • ID, group-ID are documented in fix command.

  • packing/prepare = style name of this fix command

  • file = obligatory keyword

  • filename = name of a file into which data is written

  • fix_insert = obligatory keyword

  • fix_id = id of a fix insert/stream with which particles were created

  • insert_extend = obligatory keyword

  • length = distance between the two compressive faces at the end of the compression

  • multiple keyword/value pairs may be appended

  • keyword = mesh_shift or write_at

mesh_shift value = mx my mz
  mx, my, mz = offset of insertion face at the end of the compression
write_at value = step
  step = at which step the data is written

Examples

fix pack_writer all packing/prepare file restart/stream.data fix_insert ins mesh_shift 0 0 0.123 insert_extend 0.023

Description

This fix allows to write particle data to be used in a fix insert/stream/predefined. For a general overview on how to use this fix please also see the corresponding How-To.

The file keyword with filename as the corresponding value determines the file into which the binary data will be written. fix_insert is the keyword that points to a fix with id fix_id which was used to create the particles in the simulation in Step 1 (see the How-To for an explanation of the steps). The insert_extend keyword allows to define the length of the insertion domain. This means, the distance between the two compressive plates.

The keyword mesh_shift should indicate by how much the original insertion face has moved from its original position. The write_at keyword allows to write this file at a certain time step. If it is not specified, the file will be written at the setup stage of this fix.

Restrictions

This fix only works with particles of template sphere or multiplesphere. This fix does not work in parallel mode.

Default

mesh_shift = (0.0 0.0 0.0)