rms

Valore quadratico medio

Sintassi

y = rms(x)

y = rms(x,"all")

y = rms(x,dim)

y = rms(x,vecdim)

y = rms(___,nanflag)

Descrizione

y = rms(x) restituisce il valore quadratico medio (RMS) dell'input x.

• Se x è un vettore riga o colonna, y è uno scalare a valore reale.

• Se x è una matrice, y è un vettore riga contenente il valore RMS per ciascuna colonna.

• Se x è un array multidimensionale, y contiene i valori RMS calcolati lungo la prima dimensione dell'array la cui grandezza non è uguale a 1. La grandezza di y in questa dimensione è 1, mentre le grandezze di tutte le altre dimensioni rimangono le stesse di x.

y = rms(x,"all") restituisce il valore RMS di tutti gli elementi in x.

y = rms(x,dim) opera lungo la dimensione dim. Ad esempio, se x è una matrice, rms(x,2) opera sugli elementi di ciascuna riga e restituisce un vettore colonna contenente il valore RMS di ciascuna riga.

y = rms(x,vecdim) opera lungo le dimensioni specificate nel vettore vecdim. Ad esempio, se x è una matrice, rms(x,[1 2]) opera su tutti gli elementi di x, poiché ogni elemento di una matrice è contenuto nella porzione di array definita dalle dimensioni 1 e 2.

y = rms(___,nanflag) specifica se includere o omettere i valori NaN nel calcolo per una qualsiasi delle sintassi precedenti. Ad esempio, rms(x,"omitnan") ignora i valori NaN nel calcolare l'RMS. Per impostazione predefinita, rms include i valori NaN.

Esempi

Valore RMS del vettore

Calcolare il valore RMS di una sinusoide.

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

y = 
0.7071

Valori RMS delle colonne della matrice

Creare una matrice e calcolare il valore RMS di ciascuna colonna.

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

y = 1×3

    5.8023    3.4157    5.0000

Valori RMS delle righe della matrice

Creare una matrice e calcolare il valore RMS di ciascuna riga specificando la dimensione come 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

Valori RMS delle pagine dell'array

Creare un array tridimensionale e calcolare il valore RMS di ciascuna pagina di dati (righe e colonne).

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 con esclusione dei valori mancanti

Creare una matrice contenente valori NaN.

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

Calcolare i valori RMS della matrice, escludendo i valori NaN. Per le colonne della matrice che contengono qualsiasi valore NaN, rms esegue il calcolo con gli elementi che non sono NaN. Per le colonne della matrice che contengono tutti valori NaN, l'RMS è NaN.

y = rms(x,"omitnan")

y = 1×4

    1.7700    0.2404       NaN    2.0903

Argomenti di input

x — Array di input

vettore | matrice | array multidimensionale

Array di input, specificato come vettore, matrice o array multidimensionale.

Tipi di dati: single | double | logical | char
Supporto numeri complessi: Sì

dim — Dimensione lungo la quale operare

scalare intero positivo

Dimensione lungo la quale operare, specificata come scalare intero positivo. Se non si specifica la dimensione, per impostazione predefinita si considera la prima dimensione dell'array la cui grandezza non è uguale a 1.

La dimensione dim indica la dimensione la cui lunghezza si riduce a 1. size(y,dim) è 1, mentre le grandezze di tutte le altre dimensioni rimangono le stesse di x.

Considerare una matrice di input m x n, x:

• y = rms(x,1) calcola il valore RMS degli elementi in ciascuna colonna di x e restituisce un vettore riga 1 x n.

• y = rms(x,2) calcola il valore RMS degli elementi in ciascuna riga di x e restituisce un vettore colonna m x 1.

vecdim — Vettore di dimensioni

vettore di numeri interi positivi

Vettore delle dimensioni lungo cui operare, specificato come vettore di numeri interi positivi. Ciascun elemento rappresenta una dimensione dell'array di input. La lunghezza dell'output nelle dimensioni operative specificate è 1, mentre le lunghezze delle altre dimensioni rimangono uguali a quelle dell'input.

Ad esempio, se x è un array di 2x3x3, rms(x,[1 2]) restituisce un array 1x1x3 i cui elementi sono i valori RMS di ciascuna pagina di x.

nanflag — Condizione di valore mancante

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

Condizione di valore mancante, specificata come uno dei seguenti valori:

• "includemissing" o "includenan": include i valori NaN in x nel calcolare l'RMS. Se qualsiasi elemento della dimensione operativa è NaN, l’elemento corrispondente in y è NaN. "includemissing" e "includenan" si comportano allo stesso modo.

• "omitmissing" o "omitnan": ignora i valori NaN in x nel calcolare l'RMS. Se tutti gli elementi della dimensione operativa sono NaN, l’elemento corrispondente in y è NaN. "omitmissing" e "omitnan" si comportano allo stesso modo.

Ulteriori informazioni

Valore quadratico medio

Il valore quadratico medio di un array x è

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

con la sommatoria eseguita lungo la dimensione specificata.

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione rms supporta completamente i tall array. Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• Se utilizzati, gli argomenti dim, vecdim e nanflag devono essere costanti al momento della generazione di codice.

• Per l'argomento di input x:

  • Se non si specifica una dimensione, il generatore di codice opera lungo la prima dimensione dell'array di input che ha grandezza variabile o la cui grandezza non è uguale a 1. Se questa dimensione ha grandezza variabile al momento della generazione di codice ed è pari a 1 in fase di esecuzione, può verificarsi un errore di runtime. Per evitare il verificarsi di tale errore, specificare la dimensione.

  • Se tutte le dimensioni dell'array input hanno grandezza variabile al momento della generazione di codice, questo array non può essere vuoto in fase di esecuzione.

• La generazione di codice non supporta input di matrici sparse per questa funzione.

Generazione di codice GPU

Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Consultare le note su utilizzo e limitazioni nella sezione Generazione di codice C/C++. Le stesse note su utilizzo e limitazioni si applicano alla generazione di codice GPU.

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

La funzione rms supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

Questa funzione supporta completamente gli array di GPU. Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

La funzione rms supporta completamente gli array distribuiti. Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introdotto in R2012a

R2023a: Specifica della condizione di valore mancante

Includere o omettere tutti i valori mancanti nell'array di input quando si calcola l'RMS utilizzando le opzioni "includemissing" o "omitmissing". Queste opzioni hanno rispettivamente lo stesso comportamento delle opzioni "includenan" e "omitnan".

R2022a: Calcolo dell''RMS di tutti gli elementi

Ora è possibile calcolare il valore RMS di tutti gli elementi dell'array di input specificando "all". Ad esempio, rms(x,"all") restituisce il valore RMS di tutti gli elementi nell'array di input x.

R2022a: Calcolo dell'RMS lungo più dimensioni

Ora è possibile calcolare il valore RMS lungo più dimensioni specificando un vettore di numeri interi positivi. Utilizzare l'argomento di input vecdim per specificare le dimensioni. Ad esempio, rms(x,[1 2]) opera lungo la prima e la seconda dimensione di x.

R2022a: Inclusione o omissione dei valori NaN

Ora è possibile includere o omettere i valori NaN nel calcolo dell'RMS. Specificare "includenan" per includere i valori NaN, ottenendo come risultato NaN. Specificare "omitnan" per ignorare tutti i valori NaN nell'input. Ad esempio, rms(x,"includenan") include i valori NaN quando si calcolano i valori RMS, ottenendo come risultato NaN.

R2022a: Spostato su MATLAB da Signal Processing Toolbox

In precedenza, rms richiedeva Signal Processing Toolbox™.

Vedi anche

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