rms

RMS 값

구문

y = rms(x)

y = rms(x,"all")

y = rms(x,dim)

y = rms(x,vecdim)

y = rms(___,nanflag)

설명

y = rms(x)는 입력 x의 RMS(제곱평균제곱근) 값을 반환합니다.

• x가 행 또는 열 벡터인 경우 y는 실수 값의 스칼라입니다.

• x가 행렬인 경우 y는 각 열의 RMS 값이 포함된 행 벡터입니다.

• x가 다차원 배열인 경우 y에는 크기가 1이 아닌 첫 번째 배열 차원을 따라 계산된 RMS 값이 포함됩니다. 이 차원에서 y의 크기는 1이 되고, 다른 모든 차원의 크기는 x와 동일하게 유지됩니다.

y = rms(x,"all")은 x에 있는 모든 요소의 RMS 값을 반환합니다.

y = rms(x,dim)은 차원 dim을 따라 연산을 수행합니다. 예를 들어, x가 행렬인 경우 rms(x,2)는 각 행의 요소에 대해 연산을 수행하며 각 행의 RMS 값이 포함된 열 벡터를 반환합니다.

y = rms(x,vecdim)은 벡터 vecdim에 지정된 차원을 따라 연산을 수행합니다. 예를 들어, x가 행렬인 경우 rms(x,[1 2])는 차원 1과 2로 정의된 배열 슬라이스에 행렬의 모든 요소가 포함되어 있으므로 x의 모든 요소에 대해 연산을 수행합니다.

y = rms(___,nanflag)는 위에 열거된 구문의 계산에 NaN 값을 포함시킬지 또는 생략할지 여부를 지정합니다. 예를 들어, rms(x,"omitnan")은 RMS를 계산할 때 NaN 값을 무시합니다. 기본적으로 rms는 NaN 값을 포함합니다.

예제

벡터의 RMS 값

정현파의 RMS 값을 계산합니다.

t = 0:0.001:1-0.001;
x = cos(2*pi*100*t);
y = rms(x)

y = 
0.7071

행렬 열의 RMS 값

행렬을 만들고 각 열의 RMS 값을 계산합니다.

x = [4 -5 1; 2 3 5; -9 1 7];
y = rms(x)

y = 1×3

    5.8023    3.4157    5.0000

행렬 행의 RMS 값

행렬을 만들고 차원을 2로 지정하여 각 행의 RMS 값을 계산합니다.

x = [6 4 23 -3; 9 -10 4 11; 2 8 -5 1];
y = rms(x,2)

y = 3×1

   12.1450
    8.9163
    4.8477

배열 페이지의 RMS 값

3차원 배열을 만들고 데이터의 각 페이지(행과 열)에 대한 RMS 값을 계산합니다.

x(:,:,1) = [2 4; -2 1];
x(:,:,2) = [9 13; -5 7];
x(:,:,3) = [4 4; 8 -3];
y = rms(x,[1 2])

y = 
y(:,:,1) =

    2.5000


y(:,:,2) =

     9


y(:,:,3) =

    5.1235

누락값을 제외한 RMS

NaN 값이 포함된 행렬을 만듭니다.

x = [1.77 -0.005 NaN -2.95; NaN 0.34 NaN 0.19];

NaN 값을 제외하고 행렬의 RMS 값을 계산합니다. NaN 값이 포함된 행렬 열의 경우 rms는 NaN이 아닌 요소에 대해 계산을 수행합니다. 값이 모두 NaN인 행렬 열의 경우 RMS는 NaN이 됩니다.

y = rms(x,"omitnan")

y = 1×4

    1.7700    0.2404       NaN    2.0903

입력 인수

x — 입력 배열

벡터 | 행렬 | 다차원 배열

입력 배열로, 벡터, 행렬, 다차원 배열 중 하나로 지정됩니다.

데이터형: single | double | logical | char
복소수 지원 여부: 예

dim — 연산을 수행할 차원

양의 정수 스칼라

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

차원 dim은 길이가 1로 줄어드는 차원을 나타냅니다. size(y,dim)은 1이 되고, 다른 모든 차원의 크기는 x와 동일하게 유지됩니다.

m×n 입력 행렬 x가 있다고 가정합니다.

• y = rms(x,1)은 x의 각 열에서 요소들의 RMS 값을 계산하고 1×n 행 벡터를 반환합니다.

• y = rms(x,2)는 x의 각 행에서 요소들의 RMS 값을 계산하고 m×1 열 벡터를 반환합니다.

vecdim — 차원의 벡터

양의 정수로 구성된 벡터

연산을 수행할 차원의 벡터로, 양의 정수로 구성된 벡터로 지정됩니다. 각 요소는 입력 배열의 차원을 나타냅니다. 지정된 연산 차원의 출력값의 길이는 1이고, 다른 차원 길이는 입력값과 동일하게 유지됩니다.

예를 들어 x가 2×3×3 배열이면 rms(x,[1 2])는 x의 각 페이지의 RMS 값을 요소로 갖는 1×1×3 배열을 반환합니다.

nanflag — 누락값 조건

"includemissing" (디폴트 값) | "includenan" | "omitmissing" | "omitnan"

누락값 조건으로, 다음 값 중 하나로 지정됩니다.

• "includemissing" 또는 "includenan" — RMS를 계산할 때 x의 NaN 값을 포함합니다. 연산 차원의 요소가 하나라도 NaN인 경우 이에 대응하는 y의 요소도 NaN입니다. "includemissing"과 "includenan"은 동일하게 동작합니다.

• "omitmissing" 또는 "omitnan" — RMS를 계산할 때 x의 NaN 값을 무시합니다. 연산 차원의 모든 요소가 NaN인 경우 이에 대응하는 y의 요소는 NaN이 됩니다. "omitmissing"과 "omitnan"은 동일하게 동작합니다.

세부 정보

RMS 값

배열 x의 RMS(제곱평균제곱근) 값은 다음과 같습니다.

$$x_{\text{RMS}}=\sqrt{\frac{1}{N}{\displaystyle \sum _{n=1}^N{\left|x_n\right|}^2}},$$

여기서 합은 지정된 차원을 따라 수행됩니다.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

rms 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• 인수 dim, vecdim, nanflag가 사용될 경우, 이러한 인수는 코드 생성 시 상수여야 합니다.

• 입력 인수 x에 대해 다음이 적용됩니다.

  • 차원을 지정하지 않을 경우 코드 생성기는 입력 배열에서 가변 크기이거나 크기가 1이 아닌 첫 번째 차원을 따라 연산을 수행합니다. 이 차원이 코드 생성 시점에 가변 크기이고 런타임에 1인 경우, 런타임 오류가 발생할 수 있습니다. 이 오류를 피하려면 차원을 지정하십시오.

  • 코드 생성 시 입력 배열의 모든 차원이 가변 크기이면 이 배열은 런타임에 비어 있을 수 없습니다.

• 코드 생성 시 이 함수에 대해 희소 행렬 입력값은 지원되지 않습니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

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

이 함수는 GPU 배열을 완전히 지원합니다. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2012a에 개발됨

R2023a: 누락값 조건 지정

RMS를 구할 때 "includemissing" 또는 "omitmissing" 옵션을 사용하여 입력 배열의 모든 누락값을 포함하거나 생략합니다. 이러한 옵션은 각각 "includenan" 및 "omitnan" 옵션과 동일하게 동작합니다.

R2022a: 모든 요소에 대해 RMS 계산

이제 "all"을 지정하여 입력 배열에 있는 모든 요소의 RMS 값을 계산할 수 있습니다. 예를 들어, rms(x,"all")은 입력 배열 x에 있는 모든 요소의 RMS 값을 반환합니다.

R2022a: 여러 차원을 따라 RMS 계산

이제 양의 정수로 구성된 벡터를 지정하여 여러 차원을 따라 RMS 값을 계산할 수 있습니다. 차원을 지정하려면 vecdim 입력 인수를 사용하십시오. 예를 들어, rms(x,[1 2])는 x의 첫 번째 차원과 두 번째 차원을 따라 연산을 수행합니다.

R2022a: NaN 값 포함 또는 생략

이제 RMS 계산에 NaN 값을 포함시키거나 생략할 수 있습니다. NaN 값을 포함하려면 "includenan" 을 지정하며, NaN 결과가 생성됩니다. 입력의 모든 NaN 값을 무시하려면 "omitnan"을 지정합니다. 예를 들어, rms(x,"includenan")은 RMS 값을 계산할 때 NaN 값을 포함하며, 결과적으로 NaN이 생성됩니다.

R2022a: Signal Processing Toolbox에서 MATLAB으로 이동됨

이전에는 rms를 실행하려면 Signal Processing Toolbox™가 필요했습니다.

참고 항목

min | max | median | mean | std | peak2rms (Signal Processing Toolbox)