rms

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), 여기서 nanflag는 "omitnan"이면 계산에서 NaN 값이 무시됩니다. nanflag의 디폴트 값은 "includenan"이며, 이 경우 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)

배열 페이지의 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(제곱평균제곱근) 값
스칼라 | 벡터 | N차원 배열

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

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

세부 정보