# amin#

## Purpose#

Moves across one dimension of an N-dimensional array and finds the smallest element.

## Format#

y = amin(x, dim)#
Parameters:
• x (array) – N-dimensional array

• dim (scalar) – the dimension across which to find the minimum value.

Returns:

y (N-dimensional array)

## Examples#

```/*
** Setting the rng seed allows for repeatable
** random numbers
*/
rndseed 8237348;

/*
** Create a 24x1 vector of random normal numbers
** with a standard deviation of 10 and then round
** to the nearest integer value
*/
x = round(10*rndn(24, 1));

/*
** Reshape the 24x1 vector into a 2x3x4 dimensional array
** NOTE: The pipe operator '|' is for vertical concatenation
*/
x = areshape(x, 2|3|4);

dim = 2;
y = amin(x, dim);
```

x is a 2x3x4 array, such that: [1,1,1] through [1,3,4] =

``` 1.0000000      -11.000000       9.0000000      -8.0000000
-2.0000000      -10.000000      -6.0000000      -5.0000000
-5.0000000       17.000000       9.0000000      -2.0000000
```

[2,1,1] through [2,3,4] =

```-4.0000000      -2.0000000       7.0000000      -2.0000000
4.0000000       13.000000      -16.000000       11.000000
2.0000000      -1.0000000       12.000000      -16.000000
```

y will be a 2x1x4 array, such that: [1,1,1] through [1,1,4] =

```-5.0000000      -11.000000      -6.0000000      -8.0000000
```

[2,1,1] through [2,1,4] =

```-4.0000000      -2.0000000      -16.000000      -16.000000
```
```y = amin(x, 1);
```

Using the same array x as the above example, this example finds the minimum value across the first dimension. y will be a 2x3x1 array, such that: [1,1,1] through [1,3,1] =

```-11.000000
-10.000000
-5.0000000
```

[2,1,1] through [2,3,1] =

```-4.0000000
-16.000000
-16.000000
```

## Remarks#

The output y, will have the same sizes of dimensions as x, except that the dimension indicated by dim will be collapsed to 1.