メインコンテンツ

trnd

スチューデントの t 乱数

説明

r = trnd(nu) は、自由度 nu のスチューデントの t 分布から乱数を生成します。

r = trnd(nu,sz1,...,szN) は、スチューデントの t 分布から乱数の配列を生成します。ここで、sz1,...,szN は各次元のサイズを示します。

r = trnd(nu,sz) は、スチューデントの t 分布から乱数の配列を生成します。ここで、サイズ ベクトル szsize(r) を指定します。

すべて折りたたむ

自由度 10 のスチューデントの t 分布から単一の乱数を生成します。

nu = 10;
r = trnd(nu)
r = 
1.0585

スチューデントの "t" 分布を使用して標準コーシー分布から乱数を生成します。

手順 1. 乱数のベクトルを生成します。

位置パラメーター mu = 0 とスケール パラメーター sigma = 1 をもつ標準コーシー分布から 10 個の乱数を含む列ベクトルを生成します。trnd を自由度 V = 1 で使用します。

rng('default');  % For reproducibility
r = trnd(1,10,1)
r = 10×1

    0.2678
    1.6547
   -0.9396
    1.7322
    0.1810
   -1.3351
   -1.1529
    1.2466
    2.4647
    5.8874

手順 2. 乱数の行列を生成します。

標準コーシー分布から 5 行 5 列の乱数の行列を生成します。

r = trnd(1,5,5)
r = 5×5

   -0.7133   -0.0308   -4.7003    2.5949   -1.0194
   -0.2579   -0.2820    0.2210   -0.5767    0.1394
    0.5966    0.9806   -1.9818    3.4180    2.1367
    2.4791   12.6472   -2.2442   -0.1092    2.9031
   -1.3137    1.0985   -0.0066   10.9506    1.8792

入力引数

すべて折りたたむ

スチューデントの t 分布の自由度。スカラー値、またはスカラー値の配列として指定します。

複数の分布から乱数を生成するには、配列を使用して nu を指定します。r の各要素は、nu 内の対応する自由度によって指定された分布から生成された乱数です。

例: [9 19 49 99]

データ型: single | double

各次元のサイズ。整数の引数として個別に指定します。

nu が配列である場合、nu の次元と一致する次元 sz1,...,szN を指定しなければなりません。sz1,...,szN の既定値は nu の次元です。

  • 単一の値 sz1 を指定した場合、r はサイズ sz1sz1 列の正方行列になります。

  • いずれかの次元のサイズが 0 または負である場合、r は空の配列になります。

  • 2 次元を超える場合、trnd はサイズ 1 の後続次元を無視します。たとえば、trnd(5,3,1,1,1) は、自由度 5 の分布に従う乱数から成る 3 行 1 列のベクトルを生成します。

例: 3,5

データ型: single | double

各次元のサイズ。整数の行ベクトルとして指定します。

nu が配列である場合、nu の次元と一致する次元 sz を指定しなければなりません。sz の既定値は nu の次元です。

  • 単一の値 [sz1] を指定した場合、r はサイズ sz1sz1 列の正方行列になります。

  • いずれかの次元のサイズが 0 または負である場合、r は空の配列になります。

  • 2 次元を超える場合、trnd はサイズ 1 の後続次元を無視します。たとえば、trnd(5,[3 1 1 1]) は、自由度 5 の分布に従う乱数から成る 3 行 1 列のベクトルを生成します。

例: [3 5]

データ型: single | double

出力引数

すべて折りたたむ

スチューデントの t 乱数。スカラー値、または sz1,...,szN もしくは sz によって指定された次元数のスカラー値の配列として返されます。r の各要素は、nu 内の対応する自由度によって指定された分布から生成された乱数です。

代替機能

  • trnd はスチューデントの t 分布専用の関数です。Statistics and Machine Learning Toolbox™ には、さまざまな確率分布をサポートする汎用関数 random もあります。random を使用するには、確率分布の名前とパラメーターを指定します。分布専用の関数 trnd は汎用関数 random より高速です。

  • 乱数を対話的に生成するには、乱数発生用ユーザー インターフェイス randtool を使用します。

拡張機能

すべて展開する

バージョン履歴

R2006a より前に導入