trnd

Números aleatorios t de Student

Sintaxis

r = trnd(nu)

r = trnd(nu,sz1,...,szN)

r = trnd(nu,sz)

Descripción

r = trnd(nu) genera un número aleatorio a partir de la distribución t de Student con nu grados de libertad.

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

r = trnd(nu,sz) genera un arreglo de números aleatorios a partir de la distribución t de Student, donde el vector del tamaño sz especifica size(r).

Ejemplos

Generar un número aleatorio de distribución t de Student

Genere un solo número aleatorio a partir de la distribución t de Student con 10 grados de libertad.

nu = 10;
r = trnd(nu)

r = 1.0585

Generar números aleatorios de distribución t de Student

Genere un arreglo de 1 por 6 de números aleatorios t de Student con 1 grado de libertad.

nu1 = ones(1,6); % 1-by-6 array of ones
r1 = trnd(nu1)

r1 = 1×6

    0.2108    7.8450  -11.0511    0.4134    4.3293   -0.8323

Si especifica nu como escalar, se expande a un arreglo constante con dimensiones especificadas por sz1,...,szn.

Genere un arreglo de 2 por 6 de números aleatorios t de Student con 3 grados de libertad.

nu2 = 3;
sz1 = 2;
sz2 = 6;
r2 = trnd(nu2,sz1,sz2)

r2 = 2×6

    0.9257    0.3379    0.6477   -2.2792   -2.8371    0.3632
   -0.2996   -0.6845   -1.2554   -0.5134    1.0458   -0.5521

Si especifica nu y sz como arreglos, entonces las dimensiones especificadas por sz deben coincidir con la dimensión de nu.

Genere un arreglo de 1 por 6 de números aleatorios t de Student con entre 1 y 6 grados de libertad.

nu3 = 1:6;
sz = [1 6];
r3 = trnd(nu3,sz)

r3 = 1×6

    1.3609    0.1845   -4.0246   -0.8724   -0.7507    2.3493

Argumentos de entrada

nu — Grados de libertad

valor de escalar | arreglo de valores de escalar

Grados de libertad de la distribución t de Student, especificados como un valor de escalar o un arreglo de valores de escalar.

Para generar números aleatorios de varias distribuciones, especifique nu usando un arreglo. Cada elemento en r es el número aleatorio generado de la distribución especificada por los correspondientes grados de libertad en nu.

Ejemplo: [9 19 49 99]

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 nu es un arreglo, entonces las dimensiones especificadas sz1,...,szN deben coincidir con las dimensiones de nu. Los valores predeterminados de sz1,...,szN son las dimensiones de nu.

• 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, trnd ignora las siguientes dimensiones con un tamaño de 1. Por ejemplo, trnd(5,3,1,1,1) produce un vector de 3 por 1 de números aleatorios a partir de la distribución con 5 grados de libertad.

Ejemplo: 3,5

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 nu es un arreglo, entonces las dimensiones especificadas sz deben coincidir con las dimensiones de nu. Los valores predeterminados de sz son las dimensiones de nu.

• 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, trnd ignora las siguientes dimensiones con un tamaño de 1. Por ejemplo, trnd(5,[3 1 1 1]) produce un vector de 3 por 1 de números aleatorios a partir de la distribución con 5 grados de libertad.

Ejemplo: [3 5]

Tipos de datos: single | double

Argumentos de salida

r — Números aleatorios t de Student

valor de escalar | arreglo de valores de escalar

Números aleatorios t de Student, devueltos como un valor de escalar o un arreglo de valores de escalar 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 grados de libertad en nu.

Funcionalidad alternativa

• trnd es una función específica para la distribución t de Student. 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. Tenga en cuenta que la función específica de distribución trnd 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 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

tpdf | tcdf | tinv | tstat | random

Temas

• Distribución t de Student