Main Content

gamcdf

ガンマ累積分布関数

説明

p = gamcdf(x,a) は、x 内の値で評価した、a に形状パラメーターをもつ、標準ガンマ分布の累積分布関数 (cdf) を返します。

p = gamcdf(x,a,b) は、x 内の値で評価した、a に形状パラメーター、b にスケール パラメーターをもつ、ガンマ分布の cdf を返します。

[p,pLo,pUp] = gamcdf(x,a,b,pCov) は、ab が推定値である場合の p の 95% 信頼区間 [pLo,pUp] も返します。pCov は、推定されるパラメーターの共分散行列です。

[p,pLo,pUp] = gamcdf(x,a,b,pCov,alpha) は、信頼区間 [pLo pUp] の信頼水準が 100(1–alpha)% であることを指定します。

___ = gamcdf(___,'upper') は、下裾の値を 1 から減算するよりも正確に極端に上裾にある確率を計算するアルゴリズムを使用して、x 内の値で評価した cdf の補数を返します。'upper' は、前の構文における任意の入力引数の組み合わせの後に続けることができます。

すべて折りたたむ

ガンマ分布の平均の cdf を計算します。この cdf は、パラメーターの積 ab と等しくなります。

a = 1:6;
b = 5:10;
prob = gamcdf(a.*b,a,b)
prob = 1×6

    0.6321    0.5940    0.5768    0.5665    0.5595    0.5543

ab が大きくなるにつれて、分布が対称になり、平均は中央値に近づきます。

ガンマ分布データを使用して、観測値が区間 [0 10] にある確率を推定する信頼区間を求めます。

形状 2、スケール 51000 個のガンマ分布乱数の標本を生成します。

x = gamrnd(2,5,1000,1);

パラメーターの推定値を計算します。

[params,~] = gamfit(x)
params = 1×2

    2.1089    4.8147

パラメーターを ahat および bhat として格納します。

ahat = params(1);
bhat = params(2);

パラメーター推定の共分散を求めます。

[~,nCov] = gamlike(params,x)
nCov = 2×2

    0.0077   -0.0176
   -0.0176    0.0512

観測値が区間 [0 10] にある確率を推定する信頼区間を作成します。

[prob,pLo,pUp] = gamcdf(10,ahat,bhat,nCov)
prob = 0.5830
pLo = 0.5587
pUp = 0.6069

形状パラメーターが 2、スケール パラメーターが 3 のガンマ分布からの観測値が区間 [150 Inf] にある確率を求めます。

p1 = 1 - gamcdf(150,2,3)
p1 = 0

gamcdf(150, 2, 3) はほぼ 1 なので、p10 になります。極端に上裾にある確率をより正確に gamcdf に計算させるため、'upper' を指定します。

p2 = gamcdf(150,2,3,'upper')
p2 = 9.8366e-21

入力引数

すべて折りたたむ

cdf を評価する値。非負のスカラー値、または非負のスカラー値の配列として指定します。

信頼区間 [pLo,pUp] を計算するよう pCov に指定した場合、x はスカラー値でなければなりません。

  • 複数の値で cdf を評価するには、配列を使用して x を指定します。

  • 複数の分布の cdf を評価するには、配列を使用して ab を指定します。

入力引数 xa および b の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、gamcdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。p の各要素は、x 内の対応する要素で評価された、a および b 内の対応する要素によって指定された分布の cdf の値です。

例: [3 4 7 9]

データ型: single | double

ガンマ分布の形状。正のスカラー値、または正のスカラー値の配列として指定します。

  • 複数の値で cdf を評価するには、配列を使用して x を指定します。

  • 複数の分布の cdf を評価するには、配列を使用して ab を指定します。

入力引数 xa および b の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、gamcdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。p の各要素は、x 内の対応する要素で評価された、a および b 内の対応する要素によって指定された分布の cdf の値です。

例: [1 2 3 5]

データ型: single | double

ガンマ分布のスケール。正のスカラー値、または正のスカラー値の配列として指定します。

  • 複数の値で cdf を評価するには、配列を使用して x を指定します。

  • 複数の分布の cdf を評価するには、配列を使用して ab を指定します。

入力引数 xa および b の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、gamcdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。p の各要素は、x 内の対応する要素で評価された、a および b 内の対応する要素によって指定された分布の cdf の値です。

例: [1 1 2 2]

データ型: single | double

推定値 a および b の共分散。2 行 2 列の行列を指定します。

pCov を指定して信頼区間 [pLo,pUp] を計算する場合、xa および b はスカラー値でなければなりません。

abgamfit または mle を使用して、ab の共分散は gamlike を使用して推定できます。たとえば、ガンマ分布の cdf 値の信頼区間を参照してください。

データ型: single | double

信頼区間の有意水準。範囲 (0,1) のスカラーを指定します。信頼水準は 100(1–alpha)% です。alpha は、真の値が信頼区間に含まれない確率です。

例: 0.01

データ型: single | double

出力引数

すべて折りたたむ

x 内の値で評価した cdf の値。スカラー値、またはスカラー値の配列として返されます。p は、必要なスカラー拡張後の xa、および b と同じサイズになります。p の各要素は、x 内の対応する要素で評価された、a および b 内の対応する要素によって指定された分布の cdf の値です。

p の信頼限界の下限。スカラー値、またはスカラー値の配列として返されます。pLop と同じサイズになります。

p の信頼限界の上限。スカラー値、またはスカラー値の配列として返されます。pUpp と同じサイズになります。

詳細

すべて折りたたむ

ガンマ cdf

ガンマ分布は、2 パラメーターの曲線群です。パラメーター a は形状、パラメーター b はスケールです。

ガンマ累積分布関数は、次の式で表されます。

p=F(x|a,b)=1baΓ(a)0xta1etbdt.

結果 p は、パラメーター a および b をもつガンマ分布に従う単一の観測値が区間 [0 x] に含まれる確率です。

ガンマ cdf は、次によって、不完全ガンマ関数 gammainc と関連付けられます。

f(x|a,b)=gammainc(xb,a).

標準ガンマ分布は、不完全ガンマ関数と正確に一致する b = 1 のときに発生します。

詳細は、ガンマ分布を参照してください。

代替機能

  • gamcdf はガンマ分布専用の関数です。Statistics and Machine Learning Toolbox™ には、さまざまな確率分布をサポートする汎用関数 cdf もあります。cdf を使用するには、GammaDistribution 確率分布オブジェクトを作成し入力引数として渡すか、確率分布名とそのパラメーターを指定します。分布専用の関数 gamcdf は汎用関数 cdf より高速です。

  • 確率分布の累積分布関数 (cdf) または確率密度関数 (pdf) のプロットを対話的に作成するには、確率分布関数アプリを使用します。

拡張機能

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

バージョン履歴

R2006a より前に導入