# max

Returns maximum values.

## Syntax

m = max(x)

m = max(x, [], dim)

[m,idx] = max(...)

m = max(x, y)

## Inputs

`x`- The matrix to query.
`y`- The second matrix for a pairwise query with
`x`. `dim`- The dimension on which to operate, or 'all'.

## Outputs

- m
- The maximum values.
- idx
- The index of each maximum value. Not valid for a pairwise query.

## Examples

Vector input with two outputs:

`[m,idx] = max([1,7,5])`

```
m = 7
idx = 2
```

Matrix input:

`m = max([1,6;2,7])`

```
m = [Matrix] 1 x 2
2 7
```

Matrix input with dimension:

`m = max([1,6;2,5],[],1)`

```
m = [Matrix] 1 x 2
2 6
```

Two matrix inputs:

`m = max([1,6;2,5],[1,2;3,4])`

```
m = [Matrix] 2 x 2
1 6
3 5
```

## Comments

For a single operand, the function returns the maximum element of each vector in the specified dimension. If the second output is requested, it contains the single index of each maximum element.

For two operands with common dimensions, the function returns the maximum element from each element pair. If an operand is a single element, it is compared with each element of the other operand.

NaN single values and elements in dense matrices are ignored except when there are no numeric values to compare.