Maximum elements of array - MATLAB max (2024)

Table of Contents
Syntax Description Examples Largest Vector Element Largest Complex Element Largest Element in Each Matrix Column Largest Element in Each Matrix Row Maximum of Array Page Largest Element Including Missing Values Largest Element Indices Return Linear Indices Largest Element Comparison Input Arguments A — Input array scalar | vector | matrix | multidimensional array | table | timetable dim — Dimension to operate along positive integer scalar vecdim — Vector of dimensions vector of positive integers B — Additional input array scalar | vector | matrix | multidimensional array | table | timetable missingflag — Missing value condition "omitmissing" (default) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined" method — Comparison method "auto" (default) | "real" | "abs" Output Arguments M — Maximum values scalar | vector | matrix | multidimensional array | table I — Index scalar | vector | matrix | multidimensional array | table C — Maximum elements from A or B scalar | vector | matrix | multidimensional array | table | timetable Extended Capabilities Tall Arrays Calculate with arrays that have more rows than fit in memory. C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™. GPU Code Generation Generate CUDA® code for NVIDIA® GPUs using GPU Coder™. HDL Code Generation Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™. Thread-Based Environment Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool. GPU Arrays Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™. Distributed ArraysPartition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™. Version History R2023b: Specifying second input array as character array will not be supported R2023a: Specify missing value condition R2023a: Perform calculations directly on tables and timetables R2021b: Specify comparison method R2018b: Operate on multiple dimensions See Also Functions Topics MATLAB Command Americas Europe Asia Pacific References

Maximum elements of array

collapse all in page

Syntax

M = max(A)

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

M = max(A,[],dim)

M = max(A,[],vecdim)

M = max(A,[],___,missingflag)

[M,I] =max(___)

[M,I] =max(A,[],___,"linear")

C = max(A,B)

C = max(A,B,missingflag)

___ = max(___,"ComparisonMethod",method)

Description

example

M = max(A) returns the maximum elements of an array.

  • If A is a vector, then max(A) returns the maximum of A.

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

  • If A is a multidimensional array, then max(A) operates along the first dimension of A whose size is greater than 1, treating the elements as vectors. The size of M in this dimension becomes 1, while the sizes of all other dimensions remain the same as in A. If A is an empty array whose first dimension has zero length, then M is an empty array with the same size as A.

  • If A is a table or timetable, then max(A) returns a one-row table containing the maximum of each variable. (since R2023a)

example

M = max(A,[],"all") finds the maximum over all elements of A.

example

M = max(A,[],dim) returns the maximum element along dimension dim. For example, if A is a matrix, then max(A,[],2) returns a column vector containing the maximum value of each row.

example

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

example

M = max(A,[],___,missingflag) specifies whether to omit or include missing values in A for any of the previous syntaxes. For example, max(A,[],"includemissing") includes all missing values when computing the maximum. By default, max omits missing values.

example

[M,I] =max(___) also returns the index into the operating dimension that corresponds to the first occurrence of the maximum value of A.

example

[M,I] =max(A,[],___,"linear") also returns the linear index into A that corresponds to the maximum value in A.

example

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

C = max(A,B,missingflag) also specifies how to treat missing values.

___ = max(___,"ComparisonMethod",method) optionally specifies how to compare elements for any of the previous syntaxes. For example, for a vector A = [-1 2 -9], the syntax max(A,[],"ComparisonMethod","abs") compares the elements of A according to their absolute values and returns a maximum value of -9.

Examples

collapse all

Largest Vector Element

Open Live Script

Create a vector and compute its largest element.

A = [23 42 37 18 52];M = max(A)
M = 52

Largest Complex Element

Open Live Script

Create a complex vector and compute its largest element, that is, the element with the largest magnitude.

A = [-2+2i 4+i -1-3i];max(A)
ans = 4.0000 + 1.0000i

Largest Element in Each Matrix Column

Create a matrix and compute the largest element in each column.

A = [2 8 4; 7 3 9]
A = 2×3 2 8 4 7 3 9
M = max(A)
M = 1×3 7 8 9

Largest Element in Each Matrix Row

Open Live Script

Create a matrix and compute the largest element in each row. 

A = [1.7 1.2 1.5; 1.3 1.6 1.99]
A = 2×3 1.7000 1.2000 1.5000 1.3000 1.6000 1.9900
M = max(A,[],2)
M = 2×1 1.7000 1.9900

Maximum of Array Page

Open Live Script

Create a 3-D array and compute the maximum over each page of data (rows and columns).

A(:,:,1) = [2 4; -2 1];A(:,:,2) = [9 13; -5 7];A(:,:,3) = [4 4; 8 -3];M1 = max(A,[],[1 2])
M1 = M1(:,:,1) = 4M1(:,:,2) = 13M1(:,:,3) = 8

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

M2 = max(A,[],[1 2 3])
M2 = 13
Mall = max(A,[],"all")
Mall = 13

Largest Element Including Missing Values

Open Live Script

Create a matrix containing NaN values.

A = [1.77 -0.005 NaN -2.95; NaN 0.34 NaN 0.19]
A = 2×4 1.7700 -0.0050 NaN -2.9500 NaN 0.3400 NaN 0.1900

Compute the maximum value of the matrix, including missing values. For matrix columns that contain any NaN value, the maximum is NaN.

M = max(A,[],"includemissing")
M = 1×4 NaN 0.3400 NaN 0.1900

Largest Element Indices

Open Live Script

Create a matrix A and compute the largest elements in each column, as well as the row indices of A in which they appear.

A = [1 9 -2; 8 4 -5]
A = 2×3 1 9 -2 8 4 -5
[M,I] = max(A)
M = 1×3 8 9 -2
I = 1×3 2 1 1

Return Linear Indices

Open Live Script

Create a matrix A and return the maximum value of each row in the matrix M. Use the "linear" option to also return the linear indices I such that M = A(I). 

A = [1 2 3; 4 5 6]
A = 2×3 1 2 3 4 5 6
[M,I] = max(A,[],2,"linear")
M = 2×1 3 6
I = 2×1 5 6
maxvals = A(I)
maxvals = 2×1 3 6

Largest Element Comparison

Open Live Script

Create a matrix and return the largest value between each of its elements compared to a scalar.

A = [1 7 3; 6 2 9]
A = 2×3 1 7 3 6 2 9
B = 5;C = max(A,B)
C = 2×3 5 7 5 6 5 9

Input Arguments

collapse all

A — Input array
scalar | vector | matrix | multidimensional array | table | timetable

Input array, specified as a scalar, vector, matrix, multidimensional array, table, or timetable.

  • If A is complex, then max(A) returnsthe complex number with the largest magnitude. If magnitudes areequal, then max(A) returns the value with the largestmagnitude and the largest phase angle.

  • If A is a scalar, then max(A) returns A.

  • If A is a 0-by-0 empty array, then max(A) isas well.

If A has type categorical, then it must be ordinal.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration | table | timetable
Complex Number Support: Yes

dim — Dimension to operate along
positive integer scalar

Dimension to operate along, specified as a positive integer scalar. If you do not specify the dimension, then the default is the first array dimension of size greater than 1.

Dimension dim indicates the dimension whoselength reduces to 1. The size(M,dim) is 1,while the sizes of all other dimensions remain the same, unless size(A,dim) is 0.If size(A,dim) is 0, then max(A,dim) returnsan empty array with the same size as A.

Consider an m-by-n input matrix, A:

  • max(A,[],1) computes the maximum of the elements in each column of A and returns a 1-by-n row vector.

    Maximum elements of array - MATLAB max (1)

  • max(A,[],2) computes the maximum of the elements in each row of A and returns an m-by-1 column vector.

    Maximum elements of array - MATLAB max (2)

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 max(A,[],[1 2]) returns a 1-by-1-by-3 array whose elements are the maximums computed over each page of A.

Maximum elements of array - MATLAB max (3)

B — Additional input array
scalar | vector | matrix | multidimensional array | table | timetable

Additional input array, specified as a scalar, vector, matrix, multidimensional array, table, or timetable. Inputs A and B must either be the same size or have sizes that are compatible (for example, A is an M-by-N matrix and B is a scalar or 1-by-N row vector). For more information, see Compatible Array Sizes for Basic Operations.

  • If A and B are both arrays, then they must be the same data type unless one is a double. In that case, the data type of the other array can be single, duration, or any integer type.

  • If A and B are ordinal categorical arrays, they must have the same sets of categories with the same order.

  • If either A or B is a table or timetable, then the other input can be an array, table, or timetable.

If B has type categorical, then it must be ordinal.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration | table | timetable
Complex Number Support: Yes

missingflag — Missing value condition
"omitmissing" (default) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined"

Missing value condition, specified as one of the values in this table.

ValueInput Data TypeDescription
"omitmissing"All supported data typesIgnore missing values in the input arrays, and compute the maximum over fewer points. If all elements in the operating dimension are missing, then the corresponding element in M is missing.
"omitnan"double, single, duration
"omitnat"datetime
"omitundefined"categorical
"includemissing"All supported data types

Include missing values in the input arrays when computing the maximum. If any element in the operating dimension is missing, then the corresponding element in M is missing.

"includenan"double, single, duration
"includenat"datetime
"includeundefined"categorical

method — Comparison method
"auto" (default) | "real" | "abs"

Comparison method for numeric input, specified as one of these values:

  • "auto" — For a numeric input array A, compare elements by real(A) when A is real, and by abs(A) when A is complex.

  • "real" — For a numeric input array A, compare elements by real(A) when A is real or complex. If A has elements with equal real parts, then use imag(A) to break ties.

  • "abs" — For a numeric input array A, compare elements by abs(A) when A is real or complex. If A has elements with equal magnitude, then use angle(A) in the interval (-π,π] to break ties.

Output Arguments

collapse all

M — Maximum values
scalar | vector | matrix | multidimensional array | table

Maximum values, returned as a scalar, vector, matrix, multidimensional array, or table. size(M,dim) is 1, while the sizes of all other dimensions match the size of the corresponding dimension in A, unless size(A,dim) is 0. If size(A,dim) is 0, then M is an empty array with the same size as A.

I — Index
scalar | vector | matrix | multidimensional array | table

Index, returned as a scalar, vector, matrix, multidimensional array, or table. I is the same size as the first output.

When "linear" is not specified, I is the index into the operating dimension. When "linear" is specified, I contains the linear indices of A corresponding to the maximum values.

If the largest element occurs more than once, then I contains the index to the first occurrence of the value.

C — Maximum elements from A or B
scalar | vector | matrix | multidimensional array | table | timetable

Maximum elements from A or B, returned as a scalar, vector, matrix, multidimensional array, table, or timetable. The size of C is determined by implicit expansion of the dimensions of A and B. For more information, see Compatible Array Sizes for Basic Operations.

The data type of C depends on the data typesof A and B:

  • If A and B arethe same data type, then C matches the data typeof A and B.

  • If either A or B is single,then C is single.

  • If either A or B isan integer data type with the other a scalar double,then C assumes the integer data type.

  • If either A or B is a table or timetable, then C is a table or timetable.

Extended Capabilities

This function fully supports GPU arrays. For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Version History

Introduced before R2006a

expand all

Specifying a second input array as a character array gives a warning and will generate an error in a future release. This change minimizes confusion with other arguments that can be specified as character vectors, such as the missing value condition. To maintain the previous functionality, you can convert the second input array to double, for example, max(A,double(B),'includenan').

Omit or include all missing values in the input arrays when computing the maximum value by using the "omitmissing" or "includemissing" options. Previously, "omitnan", "includenan", "omitnat", "includenat", "omitundefined", and "includeundefined" specified a missing value condition that was specific to the data type of the input arrays.

The max function can calculate on all variables within a table or timetable without indexing to access those variables. All variables must have data types that support the calculation. For more information, see Direct Calculations on Tables and Timetables.

Specify the real or absolute value method for determining the maximum value of the input by using the ComparisonMethod parameter.

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

See Also

Functions

  • maxk | bounds | min | mean | median | sort | islocalmax | clip

Topics

  • Array Indexing

MATLAB Command

You clicked a link that corresponds to this MATLAB command: 

 
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
 
 
 
 
 
 
 
 Maximum elements of array - MATLAB max (4) 
 
 
 
 
Select a Web Site
 
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
 
 
 
You can also select a web site from the following list:
 
 
 
Americas
 
     
  • América Latina (Español)
    •  
  • Canada (English)
    •  
  • United States (English)
    •  
 
 
 
Europe
 
 
 
     
  • Belgium (English)
    •  
  • Denmark (English)
    •  
  • Deutschland (Deutsch)
    •  
  • España (Español)
    •  
  • Finland (English)
    •  
  • France (Français)
    •  
  • Ireland (English)
    •  
  • Italia (Italiano)
    •  
  • Luxembourg (English)
    •  
 
 
 
     
  • Netherlands (English)
    •  
  • Norway (English)
    •  
  • Österreich (Deutsch)
    •  
  • Portugal (English)
    •  
  • Sweden (English)
    •  
  • Switzerland 
       
    • Deutsch
      •  
    • English
      •  
    • Français
      •  
     
    •  
  • United Kingdom (English)
    •  
 
 
 
 
 
Asia Pacific
  
 
 
Contact your local office
 
 
 
 
 

                                                        Maximum elements of array - MATLAB max (2024)
                        

                            
                        

                    

                                                            
References

    
                                                
Top Articles

                            

                                                                    



    
    

        34 Recipes That Got Us Through the Great Depression
    


                                                                    



    
    

        Prop Firms with High Leverage 2024 - ProprietaryFirms.com
    


                                                                                                    



    
    

        My Uhs Ut Austin
    


                



    
    

        Haktuts Coin Master 50 Free Spins link [Today's Links 6 July 2024]
    


                



    
    

        Find Jeopardy Games About fema is 860 c test answers quizlet
    


                



    
    

        AP US HISTORYTo What Extent Was The Election Of 1860 A Turning Point In American Political, Social, And
    


                



    
    

        Diablo 2 Resurrected Blizzard Sorceress Build
    


                



    
    

        Quad-City Times from Davenport, Iowa
    


                



    
    

        Culver's Hacks That Will Change The Way You Order Forever - Mashed
    


                



    
    

        Best of the Money blog
    


                



    
    

        Fort Myers, FL Real Estate & Homes for Sale | realtor.com®
    


                



    
    

        Jio Rockers 2022
    


                                                                

                                                                
Latest Posts

                        

                                                            



    
    

        Millionaire Shortbread Recipe (Caramel Shortbread)
    


                                                            



    
    

        Swedish Meatball Sauce Recipe - Sauce Fanatic
    


                                                    

                    
                    

        

    
    
    



                    

    
Article information

    
Author:  Corie Satterfield 

    
Last Updated:   

    
Views: 6310

    
Rating: 4.1 / 5 (42 voted)

    
Reviews: 81% of readers found this page helpful





    
Author information

    
Name: Corie Satterfield

    
Birthday: 1992-08-19

    
Address: 850 Benjamin Bridge, Dickinsonchester, CO 68572-0542

    
Phone: +26813599986666

    
Job: Sales Manager

    
Hobby: Table tennis, Soapmaking, Flower arranging, amateur radio, Rock climbing, scrapbook, Horseback riding

    
Introduction: My name is Corie Satterfield, I am a fancy, perfect, spotless, quaint, fantastic, funny, lucky person who loves writing and wants to share my knowledge and understanding with you.