nanstd

y = nanstd(X) は、すべての NaN 値を削除して計算された、X の標準偏差 std です。

X がベクトルである場合、nanstd(X) は X のすべての非 NaN 要素の標本標準偏差です。
X が行列である場合、nanstd(X) は NaN 値を削除して計算された、列標本標準偏差の行ベクトルです。
X が多次元配列である場合、nanstd は X の大きさが 1 でない最初の次元に作用します。この次元のサイズは 1 になりますが、他の次元のサイズはすべて変化しません。nanstd はすべての NaN 値を削除します。
既定では、nanstd は n - 1 によって y を正規化します。n は、NaN 値が含まれている観測値を削除した後で残った観測値の個数です。

y = nanstd(X,flag) は、flag によって指定された正規化に基づいて、X の標準偏差を返します。flag は、n - 1 による正規化を指定する 0 (既定値) または n による正規化を指定する 1 です。n は、NaN 値が含まれている観測値を削除した後で残った観測値の個数です。

y = nanstd(X,flag,'all') は、NaN 値を削除して計算された、X のすべての要素の標準偏差を返します。

y = nanstd(X,flag,dim) は、NaN 値を削除して計算された、X の作用次元 dim に沿った標準偏差を返します。

y = nanstd(X,flag,vecdim) は、ベクトル vecdim で指定された次元における標準偏差を返します。標準偏差は、NaN 値を削除した後で計算されます。たとえば X が行列である場合、次元 1 および 2 によって定義される配列スライスには行列のそれぞれの要素がすべて含まれるため、nanstd(X,0,[1 2]) は X のすべての非 NaN 要素の標本標準偏差になります。

例

行列データの標準偏差

欠損値が含まれている行列データの列標準偏差を求めます。

X = magic(3);
X([1 6:9]) = NaN

X = 3×3

   NaN     1   NaN
     3     5   NaN
     4   NaN   NaN

y = nanstd(X)

y = 1×3

    0.7071    2.8284       NaN

母集団の標準偏差と標本の標準偏差

carsmall データセットを読み込みます。

load carsmall

Horsepower データの母標準偏差と標本標準偏差を計算します。関数 nanstd は、Horsepower 内の欠損値を無視します。

y1 = nanstd(Horsepower,1)   % Population formula

y1 = 45.2963

y2 = nanstd(Horsepower,0)   % Sample formula

y2 = 45.5268

すべての値の標準偏差

欠損値を無視して、配列内のすべての値の標準偏差を求めます。

欠損値が含まれている 3 x 4 x 2 の配列 X を作成します。

X = reshape(1:24,[3 4 2]);
X([8:10 18]) = NaN

X = 
X(:,:,1) =

     1     4     7   NaN
     2     5   NaN    11
     3     6   NaN    12


X(:,:,2) =

    13    16    19    22
    14    17    20    23
    15   NaN    21    24

X の要素の標本標準偏差を求めます。

y = nanstd(X,0,'all')

y = 7.5385

スカラー次元に沿った標準偏差

欠損値が含まれている行列データの行標準偏差を求めます。2 番目の次元に沿って標本標準偏差を計算するよう指定します。

X = magic(3);
X([1 6:9]) = NaN

X = 3×3

   NaN     1   NaN
     3     5   NaN
     4   NaN   NaN

y = nanstd(X,0,2)

ベクトル次元に沿った標準偏差

複数の次元における多次元配列の標準偏差を求めます。

欠損値が含まれている 3 x 4 x 2 の配列 X を作成します。

X = reshape(1:24,[3 4 2]);
X([8:10 18]) = NaN

X = 
X(:,:,1) =

     1     4     7   NaN
     2     5   NaN    11
     3     6   NaN    12


X(:,:,2) =

    13    16    19    22
    14    17    20    23
    15   NaN    21    24

作用次元として 1 番目の次元と 2 番目の次元を指定して、X の各ページの標本標準偏差を求めます。

ypage = nanstd(X,0,[1 2])

ypage = 
ypage(:,:,1) =

    3.8079


ypage(:,:,2) =

    3.7779

たとえば、ypage(1,1,2) は X(:,:,2) の非 NaN 要素の標本標準偏差です。

作用次元として 2 番目の次元と 3 番目の次元を指定して、各 X(i,:,:) スライスの要素の標本標準偏差を求めます。

yrow = nanstd(X,0,[2 3])

yrow = 3×1

    7.9102
    7.6904
    8.2158

たとえば、yrow(3) は X(3,:,:) の非 NaN 要素の標本標準偏差です。

入力引数

`X` — 入力データ
スカラー | ベクトル | 行列 | 多次元配列

入力データ。スカラー、ベクトル、行列または多次元配列を指定します。

データ型: single | double

`flag` — 正規化のインジケーター
`0` (既定値) | `1`

標準偏差の計算に使用する正規化のインジケーター。0 または 1 を指定します。

flag が 0 (既定値) である場合、nanstd は X の標本標準偏差を返します。nanstd(X,0) は nanstd(X) と同じです。
flag が 1 である場合、nanstd は X の母標準偏差を返します。

データ型: single | double

`dim` — 作用する対象となる次元
正の整数スカラー

作用する対象となる次元。正の整数スカラーを指定します。値を指定しなかった場合、サイズが 1 ではない最初の配列次元が既定値になります。

dim は、長さを 1 に縮小する次元を指定します。size(y,dim) は 1 ですが、他の次元のサイズはすべて変化しません。

2 次元配列 X について考えます。

dim が 1 に等しい場合、nanstd(X,0,1) は各列の標本標準偏差が格納されている行ベクトルを返します。
dim が 2 に等しい場合、nanstd(X,0,2) は各行の標本標準偏差が格納されている列ベクトルを返します。

dim が ndims(X) より大きい場合、または size(X,dim) が 1 である場合、nanstd はゼロの配列を返します。この配列の次元および欠損値は X と同じです。

データ型: single | double

`vecdim` — 次元のベクトル
正の整数ベクトル

次元のベクトル。正の整数ベクトルを指定します。vecdim の各要素は、入力配列 X の次元を表します。出力 y の指定された作用次元における長さは 1 です。他の次元の長さは、X と y で同じになります。

たとえば、X が 2 x 3 x 3 の配列である場合、nanstd(X,0,[1 2]) は 1 x 1 x 3 の配列を返します。出力配列の各要素は、X の対応するページにおける要素の標本標準偏差です。

データ型: single | double

出力引数

`y` — 標準偏差の値
スカラー | ベクトル | 行列 | 多次元配列

標準偏差の値。スカラー、ベクトル、行列または多次元配列として返されます。

詳細