Main Content

nanmean

(권장되지 않음) NaN 값을 무시하여 평균 구하기

nanmean은 권장되지 않습니다. MATLAB® 함수 mean을 대신 사용하십시오. mean 함수를 사용하면 NaN 값을 계산에 포함할지 아니면 제외할지 여부를 지정할 수 있습니다. 자세한 내용은 호환성 관련 고려 사항 항목을 참조하십시오.

설명

예제

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

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

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

  • X가 다차원 배열인 경우, nanmeanX의 첫 번째 비한원소 차원을 따라 연산을 수행합니다. 이 차원의 크기는 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

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

누락값을 포함하는 2×5×3 배열 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

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

누락값을 포함하는 2×5×3 배열 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가 빈 배열인 경우 nanmean(X)NaN입니다. 자세한 내용은 항목을 참조하십시오.

데이터형: single | double

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

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

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

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

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

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

데이터형: single | double

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

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

Mapping of input dimension of 2-by-3-by-3 to output dimension of 1-by-1-by-3

데이터형: single | double

출력 인수

모두 축소

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

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

확장 기능

버전 내역

R2006a 이전에 개발됨

모두 축소

R2020b: nanmean은 권장되지 않음

nanmean은 권장되지 않습니다. MATLAB 함수 mean을 대신 사용하십시오. nanmean을 제거할 계획은 없습니다.

코드를 업데이트하려면 함수 이름 nanmeanmean으로 변경하십시오. 그런 다음 nanflag 입력 인수에 대해 'omitnan' 옵션을 지정하십시오.

mean 함수는 nanmean 함수에 비해 다음과 같은 이점이 있습니다.

  • mean은 tall형 배열, GPU 배열, 분포 배열, C/C++ 코드 생성 및 GPU 코드 생성을 지원하기 위한 더 확장된 기능을 제공합니다.

  • mean은 지정된 데이터형을 갖는 출력값을 반환합니다.

참고 항목

|