randi

Enteros aleatorios distribuidos de manera uniforme

Sintaxis

X = randi(imax)

X = randi(imax,n)

X = randi(imax,sz1,...,szN)

X = randi(imax,sz)

X = randi(___,typename)

X = randi(___,like=p)

X = randi([imin,imax],___)

X = randi(s,___)

Descripción

X = randi(imax) devuelve un entero escalar aleatorio entre 1 e imax.

X = randi(imax,n) devuelve una matriz de n por n de enteros aleatorios extraídos de la distribución uniforme discreta en el intervalo [1,imax].

X = randi(imax,sz1,...,szN) devuelve un arreglo de sz1 por ... por szN en el que sz1,...,szN indica el tamaño de cada dimensión. Por ejemplo, randi(10,3,4) devuelve un arreglo de 3 por 4 de enteros aleatorios entre 1 y 10.

X = randi(imax,sz) devuelve un arreglo en el que el vector de tamaño sz define size(X). Por ejemplo, randi(10,[3 4]) devuelve un arreglo de 3 por 4 de enteros aleatorios entre 1 y 10.

X = randi(___,typename) devuelve un arreglo de enteros aleatorios entre 1 e imax del tipo de datos typename. La entrada typename puede ser "single", "double", "int8", "uint8", "int16", "uint16", "int32", "uint32" o "logical". Puede utilizar cualquiera de los argumentos de entrada de las sintaxis anteriores.

X = randi(___,like=p) devuelve un arreglo de enteros aleatorios como p, es decir, con el mismo tipo de datos y complejidad (real o complejo) que p. Puede especificar typename o like, pero no ambos.

X = randi([imin,imax],___) devuelve un arreglo que contiene enteros seudoaleatorios extraídos de la distribución uniforme discreta en el intervalo [imin,imax], utilizando cualquiera de las sintaxis anteriores.

X = randi(s,___) genera enteros a partir de una secuencia de números aleatorios s en lugar de a partir de la secuencia global predeterminada. Para crear una secuencia, utilice RandStream. Puede especificar s seguido de cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

Ejemplos

Matriz cuadrada de enteros aleatorios

Genere una matriz de 5 por 5 de enteros aleatorios entre 1 y 10. La primera entrada a randi indica el entero más grande en el intervalo de muestreo (el entero más pequeño en el intervalo es 1).

r = randi(10,5)

r = 5×5

     9     1     2     2     7
    10     3    10     5     1
     2     6    10    10     9
    10    10     5     8    10
     7    10     9    10     7

Enteros aleatorios dentro de un intervalo específico

Genere un vector columna de 10 por 1 de enteros aleatorios distribuidos uniformemente a partir del intervalo [-5,5].

r = randi([-5,5],10,1)

r = 10×1

     3
     4
    -4
     5
     1
    -4
    -2
     1
     5
     5

Controlar la generación de números aleatorios

Guarde el estado actual del generador de números aleatorios y cree un vector de 1 por 5 de enteros aleatorios.

s = rng;
r = randi(10,1,5)

r = 1×5

     9    10     2    10     7

Restablezca el estado del generador de números aleatorios a s y, después, cree un vector nuevo de 1 por 5 de enteros aleatorios. Los valores son los mismos que antes.

rng(s);
r1 = randi(10,1,5)

r1 = 1×5

     9    10     2    10     7

Arreglo 3D de enteros aleatorios

Cree un arreglo de 3 por 2 por 3 de enteros aleatorios distribuidos de manera uniforme entre 1 y 500.

X = randi(500,[3,2,3])

X = 
X(:,:,1) =

   408   457
   453   317
    64    49


X(:,:,2) =

   140   483
   274    79
   479   486


X(:,:,3) =

   479    71
   243   211
   401   458

Enteros aleatorios de otros tipos de datos

Cree un vector de 1 por 4 de números aleatorios entre 1 y 100 cuyos elementos sean de tipo int16.

r = randi(100,1,4,"int16")

r = 1×4 int16 row vector

   82   91   13   92

class(r)

ans = 
'int16'

Tamaño definido por el arreglo existente

Cree una matriz de enteros aleatorios distribuidos de manera uniforme entre 1 y 10 con el mismo tamaño que un arreglo existente.

A = [3 2; -2 1];
sz = size(A);
X = randi(10,sz)

X = 2×2

     9     2
    10    10

Es habitual combinar las dos líneas anteriores de código en una única línea:

X = randi(10,size(A));

Tamaño y tipo de datos numéricos definidos por un arreglo existente

Cree una matriz de enteros con signo de 8 bits de 2 por 2.

p = int8([3 2; -2 1]);

Cree un arreglo de enteros aleatorios que sea del mismo tamaño y tipo de datos que p.

X = randi(10,size(p),like=p)

X = 2×2 int8 matrix

    9    2
   10   10

class(X)

ans = 
'int8'

Enteros complejos aleatorios

Desde R2022a

Genere 10 enteros complejos aleatorios a partir de la distribución uniforme discreta en un dominio cuadrado con partes reales e imaginarias en el intervalo [-5,5].

a = randi([-5,5],10,1,like=1i)

a = 10×1 complex

   3.0000 + 4.0000i
  -4.0000 + 5.0000i
   1.0000 - 4.0000i
  -2.0000 + 1.0000i
   5.0000 + 5.0000i
  -4.0000 + 5.0000i
   5.0000 + 0.0000i
   3.0000 - 4.0000i
  -1.0000 + 5.0000i
   3.0000 + 5.0000i

Arreglo lógico aleatorio

Desde R2023a

Cree una matriz de 5 por 5 de valores lógicos aleatorios (0 y 1) con una distribución uniforme discreta.

r = randi([0 1],5,"logical")

r = 5×5 logical array

   1   0   0   0   1
   1   0   1   0   0
   0   1   1   1   1
   1   1   0   1   1
   1   1   1   1   1

Argumentos de entrada

imax — Valor entero más grande en intervalo de muestra

entero positivo

Valor entero más grande en intervalo de muestra, especificado como entero positivo. randi extrae valores de la distribución uniforme en el intervalo de muestra [1,imax].

Ejemplo: randi(10,5)

imin — Valor entero más pequeño en intervalo de muestra

1 (predeterminado) | entero escalar

Valor entero más pequeño en intervalo de muestra, especificado como entero escalar.

Tanto imin como imax deben ser enteros que satisfagan imin ≤ imax.

Por ejemplo, randi([50,100],5) devuelve una matriz de 5 por 5 de enteros aleatorios entre 50 y 100 (incluidos estos).

n — Tamaño de la matriz cuadrada

valor entero

Tamaño de la matriz cuadrada, especificado como valor entero.

• Si n es 0, X es una matriz vacía.

• Si n es negativo, se trata como 0.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Tamaño de cada dimensión (como argumentos separados)

valores enteros

Tamaño de cada dimensión, especificado como argumentos separados de valores enteros.

• Si el tamaño de una dimensión cualquiera es 0, X es un arreglo vacío.

• Si el tamaño de una dimensión cualquiera es negativo, se trata como 0.

• Más allá de la segunda dimensión, randi ignora las dimensiones finales de tamaño 1. Por ejemplo, randi([5,10],3,1,1,1) produce un vector de 3 por 1 de enteros aleatorios entre 5 y 10.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Tamaño de cada dimensión (como vector fila)

valores enteros

Tamaño de cada dimensión, especificado como vector fila de valores enteros. Cada elemento de este vector indica el tamaño de la dimensión correspondiente:

• Si el tamaño de una dimensión cualquiera es 0, X es un arreglo vacío.

• Si el tamaño de una dimensión cualquiera es negativo, se trata como 0.

• Más allá de la segunda dimensión, randi ignora las dimensiones finales de tamaño 1. Por ejemplo, randi([5,10],[3 1 1 1]) produce un vector de 3 por 1 de enteros aleatorios entre 5 y 10.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Tipo de datos (clase) que crear

"double" (predeterminado) | "single" | "int8" | "uint8" | "int16" | "uint16" | ...

Tipo de datos (clase) que se desea crear, especificado como "double", "single", "int8", "uint8", "int16", "uint16", "int32", "uint32", "logical", o el nombre de otra clase que sea compatible con randi.

Ejemplo: randi(5,5,"int8")

p — Prototipo del arreglo que crear

arreglo numérico | arreglo lógico

Prototipo del arreglo que se desea crear, especificado como arreglo numérico o lógico.

Ejemplo: randi(5,5,like=p)

Tipos de datos: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | logical
Soporte de números complejos: Sí

s — Secuencia de números aleatorios

objeto RandStream

Secuencia de números aleatorios, especificada como objeto RandStream.

Ejemplo: s = RandStream("dsfmt19937"); randi(s,[5,10],[3 1])

Argumentos de salida

X — Arreglo de salida

escalar | vector | matriz | arreglo multidimensional

Arreglo de salida, devuelto como escalar, vector, matriz o arreglo multidimensional.

Más acerca de

Generador de números pseudoaleatorios

El generador subyacente de números para randi es un generador de números pseudoaleatorios, que crea una secuencia determinista de números que parecen aleatorios. Estos números son predecibles si se conocen la semilla y el algoritmo determinista del generador. Aunque no son verdaderamente aleatorios, los números generados superan varias pruebas estadísticas de aleatoriedad, cumpliendo la condición de ser independientes y estar distribuidos de manera idéntica (i.i.d.) y justificando el nombre de pseudoaleatorios.

Sugerencias

• La secuencia de números que produce randi viene determinada por la configuración interna del generador de números pseudoaleatorios uniforme que subyace a rand, randi y randn. Puede controlar ese generador de números aleatorios compartido utilizando rng.

• Los arreglos devueltos por randi pueden contener valores enteros repetidos. En ocasiones, este comportamiento se conoce como muestreo con sustitución. Utilice randperm si necesita que todos los valores sean únicos.

• Si imin y imax se encuentran fuera del intervalo del tipo de salida (según la especificación de typename o del prototipo p), randi crea en primer lugar números enteros aleatorios en el intervalo [imin,imax] y convierte los números enteros resultantes fuera del intervalo en el valor mínimo o máximo del tipo de salida. Por ejemplo:

  rng default;
  r = randi([-10 10],1,10)

  r =
  
       7     9    -8     9     3    -8    -5     1    10    10

  rng default;
  r = randi([-10 10],1,10,"logical")

  r =
  
    1×10 logical array
  
     1   1   0   1   1   0   0   1   1   1

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• Si se utiliza, el argumento de entrada typename debe ser "double", "single", "int8", "uint8", "int16", "uint16", "int32", "uint32" o "logical". No se admiten otras clases, aunque la clase defina un método randi estático.

• Si se utilizan, los argumentos de tamaño n, sz y sz1,...,szN deben ser de tamaño fijo.

• El generador de código utiliza matemáticas de doble precisión para calcular salidas de precisión simple.

• En la mayoría de los casos, los archivos MEX generados utilizan el mismo estado de número aleatorio que MATLAB^®. Si se deshabilitan las llamadas extrínsecas o llama a randi desde dentro de un bucle parfor, el código MEX generado y el código independiente mantienen su estado de número aleatorio propio que se inicializa con el valor predeterminado de MATLAB, rng(0,"twister").

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 randi es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Puede especificar typename como 'gpuArray'. Si especifica typename como 'gpuArray', el tipo subyacente predeterminado del arreglo es double.

  Para crear un arreglo de GPU con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, X = randi(imax,3,datatype,'gpuArray') crea un arreglo de GPU de 3 por 3 de enteros aleatorios en el rango [1 imax] con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

• También puede especificar la variable numérica p como gpuArray.

  Si especifica p como gpuArray, el tipo subyacente del arreglo devuelto es el mismo que p.

• Para usar la sintaxis de secuencia, randi(s,___), en una GPU, s debe ser un objeto parallel.gpu.RandStream (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:

• La sintaxis de secuencia randi(s,___) no es compatible con arreglos codistributed o distributed.

• Puede especificar typename como 'codistributed' o 'distributed'. Si especifica typename como 'codistributed' o 'distributed', el tipo subyacente predeterminado del arreglo devuelto es double.

  Para crear un arreglo distribuido o codistribuido con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, X = randi(imax,3,datatype,'distributed') crea una matriz distribuida de 3 por 3 de enteros aleatorios en el rango [1 imax] con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'logical'

• También puede especificar p como arreglo codistributed o distributed.

  Si especifica p como arreglo codistributed o distributed, el tipo subyacente del arreglo devuelto es el mismo que p.

• Para ver sintaxis codistributed adicionales, consulte randi (codistributed) (Parallel Computing Toolbox).

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido en R2008b

R2023a: Crear un arreglo lógico aleatorio

Puede crear un arreglo lógico aleatorio especificando typename como "logical" o el prototipo p como un arreglo lógico. Por ejemplo, consulte Arreglo lógico aleatorio.

R2022a: Coincidir complejidad con like y utilizar like con el objeto RandStream

El argumento nombre-valor like es compatible con los arreglos de prototipo real y complejo. Por ejemplo:

r = randi(2,2,like=1i)

r =

   2.0000 + 2.0000i   2.0000 + 1.0000i
   1.0000 + 2.0000i   1.0000 + 2.0000i

Todas las sintaxis son compatibles con esta funcionalidad. También, ahora puede utilizar like con un objeto RandStream como la primera entrada de randi.

R2014a: Coincidir tipos de datos de una variable existente con 'like'

Para generar números aleatorios con el mismo tipo de datos que una variable existente, utilice la sintaxis randi(__,'like',p). Por ejemplo:

A = single(pi);
r = randi(4,4,'like',A);
class(r)

ans = 
single

Esta funcionalidad no está disponible al pasar un objeto RandStream como la primera entrada a randi.

R2013b: No se admiten entradas de tamaño no entero

Especificar una dimensión que no es un entero provoca un error. Utilice floor para convertir entradas de tamaño no entero en enteros.

Consulte también

rand | randn | rng | RandStream | randperm

Temas

• Enteros aleatorios
• Crear arreglos de números aleatorios
• Generar números aleatorios que sean repetibles
• Generar números aleatorios que sean diferentes
• Crear y controlar una secuencia de números aleatorios
• Class Support for Array-Creation Functions
• ¿Por qué se repiten números aleatorios después del inicio?