nanmedian

R2026b

(非推奨) NaN 値を無視した中央値

関数 nanmedian は推奨されません。代わりに、MATLAB^® 関数 median を使用してください。関数 median では、計算に NaN 値を含めるか省略するかを指定できます。詳細については、バージョン履歴を参照してください。

構文

y = nanmedian(X)

y = nanmedian(X,"all")

y = nanmedian(X,dim)

y = nanmedian(X,vecdim)

説明

y = nanmedian(X) は、すべての NaN 値を削除して計算された、X の要素の median を返します。

• X がベクトルである場合、nanmedian(X) は X のすべての非 NaN 要素の中央値です。

• X が行列である場合、nanmedian(X) は NaN 値を削除して計算された、列中央値の行ベクトルです。

• X が多次元配列である場合、nanmedian は X の大きさが 1 でない最初の次元に作用します。この次元のサイズは 1 になりますが、他の次元のサイズはすべて変化しません。nanmedian はすべての NaN 値を削除します。

y = nanmedian(X,"all") は、NaN 値を削除して計算された、X のすべての要素の中央値を返します。

y = nanmedian(X,dim) は、NaN 値を削除して計算された、X の作用次元 dim に沿った中央値を返します。

y = nanmedian(X,vecdim) は、ベクトル vecdim で指定された次元における中央値を返します。中央値は、NaN 値を削除した後で計算されます。たとえば X が行列である場合、次元 1 および 2 によって定義される配列スライスには行列のそれぞれの要素がすべて含まれるため、nanmedian(X,[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 = nanmedian(X)

y = 1×3

    3.5000    3.0000       NaN

ベクトル次元に沿った中央値

複数の次元における多次元配列の中央値を求めます。

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

X = reshape(1:30,[3 5 2]);
X([10:12 25]) = NaN

X = 
X(:,:,1) =

     1     4     7   NaN    13
     2     5     8   NaN    14
     3     6     9   NaN    15


X(:,:,2) =

    16    19    22   NaN    28
    17    20    23    26    29
    18    21    24    27    30

作用次元として 1 番目の次元と 2 番目の次元を指定して、X の各ページの中央値を求めます。

ypage = nanmedian(X,[1 2])

ypage = 
ypage(:,:,1) =

    6.5000


ypage(:,:,2) =

   22.5000

たとえば、ypage(1,1,1) は X(:,:,1) の非 NaN 要素の中央値です。

作用次元として 1 番目の次元と 3 番目の次元を指定して、各 X(:,i,:) スライスの要素の中央値を求めます。

ycol = nanmedian(X,[1 3])

ycol = 1×5

    9.5000   12.5000   15.5000   26.5000   21.5000

たとえば、ycol(4) は X(:,4,:) の非 NaN 要素の中央値です。

入力引数

X — 入力データ

スカラー | ベクトル | 行列 | 多次元配列

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

X が空の配列である場合、nanmedian(X) は NaN になります。

dim — 作用する対象となる次元

正の整数スカラー

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

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

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

• dim が 1 に等しい場合、nanmedian(X,1) は各列の中央値が格納されている行ベクトルを返します。

• dim が 2 に等しい場合、nanmedian(X,2) は各行の中央値が格納されている列ベクトルを返します。

dim が ndims(X) より大きい場合、または size(X,dim) が 1 である場合、nanmedian は X を返します。

vecdim — 次元のベクトル

正の整数ベクトル

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

たとえば、X が 2×3×3 の配列である場合、nanmedian(X,[1 2]) は 1×1×3 の配列を返します。出力の各要素は、X の対応するページにおける要素の中央値です。

出力引数

y — 中央値の値

スカラー | ベクトル | 行列 | 多次元配列

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

拡張機能

C/C++ コード生成

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

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

• 入力引数 "all" および vecdim はサポートされません。

• 入力引数 dim はコンパイル時の定数でなければなりません。

• 入力引数 dim を指定しなかった場合、生成されるコードでは作用次元が異なる可能性があります。この結果、ランタイム エラーが発生する可能性があります。詳細は、既定の次元の選択に関する MATLAB との非互換性 (MATLAB Coder)を参照してください。

コード生成の詳細については、統計と機械学習の関数のコード生成の紹介およびMATLAB Coder を使用したコード生成の概要 (MATLAB Coder)を参照してください。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限については、「C/C++ コード生成」セクションを参照してください。GPU コード生成にも同様の、使用上の注意および制限が適用されます。

GPU 配列

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

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

• 入力引数 "all" および vecdim はサポートされません。

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

バージョン履歴

R2006a より前に導入

R2020b: nanmedian は非推奨

関数 nanmedian は推奨されません。代わりに、MATLAB 関数 median を使用してください。nanmedian が削除される予定はありません。

コードを更新するには、関数名 nanmedian のインスタンスを median に変更します。次に、入力引数 missingflag に "omitnan" オプションを指定します。

median は、tall 配列、GPU 配列、分散配列、および C/C++ コード生成をサポートするための、より拡張された機能を提供します。

参考

NaN | median