matplotlib.lines.Line2D#
- class matplotlib.lines.Line2D(xdata, ydata, *, linewidth=None, linestyle=None, color=None, gapcolor=None, marker=None, markersize=None, markeredgewidth=None, markeredgecolor=None, markerfacecolor=None, 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)[Quelle]#
Bases:
ArtistEine Linie - die Linie kann sowohl einen durchgehenden Linienstil haben, der alle Scheitelpunkte verbindet, als auch ein Markierungssymbol an jedem Scheitelpunkt. Zusätzlich wird die Zeichnung der durchgehenden Linie durch den Zeichenstil beeinflusst, z.B. kann man "gestufte" Linien in verschiedenen Stilen erstellen.
Erstellt eine
Line2D-Instanz mit x- und y-Daten in Sequenzen von xdata, ydata.Zusätzliche Schlüsselwortargumente sind
Line2D-EigenschaftenEigenschaft
Beschreibung
eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
float oder None
bool
antialiasedoderaabool
BboxBaseoder Nonebool
Patch oder (Path, Transform) oder None
CapStyleoder {'butt', 'projecting', 'round'}JoinStyleoder {'miter', 'round', 'bevel'}Sequenz von Floats (An/Aus-Linie in Punkten) oder (None, None)
(2, N) Array oder zwei 1D-Arrays
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, Standard: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
Farbe oder None
str
bool
object
{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
float
Marker-Stil-String,
PathoderMarkerStylemarkeredgecolorodermecmarkeredgewidthodermewfloat
markerfacecolorodermfcmarkerfacecoloraltodermfcaltmarkersizeodermsfloat
None oder int oder (int, int) oder Slice oder list[int] oder float oder (float, float) oder list[bool]
bool
Liste von
AbstractPathEffectfloat oder aufrufbar[[Artist, Event], tuple[bool, dict]]
float
bool
(scale: float, length: float, randomness: float)
bool oder None
CapStyleoder {'butt', 'projecting', 'round'}JoinStyleoder {'miter', 'round', 'bevel'}unknown
str
bool
1D-Array
1D-Array
float
Siehe
set_linestyle()für eine Beschreibung der Linienstile,set_marker()für eine Beschreibung der Markierungssymbole undset_drawstyle()für eine Beschreibung der Zeichenstile.- contains(mouseevent)[Quelle]#
Testet, ob mouseevent auf der Linie aufgetreten ist.
Ein Ereignis wird als auf der Linie aufgetreten betrachtet, wenn es weniger als
self.pickradius(Standard: 5 Punkte) von ihr entfernt ist. Verwenden Sieget_pickradiusoderset_pickradius, um den Auswahlradius abzurufen oder festzulegen.- Parameter:
- mouseevent
MouseEvent
- mouseevent
- Gibt zurück:
- containsbool
Gibt an, ob Werte innerhalb des Radius liegen.
- detailsdict
Ein Wörterbuch
{'ind': punktliste}, wobei punktliste eine Liste von Punkten der Linie ist, die sich innerhalb des Auswahlradius um die Ereignisposition befinden.TODO: Indizes nach Entfernung sortieren
- draw(renderer)[Quelle]#
Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.
Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (
Artist.get_visiblegibt False zurück).- Parameter:
- renderer
RendererBaseUnterklasse.
- renderer
Anmerkungen
Diese Methode wird in den Künstler-Unterklassen überschrieben.
- 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 = ('full', 'left', 'right', 'bottom', 'top', 'none')#
- filled_markers = ('.', 'o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D', 'd', 'P', 'X')#
- get_aa()[Quelle]#
Alias für
get_antialiased.
- get_dash_capstyle()[Quelle]#
Gibt den
CapStylefür gestrichelte Linien zurück.Siehe auch
set_dash_capstyle.
- get_dash_joinstyle()[Quelle]#
Gibt den
JoinStylefür gestrichelte Linien zurück.Siehe auch
set_dash_joinstyle.
- get_data(orig=True)[Quelle]#
Gibt die Liniendaten als ein
(xdata, ydata)-Paar zurück.Wenn orig True ist, werden die Originaldaten zurückgegeben.
- get_drawstyle()[Quelle]#
Gibt den Zeichenstil zurück.
Siehe auch
set_drawstyle.
- get_ds()[Quelle]#
Alias für
get_drawstyle.
- get_fillstyle()[Quelle]#
Gibt den Füllstil des Markierungssymbols zurück.
Siehe auch
set_fillstyle.
- get_gapcolor()[Quelle]#
Gibt die Lückenfarbe der Linie zurück.
Siehe auch
set_gapcolor.
- get_linestyle()[Quelle]#
Gibt den Linienstil zurück.
Siehe auch
set_linestyle.
- get_linewidth()[Quelle]#
Gibt die Linienbreite in Punkten zurück.
Siehe auch
set_linewidth.
- get_ls()[Quelle]#
Alias für
get_linestyle.
- get_lw()[Quelle]#
Alias für
get_linewidth.
- get_marker()[Quelle]#
Gibt das Markierungssymbol der Linie zurück.
Siehe auch
set_marker.
- get_markeredgecolor()[Quelle]#
Gibt die Randfarbe des Markierungssymbols zurück.
Siehe auch
set_markeredgecolor.
- get_markeredgewidth()[Quelle]#
Gibt die Randbreite des Markierungssymbols in Punkten zurück.
Siehe auch
set_markeredgewidth.
- get_markerfacecolor()[Quelle]#
Gibt die Füllfarbe des Markierungssymbols zurück.
Siehe auch
set_markerfacecolor.
- get_markerfacecoloralt()[Quelle]#
Gibt die alternative Füllfarbe des Markierungssymbols zurück.
Siehe auch
set_markerfacecoloralt.
- get_markersize()[Quelle]#
Gibt die Größe des Markierungssymbols in Punkten zurück.
Siehe auch
set_markersize.
- get_markevery()[Quelle]#
Gibt die `markevery`-Einstellung für die Unterabtastung von Markierungssymbolen zurück.
Siehe auch
set_markevery.
- get_mec()[Quelle]#
Alias für
get_markeredgecolor.
- get_mew()[Quelle]#
Alias für
get_markeredgewidth.
- get_mfc()[Quelle]#
Alias für
get_markerfacecolor.
- get_mfcalt()[Quelle]#
Alias für
get_markerfacecoloralt.
- get_ms()[Quelle]#
Alias für
get_markersize.
- get_pickradius()[Quelle]#
Gibt den Auswahlradius zurück, der für Containment-Tests verwendet wird.
Siehe
containsfür weitere Details.
- get_solid_capstyle()[Quelle]#
Gibt den
CapStylefür durchgehende Linien zurück.Siehe auch
set_solid_capstyle.
- get_solid_joinstyle()[Quelle]#
Gibt den
JoinStylefür durchgehende Linien zurück.Siehe auch
set_solid_joinstyle.
- get_window_extent(renderer=None)[Quelle]#
Ruft die Bounding Box des Künstlers im Anzeigeraum ab.
Die Breite und Höhe der Bounding Box sind nicht negativ.
Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.
Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.
- get_xdata(orig=True)[Quelle]#
Gibt die xdata zurück.
Wenn orig True ist, werden die Originaldaten zurückgegeben, andernfalls die verarbeiteten Daten.
- get_ydata(orig=True)[Quelle]#
Gibt die ydata zurück.
Wenn orig True ist, werden die Originaldaten zurückgegeben, andernfalls die verarbeiteten Daten.
- is_dashed()[Quelle]#
Gibt zurück, ob die Linie einen gestrichelten Linienstil hat.
Ein benutzerdefinierter Linienstil wird als gestrichelt angenommen, wir inspizieren die
onoffseqnicht direkt.Siehe auch
set_linestyle.
- lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted', 'None': '_draw_nothing'}#
- markers = {' ': 'nothing', '': 'nothing', '*': 'star', '+': 'plus', ',': 'pixel', '.': 'point', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', '<': 'triangle_left', '>': 'triangle_right', 'D': 'diamond', 'H': 'hexagon2', 'None': 'nothing', 'P': 'plus_filled', 'X': 'x_filled', '^': 'triangle_up', '_': 'hline', 'd': 'thin_diamond', 'h': 'hexagon1', 'none': 'nothing', 'o': 'circle', 'p': 'pentagon', 's': 'square', 'v': 'triangle_down', 'x': 'x', '|': 'vline', 0: 'tickleft', 1: 'tickright', 10: 'caretupbase', 11: 'caretdownbase', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase'}#
- property pickradius#
Gibt den Auswahlradius zurück, der für Containment-Tests verwendet wird.
Siehe
containsfür weitere Details.
- set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<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=<UNSET>, linewidth=<UNSET>, marker=<UNSET>, markeredgecolor=<UNSET>, markeredgewidth=<UNSET>, markerfacecolor=<UNSET>, markerfacecoloralt=<UNSET>, markersize=<UNSET>, 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>)[Quelle]#
Setzt mehrere Eigenschaften auf einmal.
Unterstützte Eigenschaften sind
Eigenschaft
Beschreibung
eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
float oder None
bool
bool
BboxBaseoder Nonebool
Patch oder (Path, Transform) oder None
CapStyleoder {'butt', 'projecting', 'round'}JoinStyleoder {'miter', 'round', 'bevel'}Sequenz von Floats (An/Aus-Linie in Punkten) oder (None, None)
(2, N) Array oder zwei 1D-Arrays
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, Standard: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
Farbe oder None
str
bool
object
{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
float
Marker-Stil-String,
PathoderMarkerStylefloat
float
None oder int oder (int, int) oder Slice oder list[int] oder float oder (float, float) oder list[bool]
bool
Liste von
AbstractPathEffectfloat oder aufrufbar[[Artist, Event], tuple[bool, dict]]
float
bool
(scale: float, length: float, randomness: float)
bool oder None
CapStyleoder {'butt', 'projecting', 'round'}JoinStyleoder {'miter', 'round', 'bevel'}unknown
str
bool
1D-Array
1D-Array
float
- set_aa(b)[Quelle]#
Alias für
set_antialiased.
- set_antialiased(b)[Quelle]#
Gibt an, ob Antialiasing-Rendering verwendet werden soll.
- Parameter:
- bbool
- set_dash_capstyle(s)[Quelle]#
Wie die Endkappen gezeichnet werden, wenn die Linie
is_dashedist.Der Standard-Capstyle ist
rcParams["lines.dash_capstyle"](Standard:<CapStyle.butt: 'butt'>).- Parameter:
- s
CapStyleoder {'butt', 'projecting', 'round'}
- s
- set_dash_joinstyle(s)[Quelle]#
Wie Segmente der Linie verbunden werden, wenn sie
is_dashedist.Der Standard-Joinstyle ist
rcParams["lines.dash_joinstyle"](Standard:<JoinStyle.round: 'round'>).- Parameter:
- s
JoinStyleoder {'miter', 'round', 'bevel'}
- s
- set_dashes(seq)[Quelle]#
Legt die Strichsequenz fest.
Die Strichsequenz ist eine Sequenz von Gleitkommazahlen gerader Länge, die die Länge von Strichen und Lücken in Punkten beschreibt.
Zum Beispiel beschreibt (5, 2, 1, 2) eine Sequenz von 5-Punkt- und 1-Punkt-Strichen, die durch 2-Punkt-Lücken getrennt sind.
Siehe auch
set_gapcolor, womit diese Lücken mit einer Farbe gefüllt werden können.- Parameter:
- seqSequenz von Gleitkommazahlen (an/aus Tinte in Punkten) oder (None, None)
Wenn seq leer ist oder
(None, None), wird der Linienstil auf durchgezogen gesetzt.
- set_data(*args)[Quelle]#
Legt die x- und y-Daten fest.
- Parameter:
- *args(2, N) Array oder zwei 1D-Arrays
- set_drawstyle(drawstyle)[Quelle]#
Legt den Zeichenstil des Plots fest.
Der Zeichenstil bestimmt, wie die Punkte verbunden werden.
- Parameter:
- drawstyle{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, Standard: 'default'
Für 'default' werden die Punkte mit geraden Linien verbunden.
Die "steps"-Varianten verbinden die Punkte mit stufenartigen Linien, d.h. horizontalen Linien mit vertikalen Stufen. Sie unterscheiden sich in der Position der Stufe.
'steps-pre': Die Stufe befindet sich am Anfang des Liniensegments, d.h. die Linie wird den y-Wert des rechten Punkts haben.
'steps-mid': Die Stufe befindet sich auf halber Strecke zwischen den Punkten.
'steps-post: Die Stufe befindet sich am Ende des Liniensegments, d.h. die Linie wird den y-Wert des linken Punkts haben.
'steps' ist gleich 'steps-pre' und wird aus Kompatibilitätsgründen beibehalten.
Beispiele siehe Schritt-Demo.
- set_ds(drawstyle)[Quelle]#
Alias für
set_drawstyle.
- set_fillstyle(fs)[Quelle]#
Legt den Füllstil des Markers fest.
- Parameter:
- fs{'full', 'left', 'right', 'bottom', 'top', 'none'}
Mögliche Werte
'full': Füllt den gesamten Marker mit markerfacecolor.
'left', 'right', 'bottom', 'top': Füllt die Hälfte des Markers auf der angegebenen Seite mit markerfacecolor. Die andere Hälfte des Markers wird mit markerfacecoloralt gefüllt.
'none': Keine Füllung.
Beispiele siehe Markerfüllstile.
- set_gapcolor(gapcolor)[Quelle]#
Legt eine Farbe zum Füllen der Lücken im gestrichelten Linienstil fest.
Hinweis
Gestreifte Linien werden durch das Zeichnen zweier überlappender gestrichelter Linien erzeugt. Es kann zu Überlappungen zwischen diesen beiden kommen, was bei Verwendung von Transparenz zu Artefakten führen kann.
Diese Funktionalität ist experimentell und kann sich ändern.
- Parameter:
- gapcolorcolor oder None
Die Farbe, mit der die Lücken gefüllt werden. Wenn None, sind die Lücken ungefüllt.
- set_linestyle(ls)[Quelle]#
Legt den Linienstil der Linie fest.
- Parameter:
- ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
Mögliche Werte
Eine Zeichenkette
Linienstil (linestyle)
Beschreibung
'-'oder'solid'durchgezogene Linie
'--'oder'dashed'gestrichelte Linie
'-.'oder'dashdot'Strichpunktlinie
':'oder'dotted'gepunktete Linie
'none','None',' ', oder''Zeichne nichts
Alternativ kann ein Strich-Tupel der folgenden Form angegeben werden
(offset, onoffseq)
wobei
onoffseqein Tupel gerader Länge von Ein- und Aus-Tinte in Punkten ist. Siehe auchset_dashes().
Beispiele siehe Linienstile.
- set_linewidth(w)[Quelle]#
Legt die Linienbreite in Punkten fest.
- Parameter:
- wfloat
Linienbreite in Punkten.
- set_ls(ls)[Quelle]#
Alias für
set_linestyle.
- set_lw(w)[Quelle]#
Alias für
set_linewidth.
- set_marker(marker)[Quelle]#
Legt den Marker der Linie fest.
- Parameter:
- markerMarker-Stil-Zeichenkette,
PathoderMarkerStyle Siehe
markersfür eine vollständige Beschreibung möglicher Argumente.
- markerMarker-Stil-Zeichenkette,
- set_markeredgewidth(ew)[Quelle]#
Legt die Marker-Randbreite in Punkten fest.
- Parameter:
- ewfloat
Marker-Randbreite in Punkten.
- set_markersize(sz)[Quelle]#
Legt die Markergröße in Punkten fest.
- Parameter:
- szfloat
Markergröße in Punkten.
- set_markevery(every)[Quelle]#
Legt die Markevery-Eigenschaft fest, um den Plot beim Verwenden von Markern zu untersubsamplen.
z.B. wenn
every=5, wird jeder 5. Marker gezeichnet.- Parameter:
- everyNone oder int oder (int, int) oder slice oder list[int] oder float oder (float, float) oder list[bool]
Welche Marker gezeichnet werden sollen.
every=None: jeder Punkt wird gezeichnet.every=N: jeder N-te Marker wird gezeichnet, beginnend mit Marker 0.every=(start, N): jeder N-te Marker, beginnend mit Index start, wird gezeichnet.every=slice(start, end, N): jeder N-te Marker, beginnend mit Index start, bis, aber nicht einschließlich, Index end, wird gezeichnet.every=[i, j, m, ...]: nur Marker an den angegebenen Indizes werden gezeichnet.every=[True, False, True, ...]: nur Positionen, die True sind, werden gezeichnet. Die Liste muss die gleiche Länge wie die Datenpunkte haben.every=0.1(d.h. ein float): Marker werden in ungefähr gleichen visuellen Abständen entlang der Linie platziert; der Abstand entlang der Linie zwischen den Markern ergibt sich durch Multiplikation des Display-Koordinatenabstands der Diagonalen des Achsenbegrenzungsrahmens mit dem Wert von every.every=(0.5, 0.1)(d.h. ein Tupel aus zwei Floats): Ähnlich wieevery=0.1, aber der erste Marker wird um 0.5 mal die Display-Koordinaten-Diagonale entlang der Linie versetzt.
Beispiele siehe Markevery-Demo.
Anmerkungen
Das Setzen von markevery zeichnet immer noch Marker nur an tatsächlichen Datenpunkten. Während das Float-Argumentformular eine gleichmäßige visuelle Abstandsbestrebung hat, muss es vom idealen Abstand zum nächsten verfügbaren Datenpunkt umgerechnet werden. Abhängig von der Anzahl und Verteilung der Datenpunkte kann das Ergebnis immer noch nicht gleichmäßig aussehen.
Wenn ein Startversatz zur Angabe des ersten Markers verwendet wird, erfolgt der Versatz vom ersten Datenpunkt, der sich vom ersten sichtbaren Datenpunkt unterscheiden kann, wenn der Plot gezoomt ist.
Beim Zoomen in einen Plot mit Float-Argumenten ändern sich die tatsächlichen Datenpunkte, die Marker haben, da der Abstand zwischen den Markern immer vom Diagramm-Koordinaten-Achsen-Begrenzungsrahmen-Diagonalen bestimmt wird, unabhängig von den tatsächlichen Achsdatenlimits.
- set_mec(ec)[Quelle]#
Alias für
set_markeredgecolor.
- set_mew(ew)[Quelle]#
Alias für
set_markeredgewidth.
- set_mfc(fc)[Quelle]#
Alias für
set_markerfacecolor.
- set_mfcalt(fc)[Quelle]#
Alias für
set_markerfacecoloralt.
- set_ms(sz)[Quelle]#
Alias für
set_markersize.
- set_picker(p)[Quelle]#
Legt die Event-Picker-Details für die Linie fest.
- Parameter:
- pfloat oder callable[[Artist, Event], tuple[bool, dict]]
Wenn eine Gleitkommazahl, wird sie als Picker-Radius in Punkten verwendet.
- set_pickradius(pickradius)[Quelle]#
Legt den Picker-Radius für Einbeziehungstests fest.
Siehe
containsfür weitere Details.- Parameter:
- pickradiusfloat
Picker-Radius in Punkten.
- set_solid_capstyle(s)[Quelle]#
Wie die Endkappen gezeichnet werden, wenn die Linie durchgezogen ist (nicht
is_dashed).Der Standard-Capstyle ist
rcParams["lines.solid_capstyle"](Standard:<CapStyle.projecting: 'projecting'>).- Parameter:
- s
CapStyleoder {'butt', 'projecting', 'round'}
- s
- set_solid_joinstyle(s)[Quelle]#
Wie Segmente verbunden werden, wenn die Linie durchgezogen ist (nicht
is_dashed).Der Standard-Joinstyle ist
rcParams["lines.solid_joinstyle"](Standard:<JoinStyle.round: 'round'>).- Parameter:
- s
JoinStyleoder {'miter', 'round', 'bevel'}
- s
- zorder = 2#
Beispiele für die Verwendung von matplotlib.lines.Line2D#
SkewT-LogP-Diagramm: Verwendung von Transformationen und benutzerdefinierten Projektionen
Figuren-Beschriftungen: suptitle, supxlabel, supylabel
Benutzerdefinierter Tick-Formatierer für Zeitreihen