Back to main menu

Option: add-atom


-add-atom <species> at <x> <y> <z>

-add-atom <species> relative <index> <x> <y> <z>

-add-atom <species> near <index>

-add-atom <species> random <N>


This option adds one or more new atom(s) of the given <species> in the system.

When using the keyword at, a new atom is inserted exactly at the given location. The positions <x>, <y>, <z> are usually given in Å. It is also possible to give them with respect to the box dimensions with the keyword BOX and an operation (see this page).

When using the keyword relative, the new atom is placed at the given vector (x,y,z) relatively to the atom of the given <index>.

When using the keyword near <index> (where <index> is an integer), a new atom is inserted near the atom with the given <index>. The new atom will be inserted in the tetrahedral site formed by the atom with the given <index> and its three nearest neighbors.

When using the keyword random <N> (where <N> is an integer), then <N> new atoms are inserted at random positions in the system. The position of each new atom will be decided randomly, and then changed to be at the center of the four nearest neighbors of that position. Note that this option attempts to generate random positions for the new atoms, therefore it is largely non-reproducible, i.e. starting from the exact same system and applying the present option will likely lead to different results.

The new atom(s) are added at the end of the atom list, so that old atoms keep their former indices. In order to change the way atoms are sorted it is possible to use the option -sort.

If other atoms of the same <species> have shells (in the sense of an ionic core-shell model), then the new atoms are also created with a shell at the same position as their core. If other atoms had auxiliary properties, then the properties of the first atom of the same species are applied to the new atom(s).


By default no new atom is introduced.


Back to main menu