Main Content

La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

rms

Valor de la media cuadrática

contraer todo en la página

Sintaxis

y = rms(x)
y = rms(x,"all")
y = rms(x,dim)
y = rms(x,vecdim)
y = rms(___,nanflag)

Descripción

ejemplo

y = rms(x) devuelve el valor de la media cuadrática (RMS) de la entrada, x.

  • Si x es un vector fila o columna, y es un escalar de valor real.

  • Si x es una matriz, y es un vector fila que contiene el valor RMS de cada columna.

  • Si x es un arreglo multidimensional, y contiene los valores RMS calculados en la primera dimensión del arreglo de tamaño mayor que 1. El tamaño de y en esta dimensión es 1, mientras que los tamaños de todas las demás dimensiones permanecen iguales que en x.

y = rms(x,"all") devuelve el valor RMS de todos los elementos de x.

ejemplo

y = rms(x,dim) opera en la dimensión dim. Por ejemplo, si x es una matriz, rms(x,2) opera sobre los elementos de cada fila y devuelve un vector columna que contiene el valor RMS de cada fila.

ejemplo

y = rms(x,vecdim) opera en las dimensiones especificadas en el vector vecdim. Por ejemplo, si x es una matriz, rms(x,[1 2]) opera en todos los elementos de x, puesto que todos los elementos de una matriz están incluidos en la parte del arreglo definida por las dimensiones 1 y 2.

ejemplo

y = rms(___,nanflag) especifica si incluir u omitir valores NaN en el cálculo de cualquiera de las sintaxis anteriores. Por ejemplo, rms(x,"omitnan") ignora los valores NaN al calcular la RMS. De forma predeterminada, rms incluye valores NaN.

Ejemplos

contraer todo

Abrir script en vivo

Calcule el valor RMS de una sinusoide.

t = 0:0.001:1-0.001;
x = cos(2*pi*100*t);
y = rms(x)
y = 0.7071
Abrir script en vivo

Cree una matriz y calcule el valor RMS de cada columna.

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

    5.8023    3.4157    5.0000
Abrir script en vivo

Cree una matriz y calcule el valor RMS de cada fila especificando la dimensión como 2.

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
Abrir script en vivo

Cree un arreglo 3D y calcule el valor RMS de cada página de datos (filas y columnas).

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
Abrir script en vivo

Cree una matriz que contenga valores NaN.

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

Calcule los valores RMS de la matriz excluyendo los valores NaN. Para columnas de matriz que contienen un valor NaN, rms se calcula con elementos que no son NaN. Para columnas de matriz que contienen solo valores NaN, el valor RMS es NaN.

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

    1.7700    0.2404       NaN    2.0903

Argumentos de entrada

contraer todo

Arreglo de entrada, especificado como vector, matriz o arreglo multidimensional.

Tipos de datos: single | double | logical | char
Soporte de números complejos: Sí

Dimensión en la que operar, especificada como escalar entero positivo. Si no especifica la dimensión, el valor predeterminado es la primera dimensión del arreglo de tamaño mayor que 1.

La dimensión dim indica la dimensión cuya longitud reduce a 1. El size(y,dim) es 1, mientras que los tamaños de todas las demás dimensiones siguen siendo los mismos que x.

Considere una matriz de entrada de m por n, x:

  • y = rms(x,1) calcula el valor RMS de los elementos de cada columna de x y devuelve un vector fila de 1 por n.

  • y = rms(x,2) calcula el valor RMS de los elementos de cada fila de x y devuelve un vector columna de m por 1.

Vector de dimensiones sobre las que operar, especificado como vector de enteros positivos. Cada elemento representa una dimensión del arreglo de entrada. La longitud de la salida en las dimensiones operativas especificadas es 1, mientras que las demás se mantienen iguales que en la entrada.

Por ejemplo, si x es un arreglo de 2 por 3 por 3, rms(x,[1 2]) devuelve un arreglo de 1 por 1 por 3 cuyos elementos son los valores RMS de cada página de x.

Condición de valor faltante, especificada como uno de estos valores:

  • "includemissing" o "includenan": incluyen los valores NaN en x al calcular la RMS. Si un elemento de la dimensión operativa es NaN, el elemento correspondiente en y es NaN. "includemissing" y "includenan" presentan el mismo comportamiento.

  • "omitmissing" o "omitnan": ignoran los valores NaN de x al calcular la RMS. Si todos los elementos de la dimensión operativa son NaN, el elemento correspondiente en y es NaN. "omitmissing" y "omitnan" presentan el mismo comportamiento.

Más acerca de

contraer todo

Valor de la media cuadrática

El valor de la media cuadrática de un arreglo x es

xRMS=1N∑n=1N|xn|2,

con la suma realizada a lo largo de la dimensión especificada.

Capacidades ampliadas

Historial de versiones

Introducido en R2012a

expandir todo

Consulte también

| | | | | (Signal Processing Toolbox)