# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

# minus (DataMatrix)

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.