max

Elementos máximos de un array

Sintaxis

M = max(A)

M = max(A,[],dim)

M = max(A,[],nanflag)

M = max(A,[],dim,nanflag)

[M,I] = max(___)

C = max(A,B)

C = max(A,B,nanflag)

Descripción

M = max(A) devuelve los elementos máximos de un array.

• Si A es un vector, max(A) devuelve el máximo de A.

• Si A es una matriz, max(A) es un vector de fila que contiene el valor máximo de cada columna.

• Si A es un array multidimensional, max(A) opera a lo largo de la primera dimensión del array cuyo tamaño no es igual a 1, tratando los elementos como vectores. El tamaño de esta dimensión se convierte en 1, mientras que los tamaños de todas las demás dimensiones permanecen iguales. Si A es un array vacío cuya primera dimensión tiene una longitud de cero, max(A) devuelve un array vacío con el mismo tamaño que A.

M = max(A,[],dim) devuelve los elementos más grandes a lo largo de la dimensión dim. Por ejemplo, si A es una matriz, max(A,[],2) es un vector de columna que contiene el valor máximo de cada fila.

M = max(A,[],nanflag) especifica si se deben incluir u omitir los valores NaN en el cálculo. Por ejemplo, max(A,[],'includenan') incluye todos los valores NaN en A, mientras que max(A,[],'omitnan') los ignora.

M = max(A,[],dim,nanflag) también especifica la dimensión en la que operar al utilizar la opción nanflag.

[M,I] = max(___) encuentra los índices de los valores máximos de A y los devuelve en el vector de salida I, utilizando cualquiera de los argumentos de entrada de las sintaxis anteriores. Si el valor máximo se produce más de una vez, max devuelve el índice correspondiente a la primera aparición.

C = max(A,B) devuelve un array con los elementos más grandes tomados de A o B.

C = max(A,B,nanflag) también especifica cómo tratar los valores NaN.

Ejemplos

Elemento vectorial más grande

Cree un vector y calcule su elemento más grande.

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

M = 52

Elemento complejo más grande

Cree un vector complejo y calcule su elemento más grande, es decir, el elemento con mayor magnitud.

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

ans = 4.0000 + 1.0000i

Elemento más grande en cada columna de matriz

Cree una matriz y calcule el elemento más grande de cada columna.

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

Elemento más grande en cada fila de matriz

Cree una matriz y calcule el elemento más grande de cada fila.

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

Índices de elementos más grandes

Cree una matriz A y calcule los elementos más grandes de cada columna, así como los índices de fila de A en los que aparecen.

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

Comparación de elemento más grande

Cree una matriz y devuelva el valor más grande entre cada uno de sus elementos en comparación con un escalar.

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

Elemento más grande de una matriz

Cree una matriz A y utilice su representación de columna, A(:), para buscar el valor y el índice del elemento más grande.

A = [8 2 4; 7 3 9]

A = 2×3

     8     2     4
     7     3     9

A(:)

ans = 6×1

     8
     7
     2
     3
     4
     9

[M,I] = max(A(:))

M = 9

I = 6

I es el índice de A(:) que contiene el elemento más grande.

A continuación, utilice la función ind2sub para extraer los índices de fila y columna de A correspondientes al elemento más grande.

[I_row, I_col] = ind2sub(size(A),I)

I_row = 2

I_col = 3

Si solo necesita el valor máximo de A y no su índice, llame dos veces a la función max.

M = max(max(A))

M = 9

Elemento más grande que implica NaN

Cree un vector y calcule su máximo, excluyendo los valores NaN.

A = [1.77 -0.005 3.98 -2.95 NaN 0.34 NaN 0.19];
M = max(A,[],'omitnan')

M = 3.9800

max(A) también producirá este resultado, ya que 'omitnan' es la opción predeterminada.

Utilice el marcador 'includenan' para devolver NaN.

M = max(A,[],'includenan')

M = NaN

Argumentos de entrada

A — Array de entrada

escalar | vector | matriz | array multidimensional

Array de entrada, especificado como escalar, vector, matriz o array multidimensional.

• Si A es complejo, max(A) devuelve el número complejo con la magnitud más grande. Si las magnitudes son iguales, max(A) devuelve el valor con la magnitud más grande y el ángulo de fase más grande.

• Si A es un escalar, max(A) devuelve A.

• Si A es un array vacío de 0 por 0, max(A) también.

Si A tiene el tipo categorical, debe ser ordinal.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration
Soporte de números complejos: Sí

dim — Dimensión en la que operar

escalar entero positivo

Dimensión en la que operar, especificada como un escalar entero positivo. Si no se especifica ningún valor, la opción predeterminada es la primera dimensión del array cuyo tamaño no sea igual a 1.

La dimensión dim indica la dimensión cuya longitud se reduce a 1. size(M,dim) es 1, mientras que los tamaños de todas las demás dimensiones permanecen iguales, a menos que size(A,dim) sea 0. Si size(A,dim) es 0, max(A,dim) devuelve un array vacío con el mismo tamaño que A.

Considere un array de entrada de dos dimensiones, A:

• Si dim = 1, max(A,[],1) devuelve un vector de fila que contiene el elemento más grande de cada columna.

  

• Si dim = 2, max(A,[],2) devuelve un vector de columna que contiene el elemento más grande de cada fila.

  

max devuelve A si dim es mayor que ndims(A).

B — Array de entrada adicional

escalar | vector | matriz | array multidimensional

Array de entrada adicional, especificado como escalar, vector, matriz o array multidimensional. Las entradas numéricas A y B deben tener el mismo tamaño o tener tamaños compatibles (por ejemplo, A es una matriz de M por N y B es un vector de fila escalar o de 1 por N). Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

Si A y B son arrays de fecha/hora, duración o categóricos, deben tener el mismo tamaño a menos que uno sea un escalar.

• A y B deben tener el mismo tipo de datos a menos que uno sea double. En ese caso, el tipo de datos del otro array puede ser single, duration o cualquier tipo de entero.

• Si A y B son arrays categóricos ordinales, deben tener los mismos conjuntos de categorías con el mismo orden.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration
Soporte de números complejos: Sí

nanflag — Condición NaN

'omitnan' (predeterminado) | 'includenan'

Condición NaN, especificada como uno de estos valores:

• 'omitnan': ignorar todos los valores NaN de la entrada.

• 'includenan': incluir los valores NaN de la entrada en el cálculo.

Para los arrays datetime, también puede utilizar 'omitnat' o 'includenat' para omitir e incluir los valores NaT, respectivamente.

La función max no admite la opción nanflag para los arrays categorical.

Tipos de datos: char

Argumentos de salida

M — Valores máximos

escalar | vector | matriz | array multidimensional

Valores máximos, devueltos como escalar, vector, matriz o array multidimensional. size(M,dim) es 1, mientras que los tamaños de todas las demás dimensiones coinciden con el tamaño de la dimensión correspondiente en A, a menos que size(A,dim) sea 0. Si size(A,dim) es 0, M es un array vacío con el mismo tamaño que A.

I — Índice a los valores máximos de A

escalar | vector | matriz | array multidimensional

Índice a los valores máximos de A, devueltos como escalar, vector, matriz o array multidimensional. I tiene el mismo tamaño que M. Si el elemento más grande se produce más de una vez, I contiene el índice para la primera aparición del valor.

C — Elementos máximos de A o B

escalar | vector | matriz | array multidimensional

Elementos máximos de A o B, devueltos como escalar, vector, matriz o array multidimensional. El tamaño de C se determina mediante la expansión implícita de las dimensiones de A y B. Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

El tipo de datos de C depende de los tipos de datos de A y B:

• Si A y B tienen el mismo tipo de datos, C coincide con el tipo de datos de A y B.

• Si A o B es single, C es single.

• Si A o B tiene un tipo de datos entero y el otro es un escalar double, C asume el tipo de datos entero.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

Esta función soporta tall arrays con la limitación:

• No se admite la sintaxis de dos salidas [Y,I] = max(...).

Para obtener más información, consulte Arreglos altos para datos con memoria insuficiente.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas de uso y limitaciones:

• Si especifica dim, debe ser una constante.

• Consulte Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder).

• Consulte Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder).

Consulte también

bounds | mean | median | min | sort

Temas

• Indexación de arreglos

Introducido antes de R2006a

×

Abrir ejemplo

Tiene una versión modificada de este ejemplo. ¿Desea abrir este ejemplo con sus modificaciones?

No, sobrescribir la versión modificada Sí