LAMMPS dump local file reader

../../../_images/lammps_dump_local_reader.jpg — User interface of the LAMMPS dump local reader, when attached to a Load trajectory modifier.

For loading per-bond data from files written by the dump command of the LAMMPS simulation code.

Supported format variants

The reader specifically handles files written by the LAMMPS dump style local. Since such files only store per-bond information but no particle data, the file reader is typically used in conjunction with a Load trajectory modifier to amend an already loaded particle model with varying bonds, e.g. from a reactive MD simulation.

The reader can parse gzipped files (“.gz” suffix) directly. Binary files (“.bin” suffix) are not supported.

Column-to-property mapping

The different data columns in a dump local file must be mapped to corresponding bond properties within OVITO during file import. Since OVITO cannot guess the right mapping automatically in almost all cases (because file columns have user-defined names), you usually have to specify the correct mapping by hand in the following dialog displayed by the file reader:

../../../_images/lammps_dump_local_reader_mapping_dialog.jpg

For further information on how to set up the bond property mapping correctly, see the Load trajectory modifier.

Python parameters

The file reader accepts the following keyword parameters in a Python call to the load() function:

load(location, columns=None, **kwargs)

Parameters: columns (list[str|None]) – A list of OVITO bond property names, one for each data column in the dump local file. List entries may be set to None to skip individual file columns during parsing.