min

Elementos mínimos de un arreglo

Sintaxis

M = min(A)

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

M = min(A,[],dim)

M = min(A,[],vecdim)

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

[M,I] = min(___)

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

C = min(A,B)

C = min(A,B,missingflag)

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

Descripción

M = min(A) devuelve los elementos mínimos de un arreglo.

• Si A es un vector, min(A) devuelve el mínimo de A.

• Si A es una matriz, min(A) es un vector fila que contiene el valor mínimo de cada columna de A.

• Si A es un arreglo multidimensional, min(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, min(A) devuelve una tabla de una fila que contiene el mínimo de cada variable. (desde R2023a)

M = min(A,[],"all") devuelve el mínimo de todos los elementos de A.

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

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

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

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

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

C = min(A,B) devuelve un arreglo con los elementos más pequeños tomados de A o B.

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

___ = min(___,"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 min(A,[],"ComparisonMethod","abs") compara los elementos de A según sus valores absolutos y devuelve un valor mínimo de -1.

Ejemplos

Menor elemento de un vector

Cree un vector y calcule su menor elemento.

A = [23 42 37 15 52];
M = min(A)

M = 
15

Menor elemento complejo

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

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

ans = 
-2.0000 + 2.0000i

Menor elemento de cada columna de una matriz

Cree una matriz y calcule el menor elemento de cada columna.

A = [2 8 4; 7 3 9]

A = 2×3

     2     8     4
     7     3     9

M = min(A)

M = 1×3

     2     3     4

Menor elemento de cada fila de una matriz

Cree una matriz y calcule el menor 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 = min(A,[],2)

M = 2×1

    1.2000
    1.3000

Mínimo de página de un arreglo

Cree un arreglo 3D y calcule el mínimo 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 = min(A,[],[1 2])

M1 = 
M1(:,:,1) =

    -2


M1(:,:,2) =

    -5


M1(:,:,3) =

    -3

Para calcular el mínimo 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 = min(A,[],[1 2 3])

M2 = 
-5

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

Mall = 
-5

Menor elemento con valores faltantes

Cree una matriz que contenga valores NaN.

A = [1.77 -0.005 3.98 -2.95; NaN 0.34 NaN 0.19]

A = 2×4

    1.7700   -0.0050    3.9800   -2.9500
       NaN    0.3400       NaN    0.1900

Calcule el valor mínimo de la matriz, incluidos los valores faltantes. Para columnas de matriz que contienen un valor NaN, el mínimo es NaN.

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

M = 1×4

       NaN   -0.0050       NaN   -2.9500

Índices de los menores elementos

Cree una matriz A y calcule los menores 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] = min(A)

M = 1×3

     1     4    -5

I = 1×3

     1     2     2

Devolver índices lineales

Cree una matriz A y devuelva el valor mínimo 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] = min(A,[],2,"linear")

M = 2×1

     1
     4

I = 2×1

     1
     2

minvals = A(I)

minvals = 2×1

     1
     4

Comparación de los menores elementos

Cree una matriz y devuelva el menor 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 = min(A,B)

C = 2×3

     1     5     3
     5     2     5

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, min(A) devuelve el número complejo con la menor magnitud. Si las magnitudes son iguales, min(A) devuelve el valor con la menor magnitud y el menor ángulo de fase.

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

• Si A es un arreglo vacío de 0 por 0, min(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, min(A,dim) devuelve un arreglo vacío con el mismo tamaño que A.

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

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

  

• min(A,[],2) calcula el mínimo 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, min(A,[],[1 2]) devuelve un arreglo de 1 por 1 por 3 cuyos elementos son los mínimos calculados de cada página de A.

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ínimo 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ínimo. Si falta un elemento en la dimensión operativa, falta el elemento correspondiente en M.
"includenan"	double, single, duration
"includenat"	datetime
"includeundefined"	categorical

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í

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ínimos

escalar | vector | matriz | arreglo multidimensional | tabla

Valores mínimos, 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 | 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ínimos.

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

C — Elementos mínimos de A o B

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

Elementos mínimos 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 min 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.

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

• Para el argumento de entrada A:

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

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

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

• 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 min(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 min(real(A)) o min(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 min 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, min(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, min(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ínimo 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 min 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ínimo 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

• mink | bounds | max | mean | median | sort | islocalmin | clip

Temas

• Indexación de arreglos