matplotlib.pyplot.xcorr #

matplotlib.pyplot. xcorr ( x , y , normed =True , detrend=<function detrend_none> , usevlines=True , maxlags=10 , * , data=None , **kwargs ) [source] #

Tracez la corrélation croisée entre x et y .

La corrélation avec le retard k est définie comme \(\sum_n x[n+k] \cdot y^*[n]\), où\(y^*\)est le conjugué complexe de\(y\).

Paramètres :
x, y en forme de tableau de longueur n
detrend appelable, par défaut : mlab.detrend_none(pas de suppression de tendance)

Une fonction de suppression de tendance appliquée à x et y . Il doit porter la signature

detrend(x: np.ndarray) -> np.ndarray
booléen normé , par défaut : True

Si True, les vecteurs d'entrée sont normalisés à l'unité de longueur.

usevlines booléen , par défaut : True

Détermine le style de tracé.

Si True, les lignes verticales sont tracées de 0 à la valeur xcorr en utilisant Axes.vlines. De plus, une ligne horizontale est tracée à y=0 en utilisant Axes.axhline.

Si False, les marqueurs sont tracés aux valeurs xcorr à l'aide de Axes.plot.

maxlags entier , par défaut : 10

Nombre de décalages à afficher. Si aucun, renverra tous les retards.2 * len(x) - 1

Retours :
tableau des décalages (longueur 2*maxlags+1)

Le vecteur de décalage.

tableau c (longueur 2*maxlags+1)

Le vecteur de corrélation automatique.

ligne LineCollectionouLine2D

Artistajouté aux Axes de la corrélation :

b Line2Dou Aucun

Ligne horizontale à 0 si usevlines vaut True Aucune usevlines vaut False.

Autres paramètres :
propriété de style de ligne Line2D, facultative

Le style de ligne pour tracer les points de données. Utilisé uniquement si usevlines est False.

marqueur str, par défaut : 'o'

Le marqueur pour tracer les points de données. Utilisé uniquement si usevlines est False.

objet de données indexable, facultatif

S'ils sont fournis, les paramètres suivants acceptent également une chaîne s, qui est interprétée comme data[s](sauf si cela déclenche une exception) :

x , y

**kwargs

Des paramètres supplémentaires sont passés à Axes.vlineset Axes.axhlinesi usevlines est True; sinon, ils sont transmis à Axes.plot.

Remarques

La corrélation croisée est effectuée avec numpy.correlateavec .mode = "full"