matplotlib.pyplot.plot #

matplotlib.pyplot. plot ( * args , scalex = True , scaley = True , data = None , ** kwargs ) [source] #

Tracez y par rapport à x sous forme de lignes et/ou de marqueurs.

Signatures d'appel :

plot([x], y, [fmt], *, data=None, **kwargs)
plot([x], y, [fmt], [x2], y2, [fmt2], ..., **kwargs)

Les coordonnées des points ou nœuds de ligne sont données par x , y .

Le paramètre facultatif fmt est un moyen pratique de définir le formatage de base comme la couleur, le marqueur et le style de ligne. Il s'agit d'une notation de chaîne de raccourci décrite dans la section Notes ci-dessous.

>>> plot(x, y)        # plot x and y using default line style and color
>>> plot(x, y, 'bo')  # plot x and y using blue circle markers
>>> plot(y)           # plot y using x as index array 0..N-1
>>> plot(y, 'r+')     # ditto, but with red plusses

Vous pouvez utiliser des Line2Dpropriétés comme arguments de mot clé pour plus de contrôle sur l'apparence. Les propriétés de ligne et fmt peuvent être mélangées. Les deux appels suivants donnent des résultats identiques :

>>> plot(x, y, 'go--', linewidth=2, markersize=12)
>>> plot(x, y, color='green', marker='o', linestyle='dashed',
...      linewidth=2, markersize=12)

En cas de conflit avec fmt , les arguments de mot clé sont prioritaires.

Tracer des données étiquetées

Il existe un moyen pratique de tracer des objets avec des données étiquetées (c'est-à-dire des données accessibles par index obj['y']). Au lieu de donner les données dans x et y , vous pouvez fournir l'objet dans le paramètre data et donner simplement les étiquettes pour x et y :

>>> plot('xlabel', 'ylabel', data=obj)

Tous les objets indexables sont pris en charge. Cela pourrait être par exemple un dict, un pandas.DataFrameou un tableau numpy structuré.

Tracer plusieurs ensembles de données

Il existe différentes manières de tracer plusieurs ensembles de données.

Le moyen le plus simple consiste simplement à appeler plotplusieurs fois. Exemple:
```
>>> plot(x1, y1, 'bo')
>>> plot(x2, y2, 'go')
```
Si x et/ou y sont des tableaux 2D, un ensemble de données séparé sera dessiné pour chaque colonne. Si x et y sont 2D, ils doivent avoir la même forme. Si un seul d'entre eux est 2D de forme (N, m), l'autre doit avoir une longueur N et sera utilisé pour chaque ensemble de données m.

Exemple:
```
>>> x = [1, 2, 3]
>>> y = np.array([[1, 2], [3, 4], [5, 6]])
>>> plot(x, y)
```
est équivalent à:
```
>>> for col in range(y.shape[1]):
...     plot(x, y[:, col])
```
La troisième méthode consiste à spécifier plusieurs ensembles de groupes [x] , y , [fmt] :
```
>>> plot(x1, y1, 'g^', x2, y2, 'g-')
```
Dans ce cas, tout argument de mot-clé supplémentaire s'applique à tous les ensembles de données. De plus, cette syntaxe ne peut pas être combinée avec le paramètre data .

Par défaut, chaque ligne se voit attribuer un style différent spécifié par un 'cycle de style'. Les paramètres de propriété fmt et line ne sont nécessaires que si vous souhaitez des écarts explicites par rapport à ces valeurs par défaut. Vous pouvez également modifier le cycle de style à l'aide de rcParams["axes.prop_cycle"](par défaut : ).cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])

Paramètres :

x, y type tableau ou scalaire

Les coordonnées horizontales/verticales des points de données. Les valeurs xrange(len(y)) sont facultatives et par défaut à .

Généralement, ces paramètres sont des tableaux 1D.

Ils peuvent également être scalaires ou bidimensionnels (dans ce cas, les colonnes représentent des ensembles de données distincts).

Ces arguments ne peuvent pas être passés en tant que mots-clés.

fmt str, facultatif

Une chaîne de format, par exemple 'ro' pour les cercles rouges. Voir la section Remarques pour une description complète des chaînes de format.

Les chaînes de format ne sont qu'une abréviation pour définir rapidement les propriétés de ligne de base. Tous ces éléments et bien d'autres peuvent également être contrôlés par des arguments de mots clés.

Cet argument ne peut pas être passé comme mot-clé.

objet de données indexable, facultatif

Un objet avec des données étiquetées. S'ils sont fournis, indiquez les noms des étiquettes à tracer en x et y .

Noter

Techniquement, il y a une légère ambiguïté dans les appels où la deuxième étiquette est un fmt valide . pourrait être ou . Dans de tels cas, la première interprétation est choisie, mais un avertissement est émis. Vous pouvez supprimer l'avertissement en ajoutant une chaîne de format vide .plot('n', 'o', data=obj)plt(x, y)plt(y, fmt)plot('n', 'o', '', data=obj)

Retours :

liste deLine2D: Une liste de lignes représentant les données tracées.

Autres paramètres :

scalex, scaley bool, par défaut : True

Ces paramètres déterminent si les limites de la vue sont adaptées aux limites des données. Les valeurs sont transmises à autoscale_view.

**propriétés kwargs Line2D, facultatives

kwargs sont utilisés pour spécifier des propriétés comme une étiquette de ligne (pour les légendes automatiques), une largeur de ligne, un anticrénelage, une couleur de face de marqueur. Exemple:

>>> plot([1, 2, 3], [1, 2, 3], 'go-', label='line 1', linewidth=2)
>>> plot([1, 2, 3], [1, 4, 9], 'rs', label='line 2')

Si vous spécifiez plusieurs lignes avec un seul appel de tracé, les kwargs s'appliquent à toutes ces lignes. Dans le cas où l'objet d'étiquette est itérable, chaque élément est utilisé comme étiquettes pour chaque ensemble de données.

Voici une liste des Line2Dpropriétés disponibles :

Propriété	La description
`agg_filter`	une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image
`alpha`	scalaire ou Aucun
`animated`	bourdonner
`antialiased`ou aa	bourdonner
`clip_box`	`Bbox`
`clip_on`	bourdonner
`clip_path`	Patch ou (chemin, transformation) ou aucun
`color`ou c	Couleur
`dash_capstyle`	`CapStyle`ou {'bout', 'en saillie', 'rond'}
`dash_joinstyle`	`JoinStyle`ou {'onglet', 'rond', 'biseau'}
`dashes`	séquence de flottants (on/off encre en points) ou (Aucun, Aucun)
`data`	(2, N) tableau ou deux tableaux 1D
`drawstyle`ou dès	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, par défaut : 'default'
`figure`	`Figure`
`fillstyle`	{'plein', 'gauche', 'droite', 'bas', 'haut', 'aucun'}
`gapcolor`	couleur ou Aucun
`gid`	chaîne
`in_layout`	bourdonner
`label`	objet
`linestyle`ou ls	{'-', '--', '-.', ':', '', (décalage, on-off-seq), ...}
`linewidth`ou lw	flotteur
`marker`	chaîne de style marqueur, `Path`ou`MarkerStyle`
`markeredgecolor`ou mec	Couleur
`markeredgewidth`ou miauler	flotteur
`markerfacecolor`ou mfc	Couleur
`markerfacecoloralt`ou mfcalt	Couleur
`markersize`ou ms	flotteur
`markevery`	None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
`mouseover`	bourdonner
`path_effects`	`AbstractPathEffect`
`picker`	float ou callable[[Artist, Event], tuple[bool, dict]]
`pickradius`	inconnue
`rasterized`	bourdonner
`sketch_params`	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
`snap`	booléen ou Aucun
`solid_capstyle`	`CapStyle`ou {'bout', 'en saillie', 'rond'}
`solid_joinstyle`	`JoinStyle`ou {'onglet', 'rond', 'biseau'}
`transform`	inconnue
`url`	chaîne
`visible`	bourdonner
`xdata`	Tableau 1D
`ydata`	Tableau 1D
`zorder`	flotteur

Voir également

scatter: Nuage de points XY avec des marqueurs de taille et/ou de couleur variables (parfois aussi appelé graphique à bulles).

Remarques

Formater les chaînes

Une chaîne de format se compose d'une partie pour la couleur, le marqueur et la ligne :

fmt = '[marker][line][color]'

Chacun d'eux est facultatif. Si elle n'est pas fournie, la valeur du cycle de style est utilisée. Exception : Si lineest donné, mais non marker, les données seront une ligne sans marqueurs.

D'autres combinaisons telles que [color][marker][line]sont également prises en charge, mais notez que leur analyse peut être ambiguë.

Marqueurs

personnage	la description
`'.'`	marqueur de points
`','`	marqueur de pixels
`'o'`	marqueur de cercle
`'v'`	marqueur triangle_down
`'^'`	marqueur triangle_up
`'<'`	marqueur triangle_left
`'>'`	marqueur triangle_droit
`'1'`	marqueur tri_down
`'2'`	marqueur tri_up
`'3'`	marqueur tri_left
`'4'`	marqueur tri_right
`'8'`	marqueur octogone
`'s'`	marqueur carré
`'p'`	marqueur pentagone
`'P'`	plus marqueur (rempli)
`'*'`	marqueur étoile
`'h'`	marqueur hexagone1
`'H'`	marqueur hexagone2
`'+'`	plus marqueur
`'x'`	x marqueur
`'X'`	x (rempli) marqueur
`'D'`	marqueur de diamant
`'d'`	marqueur thin_diamond
`'\|'`	marqueur vline
`'_'`	marqueur hline

Styles de ligne

personnage	la description
`'-'`	style de ligne solide
`'--'`	style de ligne pointillée
`'-.'`	style de ligne tiret-point
`':'`	style de ligne pointillée

Exemples de chaînes de format :

'b'    # blue markers with default shape
'or'   # red circles
'-g'   # green solid line
'--'   # dashed line with default color
'^k:'  # black triangle_up markers connected by a dotted line

Couleurs

Les abréviations de couleur prises en charge sont les codes à une seule lettre

personnage	Couleur
`'b'`	bleu
`'g'`	vert
`'r'`	rouge
`'c'`	cyan
`'m'`	magenta
`'y'`	jaune
`'k'`	le noir
`'w'`	blanche

et les 'CN'couleurs indexées dans le cycle de propriétés par défaut.

Si la couleur est la seule partie de la chaîne de format, vous pouvez également utiliser n'importe quelle matplotlib.colorsspécification, par exemple des noms complets ( 'green') ou des chaînes hexadécimales ( '#008000').

Exemples utilisant `matplotlib.pyplot.plot`#

Tracé des valeurs masquées et NaN

Dispersion masquée

Démo d'escaliers

Démo étape

Sous-classes de figures personnalisées

Gestion de plusieurs chiffres dans pyplot

Axe partagé

Plusieurs sous-parcelles

Contrôle du style du texte et des étiquettes à l'aide d'un dictionnaire

Positionnement du titre

Lignes infinies

chaîne de format plot()

Pyplot Mathtext

Pyplot simple

Pyplot Trois

Pyplot Deux sous-parcelles

dauphins

Feuille de style Solarized Light

Saisie de cadre

Rapport de coordonnées

Personnaliser RC

Démo Findobj

PDF multipage

Sortie standard d'impression

Définir et obtenir des propriétés

transforme.offset_copy

Démo Zorder

Échelle personnalisée

Placer des graduations de date à l'aide de règles de récurrence

Rotation des étiquettes de tiques personnalisées

Gestionnaire d'outils

Tutoriel Pyplot

Personnalisation de Matplotlib avec des feuilles de style et rcParams

Guide de démarrage rapide

Guide des effets de chemin

matplotlib.pyplot.plot #

Exemples utilisant matplotlib.pyplot.plot#

Exemples utilisant `matplotlib.pyplot.plot`#