matplotlib.axes.Axes.csd #
- Assi. csd ( x , y , 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 ) [fonte] #
Tracciare la densità cross-spettrale.
La densità spettrale incrociata\(P_{xy}\)con il metodo del periodogramma medio di Welch. I vettori x e y sono divisi 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 prodotto delle FFT dirette di x e y viene calcolato in media su ogni segmento da calcolare\(P_{xy}\), con un ridimensionamento per correggere la perdita di potenza dovuta al windowing.
Se len( x ) < NFFT o len( y ) < NFFT , verranno riempiti con zero in NFFT .
- Parametri :
- x, y matrici o sequenze 1-D
Array o sequenze contenenti 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 n
fft
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 definiscedetrend_none
,detrend_mean
edetrend_linear
, ma puoi anche utilizzare una funzione personalizzata. Puoi anche usare una stringa per scegliere una delle funzioni: 'none' callsdetrend_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 Pxy 1-D
I valori per lo spettro incrociato\(P_{xy}\)prima del ridimensionamento (valore complesso).
- freqs matrice 1-D
Le frequenze corrispondenti agli elementi in Pxy .
- linea
Line2D
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 comedata[s]
(a meno che ciò non sollevi un'eccezione):x , y
- **kwargs
Gli argomenti delle parole chiave controllano le
Line2D
proprietà:Proprietà
Descrizione
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
scalare o Nessuno
bool
antialiased
o aabool
bool
Patch o (Percorso, Trasforma) o Nessuno
color
o ccolore
CapStyle
o {'culo', 'sporgente', 'rotondo'}JoinStyle
o {'mitre', 'round', 'bevel'}sequenza di float (on/off inchiostro in punti) o (Nessuno, Nessuno)
(2, N) o due array 1D
drawstyle
o ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'completo', 'sinistra', 'destra', 'basso', 'alto', 'nessuno'}
colore o Nessuno
str
bool
oggetto
linestyle
o ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth
o lwgalleggiante
stringa di stile marcatore,
Path
oMarkerStyle
markeredgecolor
o mecccolore
markeredgewidth
o miagolaregalleggiante
markerfacecolor
o mfccolore
markerfacecoloralt
o mfcaltcolore
markersize
o msgalleggiante
Nessuno o int o (int, int) o slice o lista[int] o float o (float, float) o lista[bool]
bool
float o callable[[Artista, Evento], tuple[bool, dict]]
sconosciuto
bool
(scala: float, lunghezza: float, casualità: float)
bool o Nessuno
CapStyle
o {'culo', 'sporgente', 'rotondo'}JoinStyle
o {'mitre', 'round', 'bevel'}sconosciuto
str
bool
matrice 1D
matrice 1D
galleggiante
Guarda anche
psd
è equivalente all'impostazione .
y = x
Appunti
Per tracciare, la potenza viene tracciata come \(10 \log_{10}(P_{xy})\)per i decibel, però\(P_{xy}\)stesso viene restituito.
Riferimenti
Bendat & Piersol - Dati casuali: procedure di analisi e misurazione, John Wiley & Sons (1986)