statelevels

levels = statelevels(x) は、ヒストグラム法を使用して 2 値波形 x の Low 状態レベルおよび High 状態レベルを推定します。詳細については、アルゴリズムを参照してください。

levels = statelevels(x,nbins) では、ヒストグラムで使用するビンの数を正のスカラー値として指定します。

levels = statelevels(x,nbins,method) は、サブヒストグラムの平均またはモードを使用して状態レベルを推定します。

levels = statelevels(x,nbins,method,bounds) は、2 要素の実数行ベクトル bounds のヒストグラムの下限と上限を指定します。statelevels は、ヒストグラムを計算するときに、これらの境界の外側にある x の値をすべて無視します。

[levels,histogram] = statelevels(___) は、x の値のヒストグラムを返します。

[levels,histogram,binlevels] = statelevels(___) は、各ヒストグラムビンの幅の中心値を返します。

statelevels(___) は、信号とそれに対応するヒストグラムのプロットを表示します。

例

状態レベルとサブヒストグラムの表示

2.3 V 不足減衰クロックデータの Low 状態レベルおよび High 状態レベルを推定します。推定された状態レベルとサブヒストグラムを使ってデータをプロットします。

load('clockex.mat','x')

statelevels(x)

ans = 1×2

    0.0027    2.3068

100 のビンとサブヒストグラムのモードを使用した状態レベル

4 MHz でサンプリングされた 2.3 V 不足減衰クロックデータの Low 状態レベルおよび High 状態レベルを推定します。

既定のビン数とサブヒストグラムのモードを使用して、状態レベルを推定します。

load('clockex.mat','x','t')
levs = statelevels(x)

levs = 1×2

    0.0027    2.3068

推定された Low 状態レベルおよび High 状態レベルを示すラインと共にクロックデータをプロットします。

statelevels(x)

ans = 1×2

    0.0027    2.3068

サブヒストグラムの平均を使用した状態レベル

4 MHz でサンプリングされた 2.3 V 不足減衰クロックデータの Low 状態レベルおよび High 状態レベルを推定します。

既定のビン数とサブヒストグラムの平均を使用して、状態レベルを推定します。推定された Low 状態レベルおよび High 状態レベルを示すラインと共にクロックデータをプロットします。

load('clockex.mat','x','t')

statelevels(x,1e3,'mean')

ans = 1×2

   -0.0014    2.3014

ヒストグラムカウントと各ヒストグラムビンの幅の中心値

4 MHz でサンプリングされた 2.3 V 不足減衰クロックデータの Low 状態レベルおよび High 状態レベルを推定します。ヒストグラム法で使用されるヒストグラムカウントと各ヒストグラムビンの幅の中心値を返します。4 つのビンを使用します。

load('clockex.mat','x','t')
[levs,histog,bilevs] = statelevels(x,4)

levs = 1×2

    0.2427    2.0428

histog = 4×1

    50
     0
     0
    50

bilevs = 4×1

    0.2427
    0.8427
    1.4428
    2.0428

波形をプロットして、レベルに注釈を付けます。

statelevels(x,4)

ans = 1×2

    0.2427    2.0428

入力引数

`x` — 2 値波形
実数ベクトル

2 値波形。実数値のベクトルとして指定します。

`nbins` — ヒストグラムビンの数
`100` (既定値) | 正の整数

ヒストグラムビンの数。実数の正のスカラーとして指定します。

`method` — 状態レベルの推定法
`'mode'` (既定値) | `'mean'`

サブヒストグラムでの状態レベルの推定法。'mode' または 'mean' として指定します。method は、Low 状態レベルおよび High 状態レベルの推定に使用する統計手法を指定します。アルゴリズムを参照してください。

`bounds` — ヒストグラムの下限と上限
2 要素の実数行ベクトル

ヒストグラムの下限と上限。2 要素の実数行ベクトルとして指定します。statelevels は、ヒストグラムを計算するときに、これらの境界の外側にある x の値をすべて無視します。

出力引数

`levels` — Low 状態および High 状態のレベル
2 要素の正の行ベクトル

Low 状態および High 状態のレベル。2 要素の正の行ベクトルとして返されます。状態レベルのベクトルは、ヒストグラム法によって推定されます。levels の最初の要素は Low 状態レベルで、2 番目の要素は High 状態レベルです。

`histogram` — ヒストグラムのカウント
列ベクトル

ヒストグラムカウント。各ヒストグラムビンにあるデータ値の数を含む nbins 要素の列ベクトルとして返されます。

`binlevels` — ヒストグラムビンの幅の中心値
列ベクトル

ヒストグラムビンの幅の中心値。列ベクトルとして返されます。この列ベクトルには、histogram のヒストグラムカウントに対するビンの幅の中心値が含まれます。

詳細