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.

randsample

Muestra aleatoria

Sintaxis

y = randsample(n,k)

y = randsample(population,k)

y = randsample(___,replacement)

y = randsample(n,k,true,w)

y = randsample(population,k,true,w)

y = randsample(s,___)

Descripción

y = randsample(n,k) devuelve k valores muestreados uniformemente de manera aleatoria, sin sustitución, a partir de los enteros del 1 al n.

y = randsample(population,k) devuelve un vector de k valores muestreados uniformemente de manera aleatoria, sin sustitución, a partir de los valores del vector population.

y = randsample(___,replacement) devuelve una muestra tomada con sustitución si replacement es true, o sin sustitución si replacement es false. Especifique replacement a continuación de cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

y = randsample(n,k,true,w) usa un vector de ponderaciones no negativas, w, cuya longitud es n, para determinar la probabilidad de que un entero i sea seleccionado como entrada para y.

y = randsample(population,k,true,w) usa un vector de ponderaciones no negativas, w, de la misma longitud que el vector population, para determinar la probabilidad de que un valor population(i) sea seleccionado como entrada para y.

y = randsample(s,___) usa la secuencia s para generar números aleatorios. La opción s puede preceder a cualquiera de los argumentos de entrada de las sintaxis anteriores. s pertenece a la clase RandStream.

Ejemplos

Valor de muestra único a partir de un rango

Extraiga un valor único a partir de los enteros del 1 al 10.

n = 10;
x = randsample(n,1)

x = 9

Muestra del vector de población

Cree la semilla aleatoria para reproducir los resultados.

s = RandStream('mlfg6331_64'); 

Extraiga un valor único a partir del vector [10:20].

population = 10:20;
y = randsample(s,population,1)

y = 17

Generar una secuencia aleatoria para las probabilidades especificadas

Cree la secuencia numérica aleatoria para la reproducibilidad.

s = RandStream('mlfg6331_64');

Seleccione 48 caracteres de manera aleatoria y con sustitución a partir de la secuencia ACGT, según las probabilidades especificadas.

R = randsample(s,'ACGT',48,true,[0.15 0.35 0.35 0.15])

R = 
'GGCGGCGCAAGGCGCCGGACCTGGCTGCACGCCGTTCCCTGCTACTCG'

Establecer una secuencia de números aleatorios

Cree la secuencia numérica aleatoria para la reproducibilidad.

s = RandStream('mlfg6331_64'); 

Extraiga cinco valores con sustitución a partir de los enteros 1:10.

y = randsample(s,10,5,true)

y = 5×1

     7
     8
     5
     7
     8

Argumentos de entrada

n — Límite superior del rango

entero positivo

El límite superior del rango (del 1 al n), a partir del que se realiza el muestreo, especificado como un entero positivo. Por defecto, randsample realiza un muestreo uniforme de manera aleatoria, sin sustitución, a partir de los valores del rango del 1 al n.

Tipos de datos: single | double

population — Datos de entrada

vector

Los datos de entrada a partir de los cuales se realiza el muestreo, especificados como un vector. Por defecto, randsample realiza un muestreo uniforme de manera aleatoria, sin sustitución, a partir de los valores de population. La orientación de y (fila o columna) es la misma que la de population.

Si population es un vector numérico que contiene únicamente valores enteros no negativos, y population puede tener la longitud 1, use y = population(randsample(length(population),k)) o y = datasample(population,k,'Replace',false) en lugar de y = randsample(population,k).

Ejemplo: y = randsample([50:100],20) devuelve un vector de 20 valores muestreados uniformemente de manera aleatoria, sin sustitución, a partir del vector population, que consta de enteros del 50 al 100.

Tipos de datos: single | double | logical | char | string | categorical

k — Número de muestras

entero positivo

El número de muestras, especificado como un entero positivo.

Ejemplo: randsample(20,10) devuelve un vector de 10 valores muestreados uniformemente de manera aleatoria, sin sustitución, a partir de los enteros del 1 al 20.

Tipos de datos: single | double

replacement — Indicador para realizar muestreos con sustitución

false (predeterminado) | true

El indicador para realizar muestreos con sustitución, especificado como false o true.

Ejemplo: randsample(10,2,true) devuelve dos valores con sustitución a partir de los enteros del 1 al 10.

Tipos de datos: logical

w — Ponderaciones del muestreo

ones(n,1) (predeterminado) | vector de valores de escalar no negativos

Las ponderaciones del muestreo, especificadas como un vector de valores de escalar no negativos. La longitud de w debe ser igual al rango de enteros a muestrear o a la longitud de population. El vector w debe tener como mínimo un valor positivo. Si w contiene valores negativos o valores NaN, randsample muestra un mensaje de error. La función randsample realiza un muestreo con probabilidad proporcional a w(i)/sum(w). Normalmente, w es un vector de probabilidades. La función randsample solo es compatible con la especificación de ponderaciones para realizar muestreos con sustitución.

Ejemplo: [0.1 0.5 0.35 0.46]

Tipos de datos: single | double

s — Secuencia de números aleatorios

Secuencia de números aleatorios predeterminada de MATLAB^® (predeterminado) | RandStream

La secuencia de números aleatorios, especificada como la secuencia de números aleatorios predeterminada de MATLAB o RandStream. Para obtener más detalles, consulte Crear y controlar una secuencia de números aleatorios.

Ejemplo: s = RandStream('mlfg6331_64') crea una secuencia de números aleatorios que usa el algoritmo de generación de Fibonacci retardado multiplicativo.

Argumentos de salida

y — Muestra

vector | escalar

La muestra, devuelta como un vector o un escalar.

• Si k = 1, y es un escalar.

• Si k > 1, y es un vector de k por 1.

Funcionalidad alternativa

Para muestrear datos de manera aleatoria, con o sin sustitución, use datasample.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• Cuando realiza muestreos sin sustitución, es posible que el orden de los valores de salida no coincida con el orden de MATLAB.

• La generación de código no es compatible con el argumento de entrada de la secuencia de números aleatorios s.

Para obtener más información sobre la generación de código, consulte Introduction to Code Generation y General Code Generation Workflow.

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

Historial de versiones

Introducido antes de R2006a

Consulte también

datasample | rand | randperm | RandStream