KernelDistribution

R2026b

カーネル確率分布オブジェクト

説明

KernelDistribution オブジェクトは、ノンパラメトリックなカーネル平滑化分布のパラメーター、モデルの説明、および標本データから構成されます。

カーネル分布は、確率変数の確率密度関数 (pdf) のノンパラメトリック推定です。

カーネル分布では、次のパラメーターを使用します。

オプション	説明	取り得る値
Kernel	カーネル関数のタイプ	normal, box, triangle, epanechnikov
Bandwidth	カーネル平滑化パラメーター	Bandwidth > 0

作成

KernelDistribution 確率分布オブジェクトを作成するには、いくつかの方法があります。

• fitdist を使用して分布をデータに当てはめる。

• 分布フィッター アプリを使用して対話的に分布をデータに当てはめる。

プロパティ

分布パラメーター

Kernel — カーネル平滑化のタイプ

'normal' | 'box' | 'triangle' | 'epanechnikov'

カーネル関数のタイプ。有効なカーネル関数タイプ名として指定します。

Bandwidth — カーネル平滑化ウィンドウの帯域幅

正のスカラー値

カーネル平滑化ウィンドウの帯域幅。正のスカラー値として指定します。

データ型: single | double

分布特性

IsTruncated — 打ち切られた分布の論理フラグ

読み取り専用: 0 (既定値) | 1

この プロパティ は読み取り専用です。

打ち切られた分布の論理フラグ。0 または 1 として表されます。IsTruncated が 0 である場合、分布は打ち切られません。IsTruncated が 1 である場合、分布は打ち切られます。

データ型: logical

Truncation — 打ち切り区間

読み取り専用: 数値スカラーのベクトル

この プロパティ は読み取り専用です。

確率分布の打ち切り区間。打ち切りの上限と下限を含む数値スカラーのベクトルとして表されます。

データ型: single | double

その他のオブジェクト プロパティ

DistributionName — 確率分布名

読み取り専用: 文字ベクトル

この プロパティ は読み取り専用です。

確率分布の名前。文字ベクトルとして表されます。

データ型: char

InputData — 分布の当てはめに使用されるデータ。

読み取り専用: 構造体

この プロパティ は読み取り専用です。

分布の当てはめに使用するデータ。以下を含む構造体として表されます。

• data – 分布の当てはめに使用するデータ ベクトル

• cens – 打ち切りベクトル (ない場合は空)

• freq – 度数ベクトル (ない場合は空)

データ型: struct

オブジェクト関数

cdf	累積分布関数
gather	GPU からの Statistics and Machine Learning Toolbox オブジェクトのプロパティの収集
icdf	逆累積分布関数
iqr	確率分布の四分位数間範囲
mean	確率分布の平均
median	確率分布の中央値
negloglik	確率分布の負の対数尤度
pdf	確率密度関数
plot	確率分布オブジェクトのプロット
random	乱数
std	確率分布の標準偏差
truncate	確率分布オブジェクトの打ち切り
var	確率分布の分散

例

データへのカーネル分布オブジェクトの当てはめ

標本データを読み込みます。

load carsmall

変数 MPG には、自動車の燃費効率のデータが格納されています。

カーネル分布を MPG に当てはめて、確率分布オブジェクトを作成します。

pd = fitdist(MPG,"Kernel")

pd = 
  KernelDistribution

    Kernel = normal
    Bandwidth = 4.11428
    Support = unbounded

pd は、プロパティにカーネル平滑化タイプ、カーネル平滑化ウィンドウの帯域幅、および入力データについての指定を含む確率分布オブジェクトです。

入力データのヒストグラムでカーネル確率密度関数をプロットします。

plot(pd)

プロットは、MPG データに当てはめたカーネル分布の pdf を示しています。分布は右裾が大きく広がっており、若干偏っていますが滑らかです。

拡張機能

GPU 配列

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

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

• KernelDistribution は、fitdist で GPU 配列の入力引数を指定して当てはめられた確率分布オブジェクトにすることができます。

• KernelDistribution のオブジェクト関数は GPU 配列を完全にサポートしています。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2013a で導入

参考

fitdist | 分布フィッター

トピック

• 確率分布オブジェクトのグループ化されたデータへの当てはめ
• 複数の分布近似の比較
• カーネル分布
• ノンパラメトリックな経験的確率分布