rms

Valor de la media cuadrática

Sintaxis

y = rms(x)

y = rms(x,"all")

y = rms(x,dim)

y = rms(x,vecdim)

y = rms(___,nanflag)

Descripción

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 a lo largo de la primera dimensión del arreglo cuyo tamaño no es igual a 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.

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.

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.

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

Valor RMS de un vector

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

Valores RMS de las columnas de una matriz

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

Valores RMS de las filas de una matriz

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

Valores RMS de las páginas de un arreglo

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

RMS sin valores faltantes

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

x — Arreglo de entrada

vector | matriz | arreglo multidimensional

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

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

dim — Dimensión en la que operar

escalar entero positivo

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 cuyo tamaño no es igual a 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.

vecdim — Vector de dimensiones

vector de enteros positivos

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.

nanflag — Condición de valor faltante

"includemissing" (predeterminado) | "includenan" | "omitmissing" | "omitnan"

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

Valor de la media cuadrática

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

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

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

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función rms es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Si se utilizan, los argumentos dim, vecdim, nanflag y deben ser constantes en el tiempo de generación del código.

• Para el argumento de entrada x:

  • Si no especifica ninguna dimensión, el generador de código opera en la primera dimensión del arreglo de entrada que sea de tamaño variable o cuyo tamaño no sea igual a 1. Si esta dimensión es de tamaño variable en el tiempo de generación del código y tiene el valor 1 en el tiempo de ejecución, puede producirse un error en el tiempo de ejecución. Para evitar este error, especifique la dimensión.

  • Si todas las dimensiones del arreglo de entrada son de tamaño variable en el tiempo de generación del código, este arreglo no puede estar vacío en el tiempo de ejecución.

• La generación de código no es compatible con entradas de matrices dispersas en esta función.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos de GPU. Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido en R2012a

R2023a: Especificar una condición de valor faltante

Incluya u omita todos valores faltantes en el arreglo de entrada cuando calcule la RMS usando las opciones "includemissing" u "omitmissing". Estas opciones tienen el mismo comportamiento que las opciones "includenan" y "omitnan", respectivamente.

R2022a: Calcular el valor RMS de todos los elementos

Ahora puede calcular el valor RMS de todos los elementos del arreglo de entrada especificando "all". Por ejemplo, rms(x,"all") devuelve el valor RMS de todos los elementos del arreglo de entrada x.

R2022a: Calcular el valor RMS en varias dimensiones

Ahora puede calcular el valor RMS en varias dimensiones especificando un vector de enteros positivos. Use el argumento de entrada vecdim para especificar las dimensiones. Por ejemplo, rms(x,[1 2]) opera en la primera y segunda dimensión de x.

R2022a: Incluir u omitir valores NaN

Ahora puede incluir u omitir valores NaN en el cálculo de la RMS. Especifique "includenan" para incluir los valores NaN, lo que resulta en NaN. Especifique "omitnan" para ignorar todos los valores NaN en la entrada. Por ejemplo, rms(x,"includenan") incluye los valores NaN al calcular los valores RMS, lo que resulta en NaN.

R2022a: Se trasladó a MATLAB desde Signal Processing Toolbox

Anteriormente, rms requería Signal Processing Toolbox™.

Consulte también

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