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.

range

Rango de valores

Sintaxis

y = range(X)

y = range(X,'all')

y = range(X,dim)

y = range(X,vecdim)

Descripción

y = range(X) devuelve la diferencia entre los valores máximos y mínimos de los datos de muestra de X.

• Si X es un vector, range(X) es el rango de los valores de X.

• Si X es una matriz, range(X) es un vector fila que contiene el rango de cada una de las columnas de X.

• Si X es un arreglo multidimensional, range opera a lo largo de la primera dimensión no singular de X, tratando los valores como vectores. El tamaño de esta dimensión pasa a ser 1, mientras que los tamaños del resto de dimensiones no varían. Si X es un arreglo vacío en el que la primera dimensión es 0, range(X) devuelve un arreglo vacío con el mismo tamaño que X.

y = range(X,'all') devuelve el rango de todos los elementos de X.

y = range(X,dim) devuelve el rango a lo largo de la dimensión operativa dim de X. Por ejemplo, si X es una matriz, range(X,2) es un vector columna que contiene el valor del rango de cada fila.

y = range(X,vecdim) devuelve el rango a lo largo de las dimensiones especificadas en el vector vecdim. Por ejemplo, si X es una matriz, range(X,[1 2]) es el rango de todos los elementos de X porque cada elemento de una matriz está contenido en la porción del arreglo definida por las dimensiones 1 y 2.

Ejemplos

Rango de números aleatorios normales estándar

Genere cinco muestras grandes de números aleatorios normales estándar.

rng('default') % For reproducibility
rv = normrnd(0,1,1000,5);

Encuentre los valores del rango de las muestras.

near6 = range(rv)

near6 = 1×5

    6.8104    6.6420    6.9578    6.0860    6.8165

El valor del rango es aproximadamente 6 para cada muestra.

Rango de puntuaciones en exámenes

Encuentre el rango de las puntuaciones en los exámenes a lo largo de cinco exámenes.

Cargue el conjunto de datos examgrades.

load examgrades

Encuentre el rango de todas las puntuaciones en los exámenes.

y = range(grades,'all')

y = 46

Rango de puntuaciones en exámenes por alumno

Encuentre el rango de las puntuaciones en los exámenes de cada alumno a lo largo de cinco exámenes.

Cargue el conjunto de datos examgrades.

load examgrades

Encuentre el rango de las puntuaciones en los exámenes de los 10 primeros alumnos. Por ejemplo, la diferencia entre la mejor y la peor puntuación del octavo alumno en los exámenes es de 7 puntos.

X = grades(1:10,:);
y = range(X,2)

y = 10×1

    12
    13
    10
    12
     8
    16
    14
     7
    12
    10

Rango a lo largo de la dimensión del vector

Encuentre el rango de un arreglo multidimensional a lo largo de varias dimensiones.

Cree un arreglo de 3 por 5 por 2 de números aleatorios normales con una media de mu = 2 y una desviación estándar de sigma = 7.

rng('default') % For reproducibility
mu = 2;
sigma = 7;
X = normrnd(mu,sigma,[3 5 2])

X = 
X(:,:,1) =

    5.7637    8.0352   -1.0351   21.3861    7.0778
   14.8372    4.2314    4.3984   -7.4492    1.5586
  -13.8119   -7.1538   27.0488   23.2445    7.0032


X(:,:,2) =

    0.5652   11.8632   -6.4524    5.4223   -0.1241
    1.1310   11.9203    7.0207    9.2429    4.0571
   12.4279    6.7005   13.4116    7.0882   -3.5110

Encuentre el rango de cada página de X especificando las dimensiones 1 y 2 como las dimensiones operativas.

ypage = range(X,[1 2])

ypage = 
ypage(:,:,1) =

   40.8607


ypage(:,:,2) =

   19.8641

Por ejemplo, ypage(1,1,2) es el rango de todos los elementos de X(:,:,2).

Encuentre el rango de elementos de cada porción de X(i,:,:) especificando las dimensiones 2 y 3 como las dimensiones operativas.

yrow = range(X,[2 3])

yrow = 3×1

   27.8385
   22.2864
   40.8607

Por ejemplo, yrow(3) es el rango de todos los elementos de X(3,:,:).

Argumentos de entrada

X — Muestra de datos

escalar | vector | matriz | arreglo multidimensional

La muestra de datos, especificada como un escalar, un vector, una matriz, o un arreglo multidimensional.

• Si X es un escalar, range(X) es 0.

• Si X es un arreglo vacío de 0 por 0, range(X) también es un arreglo vacío.

Tipos de datos: single | double | logical | datetime | duration

dim — Dimensión a lo largo de la que operar

escalar entero positivo

La dimensión a lo largo de la que operar, especificada como un escalar entero positivo. Si no especifica un valor, el valor predeterminado es la primera dimensión del arreglo cuyo tamaño no sea igual a 1.

dim indica la dimensión cuya longitud se reduce a 1. size(y,dim) es 1, mientras que los tamaños del resto de dimensiones no varían a menos que size(X,dim) sea 0. Si size(X,dim) es 0, range(X,dim) devuelve un arreglo vacío del mismo tamaño que X.

Considere una muestra de datos de dos dimensiones X:

• Si dim es igual a 1, range(X,1) devuelve un vector fila que contiene el rango de cada columna.

• Si dim es igual a 2, range(X,2) devuelve un vector columna que contiene el rango de cada fila.

Si dim es mayor que ndims(X), range devuelve un arreglo de ceros con las mismas dimensiones y valores faltantes que X.

Tipos de datos: single | double

vecdim — Vector de dimensiones

vector entero positivo

Un vector de dimensiones, especificado como un vector entero positivo. Cada elemento de vecdim representa una dimensión del arreglo de entrada X. La salida y tiene la longitud 1 en las dimensiones operativas especificadas. El resto de las longitudes de las dimensiones son iguales para X e y.

Por ejemplo, si X es un arreglo de 2 por 3 por 3, range(X,[1 2]) devuelve un arreglo de 1 por 1 por 3. Cada elemento del arreglo de salida es el rango de los elementos de la página correspondiente de X.

Tipos de datos: single | double

Argumentos de salida

y — Diferencia entre los valores máximos y los mínimos

escalar | vector | matriz | arreglo multidimensional

La diferencia entre los valores máximos y los mínimos, devuelta como un escalar, un vector, una matriz o un arreglo multidimensional.

Sugerencias

• range trata NaN como valores faltantes y los ignora.

• range proporciona una estimación calculada fácilmente de la dispersión de una muestra. Evite usar range con datos que tengan valores atípicos, porque tienen una influencia excesiva en esta estadística.

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 arreglos altos. Para obtener más información, consulte Arreglos altos.

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 los entornos basados en procesos. 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™.

Notas y limitaciones de uso:

• Los argumentos de entrada 'all' y vecdim no son compatibles.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

std | iqr | mad