min

Smallest element in array of fi objects

Syntax

M = min(A)

M = min(A,[],"all")

M = min(A,[],dim)

M = min(A,[],vecdim)

[M,I] = min(___)

C = min(A,B)

Description

M = min(A) returns the smallest elements along different dimensions of fi array A.

• If A is a vector, min(A) returns the smallest element in A.

• If A is a matrix, min(A) treats the columns of A as vectors, returning a row vector containing the minimum element from each column.

• If A is a multidimensional array, min operates along the first nonsingleton dimension and returns an array of minimum values.

M = min(A,[],"all") returns the minimum over all elements of A.

M = min(A,[],dim) returns the smallest elements along dimension dim.

M = min(A,[],vecdim) returns the minimum over the dimensions specified in the vector vecdim. For example, if A is a matrix, then min(A,[],[1 2]) returns the minimum over all elements in A because every element of a matrix is contained in the array slice defined by dimensions 1 and 2.

[M,I] = min(___) finds the indices of the minimum values and returns them in array I, using any of the input arguments in the previous syntaxes. If the smallest value occurs multiple times, the index of the first occurrence is returned.

C = min(A,B) returns an array with the smallest elements taken from A or B.

Examples

Smallest Element in a Vector

Create a fixed-point vector and return the minimum value from the vector.

A = fi([1,5,4,9,2],1,16);
M = min(A)

M = 
     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

Minimum Element of Each Matrix Row

Create a matrix of fixed-point values.

A = fi(magic(4),1,16)

A = 
    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

Find the smallest element of each row by finding the minimum values along the second dimension.

M = min(A,[],2)

M = 
     2
     5
     6
     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

The output, M, is a column vector that contains the smallest element of each row of A.

Minimum Element of Each Matrix Column

Create a fixed-point matrix.

A = fi(magic(4),1,16)

A = 
    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

Find the smallest element of each column.

M = min(A)

M = 
     4     2     3     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

The output, M, is a row vector that contains the smallest element of each column of A.

Find the index of each of the minimum elements.

[M,I] = min(A)

M = 
     4     2     3     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

I = 1×4

     4     1     1     4

Minimum of Array Page

Create a fixed-point 3-D array.

A = randi(16,2,2,3);
A = fi(A,1,16)

A = 
(:,:,1) =
    14     3
    15    15
(:,:,2) =
    11     5
     2     9
(:,:,3) =
    16     3
    16    16

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

Compute the minimum over each page of data (rows and columns).

M1 = min(A,[],[1 2])

M1 = 
(:,:,1) =
     3
(:,:,2) =
     2
(:,:,3) =
     3

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

To compute the minimum over all dimensions of an array, you can either specify each dimension in the vector dimension argument or use the "all" option.

M2 = min(A,[],[1 2 3])

M2 = 
     2

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

Mall = min(A,[],"all")

Mall = 
     2

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 10

Minimum Elements from Two Arrays

Create two fixed-point arrays of the same size.

A = fi([2.3,4.7,6;0,7,9.23],1,16);
B = fi([9.8,3.21,1.6;pi,2.3,1],1,16);

Find the minimum elements from A or B.

C = min(A,B)

C = 
    2.2998    3.2100    1.6001
         0    2.2998    1.0000

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

C contains the smallest elements from each pair of corresponding elements in A and B.

Minimum Element of a Complex Vector

Create a complex fixed-point vector, A.

A = fi([1+2i,2+i,3+8i,9+i],1,8)

A = 
   1.0000 + 2.0000i   2.0000 + 1.0000i   3.0000 + 8.0000i   9.0000 + 1.0000i

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 8
        FractionLength: 3

The min function finds the smallest element of a complex vector by taking the element with the smallest magnitude.

abs(A)

ans = 
    2.2500    2.2500    8.5000    9.0000

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 8
        FractionLength: 3

In vector A, the smallest elements, at position 1 and 2, have a magnitude of 2.25. The min function returns the smallest element in output M, and the index of that element in output, I.

[M,I] = min(A)

M = 
   1.0000 + 2.0000i

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 8
        FractionLength: 3

I = 
1

Although the elements at index 1 and 2 have the same magnitude, the index of the first occurrence of that value is always returned.

Input Arguments

A — Input fi array

scalar | vector | matrix | multidimensional array

fi or numeric input array, specified as a scalar, vector, matrix, or multidimensional array. The dimensions of A and B must match unless one is a scalar.

The min function ignores NaNs.

Data Types: fi | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Complex Number Support: Yes

B — Additional input array

scalar | vector | matrix | multidimensional array

Additional input fi or numeric array, specified as a scalar, vector, matrix, or multidimensional array. The dimensions of A and B must match unless one is a scalar.

The min function ignores NaNs.

Data Types: fi | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Complex Number Support: Yes

dim — dimension to operate along

positive integer scalar

Dimension to operate along, specified as a positive integer scalar. dim can also be a fi object. If you do not specify a value, the default value is the first array dimension whose size does not equal 1.

Data Types: fi | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

vecdim — Vector of dimensions

vector of positive integers

Vector of dimensions, specified as a vector of positive integers. Each element represents a dimension of the input array. The lengths of the output in the specified operating dimensions are 1, while the others remain the same.

Consider a 2-by-3-by-3 input array, A. Then min(A,[],[1 2]) returns a 1-by-1-by-3 array whose elements are the minimums computed over each page of A.

Output Arguments

M — Minimum values

scalar | vector | matrix | multidimensional array

Minimum values, returned as a scalar, vector, matrix, or multidimensional array. M always has the same data type as the input.

I — Index

scalar | vector | matrix | multidimensional array

Index, returned as a scalar, vector, matrix, or multidimensional array. If the smallest value occurs more than once, then I contains the index to the first occurrence of the value. I is always of data type double.

C — Minimum elements from A or B

scalar | vector | matrix | multidimensional array

Minimum elements from A or B, returned as a scalar, vector, matrix, or multidimensional array.

Algorithms

When A or B is complex, the min function returns the element with the smallest magnitude. If two magnitudes are equal, then min returns the first value. This behavior differs from how the built-in min function resolves ties between complex numbers.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

HDL Code Generation
Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™.

Version History

Introduced before R2006a

R2026a: Operate on multiple dimensions

Operate on multiple dimensions of the input arrays at a time. Specify a vector of operating dimensions with vecdim, or specify the "all" option to operate on all array dimensions.