### Syntax

addmatrix(obj,Name,Value)

### Description

addmatrix(obj,Name,Value) adds a new $$[3\times 3]$$ matrix to the spinw.matrix field of obj. The added matrices can be later assigned to bonds, single ion anisotropy terms or g-tensors of magnetic atoms. If the given matrix label already exists in obj, instead of adding new matrix the existing one will be overwritten.

### Examples

The first example adds a diagonal matrix eye(3), that can describe Heisenberg interaction if assigned to a bond. The second example adds an ansisymmetric matrix that can decribe Dzyaloshinskii-Moriya (DM) interaction if assigned to a bond.

crystal = spinw
crystal.matrix.mat


Output

     1     0     0
0     1     0
0     0     1

crystal.addmatrix('value',[1 0 0],'label','J_1')
crystal.matrix.mat


Output

     0     0     0
0     0     1
0    -1     0


### Input Arguments

obj
spinw object.

### Name-Value Pair Arguments

'value'
The actual numerical values to be added as a matrix. It can have the following shapes:
• $$[3\times 3]$$ the given values will be stored in spinw.matrix as they are given.
• $$[1\times 1]$$ the given value will be multiplied with eye(3).
• [Mx My Mz] the given triplet will be used to define an antisymmetric matrix M = [0 M3 -M2;-M3 0 M1;M2 -M1 0].
'label'
Label string for plotting default value is 'matI', where $$I$$ is the index of the matrix.
'color'
Color for plotting, either row vector that contains color RGB codes (values of 0-255), or a string with the name of the color, for possible colors names swplot.color. Default color is a random color.

### Output Arguments

The obj output will contain the additional matrix in the spinw.matrix field.