exponenta event banner

gamrnd

Гамма-случайные числа

Описание

пример

r = gamrnd(a,b) генерирует случайное число из гамма-распределения с параметром формы a и параметр масштаба b.

пример

r = gamrnd(a,b,sz1,...,szN) генерирует массив случайных чисел из гамма-распределения, где sz1,...,szN указывает размер каждого размера.

пример

r = gamrnd(a,b,sz) генерирует массив случайных чисел из гамма-распределения, где вектор sz определяет size(r).

Примеры

свернуть все

Создать одно случайное число из гамма-распределения с формой 5 и масштаб 7.

r = gamrnd(5,7)
r = 68.9857

Создание пяти случайных чисел из гамма-распределений со значениями параметров формы 1 через 5 и параметр масштаба 2.

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

    7.1297    6.0918    2.1010    8.7253   29.5447

По умолчанию gamrnd генерирует массив того же размера, что и a и b после любого необходимого скалярного расширения, так что все скаляры расширяются, чтобы соответствовать размерам других входов.

Если указаны размеры массива sz1,...,szN или sz, они должны соответствовать размерам a и b после любого необходимого скалярного расширения.

Создание массива случайных чисел 2 на 3 из гамма-распределения с параметром формы 3 и параметр масштаба 7.

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

   17.9551   41.3983    7.9865
   16.4204   40.0048   44.1909

Создание шести случайных чисел из гамма-распределений со значениями параметров формы 1 через 6 и значения параметров масштабирования 5 через 10 соответственно.

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

Входные аргументы

свернуть все

Параметр формы гамма-распределения, заданный как положительное скалярное значение или массив положительных скалярных значений.

Чтобы создать случайные числа из нескольких распределений, укажите a и b с использованием массивов. Если оба a и b являются массивами, тогда размеры массивов должны быть одинаковыми. Если либо a или b является скаляром, то gamrnd расширяет скалярный аргумент в постоянный массив того же размера, что и другой аргумент. Каждый элемент в r - случайное число, сгенерированное из распределения, указанного соответствующими элементами в a и b.

Пример: [3 4 7 9]

Типы данных: single | double

Параметр масштабирования гамма-распределения, заданный как положительное скалярное значение или массив положительных скалярных значений.

Чтобы создать случайные числа из нескольких распределений, укажите a и b с использованием массивов. Если оба a и b являются массивами, тогда размеры массивов должны быть одинаковыми. Если либо a или b является скаляром, то gamrnd расширяет скалярный аргумент в постоянный массив того же размера, что и другой аргумент. Каждый элемент в r - случайное число, сгенерированное из распределения, указанного соответствующими элементами в a и b.

Пример: [1 1 2 2]

Типы данных: single | double

Размер каждого измерения, указанный как отдельные аргументы целых чисел.

Если либо a или b является массивом, то указанные размеры sz1,...,szN должны соответствовать общим измерениям a и b после любого необходимого скалярного расширения. Значения по умолчанию для sz1,...,szN являются общими измерениями.

  • Если указано одно значение sz1, то r - квадратная матрица размера sz1около-sz1.

  • Если размер любого размера равен 0 или отрицательный, то r является пустым массивом.

  • За пределами второго измерения gamrnd игнорирует конечные размеры размером 1. Например, gamrnd(2,5,3,1,1,1) создает вектор случайных чисел 3 на 1 из гамма-распределения с формой 2 и масштабом 5.

Пример: 2,4

Типы данных: single | double

Размер каждого измерения, заданный как вектор строки целых чисел.

Если либо a или b является массивом, то указанные размеры sz должны соответствовать общим измерениям a и b после любого необходимого скалярного расширения. Значения по умолчанию для sz являются общими измерениями.

  • Если указать одно значение [sz1], то r - квадратная матрица размера sz1около-sz1.

  • Если размер любого размера равен 0 или отрицательный, то r является пустым массивом.

  • За пределами второго измерения gamrnd игнорирует конечные размеры размером 1. Например, gamrnd(2,5,[3 1 1 1]) создает вектор случайных чисел 3 на 1 из гамма-распределения с формой 2 и масштабом 5.

Пример: [2 4]

Типы данных: single | double

Выходные аргументы

свернуть все

Гамма-случайные числа, возвращаемые как неотрицательное скалярное значение или массив неотрицательных скалярных значений с размерами, заданными sz1,...,szN или sz. Каждый элемент в r - случайное число, сгенерированное из распределения, указанного соответствующими элементами в a и b.

Альтернативная функциональность

  • gamrnd - функция, специфичная для гамма-распределения. Toolbox™ статистики и машинного обучения также предлагает универсальную функцию random, которая поддерживает различные распределения вероятностей. Использовать random, создайте GammaDistribution объект распределения вероятностей и передать объект в качестве входного аргумента или указать имя распределения вероятностей и его параметры. Обратите внимание, что специфичная для распределения функция gamrnd быстрее, чем универсальная функция random.

  • Использовать randg для генерации случайных чисел из стандартного гамма-распределения (единичного масштаба).

  • Для интерактивной генерации случайных чисел используйте randtoolпользовательский интерфейс для генерации случайных чисел.

Ссылки

[1] Марсалья, Джордж и Вай Ван Цанг. «Простой метод генерации гамма-переменных». ACM Transactions on Mathematical Software 26, No 3 (01.09.2000): 363-72. https://doi.org/10.1145/358407.358414.

Расширенные возможности

.
Представлен до R2006a