最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

pdf

確率密度関数

構文

y = pdf('name',x,A)

y = pdf('name',x,A,B)

y = pdf('name',x,A,B,C)

y = pdf('name',x,A,B,C,D)

y = pdf(pd,x)

説明

y = pdf('name',x,A) は、'name' と分布パラメーター A で指定された 1 パラメーターの分布族について、x の各値で評価した確率密度関数 (pdf) を返します。

y = pdf('name',x,A,B) は、'name' と分布パラメーター A および B で指定された 2 パラメーターの分布族について、x の各値で評価した pdf を返します。

y = pdf('name',x,A,B,C) は、'name' と分布パラメーター A、B および C で指定された 3 パラメーターの分布族について、x の各値で評価した pdf を返します。

y = pdf('name',x,A,B,C,D) は、'name' と分布パラメーター A、B、C および D で指定された 4 パラメーターの分布族について、x の各値で評価した pdf を返します。

y = pdf(pd,x) は、x の各値で評価した確率分布オブジェクト pd の pdf を返します。

例

正規分布の確率密度関数の計算

平均 $$\mu$$ が 0、標準偏差 $$\sigma$$ が 1 に等しい標準正規分布オブジェクトを作成します。

mu = 0;
sigma = 1;
pd = makedist('Normal','mu',mu,'sigma',sigma);

pdf を評価する値が含まれている入力ベクトル x を定義します。

x = [-2 -1 0 1 2];

x値における標準正規分布の pdf の値を計算します。

y = pdf(pd,x)

y = 1×5

    0.0540    0.2420    0.3989    0.2420    0.0540

y の各値は、入力ベクトル x の値に対応しています。たとえば、x 値が 1 の場合、対応する pdf 値 y は 0.2420 です。

代替として、確率分布オブジェクトを作成せずに同じ pdf 値を計算することもできます。関数 pdf を使用し、$$\mu$$ と $$\sigma$$ について同じパラメーター値を使用して標準正規分布を指定します。

y2 = pdf('Normal',x,mu,sigma)

y2 = 1×5

    0.0540    0.2420    0.3989    0.2420    0.0540

pdf の値は、確率分散オブジェクトを使用して計算した値と同じです。

ポアソン分布 pdf の計算

レート パラメーター $$\lambda$$ が 2 に等しいポアソン分布オブジェクトを作成します。

lambda = 2;
pd = makedist('Poisson','lambda',lambda);

pdf を評価する値が含まれている入力ベクトル x を定義します。

x = [0 1 2 3 4];

x の値におけるポアソン分布の pdf の値を計算します。

y = pdf(pd,x)

y = 1×5

    0.1353    0.2707    0.2707    0.1804    0.0902

y の各値は、入力ベクトル x の値に対応しています。たとえば、x 値が 3 の場合、対応する y の pdf 値 は 0.1804 です。

代替として、確率分布オブジェクトを作成せずに同じ pdf 値を計算することもできます。関数 pdf を使用し、レート パラメーター $$\lambda$$ について同じ値を使用してポアソン分布を指定します。

y2 = pdf('Poisson',x,lambda)

y2 = 1×5

    0.1353    0.2707    0.2707    0.1804    0.0902

pdf の値は、確率分散オブジェクトを使用して計算した値と同じです。

標準正規分布の確率密度関数をプロットする

標準正規分布オブジェクトを作成します。

pd = makedist('Normal')

pd = 
  NormalDistribution

  Normal distribution
       mu = 0
    sigma = 1

x 値を指定し、確率密度関数を計算します。

x = -3:.1:3;
pdf_normal = pdf(pd,x);

確率密度関数をプロットします。

plot(x,pdf_normal,'LineWidth',2)

ワイブル分布の確率密度関数をプロットする

ワイブル確率分布オブジェクトを作成します。

pd = makedist('Weibull','a',5,'b',2)

pd = 
  WeibullDistribution

  Weibull distribution
    A = 5
    B = 2

x 値を指定し、確率密度関数を計算します。

x = 0:.1:15;
y = pdf(pd,x);

確率密度関数をプロットします。

plot(x,y,'LineWidth',2)

入力引数

'name' — 確率分布名

文字ベクトルまたは string スカラーによる確率分布名

確率分布名。次の表のいずれかの確率分布名を指定します。

'name'	分布	入力パラメーター A	入力パラメーター B	入力パラメーター C	入力パラメーター D
'Beta'	ベータ分布	1 番目の形状パラメーター a	2 番目の形状パラメーター b	—	—
'Binomial'	二項分布	試行回数 n	各試行の成功確率 p	—	—
'BirnbaumSaunders'	バーンバウム・サンダース分布	スケール パラメーター β	形状パラメーター γ	—	—
'Burr'	ブール型 XII 分布	スケール パラメーター α	1 番目の形状パラメーター c	2 番目の形状パラメーター k	—
'Chisquare'	カイ二乗分布	自由度 ν	—	—	—
'Exponential'	指数分布	平均値 μ	—	—	—
'Extreme Value'	極値分布	位置パラメーター μ	スケール パラメーター σ	—	—
'F'	F 分布	分子の自由度 ν1	分母の自由度 ν2	—	—
'Gamma'	ガンマ分布	形状パラメーター a	スケール パラメーター b	—	—
'Generalized Extreme Value'	一般化極値分布	形状パラメーター k	スケール パラメーター σ	位置パラメーター μ	—
'Generalized Pareto'	一般化パレート分布	裾の指数 (形状) パラメーター k	スケール パラメーター σ	しきい値 (位置) パラメーター μ	—
'Geometric'	幾何分布	確率パラメーター p	—	—	—
'HalfNormal'	半正規分布	位置パラメーター μ	スケール パラメーター σ	—	—
'Hypergeometric'	超幾何分布	母集団のサイズ m	母集団内で対象となる特徴をもつ項目の個数 k	抽出した標本の個数 n	—
'InverseGaussian'	逆ガウス分布	スケール パラメーター μ	形状パラメーター λ	—	—
'Logistic'	ロジスティック分布	平均値 μ	スケール パラメーター σ	—	—
'LogLogistic'	対数ロジスティック分布	対数値の平均 μ	対数値のスケール パラメーター σ	—	—
'Lognormal'	対数正規分布	対数値の平均 μ	対数値の標準偏差 σ	—	—
'Nakagami'	仲上分布	形状パラメーター μ	スケール パラメーター ω	—	—
'Negative Binomial'	負の二項分布	成功回数 r	1 回の試行における成功確率 p	—	—
'Noncentral F'	非心 F 分布	分子の自由度 ν1	分母の自由度 ν2	非心度パラメーター δ	—
'Noncentral t'	非心 t 分布	自由度 ν	非心度パラメーター δ	—	—
'Noncentral Chi-square'	非心カイ二乗分布	自由度 ν	非心度パラメーター δ	—	—
'Normal'	正規分布	平均値 μ	標準偏差 σ	—	—
'Poisson'	ポアソン分布	平均値 λ	—	—	—
'Rayleigh'	レイリー分布	スケール パラメーター b	—	—	—
'Rician'	ライス分布	非心度パラメーター s	スケール パラメーター σ	—	—
'Stable'	安定分布	1 番目の形状パラメーター α	2 番目の形状パラメーター β	スケール パラメーター γ	位置パラメーター δ
'T'	スチューデントの t 分布	自由度 ν	—	—	—
'tLocationScale'	t 位置-スケール分布	位置パラメーター μ	スケール パラメーター σ	形状パラメーター ν	—
'Uniform'	一様分布 (連続)	下限端点 (最小) a	上限端点 (最大) b	—	—
'Discrete Uniform'	一様分布 (離散)	最大観測可能値 n	—	—	—
'Weibull'	ワイブル分布	スケール パラメーター a	形状パラメーター b	—	—

例: 'Normal'

x — pdf を評価する値

スカラー値 | スカラー値の配列

pdf を評価する値。スカラー値、またはスカラー値の配列を指定します。

入力引数 x、A、B、C および D の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、pdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。各分布の A、B、C および D の定義については、'name' を参照してください。

例: [-1,0,3,4]

データ型: single | double

A — 1 番目の確率分布パラメーター

スカラー値 | スカラー値の配列

1 番目の確率分布パラメーター。スカラー値またはスカラー値の配列を指定します。

入力引数 x、A、B、C および D の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、pdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。各分布の A、B、C および D の定義については、'name' を参照してください。

データ型: single | double

B — 2 番目の確率分布パラメーター

スカラー値 | スカラー値の配列

2 番目の確率分布パラメーター。スカラー値またはスカラー値の配列を指定します。

入力引数 x、A、B、C および D の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、pdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。各分布の A、B、C および D の定義については、'name' を参照してください。

データ型: single | double

C — 3 番目の確率密度パラメーター

スカラー値 | スカラー値の配列

3 番目の確率分布パラメーター。スカラー値またはスカラー値の配列を指定します。

入力引数 x、A、B、C および D の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、pdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。各分布の A、B、C および D の定義については、'name' を参照してください。

データ型: single | double

D — 4 番目の確率分布パラメーター

スカラー値 | スカラー値の配列

4 番目の確率分布パラメーター。スカラー値またはスカラー値の配列を指定します。

入力引数 x、A、B、C および D の 1 つ以上が配列である場合、配列のサイズは同じでなければなりません。この場合、pdf は配列入力と同じサイズの定数配列に各スカラー入力を拡張します。各分布の A、B、C および D の定義については、'name' を参照してください。

データ型: single | double

pd — 確率分布

確率分布オブジェクト

確率分布。次の表の関数またはアプリで作成した確率分布オブジェクトを指定します。

関数またはアプリ	説明
makedist	指定されたパラメーター値を使用して確率分布オブジェクトを作成します。
fitdist	確率分布オブジェクトを標本データにあてはめます。
Distribution Fitter	対話型の Distribution Fitter アプリを使用して確率分布を標本データにあてはめ、あてはめたオブジェクトをワークスペースにエクスポートします。
paretotails	裾が一般化パレート分布になっている区分的分布オブジェクトを作成します。

出力引数

y — pdf の値

スカラー値 | スカラー値の配列

pdf の値。スカラー値、またはスカラー値の配列として返されます。y は、必要なスカラー拡張後の x と同じサイズになります。y の各要素は、分布パラメーター (A、B、C、および D) 内の対応する要素または確率分布オブジェクト (pd) によって指定される分布の pdf 値で、x 内の対応する要素で評価されています。

代替機能

• pdf は、名前 'name' によって指定された分布、または確率分布オブジェクト pd のいずれも受け入れる汎用関数です。正規分布の場合は normpdf、二項分布の場合は binopdf など、分布特有の関数を使用する方が高速です。分布特有の関数の一覧については、サポートされている分布を参照してください。

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

拡張機能

C/C++ コード生成

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

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

• 入力引数 'name' はコンパイル時の定数でなければなりません。たとえば、正規分布を使用するには、coder.Constant('Normal') を codegen (MATLAB Coder) の -args の値に含めます。

• 入力引数 pd は、ベータ分布、指数分布、極値分布、対数正規分布、正規分布、ワイブル分布の近似確率分布オブジェクトとなります。確率分布を関数 fitdist の標本データにあてはめることで、pd を作成します。たとえば、確率分布オブジェクトのコードの生成を参照してください。

コード生成の詳細については、コード生成の紹介および一般的なコード生成のワークフローを参照してください。

参考

cdf | Distribution Fitter | fitdist | icdf | makedist | mle | paretotails | random

トピック

• 確率分布の操作
• サポートされている分布

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがシステム上にあります。代わりにこのバージョンを開きますか?

いいえ、変更されたバージョンを上書きします。 はい