`matplotlib.patheffects`#

Definiert Klassen für Pfadeffekte. Die Pfadeffekte werden in Text, Line2Dund unterstützt Patch.

Siehe auch

Leitfaden für Pfadeffekte

Klasse matplotlib.patheffects. AbstractPathEffect ( offset = (0.0, 0.0) ) [Quelle] #

Basen:object

Eine Basisklasse für Pfadeffekte.

Unterklassen sollten die draw_pathMethode überschreiben, um Effektfunktionen hinzuzufügen.

Parameter :

Offset (float, float), Standard: (0, 0): Der (x, y)-Offset, der auf den Pfad angewendet werden soll, gemessen in Punkten.

draw_path ( renderer , gc , tpath , affine , rgbFace = None ) [Quelle] #: Derived sollte diese Methode überschreiben. Die Argumente sind die gleichen wie, matplotlib.backend_bases.RendererBase.draw_path() außer dass das erste Argument ein Renderer ist.

Klasse matplotlib.patheffects. Normal ( offset = (0.0, 0.0) ) [Quelle] #

Basen:AbstractPathEffect

Der „Identitäts“-PathEffect.

Der einzige Zweck des normalen Pfadeffekts besteht darin, den ursprünglichen Künstler ohne speziellen Pfadeffekt zu zeichnen.

Parameter :

Offset (float, float), Standard: (0, 0): Der (x, y)-Offset, der auf den Pfad angewendet werden soll, gemessen in Punkten.

Klasse matplotlib.patheffects. PathEffectRenderer ( path_effects , Renderer ) [Quelle] #

Basen:RendererBase

Implementiert einen Renderer, der einen anderen Renderer enthält.

Dieser Proxy fängt dann Draw-Aufrufe ab und ruft die entsprechende AbstractPathEffectDraw-Methode auf.

Notiz

Nicht alle Methoden wurden für diese RendererBase-Unterklasse überschrieben. Es kann erforderlich sein, weitere Methoden hinzuzufügen, um die PathEffects-Fähigkeiten weiter zu erweitern.

Parameter :

path_effects iterierbar vonAbstractPathEffect: Die Pfadeffekte, die dieser Renderer darstellt.
Renderer- matplotlib.backend_bases.RendererBaseUnterklasse

copy_with_path_effect ( path_effects ) [Quelle] #

draw_markers ( gc , marker_path , marker_trans , path , * args , ** kwargs ) [Quelle] #

Zeichnen Sie eine Markierung an jedem Scheitelpunkt von Pfad (außer Kontrollpunkten).

Die Basisimplementierung (Fallback) führt mehrere Aufrufe von draw_path. Back-Ends möchten diese Methode möglicherweise überschreiben, um die Markierung nur einmal zu zeichnen und mehrmals wiederzuverwenden.

Parameter :

ggGraphicsContextBase: Der grafische Kontext.
marker_transmatplotlib.transforms.Transform: Eine auf den Marker angewendete affine Transformation.
transmatplotlib.transforms.Transform: Eine auf den Pfad angewendete affine Transformation.

draw_path ( gc , tpath , affine , rgbFace = None ) [Quelle] #: Zeichne eine PathInstanz mit der gegebenen affinen Transformation.

draw_path_collection ( gc , master_transform , Pfade , * args , ** kwargs ) [Quelle] #

Zeichnen Sie eine Sammlung von Pfaden .

Jeder Pfad wird zuerst durch den entsprechenden Eintrag in all_transforms (eine Liste von (3, 3)-Matrizen) und dann durch master_transform transformiert . Sie werden dann durch den entsprechenden Eintrag in offsets übersetzt , der zuvor durch offset_trans transformiert wurde .

facecolors , edgecolors , linewidths , linestyles und antialiased sind Listen, die die entsprechenden Eigenschaften festlegen.

offset_position wird jetzt nicht verwendet, aber das Argument wird aus Gründen der Abwärtskompatibilität beibehalten.

Die Basisimplementierung (Fallback) führt mehrere Aufrufe von draw_path. Backends möchten dies möglicherweise überschreiben, um jeden Satz von Pfaddaten nur einmal zu rendern und dann diesen Pfad mehrmals mit den verschiedenen Offsets, Farben, Stilen usw. zu referenzieren. Die Generatormethoden _iter_collection_raw_pathsund _iter_collectionwerden bereitgestellt, um bei der Implementierung zu helfen (und diese zu standardisieren). über Backends hinweg. Es wird dringend empfohlen, diese Generatoren zu verwenden, damit Änderungen am Verhalten von draw_path_collectionglobal vorgenommen werden können.

Klasse matplotlib.patheffects. PathPatchEffect ( offset = (0, 0) , ** kwargs ) [Quelle] #

Basen:AbstractPathEffect

Zeichnet eine PathPatchInstanz, deren Pfad vom ursprünglichen PathEffect-Künstler stammt.

Parameter :

Offset (float, float), Standard: (0, 0): Der (x, y)-Offset, der auf den Pfad angewendet werden soll, in Punkt.
**Kwarg: Alle Schlüsselwortargumente werden an den PathPatchKonstruktor übergeben. Die nicht überschreibbaren Eigenschaften sind "path", "clip_box", "transform" und "clip_path".

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Derived sollte diese Methode überschreiben. Die Argumente sind die gleichen wie, matplotlib.backend_bases.RendererBase.draw_path() außer dass das erste Argument ein Renderer ist.

Klasse matplotlib.patheffects. SimpleLineShadow ( offset = (2, -2) , shadow_color = 'k' , alpha = 0.3 , rho = 0.3 , ** kwargs ) [Quelle] #

Basen:AbstractPathEffect

Ein einfacher Schatten über eine Linie.

Parameter :

Offset (float, float), Standard: (2, -2): Der (x, y)-Offset, der auf den Pfad angewendet werden soll, in Punkt.
shadow_color Farbe, Standard: 'schwarz': Die Schattenfarbe. Ein Wert von Nonenimmt die Originalfarbe des Künstlers mit einem Skalierungsfaktor von rho an .
Alphafloat , Standard: 0,3: Die Alphatransparenz des erstellten Schattenpatches.
rho Float, Standard: 0,3: Ein Skalierungsfaktor, der auf die rgbFace-Farbe angewendet wird , wenn shadow_colorNone .
**Kwarg: Zusätzliche Schlüsselwörter werden gespeichert und an weitergeleitet AbstractPathEffect._update_gc().

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Überschreibt den standardmäßigen draw_path, um den Schattenversatz und die erforderlichen Farbänderungen für den Schatten hinzuzufügen.

Klasse matplotlib.patheffects. SimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs ) [Quelle] #

Basen:AbstractPathEffect

Ein einfacher Schatten über einen gefüllten Patch.

Parameter :

Offset (float, float), Standard: (2, -2): Der (x, y)-Offset des Schattens in Punkten.
shadow_rgbGesichtsfarbe _: Die Schattenfarbe.
Alphafloat , Standard: 0,3: Die Alphatransparenz des erstellten Schattenpatches.
rho Float, Standard: 0,3: Ein Skalierungsfaktor, der auf die rgbFace-Farbe angewendet wird, wenn shadow_rgbFace nicht angegeben ist.
**Kwarg: Zusätzliche Schlüsselwörter werden gespeichert und an weitergeleitet AbstractPathEffect._update_gc().

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Überschreibt den standardmäßigen draw_path, um den Schattenversatz und die erforderlichen Farbänderungen für den Schatten hinzuzufügen.

Klasse matplotlib.patheffects. Stroke ( offset = (0, 0) , ** kwargs ) [Quelle] #

Basen:AbstractPathEffect

Ein linienbasierter PathEffect, der einen Strich neu zeichnet.

Der Pfad wird mit seinem gc gestrichelt, der mit den angegebenen Schlüsselwortargumenten aktualisiert wird, dh die Schlüsselwortargumente sollten gültige gc-Parameterwerte sein.

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Zeichnen Sie den Pfad mit aktualisiertem gc.

Klasse matplotlib.patheffects. TickedStroke ( Offset = (0, 0) , Abstand = 10,0 , Winkel = 45,0 , Länge = 1,4142135623730951 , ** kwargs ) [Quelle] #

Basen:AbstractPathEffect

Ein linienbasierter PathEffect, der einen Pfad mit einem angekreuzten Stil zeichnet.

Dieser Linienstil wird häufig verwendet, um Einschränkungen bei der Optimierung darzustellen. Die Häkchen können verwendet werden, um anzuzeigen, dass eine Seite der Linie ungültig ist, oder um eine geschlossene Grenze eines Bereichs darzustellen (z. B. eine Wand oder die Kante eines Rohrs).

Der Abstand, die Länge und der Winkel der Ticks können gesteuert werden.

Dieser Linienstil wird manchmal als schraffierte Linie bezeichnet.

Siehe auch das Konturdemobeispiel .

Siehe auch die Konturen im Optimierungsbeispiel .

Parameter :

Offset (float, float), Standard: (0, 0): Der (x, y)-Offset, der auf den Pfad angewendet werden soll, in Punkt.
Abstand Float, Standard: 10,0: Der Abstand zwischen Ticks in Punkten.
Winkelfloat , Standard: 45,0: Der Winkel zwischen dem Pfad und dem Tick in Grad. Der Winkel wird so gemessen, als ob Sie eine Ameise wären, die entlang der Kurve läuft, wobei null Grad direkt nach vorne zeigt, 90 nach links, -90 nach rechts und 180 hinter Ihnen.
Länge Float, Standard: 1.414: Die Länge des Ticks relativ zum Abstand. Empfohlene Länge = 1,414 (sqrt(2)) bei Winkel=45, Länge=1,0 bei Winkel=90 und Länge=2,0 bei Winkel=60.
**Kwarg: Zusätzliche Schlüsselwörter werden gespeichert und an weitergeleitet AbstractPathEffect._update_gc().

Beispiele

Siehe TickedStroke-Pfadeffekt .

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Zeichnen Sie den Pfad mit aktualisiertem gc.

Klasse matplotlib.patheffects. withSimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs ) [Quelle] #

Basen:SimplePatchShadow

Eine Verknüpfung PathEffect zum Anwenden SimplePatchShadowund anschließenden Zeichnen des ursprünglichen Künstlers.

Mit dieser Klasse können Sie verwenden

artist.set_path_effects([path_effects.withSimplePatchShadow()])

als Abkürzung für

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])

Parameter :

Offset (float, float), Standard: (2, -2): Der (x, y)-Offset des Schattens in Punkten.
shadow_rgbGesichtsfarbe _: Die Schattenfarbe.
Alphafloat , Standard: 0,3: Die Alphatransparenz des erstellten Schattenpatches.
rho Float, Standard: 0,3: Ein Skalierungsfaktor, der auf die rgbFace-Farbe angewendet wird, wenn shadow_rgbFace nicht angegeben ist.
**Kwarg: Zusätzliche Schlüsselwörter werden gespeichert und an weitergeleitet AbstractPathEffect._update_gc().

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Überschreibt den standardmäßigen draw_path, um den Schattenversatz und die erforderlichen Farbänderungen für den Schatten hinzuzufügen.

Klasse matplotlib.patheffects. withStroke ( offset = (0, 0) , ** kwargs ) [Quelle] #

Basen:Stroke

Eine Verknüpfung PathEffect zum Anwenden Strokeund anschließenden Zeichnen des ursprünglichen Künstlers.

Mit dieser Klasse können Sie verwenden

artist.set_path_effects([path_effects.withStroke()])

als Abkürzung für

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

Der Pfad wird mit seinem gc gestrichelt, der mit den angegebenen Schlüsselwortargumenten aktualisiert wird, dh die Schlüsselwortargumente sollten gültige gc-Parameterwerte sein.

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Zeichnen Sie den Pfad mit aktualisiertem gc.

Klasse matplotlib.patheffects. withTickedStroke ( Offset = (0, 0) , Abstand = 10.0 , Winkel = 45.0 , Länge = 1.4142135623730951 , ** kwargs ) [Quelle] #

Basen:TickedStroke

Eine Verknüpfung PathEffect zum Anwenden TickedStrokeund anschließenden Zeichnen des ursprünglichen Künstlers.

Mit dieser Klasse können Sie verwenden

artist.set_path_effects([path_effects.withTickedStroke()])

als Abkürzung für

artist.set_path_effects([path_effects.TickedStroke(),
                         path_effects.Normal()])

Parameter :

Offset (float, float), Standard: (0, 0): Der (x, y)-Offset, der auf den Pfad angewendet werden soll, in Punkt.
Abstand Float, Standard: 10,0: Der Abstand zwischen Ticks in Punkten.
Winkelfloat , Standard: 45,0: Der Winkel zwischen dem Pfad und dem Tick in Grad. Der Winkel wird so gemessen, als ob Sie eine Ameise wären, die entlang der Kurve läuft, wobei null Grad direkt nach vorne zeigt, 90 nach links, -90 nach rechts und 180 hinter Ihnen.
Länge Float, Standard: 1.414: Die Länge des Ticks relativ zum Abstand. Empfohlene Länge = 1,414 (sqrt(2)) bei Winkel=45, Länge=1,0 bei Winkel=90 und Länge=2,0 bei Winkel=60.
**Kwarg: Zusätzliche Schlüsselwörter werden gespeichert und an weitergeleitet AbstractPathEffect._update_gc().

Beispiele

Siehe TickedStroke-Pfadeffekt .

draw_path ( renderer , gc , tpath , affine , rgbFace ) [Quelle] #: Zeichnen Sie den Pfad mit aktualisiertem gc.

matplotlib.patheffects#

`matplotlib.patheffects`#