이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

nanmean

NaN 값을 무시하여 평균 구하기

구문

y = nanmean(X)

y = nanmean(X,'all')

y = nanmean(X,dim)

y = nanmean(X,vecdim)

설명

y = nanmean(X)는 모든 NaN 값을 제거한 후에 계산한 X의 요소의 mean을 반환합니다.

• X가 벡터인 경우, nanmean(X)는 X에서 NaN이 아닌 모든 요소의 평균입니다.

• X가 행렬인 경우, nanmean(X)는 NaN 값을 제거한 후에 계산한 열 평균으로 구성된 행 벡터입니다.

• X가 다차원 배열인 경우, nanmean은 X의 첫 번째 비한원소 차원을 따라 연산을 수행합니다. 이 차원의 크기는 1이 되고 다른 모든 차원의 크기는 변경되지 않습니다. nanmean은 모든 NaN 값을 제거합니다.

nanmean이 모두 NaN 값으로 구성된 배열을 처리하는 방법에 대한 자세한 내용은 팁 항목을 참조하십시오.

y = nanmean(X,'all')은 NaN 값을 제거한 후에 계산한 X의 모든 요소의 평균을 반환합니다.

y = nanmean(X,dim)은 NaN 값을 제거한 후에 X의 연산 차원 dim을 따라 계산한 평균을 반환합니다.

y = nanmean(X,vecdim)은 벡터 vecdim에 지정된 차원을 따라 평균을 반환합니다. 이 함수는 NaN 값을 제거한 후 평균을 계산합니다. 예를 들어, X가 행렬인 경우 행렬의 모든 요소가 차원 1 및 차원 2로 정의된 배열 슬라이스에 포함되어 있기 때문에 nanmean(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 = nanmean(X)

y = 1×3

    3.5000    3.0000       NaN

모든 값의 평균 구하기

결측값을 무시하고 배열의 모든 값에 대한 평균을 구합니다.

결측값을 포함하는 2x5x3 배열 X를 생성합니다.

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

X = 
X(:,:,1) =

     1     3     5     7     9
     2     4     6     8   NaN


X(:,:,2) =

   NaN    13    15    17    19
   NaN    14    16    18    20


X(:,:,3) =

    21    23   NaN    27    29
    22    24    26    28    30

X의 요소에 대한 평균을 구합니다.

y = nanmean(X,'all')

y = 15.6538

스칼라 차원을 따라 평균 구하기

두 번째 차원을 따라 평균을 계산하도록 지정하여 결측값이 있는 행렬 데이터에 대한 행 평균을 구합니다.

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

X = 3×3

   NaN     1   NaN
     3     5   NaN
     4   NaN   NaN

y = nanmean(X,2)

y = 3×1

     1
     4
     4

벡터 차원을 따라 평균 구하기

여러 차원을 따르는 다차원 배열의 평균을 구합니다.

결측값을 포함하는 2x5x3 배열 X를 생성합니다.

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

X = 
X(:,:,1) =

     1     3     5     7     9
     2     4     6     8   NaN


X(:,:,2) =

   NaN    13    15    17    19
   NaN    14    16    18    20


X(:,:,3) =

    21    23   NaN    27    29
    22    24    26    28    30

차원 1과 차원 2를 연산 차원으로 지정하여 X의 각 페이지에 대한 평균을 구합니다.

ypage = nanmean(X,[1 2])

ypage = 
ypage(:,:,1) =

     5


ypage(:,:,2) =

   16.5000


ypage(:,:,3) =

   25.5556

예를 들어, ypage(1,1,1)은 X(:,:,1)에서 NaN이 아닌 요소의 평균입니다.

차원 2와 차원 3을 연산 차원으로 지정하여 각 X(i,:,:) 슬라이스에 포함된 요소의 평균을 구합니다.

yrow = nanmean(X,[2 3])

yrow = 2×1

   14.5385
   16.7692

예를 들어, yrow(2)는 X(2,:,:)에서 NaN이 아닌 요소의 평균입니다.

입력 인수

X — 입력 데이터

스칼라 | 벡터 | 행렬 | 다차원 배열

입력 데이터로, 스칼라, 벡터, 행렬 또는 다차원 배열로 지정됩니다.

X가 빈 배열인 경우 nanmean(X)는 NaN입니다. 자세한 내용은 팁 항목을 참조하십시오.

데이터형: single | double

dim — 연산을 수행할 차원

양의 정수 스칼라

연산을 수행할 차원으로, 양의 정수 스칼라로 지정됩니다. 값을 지정하지 않으면 디폴트 값은 크기가 1이 아닌 첫 번째 배열 차원이 됩니다.

dim은 길이가 1로 줄어드는 차원을 나타냅니다. size(y,dim)은 1이 되고, 다른 모든 차원의 크기는 변경되지 않습니다.

2차원 배열 X가 있다고 가정합니다.

• dim이 1인 경우, nanmean(X,1)은 각 열의 평균을 포함하는 행 벡터를 반환합니다.

• dim이 2인 경우, nanmean(X,2)는 각 행의 평균을 포함하는 열 벡터를 반환합니다.

dim이 ndims(X)보다 크거나 size(X,dim)이 1인 경우, nanmean은 X를 반환합니다.

데이터형: single | double

vecdim — 차원의 벡터

양의 정수 벡터

차원의 벡터로, 양의 정수 벡터로 지정됩니다. vecdim의 각 요소는 입력 배열 X의 차원을 나타냅니다. 출력값 y는 지정된 연산 차원에서 길이가 1입니다. 다른 차원 길이는 X 및 y에서 같습니다.

예를 들어, X가 2x3x3 배열인 경우 nanmean(X,[1 2])는 1x1x3 배열을 반환합니다. 출력값의 각 요소는 X의 대응하는 페이지의 요소에 대한 평균입니다.

데이터형: single | double

출력 인수

y — 평균값

스칼라 | 벡터 | 행렬 | 다차원 배열

평균값으로, 스칼라, 벡터, 행렬 또는 다차원 배열로 반환됩니다.

팁

• nanmean이 모두 NaN 값으로 구성된 배열의 평균을 계산하는 경우, NaN 값이 제거되고 나면 배열이 비게 되고, 따라서 나머지 요소의 합이 0이 됩니다. 평균 계산에 0으로 나누는 과정이 포함되므로 평균값이 NaN이 됩니다. 출력값 NaN은 NaN 값들의 평균이 아닙니다.

대체 기능

nanmean을 사용하는 대신 MATLAB^® 함수 mean을 사용하면서 입력 인수 nanflag를 값 'omitnan'으로 지정할 수 있습니다.

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 다음 구문은 코드 생성을 지원하지 않습니다.

  • y = nanmean(X,'all')

  • y = nanmean(X,vecdim)

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 다음 구문에서는 GPU 배열을 입력 인수로 사용할 수 없습니다.

  • y = nanmean(X,'all')

  • y = nanmean(X,vecdim)

자세한 내용은 Run MATLAB Functions on a GPU (Parallel Computing Toolbox) 항목을 참조하십시오.

참고 항목

NaN | mean | nanmedian

R2006a 이전에 개발됨