bounds

Valores mínimo y máximo de un arreglo

Sintaxis

[minA,maxA] = bounds(A)

[minA,maxA] = bounds(A,"all")

[minA,maxA] = bounds(A,dim)

[minA,maxA] = bounds(A,vecdim)

[minA,maxA] = bounds(___,missingflag)

Descripción

[minA,maxA] = bounds(A) devuelve el valor mínimo minA y el valor máximo maxA de un arreglo. minA equivale a min(A) y maxA equivale a max(A).

[minA,maxA] = bounds(A,"all") calcula los valores mínimo y máximo de todos los elementos de A.

[minA,maxA] = bounds(A,dim) opera en la dimensión dim de A. Por ejemplo, si A es una matriz, bounds(A,2) devuelve los vectores columna minA y maxA que contienen los valores mínimo y máximo de cada fila.

[minA,maxA] = bounds(A,vecdim) calcula los valores mínimo y máximo basándose en las dimensiones especificadas en el vector vecdim. Por ejemplo, si A es una matriz, bounds(A,[1 2]) devuelve los valores mínimo y máximo 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.

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

Ejemplos

Valores mínimo y máximo de un vector

Calcule simultáneamente los valores mínimo y máximo de un vector.

A = [2 4 -1 10 6 3 0 -16];
[minA,maxA] = bounds(A)

minA = 
-16

maxA = 
10

Valores mínimo y máximo de las filas de una matriz

Calcule los valores mínimo y máximo en cada fila de una matriz.

A = magic(4)

A = 4×4

    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1

[minA,maxA] = bounds(A,2)

minA = 4×1

     2
     5
     6
     1

maxA = 4×1

    16
    11
    12
    15

Límites de página de arreglo

Cree un arreglo 3D y calcule los valores mínimo y 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];
[minA1,maxA1] = bounds(A,[1 2]);
minA1

minA1 = 
minA1(:,:,1) =

    -2


minA1(:,:,2) =

    -5


minA1(:,:,3) =

    -3

maxA1

maxA1 = 
maxA1(:,:,1) =

     4


maxA1(:,:,2) =

    13


maxA1(:,:,3) =

     8

Para calcular los límites 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".

[minA2,maxA2] = bounds(A,[1 2 3])

minA2 = 
-5

maxA2 = 
13

[minAall,maxAall] = bounds(A,"all")

minAall = 
-5

maxAall = 
13

Límites con valores faltantes

Cree una matriz que contenga valores NaN.

A = [2 NaN 6 -5; 0 3 NaN 9]

A = 2×4

     2   NaN     6    -5
     0     3   NaN     9

Calcule los valores mínimo y máximo de la matriz incluyendo los valores NaN. Para columnas de matriz que contienen un valor NaN, el mínimo y máximo son NaN.

[minA,maxA] = bounds(A,"includenan")

minA = 1×4

     0   NaN   NaN    -5

maxA = 1×4

     2   NaN   NaN     9

Argumentos de entrada

A — Arreglo de entrada

vector | matriz | arreglo multidimensional | tabla | horario

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

Tipos de datos: single | double | 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.

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

• bounds(A,1) calcula los valores mínimo y máximo de cada columna de A y devuelve dos vectores fila de 1 por n.

  

• bounds(A,2) calcula los valores mínimo y máximo de cada fila de A y devuelve dos vectores 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, [minA,maxA] = bounds(A,[1 2]) devuelve un arreglo de 1 por 1 por 3 tanto para minA como para maxA. Los elementos de minA y maxA son los valores mínimo y máximo de la página correspondiente de A, respectivamente.

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 y el máximo en menos puntos. Si faltan todos los elementos de la dimensión operativa, faltan los elementos correspondientes en minA y maxA.
"omitnan"	double, single, duration
"omitnat"	datetime
"omitundefined"	categorical
"includemissing"	Todos los tipos de datos admitidos	Incluye los valores faltantes en el arreglo de entrada al calcular el mínimo y el máximo. Si falta un elemento en la dimensión operativa, faltan los elementos correspondientes en minA y maxA.
"includenan"	double, single, duration
"includenat"	datetime
"includeundefined"	categorical

Argumentos de salida

minA — Valor mínimo

vector | matriz | arreglo multidimensional | tabla

Valor mínimo, devuelto como vector, matriz, arreglo multidimensional o tabla.

maxA — Valor máximo

vector | matriz | arreglo multidimensional | tabla

Valor máximo, especificado como vector, matriz, arreglo multidimensional o tabla.

Capacidades ampliadas

Arreglos altos

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

La función bounds 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™.

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 bounds 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™.

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 en R2017a

R2023a: Especificar una condición de valor faltante

Omita o incluya los valores faltantes en el arreglo de entrada al calcular el mínimo y el 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 del arreglo de entrada.

R2023a: Realizar cálculos directamente en tablas y horarios

La función bounds 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.

R2018b: Operar en varias dimensiones

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

Consulte también

min | max