betaincinv

ベータ逆累積分布関数

構文

x = betaincinv(y,z,w)
x = betaincinv(y,z,w,tail)


説明

x = betaincinv(y,z,w) は、y = betainc(x,z,w) となる y、z、w の対応する要素に対して、不完全ベータ逆関数を計算します。y の要素は、閉区間 [0,1] 内になければなりません。z および w の要素は負ではない数値でなければなりません。y、z、w はすべてが実数で同じサイズ (またはいずれかがスカラー) でなければなりません。

x = betaincinv(y,z,w,tail) は、不完全ベータ関数の裾を指定します。選択肢は、0 から x までの積分を使用する 'lower' (既定の設定) と x から 1 までの積分を使用する 'upper' です。これらの 2 つの選択は以下のような関係です。betaincinv(y,z,w,'upper') = betaincinv(1-y,z,w,'lower')。y が 0 に近い場合、'upper' オプションは、1 から y を引くよりも正確な x を計算するための方法を与えます。

詳細

不完全ベータ逆関数

不完全ベータ関数は $$x=I^{-1}(y,z,w)$$ と定義され、次の式が成立します。

$$y=I(x,z,w)=\frac{1}{\beta (z,w)}{\displaystyle \underset{0}{\overset{x}{\int }}{t}^{(z-1)}{(1-t)}^{(w-1)}dt}$$

関数 betaincinv は、ニュートン法を使用して、積分の極限 x に関する不完全ベータ関数の逆関数を計算します。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

betaincinv 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• 常に複素数の結果を返します。

• 厳密な単精度計算はサポートされていません。生成されたコードでは、単精度入力で単精度出力が生成されます。ただし、関数内の変数は倍精度である可能性があります。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

betaincinv 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray (Parallel Computing Toolbox) として指定します。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2009a で導入

参考

betainc | beta | betaln