findpeaks
localiser les maxima locaux (pics) dans un signal 1-D.
📝Syntaxe
[pks, locs, widths, prominences] = findpeaks(Y)
[pks, locs, widths, prominences] = findpeaks(Y, Fs, ...)
[pks, locs, widths, prominences] = findpeaks(Y, X, ...)
📥Arguments d'entrée
Paramètre Description
Y vecteur : signal d'entrée (ligne ou colonne)
Fs scalaire : fréquence d'échantillonnage (optionnel). Si fourni, les emplacements des pics sont retournés en unités de temps.
X vecteur : valeurs x correspondant à Y (optionnel). Doit avoir la même longueur que Y.
Nom/Valeur paires options nom/valeur :
  • MinPeakHeight: scalaire numérique, défaut -Inf
  • MinPeakProminence: scalaire numérique >= 0, défaut 0
  • Threshold: scalaire numérique >= 0 (distance verticale minimale par rapport à la ligne de base voisine), défaut 0
  • MinPeakWidth: scalaire numérique >= 0, défaut 0
  • MaxPeakWidth: scalaire numérique >= 0, défaut Inf
  • MinPeakDistance: scalaire numérique >= 0 (dans les mêmes unités que X), défaut 0
  • WidthReference: 'halfprom' (par défaut) ou 'halfheight'
  • SortStr: 'none' (par défaut), 'ascend' ou 'descend'
  • NPeaks: entier positif, nombre maximum de pics à retourner (par défaut Inf)
  • Annotate: 'peaks' (par défaut) ou 'extents' (contrôle l'annotation du tracé)
📤Arguments de sortie
Paramètre Description
pks amplitudes des pics
locs emplacements des pics (valeurs x ou indices)
widths largeurs des pics mesurées à la référence de largeur spécifiée
prominences prominence de chaque pic
📄Description

findpeaks localise les maxima locaux (pics) dans un signal unidimensionnel Y.

L'algorithme détecte les pics candidats, les filtre par hauteur et seuil, calcule la prominence et les largeurs, impose une séparation minimale, et retourne les sorties demandées.

Lorsqu'aucune sortie n'est demandée, la fonction trace le signal et marque les pics détectés.

💡Exemples
Trouver des pics dans un signal simple
t = 0:0.01:2*pi;
y = sin(5*t) + 0.2*randn(size(t));
findpeaks(y, t, 'MinPeakProminence', 0.3);
Retourner les largeurs et les prominences
[pks, locs, widths, proms] = findpeaks(y, 'MinPeakHeight', 0);
🔗Voir aussi
max
🕔Historique des versions
Version Description
1.15.0 initial version
Modifier cette page sur GitHub