matplotlib.axes.Axes.psd

Assi. psd ( x , NFFT = Nessuno , Fs = Nessuno , Fc = Nessuno , detrend = Nessuno , window = Nessuno , noverlap = Nessuno , pad_to = Nessuno , lati = Nessuno , scale_by_freq = Nessuno , return_line = Nessuno , * , data = Nessuno , ** kwargs)

Tracciare la densità spettrale di potenza.

La densità spettrale di potenza\(P_{xx}\)con il metodo del periodogramma medio di Welch. Il vettore x è diviso in segmenti di lunghezza NFFT . Ogni segmento è detrend dalla funzione detrend e finestrato dalla funzione window . noverlap fornisce la lunghezza della sovrapposizione tra i segmenti. Il\(|\mathrm{fft}(i)|^2\) di ogni segmento\(i\)sono mediati per il calcolo\(P_{xx}\), con un ridimensionamento per correggere la perdita di potenza dovuta al windowing.

Se len( x ) < NFFT , verrà aggiunto zero a NFFT .

Parametri :

x Array o sequenza 1-D

Matrice o sequenza contenente i dati

Fs float, predefinito: 2

La frequenza di campionamento (campioni per unità di tempo). Viene utilizzato per calcolare le frequenze di Fourier, freqs , in cicli per unità di tempo.

finestra chiamabile o ndarray, default:window_hanning

Una funzione o un vettore di lunghezza NFFT . Per creare vettori finestra vedere window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window, ecc. Se una funzione viene passata come argomento, deve prendere un segmento di dati come argomento e restituire la versione con finestra del segmento.

lati {'default', 'onesided', 'twosided'}, facoltativo

Quali lati dello spettro tornare. 'default' è unilaterale per i dati reali e bilaterale per i dati complessi. "unilaterale" forza il ritorno di uno spettro unilaterale, mentre "twosided" forza bilaterale.

pad_to int, facoltativo

Il numero di punti in cui viene riempito il segmento di dati durante l'esecuzione della FFT. Questo può essere diverso da NFFT , che specifica il numero di punti dati utilizzati. Pur non aumentando la risoluzione effettiva dello spettro (la distanza minima tra i picchi risolvibili), ciò può fornire più punti nel grafico, consentendo maggiori dettagli. Questo corrisponde al parametro nfft nella chiamata a . L'impostazione predefinita è None, che imposta pad_to uguale a NFFT

NFFT int, predefinito: 256

Il numero di punti dati utilizzati in ogni blocco per la FFT. Una potenza 2 è più efficiente. Questo NON dovrebbe essere usato per ottenere zero padding, o il ridimensionamento del risultato non sarà corretto; usa invece pad_to per questo.

detrend {'none', 'mean', 'linear'} o richiamabile, default: 'none'

La funzione applicata a ciascun segmento prima di fft-ing, progettata per rimuovere la tendenza media o lineare. A differenza di MATLAB, dove il parametro detrend è un vettore, in Matplotlib è una funzione. Il mlab modulo definisce detrend_none, detrend_meane detrend_linear, ma puoi anche utilizzare una funzione personalizzata. Puoi anche usare una stringa per scegliere una delle funzioni: 'none' calls detrend_none. chiamate "cattive" detrend_mean. chiamate 'lineari' detrend_linear.

scale_by_freq bool, predefinito: vero

Indica se i valori di densità risultanti devono essere ridimensionati in base alla frequenza di ridimensionamento, che fornisce la densità in unità di 1/Hz. Ciò consente l'integrazione sui valori di frequenza restituiti. Il valore predefinito è True per la compatibilità MATLAB.

noverlap int, predefinito: 0 (nessuna sovrapposizione)

Il numero di punti di sovrapposizione tra i segmenti.

Fc int, predefinito: 0

La frequenza centrale di x , che compensa le estensioni x del grafico per riflettere l'intervallo di frequenza utilizzato quando un segnale viene acquisito e quindi filtrato e sottoposto a downsampling in banda base.

return_line bool, predefinito: falso

Se includere l'oggetto linea tracciato nei valori restituiti.

Resi :

Matrice Pxx 1-D

I valori per lo spettro di potenza\(P_{xx}\)prima del ridimensionamento (valore reale).

freqs matrice 1-D

Le frequenze corrispondenti agli elementi in Pxx .

lineaLine2D

La linea creata da questa funzione. Restituito solo se return_line è True.

Altri parametri :

oggetto indicizzabile dei dati , facoltativo

Se forniti, i seguenti parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione):

X

**kwargs

Gli argomenti delle parole chiave controllano le Line2Dproprietà:

Proprietà	Descrizione
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	scalare o Nessuno
animated	bool
antialiasedo aa	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
coloro c	colore
dash_capstyle	CapStyleo {'culo', 'sporgente', 'rotondo'}
dash_joinstyle	JoinStyleo {'mitre', 'round', 'bevel'}
dashes	sequenza di float (on/off inchiostro in punti) o (Nessuno, Nessuno)
data	(2, N) o due array 1D
drawstyleo ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
figure	Figure
fillstyle	{'completo', 'sinistra', 'destra', 'basso', 'alto', 'nessuno'}
gapcolor	colore o Nessuno
gid	str
in_layout	bool
label	oggetto
linestyleo ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidtho lw	galleggiante
marker	stringa di stile marcatore, PathoMarkerStyle
markeredgecoloro mecc	colore
markeredgewidtho miagolare	galleggiante
markerfacecoloro mfc	colore
markerfacecoloralto mfcalt	colore
markersizeo ms	galleggiante
markevery	Nessuno o int o (int, int) o slice o lista[int] o float o (float, float) o lista[bool]
mouseover	bool
path_effects	AbstractPathEffect
picker	float o callable[[Artista, Evento], tuple[bool, dict]]
pickradius	sconosciuto
rasterized	bool
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
solid_capstyle	CapStyleo {'culo', 'sporgente', 'rotondo'}
solid_joinstyle	JoinStyleo {'mitre', 'round', 'bevel'}
transform	sconosciuto
url	str
visible	bool
xdata	matrice 1D
ydata	matrice 1D
zorder	galleggiante

Guarda anche

specgram

Differisce nella sovrapposizione predefinita; nel non restituire la media dei periodogrammi del segmento; nel restituire i tempi dei segmenti; e nel tracciare una mappa dei colori invece di una linea.

magnitude_spectrum

Traccia lo spettro delle magnitudini.

csd

Traccia la densità spettrale tra due segnali.

Appunti

Per tracciare, la potenza viene tracciata come \(10\log_{10}(P_{xx})\)per i decibel, sebbene venga restituito lo stesso Pxx .

Riferimenti

Bendat & Piersol - Dati casuali: procedure di analisi e misurazione, John Wiley & Sons (1986)

Esempi che utilizzano matplotlib.axes.Axes.psd

Dimostrazione PSD

Dimostrazione PSD