harmmean

조화 평균

페이지 내 모두 축소

구문

m = harmmean(X)
m = harmmean(X,'all')
m = harmmean(X,dim)
m = harmmean(X,vecdim)
m = harmmean(___,nanflag)

설명

m = harmmean(X)는 표본의 조화 평균을 계산합니다. 벡터의 경우, harmmean(X)는 X에 포함된 요소의 조화 평균입니다. 행렬의 경우, harmmean(X)는 각 열의 조화 평균을 포함하는 행 벡터입니다. N차원 배열의 경우, harmmean은 X의 첫 번째 비한원소 차원을 따라 연산을 수행합니다.

예제

m = harmmean(X,'all')은 X의 모든 요소에 대한 조화 평균을 반환합니다.

예제

m = harmmean(X,dim)은 X의 연산 차원 dim을 따라 조화 평균을 취합니다.

예제

m = harmmean(X,vecdim)은 벡터 vecdim에 지정된 차원을 따라 조화 평균을 반환합니다. vecdim의 각 요소는 입력 배열 X의 차원을 나타냅니다. 출력값 m은 지정된 연산 차원에서 길이가 1입니다. 다른 차원 길이는 X 및 m에서 같습니다. 예를 들어 X가 2×3×4 배열이면 harmmean(X,[1 2])는 1×1×4 배열을 반환합니다. 출력 배열의 각 요소는 X의 대응되는 페이지에 있는 요소의 조화 평균입니다.

예제

m = harmmean(___,nanflag)는 위에 열거된 구문에 나와 있는 입력 인수 조합을 사용하여 계산에서 NaN 값을 제외할지 여부를 지정합니다. 기본적으로 harmmean은 NaN 값을 계산에 포함시킵니다(nanflag가 값 'includenan'을 가짐). NaN 값을 제외하려면 nanflag의 값을 'omitnan'으로 설정합니다.

예제

예제

모두 축소

라이브 스크립트 열기

결과 재현이 가능하도록 난수 시드값을 설정합니다.

rng('default')

5개의 행과 4개의 열을 가진 지수 난수로 구성된 행렬을 만듭니다.

X = exprnd(1,5,4)
X = 5×4

    0.2049    2.3275    1.8476    1.9527
    0.0989    1.2783    0.0298    0.8633
    2.0637    0.6035    0.0438    0.0880
    0.0906    0.0434    0.7228    0.2329
    0.4583    0.0357    0.2228    0.0414

X에 있는 열의 조화 평균과 산술 평균을 계산합니다.

harmonic = harmmean(X)
harmonic = 1×4

    0.1743    0.0928    0.0797    0.1205


arithmetic = mean(X)
arithmetic = 1×4

    0.5833    0.8577    0.5734    0.6357

X의 모든 열에서 산술 평균이 조화 평균보다 큽니다.

라이브 스크립트 열기

배열의 모든 값에 대해 조화 평균을 구합니다.

3×5×2 배열 X를 만듭니다.

X = reshape(1:30,[3 5 2])
X = 
X(:,:,1) =

     1     4     7    10    13
     2     5     8    11    14
     3     6     9    12    15


X(:,:,2) =

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

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

m = harmmean(X,'all')
m = 
7.5094
라이브 스크립트 열기

다차원 배열에서 여러 다른 연산 차원을 따라서 그리고 차원 벡터를 지정하여 조화 평균을 구합니다.

3×5×2 배열 X를 만듭니다.

X = reshape(1:30,[3 5 2])
X = 
X(:,:,1) =

     1     4     7    10    13
     2     5     8    11    14
     3     6     9    12    15


X(:,:,2) =

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

디폴트 차원을 따라 X의 조화 평균을 구합니다.

hmean1 = harmmean(X)
hmean1 = 
hmean1(:,:,1) =

    1.6364    4.8649    7.9162   10.9392   13.9523


hmean1(:,:,2) =

   16.9607   19.9666   22.9710   25.9743   28.9770

기본적으로 harmmean은 크기가 1이 아닌 X의 첫 번째 차원을 따라 연산을 수행합니다. 여기서 이 차원은 X의 첫 번째 차원입니다. 따라서 hmean1은 1×5×2 배열입니다.

두 번째 차원을 따라 X의 조화 평균을 구합니다.

hmean2 = harmmean(X,2)
hmean2 = 
hmean2(:,:,1) =

    3.1852
    5.0641
    6.5693


hmean2(:,:,2) =

   21.1595
   22.1979
   23.2329

hmean2는 3×1×2 배열입니다.

세 번째 차원을 따라 X의 조화 평균을 구합니다.

hmean3 = harmmean(X,3)
hmean3 = 3×5

    1.8824    6.6087   10.6207   14.2857   17.7561
    3.5789    8.0000   11.8710   15.4595   18.8837
    5.1429    9.3333   13.0909   16.6154   20.0000

hmean3은 3×5 배열입니다.

vecdim 입력 인수로 첫 번째 차원과 두 번째 차원을 지정하여 X의 각 페이지에 대한 조화 평균을 구합니다.

mpage = harmmean(X,[1 2])
mpage = 
mpage(:,:,1) =

    4.5205


mpage(:,:,2) =

   22.1645

예를 들어 mpage(1,1,2)는 X(:,:,2)에 포함된 요소의 조화 평균입니다.

두 번째 차원과 세 번째 차원을 지정하여 각 X(i,:,:) 슬라이스에 포함된 요소의 조화 평균을 구합니다.

mrow = harmmean(X,[2 3])
mrow = 3×1

    5.5369
    8.2469
   10.2425

예를 들어 mrow(3)은 X(3,:,:)에 포함된 요소의 조화 평균이며 harmmean(X(3,:,:),'all')을 지정하는 것과 동일합니다.

라이브 스크립트 열기

벡터를 만들고 NaN 값을 제외한 벡터의 harmmean을 계산합니다.

x = 1:10;
x(3) = nan; % Replace the third element of x with a NaN value
n = harmmean(x,'omitnan')
n = 
3.4674

'omitnan'을 지정하지 않으면 harmmean(x)는 NaN을 반환합니다.

세부 정보

모두 축소

팁

  • harmmean이 0을 포함하는 배열의 조화 평균을 계산하는 경우 반환되는 값은 0입니다.

확장 기능

모두 확장

버전 내역

R2006a 이전에 개발됨

모두 확장

참고 항목

| | |