\(\renewcommand{\AA}{\text{Å}}\)

# dump atom/adios command

# dump custom/adios command

## Syntax

    dump ID group-ID atom/adios N file.bp
    dump ID group-ID custom/adios N file.bp args

- ID = user-assigned name for the dump

- group-ID = ID of the group of atoms to be imaged

- adios = style of dump command (other styles atom or cfg or dcd or xtc or xyz or local or custom are discussed on the dump doc page)

- N = dump every this many timesteps

- file.bp = name of file/stream to write to

- args = same options as in dump custom command

## Examples

    dump adios1 all atom/adios   100 atoms.bp
    dump 4a     all custom/adios 100 dump_adios.bp id v_p x y z
    dump 2 subgroup custom/adios 100 dump_adios.bp mass type xs ys zs vx vy vz

## Description

Dump a snapshot of atom coordinates every \(N\) timesteps in the ADIOS-based “BP” file format, or using different I/O solutions in ADIOS, to a stream that can be read on-line by another program. ADIOS-BP files are binary, portable, and self-describing.

Note

To be able to use ADIOS, a file `adios2_config.xml` with specific configuration settings is expected in the current working directory. If the file is not present, LAMMPS will try to create a minimal default file. Please refer to the ADIOS documentation for details on how to adjust this file for optimal performance and desired features.

Use from write_dump:

It is possible to use these dump styles with the write_dump command. In this case, the sub-intervals must not be set at all. The write_dump command can be used to create a new file at each individual dump.

    dump 4     all atom/adios 100 dump.bp
    write_dump all atom/adios singledump.bp

## Restrictions

The number of atoms per snapshot can change with the adios style. When using the ADIOS tool ‘bpls’ to list the content of a .bp file, bpls will print __ for the size of the output table indicating that its size is changing every step.

The atom/adios and custom/adios dump styles are part of the ADIOS package. They are only enabled if LAMMPS was built with that package. See the Build package page for more info.

## Related commands

dump, dump_modify, undump