matplotlib.axes.Axes.scatter #

Haches. scatter ( x , y , s = Aucun , c = Aucun , marker = Aucun , cmap = Aucun , norm = Aucun , vmin = Aucun , vmax = Aucun , alpha = Aucun , linewidths = Aucun , * , edgecolors = Aucun , plotnonfinite = Faux ,data = Aucun , ** kwargs ) [source] #

Un nuage de points de y par rapport à x avec une taille et/ou une couleur de marqueur variable.

Paramètres :

x, y flottant ou semblable à un tableau, forme (n, )

Les positions des données.

s flottant ou semblable à un tableau, forme (n, ), facultatif

La taille du marqueur en points**2. La valeur par défaut est .rcParams['lines.markersize'] ** 2

c type tableau ou liste de couleurs ou couleur, facultatif

Les couleurs des marqueurs. Valeurs possibles:

Un scalaire ou une séquence de n nombres à mapper sur des couleurs à l'aide de cmap et norm .
Un tableau 2D dans lequel les lignes sont RVB ou RVBA.
Une séquence de couleurs de longueur n.
Une chaîne de format de couleur unique.

Notez que c ne doit pas être une seule séquence numérique RVB ou RVBA car il est impossible de la distinguer d'un tableau de valeurs à mapper en couleurs. Si vous souhaitez spécifier la même valeur RVB ou RVBA pour tous les points, utilisez un tableau 2D avec une seule ligne. Sinon, la correspondance de valeur aura priorité en cas de correspondance de taille avec x et y .

Si vous souhaitez spécifier une seule couleur pour tous les points, préférez l' argument du mot clé de couleur .

La valeur par défaut est None. Dans ce cas, la couleur du marqueur est déterminée par la valeur de color , facecolor ou facecolors . Dans le cas où ceux-ci ne sont pas spécifiés ou None, la couleur du marqueur est déterminée par la couleur suivante du Axescycle de couleurs "forme et remplissage" actuel. Ce cycle est par rcParams["axes.prop_cycle"]défaut (par défaut : ).cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])

marqueur MarkerStyle, par défaut : rcParams["scatter.marker"](par défaut : 'o')

Le style marqueur. marker peut être soit une instance de la classe, soit le raccourci textuel d'un marqueur particulier. Voir matplotlib.markerspour plus d'informations sur les styles de marqueur.

cmap str ou Colormap, par défaut : rcParams["image.cmap"](par défaut : 'viridis')

L'instance Colormap ou le nom de la palette de couleurs enregistrée utilisée pour mapper les données scalaires aux couleurs.

Ce paramètre est ignoré si c est RGB(A).

norm str ou Normalize, facultatif

La méthode de normalisation utilisée pour mettre à l'échelle les données scalaires dans la plage [0, 1] avant le mappage aux couleurs à l'aide de cmap . Par défaut, une mise à l'échelle linéaire est utilisée, mappant la valeur la plus basse à 0 et la plus élevée à 1.

S'il est donné, il peut s'agir de l'un des éléments suivants :

Une instance de Normalizeou une de ses sous-classes (voir Colormap Normalization ).
Un nom d'échelle, c'est-à-dire "linéaire", "log", "symlog", "logit", etc. Pour une liste des échelles disponibles, appelez matplotlib.scale.get_scale_names(). Dans ce cas, une sous-classe appropriée Normalizeest générée et instanciée dynamiquement.

Ce paramètre est ignoré si c est RGB(A).

vmin, flotteur vmax, facultatif

Lorsque vous utilisez des données scalaires et aucune norme explicite , vmin et vmax définissent la plage de données couverte par la palette de couleurs. Par défaut, la palette de couleurs couvre toute la plage de valeurs des données fournies. C'est une erreur d'utiliser vmin / vmax lorsqu'une instance de norme est donnée (mais l'utilisation d'un nom de norme avec vmin / vmax est acceptable).str

Ce paramètre est ignoré si c est RGB(A).

flottant alpha , par défaut : aucun

La valeur de fusion alpha, entre 0 (transparent) et 1 (opaque).

largeurs de ligne flottantes ou de type tableau, par défaut : rcParams["lines.linewidth"](par défaut : 1.5)

L'épaisseur de ligne des bords du marqueur. Remarque : La couleur de bord par défaut est 'face'. Vous voudrez peut-être aussi changer cela.

edgecolors {'face', 'none', None } ou couleur ou séquence de couleur, par défaut : rcParams["scatter.edgecolors"](par défaut : 'face')

La couleur de bord du marqueur. Valeurs possibles:

'face' : la couleur du bord sera toujours la même que la couleur de la face.
'aucun' : aucune limite de patch ne sera dessinée.
Une couleur ou une séquence de couleurs.

Pour les marqueurs non remplis, edgecolors est ignoré. Au lieu de cela, la couleur est déterminée comme avec 'face', c'est-à-dire à partir de c , colors ou facecolors .

plotnonfinite bool, par défaut : False

S'il faut tracer des points avec c non fini (c'est-à-dire inf, -inf ou nan). Si Trueles points sont dessinés avec la mauvaise couleur de palette de couleurs (voir Colormap.set_bad).

Retours :

PathCollection

Autres paramètres :

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 , s , largeurs de ligne , couleurs de bord , c , couleur de face , couleurs de face , couleur

** propriétés kwargsCollection

Voir également

plot: Pour tracer des nuages de points lorsque les marqueurs sont de taille et de couleur identiques.

Remarques

La plotfonction sera plus rapide pour les nuages de points où les marqueurs ne varient pas en taille ou en couleur.
Tout ou partie de x , y , s et c peuvent être des tableaux masqués, auquel cas tous les masques seront combinés et seuls les points non masqués seront tracés.
Fondamentalement, la dispersion fonctionne avec des tableaux 1D ; x , y , s et c peuvent être entrés sous forme de tableaux ND, mais dans la dispersion, ils seront aplatis. L'exception est c , qui ne sera aplatie que si sa taille correspond à la taille de x et y .