rms

Valeur quadratique moyenne.

📝Syntaxe

Y = rms(X)
Y = rms(X, DIM)
Y = rms(X, VECDIM)
Y = rms(X, "all")
Y = rms(..., TYPE)
Y = rms(..., NANFLAG)

📥Arguments d'entrée

Paramètre	Description
X	données d'entrée : single, double, logique ou entier.
DIM	dimension sur laquelle calculer la valeur.
VECDIM	vecteur de dimensions sur lesquelles calculer la valeur.
"all"	opérer sur tous les éléments de X.
TYPE	classe du résultat : "default", "double" ou "native".
NANFLAG	"includenan" ou "omitnan". "includemissing" et "omitmissing" sont aussi acceptés.

📤Arguments de sortie

Paramètre	Description
Y	valeurs quadratiques moyennes.

📄Description

rms calcule sqrt(mean(abs(X) .^ 2)) sur la dimension choisie :

$$\mathrm{RMS}(X) = \sqrt{ \frac{1}{N} \sum_{n=1}^{N} |x_n|^2 }$$

où N est le nombre d'éléments sur cette dimension.

Si X est un vecteur, Y est un scalaire.
Si X est une matrice, Y est un vecteur ligne contenant la valeur de chaque colonne.
Si X est un tableau multidimensionnel, Y est calculé sur la première dimension dont la taille n'est pas 1, sauf si une dimension est indiquée.

Classe du résultat : le carré et la moyenne sont toujours calculés en double, donc une entrée entière ne sature jamais. "native" renvoie la classe de l'entrée, "double" renvoie un double, et "default" renvoie un double pour une entrée entière et la classe de l'entrée sinon. Une entrée logique n'est pas une classe entière et renvoie un double.

Valeurs manquantes : les NaN sont pris en compte par défaut. Utiliser "omitnan" ou "omitmissing" pour les écarter.

💡Exemples

valeur quadratique moyenne d'un vecteur

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

une valeur par colonne

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

une valeur par ligne

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

en écartant 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]

entrée entière avec un résultat natif

M = uint8([10:30:70; 20:30:80; 30:30:90]);
R = rms(M, 'native')
% R = uint8([22 51 80])
D = rms(M)
% D = [21.6025 50.6623 80.4156]

🔗Voir aussi

peak2peak max min

🕔Historique des versions

Version	Description
1.16.0	version initiale

Modifier cette page sur GitHub