matplotlib.pyplot.tricontourf

matplotlib.pyplot. tricontourf ( * args , ** kwargs )

Dessinez des régions de contour sur une grille triangulaire non structurée.

Signatures d'appel :

tricontourf(triangulation, Z, [levels], ...)
tricontourf(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)

La grille triangulaire peut être spécifiée soit en passant un Triangulation objet comme premier paramètre, soit en passant les points x , y et éventuellement les triangles et un masque . Voir Triangulationpour une explication de ces paramètres. Si ni la triangulation ni les triangles ne sont donnés, la triangulation est calculée à la volée.

Il est possible de passer des triangles en position, c'est-à-dire . Cependant, cela est déconseillé. Pour plus de clarté, passez des triangles via un argument de mot-clé.tricontourf(x, y, triangles, Z, ...)

Paramètres :

triangulation Triangulation, facultatif

Une grille triangulaire déjà créée.

x, y, triangles, masque

Paramètres définissant la grille triangulaire. Voir Triangulation. Ceci est mutuellement exclusif avec la spécification de la triangulation .

Type de tableau Z

Les valeurs de hauteur sur lesquelles le contour est dessiné. Le mappage des couleurs est contrôlé par cmap , norm , vmin et vmax .

niveaux int ou de type tableau, facultatif

Détermine le nombre et les positions des lignes de contour/régions.

S'il s'agit d'un int n , utilisez MaxNLocator, qui essaie de choisir automatiquement pas plus de n+1 niveaux de contour "agréables" entre vmin et vmax .

S'il s'agit d'un tableau, dessinez des lignes de contour aux niveaux spécifiés. Les valeurs doivent être dans l'ordre croissant.

Retours :

TriContourSet

Autres paramètres :

couleurs chaîne de couleurs ou séquence de couleurs, facultatif

Les couleurs des niveaux, c'est-à-dire les régions de contour.

La séquence est cyclée pour les niveaux dans l'ordre croissant. Si la séquence est plus courte que le nombre de niveaux, elle est répétée.

Comme raccourci, des chaînes de couleur unique peuvent être utilisées à la place des listes à un élément, c'est-à-dire 'red'au lieu de ['red']colorer tous les niveaux avec la même couleur. Ce raccourci ne fonctionne que pour les chaînes de couleur, pas pour les autres façons de spécifier les couleurs.

Par défaut (valeur None ), la palette de couleurs spécifiée par cmap sera utilisée.

flottant alpha , par défaut : 1

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

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 les couleurs sont définies.

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 les couleurs sont définies.

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

Si vmin ou vmax ne sont pas donnés, la mise à l'échelle des couleurs par défaut est basée sur les niveaux .

Ce paramètre est ignoré si les couleurs sont définies.

origin { Aucun , 'supérieur', 'inférieur', 'image'}, par défaut : Aucun

Détermine l'orientation et la position exacte de Z en spécifiant la position de . Ceci n'est pertinent que si X , Y ne sont pas donnés.Z[0, 0]

• Aucun : est à X=0, Y=0 dans le coin inférieur gauche.Z[0, 0]

• 'inférieur' : est à X=0.5, Y=0.5 dans le coin inférieur gauche.Z[0, 0]

• 'supérieur' : est à X=N+0,5, Y=0,5 dans le coin supérieur gauche.Z[0, 0]

• 'image' : utilise la valeur de rcParams["image.origin"](par défaut : 'upper').

étendue (x0, x1, y0, y1), facultatif

Si origin n'est pas None , alors extent est interprété comme in imshow: il donne les limites extérieures des pixels. Dans ce cas, la position de Z[0, 0] est le centre du pixel, pas un coin. Si origin vaut None , alors ( x0 , y0 ) est la position de Z[0, 0] et ( x1 , y1 ) est la position de Z[-1, -1].

Cet argument est ignoré si X et Y sont spécifiés dans l'appel à contour.

ticker de localisateur.Sous -classe de localisateur, facultatif

Le localisateur est utilisé pour déterminer les niveaux de contour s'ils ne sont pas donnés explicitement via les niveaux . La valeur par défaut est MaxNLocator.

étendre {'aucun', 'les deux', 'min', 'max'}, par défaut : 'aucun'

Détermine la tricontourfcoloration des valeurs qui sont en dehors de la plage des niveaux .

Si 'ni', les valeurs en dehors de la plage de niveaux ne sont pas colorées. Si 'min', 'max' ou 'les deux', colore les valeurs en dessous, au dessus ou en dessous et au dessus de la plage des niveaux .

Les valeurs inférieures min(levels)et supérieures max(levels)sont mappées sur les valeurs inférieures/ supérieures de Colormap. Notez que la plupart des palettes de couleurs n'ont pas de couleurs dédiées pour celles-ci par défaut, de sorte que les valeurs supérieures et inférieures sont les valeurs de bord de la palette de couleurs. Vous pouvez définir ces valeurs explicitement à l'aide de Colormap.set_underet Colormap.set_over.

Noter

Un existant TriContourSetn'est pas averti si les propriétés de sa palette de couleurs sont modifiées. Par conséquent, un appel explicite à ContourSet.changed()est nécessaire après avoir modifié la palette de couleurs. L'appel explicite peut être omis, si une barre de couleurs est assignée à TriContourSetparce qu'elle appelle en interne ContourSet.changed().

xunits, yunits unités enregistrées, facultatif

Remplacez les unités d'axe en spécifiant une instance d'un fichier matplotlib.units.ConversionInterface.

booléen anticrénelé , facultatif

Activez l'anticrénelage, en remplaçant les valeurs par défaut. Pour les contours remplis, la valeur par défaut est True . Pour les contours linéaires, il est extrait de rcParams["lines.antialiased"](par défaut : True).

liste de hachures [str], facultatif

Une liste de motifs de hachures croisées à utiliser sur les zones remplies. Si Aucun, aucune hachure ne sera ajoutée au contour. Le hachurage est pris en charge uniquement dans les backends PostScript, PDF, SVG et Agg.

Remarques

tricontourfremplit les intervalles fermés en haut ; c'est-à-dire que pour les frontières z1 et z2 , la région remplie est :

z1 < Z <= z2

sauf pour l'intervalle le plus bas, qui est fermé des deux côtés (c'est-à-dire qu'il inclut la valeur la plus basse).