`deposit`

This keyword is used to simulate a deposition process, where new atoms are periodically added to the system during a run.

Syntax

This keyword is used in one of the following two ways:

deposit <interval> <direction> <height_min> [height_max] atom <type_1> <num_1> <velocity_1> [<type_2> <num_2> <velocity_2> ...] # usage 1
deposit <interval> <direction> <height_min> [height_max] file <add_atom_file> [velocity]                                        # usage 2

interval is the deposition interval (number of steps) and must be a positive integer. The number of steps in the run keyword must be divisible by it.
direction is the deposition direction: 0, 1, and 2 correspond to the x, y, and z directions, respectively. New atoms are placed at the given height along this direction and are given an initial velocity along it. The special value -1 is only allowed in the second usage and means that the atoms are added at the exact positions and with the exact velocities given in the file.
height_min and the optional height_max define the deposition height (in units of Ångstrom) along the deposition direction. If height_max is given, the height of each deposited atom is uniformly sampled between height_min and height_max; otherwise, all the atoms are deposited at height_min. When direction is -1, the height value(s) are not used.
In the first usage, one or more triplets <type> are given. For each triplet, num atoms of type type are added at each deposition, at random lateral positions in the simulation box, with an initial velocity velocity along the deposition direction. The atom types refer to those defined in the potential file, and the velocity is in units of Å/fs.
In the second usage, the atoms to be added at each deposition are read from the file add_atom_file, which contains one atom per row with 7 columns:
```
type x y z vx vy vz
```
The positions are in units of Ångstrom and the velocities are in units of Å/fs. With a non-negative direction, the coordinate along the deposition direction is replaced by the sampled height, and the optional velocity (in units of Å/fs) after the file name sets the velocity component along the deposition direction. With direction set to -1, no velocity is allowed after the file name and the file is used as it is.

At each deposition, the new atoms are appended to the model and the run is effectively split into sub-runs of interval steps, with one deposition between two consecutive sub-runs. After each sub-run, the current structure is written to a file named deposited_N.xyz in extended XYZ format, including the velocities (and the group labels if the model has grouping). If the simulation model file contains no velocity data, one extra sub-run of the pristine model is performed before the first deposition.

Example 1

Deposit 10 atoms of type 0 every 10000 steps, at a height of 30 Å in the z direction, with an initial velocity of -0.1 Å/fs (towards decreasing z):

deposit 10000 2 30 atom 0 10 -0.1

Example 2

Deposit 5 atoms of type 0 and 5 atoms of type 1 every 5000 steps, at heights uniformly sampled between 30 Å and 40 Å in the z direction:

deposit 5000 2 30 40 atom 0 5 -0.1 1 5 -0.1

Example 3

Deposit atoms read from the file add_atoms.txt every 10000 steps, resetting the z coordinate to 30 Å and the z velocity to -0.1 Å/fs:

deposit 10000 2 30 file add_atoms.txt -0.1

Example 4

Deposit atoms read from the file add_atoms.txt every 10000 steps, keeping the positions and velocities exactly as given in the file (direction is -1 and no velocity follows the file name):

deposit 10000 -1 0 file add_atoms.txt

Caveats

This keyword can appear only once in a run.in file, and only one run keyword is allowed when it is used.
The original run.in and model.xyz are saved as run.in.original and model.xyz.original, respectively, and the run.in and model.xyz files will be modified during the simulation.
If the model has grouping, all the deposited atoms are assigned to new groups (with labels one larger than the largest existing group label for each group method), such that they can be distinguished from the original atoms.

deposit