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.

gamrnd

Números aleatorios gamma

Sintaxis

r = gamrnd(a,b)

r = gamrnd(a,b,sz1,...,szN)

r = gamrnd(a,b,sz)

Descripción

r = gamrnd(a,b) genera un número aleatorio de la distribución gamma con el parámetro de forma a y el parámetro de escala b.

r = gamrnd(a,b,sz1,...,szN) genera un arreglo de números aleatorios a partir de la distribución gamma, donde sz1,...,szN indica el tamaño de cada dimensión.

r = gamrnd(a,b,sz) genera un arreglo de números aleatorios a partir de la distribución gamma, donde el vector sz especifica size(r).

Ejemplos

Generar un número aleatorio gamma

Genere un solo número aleatorio a partir de la distribución gamma con forma 5 y escala 7.

r = gamrnd(5,7)

r = 68.9857

Generar un arreglo de números aleatorios gamma

Genere cinco números aleatorios a partir de las distribuciones gamma con valores de parámetro de forma 1 a 5 y un parámetro de escala 2.

a1 = 1:5;
b1 = 2;
r1 = gamrnd(a1,b1)

r1 = 1×5

    7.1297    6.0918    2.1010    8.7253   29.5447

De forma predeterminada, gamrnd genera un arreglo que es del mismo tamaño que a y b después de cualquier expansión de escalar necesaria, de modo que todos los escalares se expanden para igualar las dimensiones del resto de salidas.

Si especifica las dimensiones de arreglo sz1,...,szN o sz, deben coincidir con las dimensiones de a y b después de cualquier expansión de escalar necesaria.

Genere un arreglo de 2 por 3 de números aleatorios para la distribución gamma con un parámetro de forma 3 y un parámetro de escala 7.

sz = [2 3];
r2 = gamrnd(3,7,sz)

r2 = 2×3

   17.9551   41.3983    7.9865
   16.4204   40.0048   44.1909

Genere seis números aleatorios para las distribuciones gamma con valores de parámetro de forma 1 a 6 y valores de parámetro de escala 5 a 10, respectivamente.

a3 = 1:6;
b3 = 5:10;
r3 = gamrnd(a3,b3,1,6)

r3 = 1×6

    9.5930    7.8289   11.0360   15.0367   28.1456   98.2664

Argumentos de entrada

a — Parámetro de forma

valor de escalar no negativo | arreglo de valores de escalar no negativos

Parámetro de forma de la distribución gamma, especificado como un valor de escalar no negativo o un arreglo de valores de escalar no negativos.

Para generar números aleatorios de varias distribuciones, especifique a y b utilizando arreglos. Si a y b son arreglos, entonces los tamaños de los arreglos deben ser los mismos. Si a o b es un escalar, entonces gamrnd expande el argumento del escalar en un arreglo constante del mismo tamaño que el otro argumento. Cada elemento en r es el número aleatorio generado de la distribución especificada por los correspondientes elementos en a y b.

Ejemplo: [3 4 7 9]

Tipos de datos: single | double

b — Parámetro de escala

valor de escalar no negativo | arreglo de valores de escalar no negativos

Parámetro de escala de la distribución gamma, especificado como un valor de escalar no negativo o un arreglo de valores de escalar no negativos.

Para generar números aleatorios de varias distribuciones, especifique a y b utilizando arreglos. Si a y b son arreglos, entonces los tamaños de los arreglos deben ser los mismos. Si a o b es un escalar, entonces gamrnd expande el argumento del escalar en un arreglo constante del mismo tamaño que el otro argumento. Cada elemento en r es el número aleatorio generado de la distribución especificada por los correspondientes elementos en a y b.

Ejemplo: [1 1 2 2]

Tipos de datos: single | double

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

valores enteros

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

Si a o b es un arreglo, entonces las dimensiones sz1,...,szN especificadas deben coincidir con las dimensiones comunes de a y b después de cualquier expansión de escalar necesaria. Los valores predeterminados de sz1,...,szN son las dimensiones comunes.

• Si especifica un único valor de sz1, entonces r es una matriz cuadrada de tamaño sz1 por sz1.

• Si el tamaño de cualquier dimensión es 0 o negativo, entonces r es un arreglo vacío.

• Más allá de la segunda dimensión, gamrnd ignora las siguientes dimensiones con un tamaño de 1. Por ejemplo, gamrnd(2,5,3,1,1,1) produce un vector de 3 por 1 de números aleatorios a partir de la distribución gamma con forma 2 y escala 5.

Ejemplo: 2,4

Tipos de datos: single | double

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

vector fila de valores enteros

Tamaño de cada dimensión, especificado como vector fila de valores enteros.

Si a o b es un arreglo, entonces las dimensiones sz especificadas deben coincidir con las dimensiones comunes de a y b después de cualquier expansión de escalar necesaria. Los valores predeterminados de sz son las dimensiones comunes.

• Si especifica un único valor de [sz1], entonces r es una matriz cuadrada de tamaño sz1 por sz1.

• Si el tamaño de cualquier dimensión es 0 o negativo, entonces r es un arreglo vacío.

• Más allá de la segunda dimensión, gamrnd ignora las siguientes dimensiones con un tamaño de 1. Por ejemplo, gamrnd(2,5,[3 1 1 1]) produce un vector de 3 por 1 de números aleatorios a partir de la distribución gamma con forma 2 y escala 5.

Ejemplo: [2 4]

Tipos de datos: single | double

Argumentos de salida

r — Números aleatorios gamma

valor de escalar no negativo | arreglo de valores de escalar no negativos

Los números aleatorios gamma, devueltos como valor de escalar no negativo o arreglo de valores de escalar no negativos con las dimensiones especificadas por sz1,...,szN o sz. Cada elemento en r es el número aleatorio generado de la distribución especificada por los correspondientes elementos en a y b.

Funcionalidad alternativa

• gamrnd es una función específica para la distribución gamma. Statistics and Machine Learning Toolbox™ también ofrece la función genérica random, que es compatible con varias distribuciones de probabilidad. Para utilizar random, cree un objeto de distribución de probabilidad GammaDistribution y pase el objeto como un argumento de entrada o especifique el nombre de la distribución de probabilidad y sus parámetros. Tenga en cuenta que la función específica de distribución gamrnd es más rápida que la función genérica random.

• Utilice randg para generar números aleatorios de la distribución gamma estándar (escala unitaria).

• Para generar números aleatorios de forma interactiva, utilice randtool, una interfaz de usuario para la generación de números aleatorios.

Referencias

[1] Marsaglia, George, and Wai Wan Tsang. “A Simple Method for Generating Gamma Variables.” ACM Transactions on Mathematical Software 26, no. 3 (September 1, 2000): 363–72. https://doi.org/10.1145/358407.358414.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

El código generado puede devolver una secuencia de números diferente a la que devuelve MATLAB^® si cualquiera de las siguientes opciones es verdadera:

• La salida no es un escalar.

• Un parámetro de entrada no es válido para la distribución.

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

GammaDistribution | randg | random | gampdf | gamcdf | gaminv | gamstat | gamfit | gamlike

Temas

• Distribución gamma