# minus

Subtract DataMatrix objects

## Syntax

```DMObjNew = minus(DMObj1, DMObj2) DMObjNew = DMObj1 - DMObj2 DMObjNew = minus(DMObj1, B) DMObjNew = DMObj1 - B DMObjNew = minus(B, DMObj1) DMObjNew = B - DMObj1 ```

## Input Arguments

 `DMObj1`, `DMObj2` DataMatrix objects, such as created by `DataMatrix` (object constructor). `B` MATLAB® numeric or logical array.

## Output Arguments

 `DMObjNew` DataMatrix object created by subtraction.

## Description

```DMObjNew = minus(DMObj1, DMObj2)``` or the equivalent `DMObjNew = DMObj1 - DMObj2` performs an element-by-element subtraction of the DataMatrix object `DMObj2` from the DataMatrix object `DMObj1` and places the results in `DMObjNew`, another DataMatrix object. `DMObj1` and `DMObj2` must have the same size (number of rows and columns), unless one is a scalar (1-by-1 DataMatrix object). The size (number of rows and columns), row names, and column names for `DMObjNew` are the same as `DMObj1`, unless `DMObj1` is a scalar; then they are the same as `DMObj2`.

```DMObjNew = minus(DMObj1, B)``` or the equivalent `DMObjNew = DMObj1 - B` performs an element-by-element subtraction of `B`, a numeric or logical array, from the DataMatrix object `DMObj1`, and places the results in `DMObjNew`, another DataMatrix object. `DMObj1` and `B` must have the same size (number of rows and columns), unless `B` is a scalar. The size (number of rows and columns), row names, and column names for `DMObjNew` are the same as `DMObj1`.

```DMObjNew = minus(B, DMObj1)``` or the equivalent `DMObjNew = B - DMObj1` performs an element-by-element subtraction of the DataMatrix object `DMObj1` from `B`, a numeric or logical array, and places the results in `DMObjNew`, another DataMatrix object. `DMObj1` and `B` must have the same size (number of rows and columns), unless `B` is a scalar. The size (number of rows and columns), row names, and column names for `DMObjNew` are the same as `DMObj1`.

Note

Arithmetic operations between a scalar DataMatrix object and a nonscalar array are not supported.

MATLAB calls ```DMObjNew = minus(X, Y)``` for the syntax `DMObjNew = X - Y` when `X` or `Y` is a DataMatrix object.

## Version History

Introduced in R2008b