spinw.addatom method

adds new atom

Syntax

addatom(obj,Name,Value)

Description

addatom(obj,Name,Value) adds a new atom to the list of symmetry inequivalent sites together with its properties, such as position, spin quantum number, form factor, etc.

Examples

To add a magnetic atom with $S=1$ at position $r=(0,0,0)$ and a non-magnetic one at $r=(1/2,0,0)$ with red and blue color respectively use the following command

crystal = spinw;
crystal.genlattice('lat_const',[4 3 3])
crystal.addatom('r',[0 1/2; 0 0; 0 0],'S',[1 0],'color',{'red' 'blue'})
crystal.plot

Input Arguments

obj: spinw object.

Name-Value Pair Arguments

r: Atomic positions stored in a matrix with dimensions of $[3\times n_{atom}]$ .
label: Names of the atoms in a cell for plotting and form factor calculations (see magion.dat), e.g. label={'atom1' 'atom2' 'atom3'}. Default value is atomi, where i is the atom index.
S: Spin quantum number stored in a row vector with $n_{atom}$ elements, for non-magnetic atoms set S to zero. If not given the spin quantum number is guessed from the given label of the atom. For example if label is MCr3+ or Cr3+ then the $S=3/2$ high spin state is assumed for Cr $^{3+}$ . The spin values for every ion is stored in the magion.dat file. If the atom type is unknown $S=0$ is assumed.
color: RGB color of the atoms for plotting stored in a matrix with dimensions of $[3\times n_{atom}]$ , where each column describes an RGB color. Each value is between 0 and 255. Default value is the color stored in the atom.dat file. Alternatively a name of the color can be given as a string, for example 'White', for multiple atoms package it into a cell. For the list of colors, see swplot.color or the color.dat file.
ox: Oxidation number given as a double or it will be determined automatically from label. Default value is 0.
occ: Occupancy, given as double. Default value is 1.
formfact: Neutron scattering form factor, given as a row vector with 9 numbers, for details see sw_mff. Also string labels can be used from the magion.dat file.
formfactn: Same as the formfact option.
formfactx: X-ray scattering form factor, given as 9 numbers, for details see sw_cff, also labels can be used from the xrayion.dat file.
Z: Atomic number, given as integer or determined from the atom label automatically. Default value is 113 (Unobtanium).
A: Atomic mass, given as integer. Default is -1 for the natural mixture of isotopes.
bn: Neutron scattering length, given as double. Not implemented yet.
bx: X-ray scattering length.
biso: Isotropic displacement factors in units of Å $^2$ . Definition is the same as in FullProf, defining the Debye-Waller factor as $W(d) = 1/8*b_{iso}/d^2$ , which is included in the structure factor as $exp(-2W(d))$ .
update: If true, existing atom with the same label and position as a new one will be updated. Default is true.

Output Arguments

The function modifies the spinw.unit_cell property of the obj spinw object.