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]) 对 x 的所有元素进行运算，因为矩阵的每个元素都包含在由维度 1 和 2 定义的数组切片中。

示例

y = rms(___,nanflag) 可指定在上述任一语法的计算中包括还是忽略 NaN 值。例如，rms(x,"omitnan") 在计算 RMS 时会忽略 NaN 值。默认情况下，rms 包括 NaN 值。

示例

示例

全部折叠

打开实时脚本

计算正弦波的 RMS 值。

t = 0:0.001:1-0.001;
x = cos(2*pi*100*t);
y = rms(x)
y = 
0.7071
打开实时脚本

创建一个矩阵并计算每列的 RMS 值。

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

    5.8023    3.4157    5.0000
打开实时脚本

创建一个矩阵，并通过将维度指定为 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 值。

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 值的矩阵。

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

计算矩阵的 RMS 值，不包括 NaN 值。对于包含任一 NaN 值的矩阵列，rms 使用非 NaN 元素进行计算。对于包含的值都是 NaN 的矩阵列，RMS 为 NaN。

y = rms(x,"omitnan")
y = 1×4

    1.7700    0.2404       NaN    2.0903

输入参数

全部折叠

输入数组，指定为向量、矩阵或多维数组。

数据类型: single | double | logical | char
复数支持: 是

沿其运算的维度，指定为正整数标量。如果不指定维度，则默认值是大小不等于 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 列向量。

要沿其运算的维度组成的向量，指定为正整数向量。每个元素代表输入数组的一个维度。在指定的运算维度中输出的长度为 1，而其他维度长度保持与输入相同。

例如，如果 x 是一个 2×3×3 数组，则 rms(x,[1 2]) 返回一个 1×1×3 数组，其元素是 x 的每个页面的 RMS 值。

缺失值条件，指定为下列值之一：

  • "includemissing" 或 "includenan" - 在计算 RMS 时包括 x 中的 NaN 值。如果运算维度中的任一元素是 NaN，则 y 中的对应元素也是 NaN。"includemissing" 和 "includenan" 具有相同的行为。

  • "omitmissing" 或 "omitnan" - 在计算 RMS 时忽略 x 中的 NaN 值。如果运算维度中的所有元素都是 NaN，则 y 中的对应元素是 NaN。"omitmissing" 和 "omitnan" 具有相同的行为。

详细信息

全部折叠

扩展功能

全部展开

版本历史记录

在 R2012a 中推出

全部展开

另请参阅

| | | | | (Signal Processing Toolbox)