matplotlib.lines.Line2D #
- classe matplotlib.lines. Line2D ( xdata , ydata , * , linewidth = Aucun , linestyle = Aucun , color = Aucun , gapcolor = Aucun , marker = Aucun , markersize = Aucun , markeredgewidth = Aucun , markeredgecolor = Aucun , markerfacecolor = Aucun , markerfacecoloralt ='none' , fillstyle = None , antialiased = None , dash_capstyle = None , solid_capstyle = None , dash_joinstyle = None , solid_joinstyle = None , pickradius = 5 , drawstyle = None , markevery = None , ** kwargs ) [source] #
Socles :
ArtistUne ligne - la ligne peut avoir à la fois un style de ligne solide reliant tous les sommets et un marqueur à chaque sommet. De plus, le dessin de la ligne continue est influencé par le style de dessin, par exemple, on peut créer des lignes "en escalier" dans différents styles.
Créez une
Line2Dinstance avec des données x et y dans des séquences de xdata , ydata .Les arguments de mots-clés supplémentaires sont
Line2Ddes propriétés :Propriété
La description
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
scalaire ou Aucun
bourdonner
antialiasedou aabourdonner
bourdonner
Patch ou (chemin, transformation) ou aucun
colorou cCouleur
CapStyleou {'bout', 'en saillie', 'rond'}JoinStyleou {'onglet', 'rond', 'biseau'}séquence de flottants (on/off encre en points) ou (Aucun, Aucun)
(2, N) tableau ou deux tableaux 1D
drawstyleou dès{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, par défaut : 'default'
{'plein', 'gauche', 'droite', 'bas', 'haut', 'aucun'}
couleur ou Aucun
chaîne
bourdonner
objet
linestyleou ls{'-', '--', '-.', ':', '', (décalage, on-off-seq), ...}
linewidthou lwflotteur
chaîne de style marqueur,
PathouMarkerStylemarkeredgecolorou mecCouleur
markeredgewidthou miaulerflotteur
markerfacecolorou mfcCouleur
markerfacecoloraltou mfcaltCouleur
markersizeou msflotteur
None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
bourdonner
float ou callable[[Artist, Event], tuple[bool, dict]]
inconnue
bourdonner
(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
booléen ou Aucun
CapStyleou {'bout', 'en saillie', 'rond'}JoinStyleou {'onglet', 'rond', 'biseau'}inconnue
chaîne
bourdonner
Tableau 1D
Tableau 1D
flotteur
Voir
set_linestyle()pour une description des styles de ligne,set_marker()pour une description des marqueurs etset_drawstyle()pour une description des styles de dessin.- contient ( mouseevent ) [source] #
Teste si mouseevent s'est produit sur la ligne.
Un événement est réputé s'être produit « sur » la ligne s'il est à moins de
self.pickradius(par défaut : 5 points) de celle-ci. Utilisezget_pickradiusouset_pickradiuspour obtenir ou définir le rayon de sélection.- Paramètres :
- événement de souris
matplotlib.backend_bases.MouseEvent
- événement de souris
- Retours :
- contient booléen
Indique si des valeurs se trouvent dans le rayon.
- dictée des détails
Un dictionnaire , où pointlist est une liste de points de la ligne qui se trouvent dans le rayon de sélection autour de la position de l'événement.
{'ind': pointlist}TODO : trier les indices renvoyés par distance
- draw ( moteur de rendu ) [source] #
Dessinez l'artiste (et ses enfants) à l'aide du moteur de rendu donné.
Cela n'a aucun effet si l'artiste n'est pas visible (
Artist.get_visiblerenvoie Faux).- Paramètres :
- sous-classe de moteur de rendu .
RendererBase
- sous-classe de moteur de rendu .
Remarques
Cette méthode est remplacée dans les sous-classes Artist.
- drawStyleKeys = ['default', 'steps-mid', 'steps-pre', 'steps-post', 'steps'] #
- drawStyles = {'default' : '_draw_lines', 'steps' : '_draw_steps_pre', 'steps-mid' : '_draw_steps_mid', 'steps-post' : '_draw_steps_post', 'steps-pre' : '_draw_steps_pre'} #
- fillStyles = ('plein', 'gauche', 'droite', 'bas', 'haut', 'aucun') #
- marqueurs_remplis = ('o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D' , 'd', 'P', 'X') #
- get_aa ( ) [source] #
Alias pour
get_antialiased.
- get_dash_capstyle ( ) [source] #
Renvoie le
CapStylepour les lignes en pointillés.Voir aussi
set_dash_capstyle.
- get_dash_joinstyle ( ) [source] #
Renvoie le
JoinStylepour les lignes en pointillés.Voir aussi
set_dash_joinstyle.
- get_data ( orig = Vrai ) [source] #
Renvoie les données de ligne sous forme de paire.
(xdata, ydata)Si orig vaut True , renvoie les données d'origine.
- get_drawstyle ( ) [source] #
Renvoie le style de dessin.
Voir aussi
set_drawstyle.
- get_ds ( ) [source] #
Alias pour
get_drawstyle.
- get_fillstyle ( ) [source] #
Renvoie le style de remplissage du marqueur.
Voir aussi
set_fillstyle.
- get_gapcolor ( ) [source] #
Renvoie la ligne gapcolor.
Voir aussi
set_gapcolor.
- get_linestyle ( ) [source] #
Renvoie le style de ligne.
Voir aussi
set_linestyle.
- get_linewidth ( ) [source] #
Renvoie la largeur de ligne en points.
Voir aussi
set_linewidth.
- get_ls ( ) [source] #
Alias pour
get_linestyle.
- get_lw ( ) [source] #
Alias pour
get_linewidth.
- get_marker ( ) [source] #
Retournez le marqueur de ligne.
Voir aussi
set_marker.
- get_markeredgecolor ( ) [source] #
Renvoie la couleur du bord du marqueur.
Voir aussi
set_markeredgecolor.
- get_markeredgewidth ( ) [source] #
Renvoie la largeur du bord du marqueur en points.
Voir aussi
set_markeredgewidth.
- get_markerfacecolor ( ) [source] #
Renvoie la couleur de la face du marqueur.
Voir aussi
set_markerfacecolor.
- get_markerfacecoloralt ( ) [source] #
Renvoie la couleur alternative de la face du marqueur.
Voir aussi
set_markerfacecoloralt.
- get_markersize ( ) [source] #
Renvoie la taille du marqueur en points.
Voir aussi
set_markersize.
- get_markevery ( ) [source] #
Renvoie le marqueur à chaque réglage pour le sous-échantillonnage du marqueur.
Voir aussi
set_markevery.
- get_mec ( ) [source] #
Alias pour
get_markeredgecolor.
- get_mew ( ) [source] #
Alias pour
get_markeredgewidth.
- get_mfc ( ) [source] #
Alias pour
get_markerfacecolor.
- get_mfcalt ( ) [source] #
Alias pour
get_markerfacecoloralt.
- get_ms ( ) [source] #
Alias pour
get_markersize.
- get_pickradius ( ) [source] #
Renvoie le rayon de sélection utilisé pour les tests de confinement.
Voir
containspour plus de détails.
- get_solid_capstyle ( ) [source] #
Renvoie le
CapStylepour les lignes pleines.Voir aussi
set_solid_capstyle.
- get_solid_joinstyle ( ) [source] #
Renvoie le
JoinStylepour les lignes pleines.Voir aussi
set_solid_joinstyle.
- get_window_extent ( moteur de rendu = Aucun ) [source] #
Obtenez la boîte englobante de l'artiste dans l'espace d'affichage.
La largeur et la hauteur de la boîte englobante sont non négatives.
Les sous-classes doivent être remplacées pour être incluses dans le calcul « serré » de la boîte englobante. La valeur par défaut est de renvoyer une boîte englobante vide à 0, 0.
Soyez prudent lorsque vous utilisez cette fonction, les résultats ne seront pas mis à jour si l'étendue de la fenêtre d'artiste de l'artiste change. L'étendue peut changer en raison de toute modification de la pile de transformation, telle que la modification des limites des axes, de la taille de la figure ou du canevas utilisé (comme cela se fait lors de l'enregistrement d'une figure). Cela peut entraîner un comportement inattendu où les figures interactives s'afficheront correctement à l'écran, mais ne seront pas enregistrées correctement.
- get_xdata ( orig = Vrai ) [source] #
Renvoyez les données étendues.
Si orig vaut True , renvoie les données d'origine, sinon les données traitées.
- get_ydata ( orig = Vrai ) [source] #
Renvoie les données y.
Si orig vaut True , renvoie les données d'origine, sinon les données traitées.
- is_dashed ( ) [source] #
Renvoie si la ligne a un style de ligne en pointillés.
Un style de ligne personnalisé est supposé être en pointillés, nous n'inspectons pas
onoffseqdirectement.Voir aussi
set_linestyle.
- lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted' , 'Aucun' : '_dessiner_rien'} #
- marqueurs = {'.': 'point', ',': 'pixel', 'o': 'cercle', 'v': 'triangle_down', '^': 'triangle_up', '<': 'triangle_left' , '>' : 'triangle_droite', '1' : 'tri_bas', '2' : 'tri_haut', '3' : 'tri_gauche', '4' : 'tri_droite', '8' : 'octogone', ' s' : 'carré', 'p' : 'pentagone', '*' : 'étoile','h' : 'hexagone1', 'H' : 'hexagone2', '+' : 'plus', 'x' : 'x', 'D' : 'losange', 'd' : 'thin_diamond', '|' : 'vline', '_' : 'hline', 'P' : 'plus_filled', 'X' : 'x_filled', 0 : 'tickleft', 1 : 'tickright ', 2 : 'tickup', 3 : 'tickdown', 4 : 'caretleft', 5 : 'caretright', 6 : 'caretup', 7 : 'caretdown', 8 : 'caretleftbase', 9 : 'caretrightbase', 10 : 'caretupbase', 11 : 'caretdownbase', 'Aucun' : 'rien', 'aucun': 'rien', ' ': 'rien', '': 'rien'} #
- propriété pickradius #
Renvoie le rayon de sélection utilisé pour les tests de confinement.
Voir
containspour plus de détails.
- set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , antialiased=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET > , dash_capstyle=<UNSET> , dash_joinstyle=<UNSET> , dashes=<UNSET> , data=<UNSET> , drawstyle=<UNSET> , fillstyle=<UNSET> , gapcolor=<UNSET> , gid=<UNSET> , in_layout=<UNSET> ,label=<UNSET> ,linestyle =<NON ENSEMBLE> , linewidth=<NON ENSEMBLE> , marker=<NON ENSEMBLE> , markeredgecolor=<NON ENSEMBLE> , markeredgewidth=<NON ENSEMBLE> , markerfacecolor=<NON ENSEMBLE> , markerfacecoloralt=<NON ENSEMBLE> , markersize=<NON ENSEMBLE> , markevery= <UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , solid_capstyle=<UNSET > ,solid_joinstyle=<UNSET> ,transform=<UNSET> , url=<UNSET> , visible=<UNSET> , xdata=<UNSET> , ydata=<UNSET> , zorder=<UNSET> ) [source] #
Définissez plusieurs propriétés à la fois.
Les propriétés prises en charge sont
Propriété
La description
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
scalaire ou Aucun
bourdonner
bourdonner
bourdonner
Patch ou (chemin, transformation) ou aucun
Couleur
CapStyleou {'bout', 'en saillie', 'rond'}JoinStyleou {'onglet', 'rond', 'biseau'}séquence de flottants (on/off encre en points) ou (Aucun, Aucun)
(2, N) tableau ou deux tableaux 1D
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, par défaut : 'default'
{'plein', 'gauche', 'droite', 'bas', 'haut', 'aucun'}
couleur ou Aucun
chaîne
bourdonner
objet
{'-', '--', '-.', ':', '', (décalage, on-off-seq), ...}
flotteur
chaîne de style marqueur,
PathouMarkerStyleCouleur
flotteur
Couleur
Couleur
flotteur
None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
bourdonner
float ou callable[[Artist, Event], tuple[bool, dict]]
inconnue
bourdonner
(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
booléen ou Aucun
CapStyleou {'bout', 'en saillie', 'rond'}JoinStyleou {'onglet', 'rond', 'biseau'}inconnue
chaîne
bourdonner
Tableau 1D
Tableau 1D
flotteur
- set_aa ( b ) [source] #
Alias pour
set_antialiased.
- set_antialiased ( b ) [source] #
Définissez s'il faut utiliser le rendu anticrénelé.
- Paramètres :
- b bool
- set_dash_capstyle ( s ) [source] #
Comment dessiner les embouts si la ligne est
is_dashed.Le style de majuscule par défaut est
rcParams["lines.dash_capstyle"](par défaut : ).<CapStyle.butt: 'butt'>- Paramètres :
- s
CapStyleou {'bout', 'en saillie', 'rond'}
- s
- set_dash_joinstyle ( s ) [source] #
Comment joindre des segments de la ligne si elle
is_dashed.Le style de jointure par défaut est
rcParams["lines.dash_joinstyle"](par défaut : ).<JoinStyle.round: 'round'>- Paramètres :
- s
JoinStyleou {'onglet', 'rond', 'biseau'}
- s
- set_dashes ( seq ) [source] #
Définissez la séquence de tirets.
La séquence de tirets est une séquence de flottants de longueur paire décrivant la longueur des tirets et des espaces en points.
Par exemple, (5, 2, 1, 2) décrit une séquence de tirets de 5 points et 1 point séparés par des espaces de 2 points.
Voir aussi
set_gapcolor, qui permet de remplir ces espaces avec une couleur.- Paramètres :
- séquence séquentielle de flottants (activation/désactivation de l'encre en points) ou (Aucun, Aucun)
Si seq est vide ou , le style de ligne sera défini sur solide.
(None, None)
- set_data ( * args ) [source] #
Définissez les données x et y.
- Paramètres :
- *args (2, N) tableau ou deux tableaux 1D
- set_drawstyle ( style de dessin ) [source] #
Définissez le style de dessin du tracé.
Le style de dessin détermine comment les points sont connectés.
- Paramètres :
- drawstyle {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, par défaut : 'default'
Pour 'default', les points sont reliés par des lignes droites.
Les variantes de marches relient les points par des lignes en forme de marches, c'est-à-dire des lignes horizontales avec des marches verticales. Ils diffèrent par l'emplacement de l'étape:
'steps-pre' : le pas est au début du segment de ligne, c'est-à-dire que la ligne sera à la valeur y du point à droite.
'steps-mid' : le pas est à mi-chemin entre les points.
'steps-post : le pas est à la fin du segment de ligne, c'est-à-dire que la ligne sera à la valeur y du point à gauche.
'steps' est égal à 'steps-pre' et est conservé pour la rétrocompatibilité.
Pour des exemples, voir Step Demo .
- set_ds ( style de dessin ) [source] #
Alias pour
set_drawstyle.
- set_fillstyle ( fs ) [source] #
Définissez le style de remplissage du marqueur.
- Paramètres :
- fs {'plein', 'gauche', 'droite', 'bas', 'haut', 'aucun'}
Valeurs possibles:
'full' : remplissez tout le marqueur avec le markerfacecolor .
'left', 'right', 'bottom', 'top' : remplissez la moitié du marqueur du côté donné avec markerfacecolor . L'autre moitié du marqueur est remplie de markerfacecoloralt .
'aucun' : pas de remplissage.
Pour des exemples, voir Styles de remplissage des marqueurs .
- set_gapcolor ( gapcolor ) [source] #
Définissez une couleur pour combler les lacunes dans le style de ligne en pointillés.
Noter
Les lignes rayées sont créées en dessinant deux lignes pointillées entrelacées. Il peut y avoir des chevauchements entre ces deux éléments, ce qui peut entraîner des artefacts lors de l'utilisation de la transparence.
Cette fonctionnalité est expérimentale et peut changer.
- Paramètres :
- couleur gapcolor ou Aucune
La couleur avec laquelle combler les lacunes. Si Aucun, les vides ne sont pas remplis.
- set_linestyle ( ls ) [source] #
Définissez le style de ligne de la ligne.
- Paramètres :
- ls {'-', '--', '-.', ':', '', (décalage, on-off-seq), ...}
Valeurs possibles:
Un string:
style de ligne
la description
'-'ou'solid'ligne continue
'--'ou'dashed'ligne pointillée
'-.'ou'dashdot'ligne pointillée
':'ou'dotted'ligne pointillée
'none','None', , ou' '''ne rien dessiner
Alternativement, un tuple de tiret de la forme suivante peut être fourni :
(offset, onoffseq)
où
onoffseqest un tuple de longueur paire d'encre allumée et éteinte en points. Voir aussiset_dashes().
Pour des exemples, voir Styles de ligne .
- set_linewidth ( w ) [source] #
Définissez la largeur de la ligne en points.
- Paramètres :
- w flotter
Largeur de ligne, en points.
- set_ls ( ls ) [source] #
Alias pour
set_linestyle.
- set_lw ( w ) [source] #
Alias pour
set_linewidth.
- set_marker ( marqueur ) [source] #
Définissez le marqueur de ligne.
- Paramètres :
- marqueur chaîne de style de marqueur,
PathouMarkerStyle Voir
markerspour une description complète des arguments possibles.
- marqueur chaîne de style de marqueur,
- set_markeredgecolor ( ec ) [source] #
Définissez la couleur du bord du marqueur.
- Paramètres :
- couleur ce
- set_markeredgewidth ( ew ) [source] #
Définissez la largeur du bord du marqueur en points.
- Paramètres :
- nouveau flotteur
Largeur du bord du marqueur, en points.
- set_markerfacecolor ( fc ) [source] #
Définissez la couleur de la face du marqueur.
- Paramètres :
- couleur FC
- set_markerfacecoloralt ( fc ) [source] #
Définissez la couleur alternative de la face du marqueur.
- Paramètres :
- couleur FC
- set_markersize ( sz ) [source] #
Définissez la taille du marqueur en points.
- Paramètres :
- flotteur _
Taille du marqueur, en points.
- set_markevery ( chaque ) [source] #
Définissez la propriété markevery pour sous-échantillonner le tracé lors de l'utilisation de marqueurs.
par exemple, si
every=5, tous les 5 marqueurs seront tracés.- Paramètres :
- tous Aucun ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
Quels marqueurs tracer.
every=None: chaque point sera tracé.every=N: chaque N-ème marqueur sera tracé en commençant par le marqueur 0.every=(start, N): chaque N-ième marqueur, commençant au début de l'index , sera tracé.every=slice(start, end, N): chaque N-ième marqueur, à partir de l'index start , jusqu'à l'index end exclu , sera tracé.every=[i, j, m, ...]: seuls les marqueurs aux indices donnés seront tracés.every=[True, False, True, ...]: seules les positions qui sont vraies seront tracées. La liste doit avoir la même longueur que les points de données.every=0.1, (c'est-à-dire un flotteur) : les marqueurs seront espacés à des distances visuelles approximativement égales le long de la ligne ; la distance le long de la ligne entre les marqueurs est déterminée en multipliant la distance des coordonnées d'affichage de la diagonale de la boîte englobante des axes par la valeur de chaque .every=(0.5, 0.1)(c'est-à-dire un tuple de longueur 2 de float): similaire àevery=0.1mais le premier marqueur sera décalé le long de la ligne de 0,5 multiplié par la distance diagonale d'affichage le long de la ligne.
Pour des exemples, voir Markevery Demo .
Remarques
La définition de markevery ne dessinera toujours que des marqueurs aux points de données réels. Alors que la forme d'argument float vise un espacement visuel uniforme, elle doit contraindre de l'espacement idéal au point de données disponible le plus proche. En fonction du nombre et de la distribution des points de données, le résultat peut toujours ne pas sembler espacé de manière régulière.
Lorsque vous utilisez un décalage de départ pour spécifier le premier marqueur, le décalage sera à partir du premier point de données qui peut être différent du premier point de données visible si le tracé est agrandi.
Si vous effectuez un zoom avant sur un tracé lors de l'utilisation d'arguments flottants, les points de données réels qui ont des marqueurs changeront car la distance entre les marqueurs est toujours déterminée à partir des coordonnées d'affichage axes-boîte englobante-diagonale, quelles que soient les limites réelles des données des axes.
- set_mec ( ec ) [source] #
Alias pour
set_markeredgecolor.
- set_mew ( ew ) [source] #
Alias pour
set_markeredgewidth.
- set_mfc ( fc ) [source] #
Alias pour
set_markerfacecolor.
- set_mfcalt ( fc ) [source] #
Alias pour
set_markerfacecoloralt.
- set_ms ( sz ) [source] #
Alias pour
set_markersize.
- set_picker ( p ) [source] #
Définissez les détails du sélecteur d'événement pour la ligne.
- Paramètres :
- p float ou callable[[Artist, Event], tuple[bool, dict]]
S'il s'agit d'un flottant, il est utilisé comme rayon de sélection en points.
- set_pickradius ( pickradius ) [source] #
Définissez le rayon de prélèvement utilisé pour les tests de confinement.
Voir
containspour plus de détails.- Paramètres :
- flotteur de rayon de sélection
Choisissez le rayon, en points.
- set_solid_capstyle ( s ) [source] #
Comment dessiner les embouts si la ligne est continue (pas
is_dashed)Le style de majuscule par défaut est
rcParams["lines.solid_capstyle"](par défaut : ).<CapStyle.projecting: 'projecting'>- Paramètres :
- s
CapStyleou {'bout', 'en saillie', 'rond'}
- s
- set_solid_joinstyle ( s ) [source] #
Comment joindre des segments si la ligne est continue (pas
is_dashed).Le style de jointure par défaut est
rcParams["lines.solid_joinstyle"](par défaut : ).<JoinStyle.round: 'round'>- Paramètres :
- s
JoinStyleou {'onglet', 'rond', 'biseau'}
- s
- zordre = 2 #
Exemples utilisant matplotlib.lines.Line2D#
Libellés des figures : suptitle, supxlabel, supylabel
Diagramme SkewT-logP : utilisation de transformations et de projections personnalisées
Formateur de ticks personnalisé pour les séries chronologiques
