max

Maximum elements of an array.

Syntax

• M = max(A)
• [M, I] = max(A)
• M = max(A, [], dim)
• [M, I] = max(A, [], dim)
• M = max(A, [], dim, 'omitnan')
• [M, I] = max(A, [], dim, 'includenan')
• [M, I] = max(A, [], 'all')
• [M, I] = max(A, [], 'all', 'omitnan')
• [M, I] = max(A, [], 'all', 'includenan')
• C = max(A, B)
• C = max(A, B, 'omitnan')
• C = max(A, B, 'includenan')

Input argument

• A - a variable
• dim - a positive integer scalar (Dimension to operate along)
• 'omitnan' - ignore all NaN values. default behaviour. max will return the first element, if all elements are NaN.
• 'includenan' - include the NaN values.
• 'all' - it finds the maximum over all elements.

Output argument

• M - Maximum values of A.
• I - Index to maximum values of A.
• C - Maximum elements from A or B.

Description

max find maximum values in an array.

If A is a matrix then M = max(A) is a row vector containing the maximum value of each column.

If A is a vector then M = max(A) will return the maximum of A.

If A If A is complex number then M = max(A) will return founded complex number with the largest magnitude.

Example

A = [1 2 3; 4 5 6];
M = max(A)
M = max(A, [], 'all')

See also

min.

History

Author

Allan CORNET