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 값을 포함합니다. 이 차원의 크기는 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,"includenan")은 NaN 값을 계산에 포함하는 반면 rms(x,"omitnan")은 이러한 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

NaN을 제외한 RMS 값

벡터를 만들고 "omitnan" 옵션을 지정하여 NaN 값을 제외하고 RMS 값을 계산합니다.

x = [1.77 -0.005 3.98 -2.95 NaN 0.34 NaN 0.19];
y = rms(x,"omitnan")

y = 2.1536

omitnan"을 지정하지 않으면 rms는 NaN을 반환합니다.

입력 인수

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 — NaN 조건

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

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

• "includenan" — RMS 값을 계산할 때 NaN 값을 포함하며, NaN 결과가 생성됩니다.

• "omitnan" — 입력값의 모든 NaN 값을 무시합니다. 모든 요소가 NaN인 경우 결과는 NaN입니다.

출력 인수

y — RMS(제곱평균제곱근) 값

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

RMS(제곱평균제곱근) 값으로, 스칼라, 벡터 또는 다차원 배열로 반환됩니다.

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

• x가 행렬인 경우 y는 차원 dim 또는 차원 vecdim을 따라 계산된 RMS 값이 포함된 벡터입니다.

• x가 다차원 배열인 경우 y는 차원 dim 또는 차원 vecdim을 따라 계산된 RMS 값을 포함합니다. 이 차원의 크기는 1인 반면, 다른 모든 차원의 크기는 x와 동일하게 유지됩니다.

세부 정보

RMS(제곱평균제곱근) 값

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

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

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

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• 제공된 경우 dim, vecdim 및 nanflag는 상수여야 합니다.

• 가변 크기 입력값의 경우 Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder)의 자동 차원 제한을 참조하십시오.

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

스레드 기반 환경

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에 개발됨

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)

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예