rms

Valeur quadratique moyenne (RMS) des éléments d'un tableau.

📝Syntaxe

y = rms(x)
y = rms(x, dim)
y = rms(x, vecdim)
y = rms(x, 'all')
y = rms(x, dim, type)
y = rms(x, 'all', type)
y = rms(x, dim, type, nanflag)
y = rms(x, 'all', type, nanflag)

📥Arguments d'entrée

Paramètre	Description
x	Tableau d'entrée, spécifié comme un vecteur, une matrice ou un tableau multidimensionnel : types single, double, logique, entier
dim	Dimension sur laquelle opérer, spécifiée comme un scalaire entier positif.
'all'	Opérer sur tous les éléments de x, en retournant la valeur RMS de tous les éléments.
type	Type de données à utiliser dans le calcul : 'double', 'native'
nanflag	Condition de valeur manquante, spécifiée comme : 'includenan', 'includemissing', 'omitnan', 'omitmissing'

📤Arguments de sortie

Paramètre	Description
y	Valeur(s) quadratique(s) moyenne(s), retournée(s) sous forme de scalaire, vecteur ou tableau.

📄Description

rms renvoie la valeur quadratique moyenne (RMS) des éléments du tableau d'entrée.

Si x est un vecteur, y est un scalaire.
Si x est une matrice, y est un vecteur ligne contenant la valeur RMS pour chaque colonne (par défaut).
Si x est un tableau multidimensionnel, y contient les valeurs RMS calculées le long de la première dimension du tableau dont la taille n'est pas égale à 1, sauf si une autre dimension est spécifiée.

La valeur quadratique moyenne d'un tableau x est: $$\mathrm{RMS}(x) = \sqrt{ \frac{1}{N} \sum_{n=1}^{N} |x_n|^2 }$$ où la sommation est effectuée le long de la ou des dimensions spécifiées, et N est le nombre d'éléments le long de ces dimensions.

Gestion des NaN : Par défaut, les valeurs NaN sont incluses. Utilisez 'omitnan' ou 'omitmissing' pour ignorer les NaN.

Gestion du type : Si type est 'native', le calcul et la sortie utilisent la même classe que l'entrée (par exemple, une entrée entière renvoie une sortie entière).

💡Exemples

Valeur RMS d'un vecteur

t = 0:0.001:1-0.001;
x = cos(2*pi*100*t);
y = rms(x)
% y = 0.7071

Valeurs RMS des colonnes d'une matrice

x = [4 -5 1; 2 3 5; -9 1 7];
y = rms(x)
% y = [5.8023 3.4157 5.0000]

Valeurs RMS des lignes d'une matrice

x = [6 4 23 -3; 9 -10 4 11; 2 8 -5 1];
y = rms(x,2)
% y = [12.1450; 8.9163; 4.8477]

RMS en excluant les valeurs manquantes

x = [1.77 -0.005 nan -2.95; nan 0.34 nan 0.19];
y = rms(x,"omitnan")
% y = [1.7700 0.2404 nan 2.0903]

RMS avec entrée entière et sortie native

M = uint8([10:30:70;20:30:80;30:30:90]);
R = rms(M, 'native')
% R est de classe uint8

🔗Voir aussi

conv max min

🕔Historique des versions

Version	Description
1.16.0	version initiale

Modifier cette page sur GitHub