max

Elementos máximos de un arreglo

Sintaxis

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)

Descripción

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

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

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

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

• Si A es una tabla u horario, max(A) devuelve una tabla de una fila que contiene el máximo de cada variable. (desde R2023a)

M = max(A,[],"all") encuentra el máximo de todos los elementos de A.

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

M = max(A,[],vecdim) devuelve el máximo de las dimensiones que se especifican en el vector vecdim. Por ejemplo, si A es una matriz, max(A,[],[1 2]) devuelve el máximo de todos los elementos de A, porque todos los elementos de una matriz están incluidos en la parte del arreglo definida por las dimensiones 1 y 2.

M = max(A,[],___,missingflag) especifica si omitir o incluir los valores faltantes en A para cualquiera de las sintaxis anteriores. Por ejemplo, en max(A,[],"includemissing") se incluyen todos los valores faltantes al calcular el máximo. De forma predeterminada, max omite los valores faltantes.

[M,I] = max(___) también devuelve el índice en la dimensión operativa que corresponde a la primera aparición del valor máximo de A.

[M,I] = max(A,[],___,"linear") también devuelve el índice lineal en A que corresponde al valor máximo de A.

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

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

___ = max(___,"ComparisonMethod",method) especifica opcionalmente cómo comparar elementos para cualquiera de las sintaxis anteriores. Por ejemplo, para un vector A = [-1 2 -9], la sintaxis max(A,[],"ComparisonMethod","abs") compara los elementos de A según sus valores absolutos y devuelve un valor máximo de -9.

Ejemplos

Mayor elemento de un vector

Cree un vector y calcule su mayor elemento.

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

M = 
52

Mayor elemento complejo

Cree un vector complejo y calcule su mayor elemento, es decir, el elemento con la mayor magnitud.

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

ans = 
4.0000 + 1.0000i

Mayor elemento de cada columna de la matriz

Cree una matriz y calcule el mayor elemento 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

Mayor elemento de cada fila de la matriz

Cree una matriz y calcule el mayor elemento 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

Máximo de página de arreglo

Cree un arreglo 3D y calcule el máximo de cada página de datos (filas y columnas).

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) =

     4


M1(:,:,2) =

    13


M1(:,:,3) =

     8

Para calcular el máximo de todas las dimensiones de un arreglo, puede especificar cada dimensión en el argumento de dimensión del vector o utilizar la opción "all".

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

M2 = 
13

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

Mall = 
13

Mayor elemento, incluyendo valores faltantes

Cree una matriz que contenga valores NaN.

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

Calcule el valor máximo de la matriz, incluidos los valores faltantes. Para columnas de matriz que contengan un valor NaN, el máximo es NaN.

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

M = 1×4

       NaN    0.3400       NaN    0.1900

Índices de los mayores elementos

Cree una matriz A y calcule los mayores elementos en 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

Devolver índices lineales

Cree una matriz A y devuelva el valor máximo de cada fila de la matriz M. Utilice la opción "linear" para devolver también los índices lineales I como 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

Comparación de los mayores elementos

Cree una matriz y devuelva el mayor valor entre cada uno de sus elementos comparado 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

Argumentos de entrada

A — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Arreglo de entrada, especificado como escalar, vector, matriz, arreglo multidimensional, tabla u horario.

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

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

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

Si A tiene el tipo categorical, debe ser ordinal.

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

dim — Dimensión en la que operar

escalar entero positivo

Dimensión en la que operar, especificada como escalar entero positivo. Si no especifica la dimensión, el valor predeterminado es la primera dimensión del arreglo cuyo tamaño no es igual a 1.

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

Considere una matriz de entrada de m por n, A:

• max(A,[],1) calcula el máximo de los elementos de cada columna de A y devuelve un vector fila de 1 por n.

  

• max(A,[],2) calcula el máximo de los elementos de cada fila de A y devuelve un vector columna de m por 1.

  

vecdim — Vector de dimensiones

vector de enteros positivos

Vector de dimensiones, especificado como vector de enteros positivos. Cada elemento representa una dimensión del arreglo de entrada. Las longitudes de la salida en las dimensiones operativas especificadas son 1, mientras que las demás se mantienen iguales.

Considere un arreglo de entrada de 2 por 3 por 3, A. En ese caso, max(A,[],[1 2]) devuelve un arreglo de 1 por 1 por 3 cuyos elementos son los máximos calculados de cada página de A.

B — Arreglo de entrada adicional

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Arreglo de entrada adicional, especificado como escalar, vector, matriz, arreglo multidimensional, tabla u horario. Las entradas A y B deben ser del mismo tamaño o tener tamaños compatibles (por ejemplo, A es una matriz M por N y B es un escalar o un vector fila 1 por N). Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

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

• Si A y B son arreglos categorical ordinales, deben tener los mismos conjuntos de categorías con el mismo orden.

• Si A o B es una tabla u horario, la otra entrada puede ser un arreglo, una tabla o un horario.

Si B tiene el tipo categorical, debe ser ordinal.

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

missingflag — Condición de valor faltante

"omitmissing" (predeterminado) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined"

Condición de valor faltante, especificada como uno de los valores de esta tabla.

Valor	Tipo de datos de entrada	Descripción
"omitmissing"	Todos los tipos de datos admitidos	Ignora los valores faltantes en los arreglos de entrada y calcula el máximo en menos puntos. Si faltan todos los elementos de la dimensión operativa, falta el elemento correspondiente en M.
"omitnan"	double, single, duration
"omitnat"	datetime
"omitundefined"	categorical
"includemissing"	Todos los tipos de datos admitidos	Incluye los valores faltantes en los arreglos de entrada al calcular el máximo. Si falta un elemento en la dimensión operativa, falta el elemento correspondiente en M.
"includenan"	double, single, duration
"includenat"	datetime
"includeundefined"	categorical

method — Método de comparación

"auto" (predeterminado) | "real" | "abs"

Método de comparación, especificado como uno de estos valores:

• "auto": en un arreglo de entrada numérico A, compare elementos mediante real(A) cuando A sea real y mediante abs(A) cuando A sea complejo.

• "real": en un arreglo de entrada numérico A, compare elementos mediante real(A) cuando A sea real o complejo. Si A tiene elementos con las mismas partes reales, utilice imag(A) para resolver empates.

• "abs": en un arreglo de entrada numérico A, compare elementos mediante abs(A) cuando A sea real o complejo. Si A tiene elementos con la misma magnitud, utilice angle(A) en el intervalo (-π,π] para resolver empates.

Argumentos de salida

M — Valores máximos

escalar | vector | matriz | arreglo multidimensional | tabla

Valores máximos, devueltos como escalar, vector, matriz o arreglo multidimensional o tabla. 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 de A, a menos que size(A,dim) sea 0. Si size(A,dim) es 0, M es un arreglo vacío con el mismo tamaño que A.

I — Índice

escalar | vector | matriz | arreglo multidimensional | tabla

Índice, devuelto como escalar, vector, matriz, arreglo multidimensional o tabla. I es del mismo tamaño que la primera salida.

Cuando "linear" no se especifica, I es el índice en la dimensión operativa. Cuando "linear" se especifica, I contiene los índices lineales de A que corresponden a los valores máximos.

Si el elemento mayor aparece más de una vez, I contiene el índice de la primera vez que aparece el valor.

C — Elementos máximos de A o B

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Elementos máximos de A o B, devueltos como escalar, vector, matriz, arreglo multidimensional, tabla u horario. El tamaño de C está determinado por 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 son el mismo tipo de datos, C coincide con el tipo de datos de A y B.

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

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

• Si A o B son una tabla o un horario, C es una tabla o un horario.

Capacidades ampliadas

Arreglos altos

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

La función max es compatible con arreglos altos con las siguientes notas y limitaciones de uso:

• No se admite la salida de índices para entradas tabulares altas.

Para obtener más información, consulte Arreglos altos.

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

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

Notas y limitaciones de uso:

• Para utilizar un arreglo vacío como segundo argumento en el tiempo de ejecución, debe especificar un arreglo de tamaño fijo de 0 por 0 en el tiempo de generación del código.

• Si se utilizan, los argumentos dim, vecdim, missingflag y method deben ser constantes en el tiempo de generación del código.

• Para el argumento de entrada A:

  • Si no especifica ninguna dimensión, el generador de código opera en la primera dimensión del arreglo de entrada que sea de tamaño variable o cuyo tamaño no sea igual a 1. Si esta dimensión es de tamaño variable en el tiempo de generación del código y tiene el valor 1 en el tiempo de ejecución, puede producirse un error en el tiempo de ejecución. Para evitar este error, especifique la dimensión.

  • En el código generado, el arreglo de entrada sigue siendo complejo, aunque todos sus elementos tengan partes imaginarias de valor cero. En estas circunstancias, los resultados producidos por el código generado pueden diferir de los producidos por MATLAB. Consulte Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder).

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• Para utilizar un arreglo vacío como segundo argumento en el tiempo de ejecución, debe especificar un arreglo de tamaño fijo de 0 por 0 en el tiempo de generación del código.

• Si se utilizan, los argumentos dim, vecdim, missingflag y method deben ser constantes en el tiempo de generación del código.

• Si no se especifica el argumento dim, el generador de código opera en la primera dimensión de A que sea de tamaño variable o cuyo tamaño no sea igual a 1.

• Si A es complejo, y todos los elementos de A tienen partes imaginarias de valor cero, MATLAB^® podría convertir A en real(A) antes de llamar a max(A). En este caso, MATLAB compara elementos según real(A), pero el código generado compara elementos según abs(A). Para que el código generado coincida con MATLAB, utilice max(real(A)) o max(A,'ComparisonMethod','real'). Consulte Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder).

Generación de código HDL

Genere código VHDL, Verilog y SystemVerilog para diseños FPGA y ASIC mediante HDL Coder™.

Notas y limitaciones de uso:

• No se admiten las entradas de matrices 3D o mayores.

• No se admiten las entradas con tipos de datos complejos.

• Las matrices o vectores de entrada deben ser del mismo tamaño.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función max es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• No se admite la salida de índices para entradas tabulares distribuidas.

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2024b: No se admite especificar el segundo arreglo de entrada como un arreglo de caracteres

Especificar un segundo arreglo de entrada como un arreglo de caracteres devuelve un error. Este cambio evita confusiones con otros argumentos que pueden especificarse como vectores de caracteres, como la condición de valor faltante. Para mantener la funcionalidad anterior, puede convertir el segundo arreglo de entrada en double, por ejemplo, max(A,double(B),"includenan").

R2023b: No es posible especificar el segundo arreglo de entrada como un arreglo de caracteres

Especificar un segundo arreglo de entrada como un arreglo de caracteres emitirá una advertencia y generará un error en una versión futura. Este cambio evita confusiones con otros argumentos que pueden especificarse como vectores de caracteres, como la condición de valor faltante. Para mantener la funcionalidad anterior, puede convertir el segundo arreglo de entrada en double, por ejemplo, max(A,double(B),"includenan").

R2023a: Especificar una condición de valor faltante

Omita o incluya todos los valores faltantes en los arreglos de entrada al calcular el valor máximo usando las opciones "omitmissing" o "includemissing". Anteriormente, "omitnan", "includenan", "omitnat", "includenat", "omitundefined" y "includeundefined" especificaban una condición de valor faltante que era específica del tipo de datos de los arreglos de entrada.

R2023a: Realizar cálculos directamente en tablas y horarios

La función max puede realizar cálculos sobre todas las variables de una tabla u horario sin indexar para acceder a dichas variables. Todas las variables deben tener tipos de datos que admitan el cálculo. Para obtener más información, consulte Direct Calculations on Tables and Timetables.

R2021b: Especificar el método de comparación

Especifique el método de valor real o absoluto para determinar el valor máximo de la entrada utilizando el parámetro ComparisonMethod.

R2018b: Operar en varias dimensiones

Opere en varias dimensiones de los arreglos de entrada al mismo tiempo. Especifique un vector de dimensiones operativas o especifique la opción "all" para operar en todas las dimensiones de los arreglos.

Consulte también

Funciones

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

Temas

• Indexación de arreglos