binornd

Números aleatorios a partir de una distribución binomial

Sintaxis

r = binornd(n,p)

r = binornd(n,p,sz1,...,szN)

r = binornd(n,p,sz)

Descripción

r = binornd(n,p) genera números aleatorios a partir de la distribución binomial especificada por el número de pruebas n y la probabilidad de éxito de cada prueba p.

n y p pueden ser vectores, matrices o arreglos multidimensionales del mismo tamaño. Alternativamente, uno o más argumentos pueden ser escalares. La función binornd expande las entradas de escalar a arreglos constantes con las mismas dimensiones que las otras entradas. La función devuelve un vector, matriz o arreglo multidimensional r del mismo tamaño que n y p.

r = binornd(n,p,sz1,...,szN) genera un arreglo de números aleatorios a partir de la distribución binomial con los parámetros escalares n y p, donde sz1,...,szN indica el tamaño de cada dimensión.

r = binornd(n,p,sz) genera un arreglo de números aleatorios a partir de la distribución binomial con los parámetros escalares n y p, donde el vector sz especifica size(r).

Ejemplos

Arreglo de números aleatorios a partir de varias distribuciones binomiales

Genere un arreglo de números aleatorios a partir de las distribuciones binomiales. Para cada distribución, especificará el número de pruebas y la probabilidad de éxito de cada prueba.

Especifique el número de pruebas.

n = 10:10:60

n = 1×6

    10    20    30    40    50    60

Especifique las probabilidades de éxito de cada prueba.

p = 1./n

p = 1×6

    0.1000    0.0500    0.0333    0.0250    0.0200    0.0167

Genere números aleatorios a partir de las distribuciones binomiales.

r = binornd(n,p)

r = 1×6

     0     1     1     0     1     1

Arreglo de números aleatorios a partir de una distribución binomial

Genere un arreglo de números aleatorios a partir de una distribución binomial. Aquí, los parámetros de distribución n y p son escalares.

Use la función binornd para generar números aleatorios a partir de la distribución binomial con 100 pruebas, donde la probabilidad de éxito en cada prueba es 0,2. La función devuelve un número.

r_scalar = binornd(100,0.2)

r_scalar = 20

Genere un arreglo de números aleatorios de 2 por 3 a partir de la misma distribución especificando las dimensiones del arreglo requerido.

r_array = binornd(100,0.2,2,3)

r_array = 2×3

    18    23    20
    18    24    23

De forma alternativa, especifique las dimensiones del arreglo requerido como un vector.

r_array = binornd(100,0.2,[2 3])

r_array = 2×3

    21    21    20
    26    18    23

Argumentos de entrada

n — Número de pruebas

entero positivo | arreglo de enteros positivos

El número de pruebas, especificado como entero positivo o arreglo de enteros positivos.

Ejemplo: [10 20 50 100]

Tipos de datos: single | double

p — Probabilidad de éxito de cada prueba

valor de escalar | arreglo de valores de escalar

La probabilidad de éxito de cada prueba, especificada como valor de escalar o un arreglo de valores de escalar. Todos los valores de p deben pertenecer al intervalo [0 1].

Ejemplo: [0.01 0.1 0.5 0.7]

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. Por ejemplo, especificar 5,3,2 genera un arreglo de números aleatorios de 5 por 3 por 2 de la distribución de probabilidad binomial.

Si n o p es un arreglo, entonces las dimensiones sz1,...,szN especificadas deben coincidir con las dimensiones comunes de n y p 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, binornd ignora las siguientes dimensiones con un tamaño de 1. Por ejemplo, binornd(n,p,3,1,1,1) produce un vector de 3 por 1 de números aleatorios.

Ejemplo: 5,3,2

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. Por ejemplo, especificar [5 3 2] genera un arreglo de números aleatorios de 5 por 3 por 2 de la distribución de probabilidad binomial.

Si n o p es un arreglo, entonces las dimensiones sz especificadas deben coincidir con las dimensiones comunes de n y p 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, binornd ignora las siguientes dimensiones con un tamaño de 1. Por ejemplo, binornd(n,p,[3 1 1 1]) produce un vector de 3 por 1 de números aleatorios.

Ejemplo: [5 3 2]

Tipos de datos: single | double

Argumentos de salida

r — Números aleatorios a partir de una distribución binomial

valor de escalar | arreglo de valores de escalar

Números aleatorios de la distribución binomial, devueltos como un valor de escalar o un arreglo de valores de escalar.

Tipos de datos: single | double

Funcionalidad alternativa

• binornd es una función específica para la distribución binomial. 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, especifique el nombre de la distribución de probabilidad y sus parámetros. De forma alternativa, cree un objeto de distribución de probabilidad BinomialDistribution y pase el objeto como un argumento de entrada. Tenga en cuenta que la función específica de distribución binornd es más rápida que la función genérica random.

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

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 de MATLAB^® en estos dos casos:

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

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 antes de R2006a

Consulte también

random | binoinv | binocdf | binofit | binostat | binopdf | BinomialDistribution

Temas

• Distribución binomial