La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

max

Elementos máximos de un arreglo

Sintaxis

M = max(A)

M = max(A,[],dim)

M = max(A,[],nanflag)

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

[M,I] = max(___)

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

M = max(A,[],vecdim)

M = max(A,[],'all',nanflag)

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

[M,I] = max(A,[],'all',___)

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

C = max(A,B)

C = max(A,B,nanflag)

___ = 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 y trata 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 se mantienen iguales. Si A es un arreglo vacío cuya primera dimensión tiene longitud cero, max(A) devuelve un arreglo vacío con el mismo tamaño que 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) es un vector columna que contiene el valor máximo de cada fila.

M = max(A,[],nanflag) especifica si incluir u omitir 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 cuando se utiliza la opción nanflag.

[M,I] = max(___) también devuelve el índice en la dimensión operativa que corresponde al valor máximo de A para cualquiera de las sintaxis anteriores.

M = max(A,[],'all') encuentra el máximo de todos los elementos de A. Esta sintaxis es válida para las versiones R2018b y posteriores de MATLAB^®.

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

M = max(A,[],'all',nanflag) calcula el máximo de todos los elementos de A cuando se utiliza la opción nanflag.

M = max(A,[],vecdim,nanflag) especifica varias dimensiones en las que se desea operar cuando se utiliza la opción nanflag.

[M,I] = max(A,[],'all',___) devuelve el índice lineal en A que corresponde al valor máximo de A cuando se especifica 'all'.

[M,I] = max(A,[],___,'linear') 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,nanflag) también especifica cómo tratar valores NaN.

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

Mayor elemento con 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

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

Use el indicador 'includenan' para devolver NaN.

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

M = NaN

Í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

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 a partir de la versión R2018b, 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

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

Arreglo de entrada, especificado como escalar, vector, matriz o arreglo multidimensional.

• 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.

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 de tamaño mayor que 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

Arreglo de entrada adicional, especificado como escalar, vector, matriz o arreglo multidimensional. 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.

• A y B deben ser el 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.

Soporte de números complejos: Sí

nanflag — Condición NaN

'omitnan' (predeterminado) | 'includenan'

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

• 'omitnan': ignora todos los valores NaN en la entrada. Si todos los elementos son NaN, max devuelve el primero.

• 'includenan': incluye los valores NaN en la entrada para el cálculo.

En el caso de los arreglos datetime, también puede utilizar 'omitnat' o 'includenat' para omitir e incluir valores NaT, respectivamente.

En el caso de los arreglos categorical, también puede utilizar 'omitundefined' o 'includeundefined' para omitir e incluir valores, respectivamente.

Tipos de datos: char

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

Valores máximos, devueltos como escalar, vector, matriz o arreglo 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 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

Índice, devuelto como escalar, vector, matriz o arreglo multidimensional. 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

Elementos máximos de A o B, devueltos como escalar, vector, matriz o arreglo multidimensional. 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.

Capacidades ampliadas

Arreglos altos

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

Esta función es totalmente compatible con los arreglos altos. 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:

• Si especifica un arreglo vacío para el segundo argumento con el propósito de proporcionar dim o nanflag, el segundo argumento deberá tener un tamaño fijo y una dimensión de 0 por 0.

• Si especifica dim o nanflag, estos valores deben ser constantes.

• Si la entrada es un arreglo de tamaño variable, la longitud de la dimensión en la que operar no debe ser cero en el tiempo de ejecución.

• 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).

Generación de código de GPU

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

Notas y limitaciones de uso:

• Si especifica un arreglo vacío para el segundo argumento con el propósito de proporcionar dim o nanflag, el segundo argumento deberá tener un tamaño fijo y una dimensión de 0 por 0.

• Si especifica dim o nanflag, estos valores deben ser constantes.

• 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).

Generación de código HDL

Genere código Verilog y VHDL 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 Run MATLAB Functions in Thread-Based Environment.

Arreglos GPU

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

Esta función es totalmente compatible con los arreglos de GPU. 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™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

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

Temas

• Indexación de arreglos

×

Abrir ejemplo

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

No, sobrescribir la versión modificada Sí