matplotlib.contour#

Classes prenant en charge le traçage et l'étiquetage des contours pour la classe Axes.

classe matplotlib.contour. ClabelText ( x = 0 , y = 0 , text = '' , * , color = None , verticalalignment = 'baseline' , horizontalalignment = 'left' , multialignment = None , fontproperties = None , rotation = None , linespacing = None , rotation_mode = Aucun, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs ) [source] #

Socles :Text

Contrairement au texte ordinaire, get_rotation renvoie un angle mis à jour dans la coordonnée du pixel en supposant que la rotation d'entrée est un angle dans la coordonnée des données (ou quel que soit le jeu de transformation).

Créez une Textinstance à x , y avec une chaîne text .

Le texte est aligné par rapport au point d'ancrage ( x , y ) selon horizontalalignment(défaut : 'left') et verticalalignment (défaut : 'bottom'). Voir aussi Alignement du texte .

Bien que Text accepte l'argument de mot-clé 'label', par défaut, il n'est pas ajouté aux poignées d'une légende.

Les arguments de mots clés valides sont :

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

backgroundcolor

Couleur

bbox

dict avec des propriétés pourpatches.FancyBboxPatch

clip_box

inconnue

clip_on

inconnue

clip_path

inconnue

colorou c

Couleur

figure

Figure

fontfamilyou famille

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontpropertiesou police ou font_properties

font_manager.FontPropertiesou stroupathlib.Path

fontsizeou taille

flottant ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

fontstretchou étirer

{une valeur numérique dans la plage 0-1000, 'ultra-condensé', 'extra-condensé', 'condensé', 'semi-condensé', 'normal', 'semi-élargi', 'élargi', 'extra-élargi ', 'ultra-élargi'}

fontstyleou style

{'normal', 'italique', 'oblique'}

fontvariantou variante

{'normal', 'petites majuscules'}

fontweightou poids

{une valeur numérique dans la plage 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'gras', 'lourd', 'extra gras', 'noir'}

gid

chaîne

horizontalalignmentou ha

{'gauche', 'centre', 'droite'}

in_layout

bourdonner

label

objet

linespacing

flottant (multiple de la taille de la police)

math_fontfamily

chaîne

mouseover

bourdonner

multialignmentou maman

{'gauche', 'droite', 'centre'}

parse_math

bourdonner

path_effects

AbstractPathEffect

picker

Aucun ou bool ou flottant ou appelable

position

(flotter, flotter)

rasterized

bourdonner

rotation

flottant ou {'vertical', 'horizontal'}

rotation_mode

{Aucun, 'par défaut', 'ancre'}

sketch_params

(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)

snap

booléen ou Aucun

text

objet

transform

Transform

transform_rotates_text

bourdonner

url

chaîne

usetex

booléen ou Aucun

verticalalignmentou va

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

bourdonner

wrap

bourdonner

x

flotteur

y

flotteur

zorder

flotteur
obtenir_rotation ( ) [source] #

Renvoie l'angle du texte en degrés entre 0 et 360.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , backgroundcolor=<UNSET> , bbox =<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<UNSET>, alignementhorizontal=<NON DÉFINI>, in_layout=<UNSET> , label=<UNSET> , linespacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> , sélecteur =<UNSET> , position=<UNSET> , rasterized=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text=<UNSET> , transform=< UNSET> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> ) [source ] #

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

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

backgroundcolor

Couleur

bbox

dict avec des propriétés pourpatches.FancyBboxPatch

clip_box

Bbox

clip_on

bourdonner

clip_path

Patch ou (chemin, transformation) ou aucun

colorou c

Couleur

figure

Figure

fontfamilyou famille

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontpropertiesou police ou font_properties

font_manager.FontPropertiesou stroupathlib.Path

fontsizeou taille

flottant ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

fontstretchou étirer

{une valeur numérique dans la plage 0-1000, 'ultra-condensé', 'extra-condensé', 'condensé', 'semi-condensé', 'normal', 'semi-élargi', 'élargi', 'extra-élargi ', 'ultra-élargi'}

fontstyleou style

{'normal', 'italique', 'oblique'}

fontvariantou variante

{'normal', 'petites majuscules'}

fontweightou poids

{une valeur numérique dans la plage 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'gras', 'lourd', 'extra gras', 'noir'}

gid

chaîne

horizontalalignmentou ha

{'gauche', 'centre', 'droite'}

in_layout

bourdonner

label

objet

linespacing

flottant (multiple de la taille de la police)

math_fontfamily

chaîne

mouseover

bourdonner

multialignmentou maman

{'gauche', 'droite', 'centre'}

parse_math

bourdonner

path_effects

AbstractPathEffect

picker

Aucun ou bool ou flottant ou appelable

position

(flotter, flotter)

rasterized

bourdonner

rotation

flottant ou {'vertical', 'horizontal'}

rotation_mode

{Aucun, 'par défaut', 'ancre'}

sketch_params

(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)

snap

booléen ou Aucun

text

objet

transform

Transform

transform_rotates_text

bourdonner

url

chaîne

usetex

booléen ou Aucun

verticalalignmentou va

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

bourdonner

wrap

bourdonner

x

flotteur

y

flotteur

zorder

flotteur
classe matplotlib.contour. ContourLabeler [source] #

Socles :object

Mixin pour fournir une capacité d'étiquetage à ContourSet.

add_label ( x , y , rotation , lev , cvalue ) [source] #

Ajouter une étiquette de contour à l'aide Textde la classe.

add_label_clabeltext ( x , y , rotation , lev , cvalue ) [source] #

Ajouter une étiquette de contour à l'aide ClabelTextde la classe.

add_label_near ( x , y , inline = True , inline_spacing = 5 , transform = None ) [source] #

Ajoutez une étiquette près du point .(x, y)

Paramètres :
x, y flottant

L'emplacement approximatif de l'étiquette.

inline bool, par défaut : True

Si True , supprimez le segment du contour sous l'étiquette.

inline_spacing entier , par défaut : 5

Espace en pixels à laisser de chaque côté de l'étiquette lors de la mise en ligne. Cet espacement sera exact pour les étiquettes aux emplacements où le contour est droit, moins pour les étiquettes sur les contours courbes.

transformer Transformou False, par défaut :self.axes.transData

Une transformation appliquée avant l'étiquetage. La valeur par défaut est interprétée comme des coordonnées de données. est synonyme de ; c'est-à- dire qu'elles doivent être interprétées comme des coordonnées d'affichage.(x, y)(x, y)FalseIdentityTransform(x, y)

calc_label_rot_and_inline ( slc , ind , lw , lc = None , spacing = 5 ) [source] #

Calculez la rotation appropriée de l'étiquette en fonction des coordonnées de contour de ligne en unités d'écran, de l'indice de l'emplacement de l'étiquette et de la largeur de l'étiquette.

Si lc n'est pas None ou vide, cassez également les contours et calculez l'inlining.

spacing est l'espace vide à laisser autour de l'étiquette, en pixels.

Les deux tâches sont effectuées ensemble pour éviter de calculer les longueurs de trajet plusieurs fois, ce qui est relativement coûteux.

La méthode utilisée ici consiste à calculer la longueur du trajet le long du contour en coordonnées de pixels, puis à regarder approximativement (largeur d'étiquette / 2) loin du point central pour déterminer la rotation, puis à casser le contour si vous le souhaitez.

clabel ( levels = None , * , fontsize = None , inline = True , inline_spacing = 5 , fmt = None , colors = None , use_clabeltext = False , manual = False , rightside_up = True , zorder = None ) [source] #

Étiquetez un tracé de contour.

Ajoute des étiquettes aux contours de ligne dans this ContourSet(qui hérite de cette classe mixin).

Paramètres :
niveaux de type tableau, facultatif

Une liste de valeurs de niveau, qui doivent être étiquetées. La liste doit être un sous-ensemble de cs.levels. S'il n'est pas indiqué, tous les niveaux sont étiquetés.

fontsize str ou float, par défaut : rcParams["font.size"](par défaut : 10.0)

Taille en points ou taille relative, par exemple "plus petit", "x-large". Voir Text.set_sizepour les valeurs de chaîne acceptées.

couleurs couleur ou couleurs ou Aucun, par défaut : Aucun

Les couleurs de l'étiquette :

  • Si None , la couleur de chaque étiquette correspond à la couleur du contour correspondant.

  • Si une couleur de chaîne, par exemple, colors = 'r' ou colors = 'red', toutes les étiquettes seront tracées dans cette couleur.

  • S'il s'agit d'un tuple de couleurs (string, float, rgb, etc.), différentes étiquettes seront tracées dans différentes couleurs dans l'ordre spécifié.

inline bool, par défaut : True

Si Truele contour sous-jacent est supprimé là où l'étiquette est placée.

flottant inline_spacing , par défaut : 5

Espace en pixels à laisser de chaque côté de l'étiquette lors de la mise en ligne.

Cet espacement sera exact pour les étiquettes aux emplacements où le contour est droit, moins pour les étiquettes sur les contours courbes.

fmt Formatterou str ou callable ou dict, facultatif

Comment les niveaux sont formatés :

  • Si a Formatter, il est utilisé pour formater tous les niveaux à la fois, en utilisant sa Formatter.format_ticksméthode.

  • S'il s'agit d'une chaîne, elle est interprétée comme une chaîne au format %-style.

  • S'il s'agit d'un appelable, il est appelé avec un niveau à la fois et doit renvoyer l'étiquette correspondante.

  • S'il s'agit d'un dict, il doit directement mapper les niveaux aux étiquettes.

La valeur par défaut est d'utiliser un standard ScalarFormatter.

manuel booléen ou itérable, par défaut : False

Si True, les étiquettes de contour seront placées manuellement à l'aide de clics de souris. Cliquez sur le premier bouton près d'un contour pour ajouter une étiquette, cliquez sur le deuxième bouton (ou éventuellement sur les deux boutons de la souris à la fois) pour terminer l'ajout d'étiquettes. Le troisième bouton peut être utilisé pour supprimer la dernière étiquette ajoutée, mais uniquement si les étiquettes ne sont pas en ligne. Alternativement, le clavier peut être utilisé pour sélectionner les emplacements des étiquettes (entrée pour terminer le placement des étiquettes, suppression ou retour arrière agissent comme le troisième bouton de la souris, et toute autre touche sélectionnera un emplacement d'étiquette).

manual peut aussi être un objet itérable de tuples (x, y). Les étiquettes de contour seront créées comme si la souris était cliquée à chaque position (x, y).

rightside_up booléen, par défaut : True

Si True, les rotations des étiquettes seront toujours de plus ou moins 90 degrés par rapport au niveau.

use_clabeltext bool, par défaut : False

Si True, ClabelTextla classe (au lieu de Text) est utilisée pour créer des étiquettes. ClabelTextrecalcule les angles de rotation des textes pendant le temps de dessin, donc cela peut être utilisé si l'aspect des axes change.

zorder float ou None, par défaut :(2 + contour.get_zorder())

zorder des étiquettes de contour.

Retours :
Étiquettes

Une liste d' Textinstances pour les étiquettes.

get_label_width ( lev , fmt , fsize ) [source] #

[ Obsolète ] Renvoie la largeur de l'étiquette en points.

Remarques

Obsolète depuis la version 3.5.

get_text ( niveau , fmt ) [source] #

Obtenez le texte de l'étiquette.

étiquettes ( inline , inline_spacing ) [source] #
locate_label ( linecontour , labelwidth ) [source] #

Trouvez un bon endroit pour dessiner une étiquette (partie relativement plate du contour).

étiquette_pop ( index = -1 ) [source] #

Par défaut, la dernière étiquette est supprimée, mais n'importe quel index peut être fourni

print_label ( linecontour , labelwidth ) [source] #

Retourne si un contour est assez long pour contenir une étiquette.

set_label_props ( étiquette , texte , couleur ) [source] #

Définissez les propriétés de l'étiquette - couleur, taille de police, texte.

too_close ( x , y , lw ) [source] #

Indique si une étiquette se trouve déjà à proximité de cet emplacement.

classe matplotlib.contour. ContourSet ( ax , * args , niveaux = Aucun , filled = False , linewidths = Aucun , linestyles = Aucun , hachures = (Aucun,) , alpha = Aucun , origin = Aucun , extent = Aucun , cmap = Aucun , colors = Aucun , norme =Aucun , vmin = Aucun , vmax = Aucun , extend = 'ni' , antialiased = Aucun , nchunk = 0 , locator = Aucun , transform = Aucun , negative_linestyles = Aucun , ** kwargs ) [source] #

Bases : ScalarMappable,ContourLabeler

Stockez un ensemble de lignes de contour ou de régions remplies.

Méthode appelable par l'utilisateur :clabel

Paramètres :
hacheAxes
niveaux [niveau0, niveau1, ..., niveaun]

Une liste de nombres à virgule flottante indiquant les niveaux de contour.

tous les segments [ niveau0segs , niveau1segs, ...]

Liste de tous les segments de polygone pour tous les niveaux . Pour les lignes de contour , et pour les régions de contour remplies . Les listes devraient ressembler àlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkinds Noneou [level0kinds, level1kinds, ...]

Liste facultative de tous les types de sommets de polygone (types de code), tels que décrits et utilisés dans Path. Ceci est utilisé pour permettre des chemins multi-connectés tels que des trous dans des polygones remplis. Sinon None, . Les listes devraient ressembler àlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Si allkinds n'est pas None, généralement tous les polygones d'un niveau de contour particulier sont regroupés de sorte que et .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Les arguments de mot-clé sont tels que décrits dans la docstring de contour.

Attributs :
hacheAxes

L'objet Axes dans lequel les contours sont dessinés.

collections silent_listde PathCollections

Le Artists représentant le contour. Il s'agit d'une liste de PathCollections pour les contours linéaires et remplis.

tableau de niveaux

Les valeurs des niveaux de contour.

tableau de couches

Identiques aux niveaux pour les contours de lignes ; à mi-chemin entre les niveaux pour les contours remplis. Voir ContourSet._process_colors.

Dessinez des lignes de contour ou des régions remplies, selon que le mot-clé arg filled est False(par défaut) ou True.

Signature d'appel :

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)
Paramètres :
hacheAxes

L' Axesobjet sur lequel dessiner.

niveaux [niveau0, niveau1, ..., niveaun]

Une liste de nombres à virgule flottante indiquant les niveaux de contour.

tous les segments [ niveau0segs , niveau1segs, ...]

Liste de tous les segments de polygone pour tous les niveaux . Pour les lignes de contour , et pour les régions de contour remplies . Les listes devraient ressembler àlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkinds [level0kinds, level1kinds, ...], facultatif

Liste facultative de tous les types de sommets de polygone (types de code), tels que décrits et utilisés dans Path. Ceci est utilisé pour permettre des chemins multi-connectés tels que des trous dans des polygones remplis. Sinon None, . Les listes devraient ressembler àlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Si allkinds n'est pas None, généralement tous les polygones d'un niveau de contour particulier sont regroupés de sorte que et .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Les arguments de mot-clé sont tels que décrits dans la docstring de contour.

modifié ( ) [source] #

Appelez ceci chaque fois que le mappable est modifié pour notifier tous les écouteurs callbackSM du signal 'modifié'.

find_nearest_contour ( x , y , indices = None , pixel = True ) [source] #

Trouvez le point du tracé de contour le plus proche de .(x, y)

Cette méthode ne prend pas en charge les contours remplis.

Paramètres :
x, y flottant

Le point de référence.

index liste int ou None, par défaut : None

Indices des niveaux de contour à considérer. Si Aucun (valeur par défaut), tous les niveaux sont pris en compte.

pixel booléen, par défaut : Vrai

Si True , mesurez la distance dans l'espace pixel (écran), ce qui est utile pour l'étiquetage manuel des contours ; sinon, mesurez la distance dans l'espace des axes.

Retours :
contourCollection

Le contour le plus proche de .(x, y)

segment entier

L'indice du Pathcontour le plus proche de .(x, y)

indice entier

L'index du segment de chemin dans segment le plus proche de .(x, y)

flottant xmin, ymin

Le point du tracé de contour le plus proche de .(x, y)

flotteur d2

La distance au carré de à .(xmin, ymin)(x, y)

get_alpha ( ) [source] #

Renvoie alpha à appliquer à tous les artistes ContourSet.

get_transform ( ) [source] #

Renvoie l' Transforminstance utilisée par ce ContourSet.

legend_elements ( variable_name='x' , str_format=<class 'str'> ) [source] #

Renvoie une liste d'artistes et d'étiquettes aptes à transiter vers legendlesquels représentent ce ContourSet.

Les étiquettes ont la forme "0 < x <= 1" indiquant les plages de données que les artistes représentent.

Paramètres :
nom_variable chaîne

La chaîne utilisée à l'intérieur de l'inégalité utilisée sur les étiquettes.

Fonction str_format : float -> str

Fonction utilisée pour formater les nombres dans les étiquettes.

Retours :
liste des artistes [ Artist]

Une liste des artistes.

liste d' étiquettes [str]

Une liste des étiquettes.

set_alpha ( alpha ) [source] #

Définissez la valeur de fusion alpha pour tous les artistes ContourSet. alpha doit être compris entre 0 (transparent) et 1 (opaque).

classe matplotlib.contour. QuadContourSet ( ax , * args , levels = None , filled = False , linewidths = None , linestyles = None , hatches = (Aucun,) , alpha = None , origin = None , extent = None , cmap = None , colors = None , norme =Aucun , vmin = Aucun , vmax = Aucun , extend = 'ni' , antialiased = Aucun , nchunk = 0 , locator = Aucun , transform = Aucun , negative_linestyles = Aucun , ** kwargs ) [source] #

Socles :ContourSet

Créez et stockez un ensemble de lignes de contour ou de zones remplies.

Cette classe n'est généralement pas instanciée directement par l'utilisateur mais par contouret contourf.

Attributs :
hacheAxes

L'objet Axes dans lequel les contours sont dessinés.

collections silent_listde PathCollections

Le Artists représentant le contour. Il s'agit d'une liste de PathCollections pour les contours linéaires et remplis.

tableau de niveaux

Les valeurs des niveaux de contour.

tableau de couches

Identiques aux niveaux pour les contours de lignes ; à mi-chemin entre les niveaux pour les contours remplis. Voir ContourSet._process_colors.

Dessinez des lignes de contour ou des régions remplies, selon que le mot-clé arg filled est False(par défaut) ou True.

Signature d'appel :

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)
Paramètres :
hacheAxes

L' Axesobjet sur lequel dessiner.

niveaux [niveau0, niveau1, ..., niveaun]

Une liste de nombres à virgule flottante indiquant les niveaux de contour.

tous les segments [ niveau0segs , niveau1segs, ...]

Liste de tous les segments de polygone pour tous les niveaux . Pour les lignes de contour , et pour les régions de contour remplies . Les listes devraient ressembler àlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkinds [level0kinds, level1kinds, ...], facultatif

Liste facultative de tous les types de sommets de polygone (types de code), tels que décrits et utilisés dans Path. Ceci est utilisé pour permettre des chemins multi-connectés tels que des trous dans des polygones remplis. Sinon None, . Les listes devraient ressembler àlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Si allkinds n'est pas None, généralement tous les polygones d'un niveau de contour particulier sont regroupés de sorte que et .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Les arguments de mot-clé sont tels que décrits dans la docstring de contour.