matplotlib.contour

Klassen zur Unterstützung von Konturdiagrammen und Beschriftungen für die Axes-Klasse.

class matplotlib.contour.ContourLabeler

Bases: object

Mixin zur Bereitstellung von Beschriftungsfunktionen für ContourSet.

add_label(x, y, rotation, lev, cvalue)

Fügt eine Konturbeschriftung hinzu, unter Berücksichtigung, ob use_clabeltext gesetzt wurde.

add_label_near(x, y, inline=True, inline_spacing=5, transform=None)

Fügt eine Beschriftung in der Nähe des Punktes (x, y) hinzu.

Parameter:

x, yfloat

Die ungefähre Position der Beschriftung.

inlinebool, Standard: True

Wenn True, wird das Segment der Kontur unter der Beschriftung entfernt.

inline_spacingint, Standard: 5

Abstand in Pixel auf jeder Seite der Beschriftung beim Inline-Platzieren. Dieser Abstand ist exakt für Beschriftungen an geraden Konturstellen, weniger exakt für Beschriftungen an gekrümmten Konturen.

transformTransform oder False, Standard: self.axes.transData

Eine Transformation, die auf (x, y) angewendet wird, bevor beschriftet wird. Der Standardwert bewirkt, dass (x, y) als Datenkoordinaten interpretiert werden. False ist ein Synonym für IdentityTransform; d. h. (x, y) sollte als Anzeige-Koordinaten interpretiert werden.

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

Beschriftet einen Konturplot.

Fügt Beschriftungen zu Linienkonturen in diesem ContourSet hinzu (das von dieser Mixin-Klasse erbt).

Parameter:

levelsarray-ähnlich, optional

Eine Liste von Level-Werten, die beschriftet werden sollen. Die Liste muss eine Teilmenge von cs.levels sein. Wenn nicht angegeben, werden alle Levels beschriftet.

fontsizestr oder float, Standard: rcParams["font.size"] (Standard: 10.0)

Größe in Punkten oder relative Größe z.B. 'smaller', 'x-large'. Siehe Text.set_size für akzeptierte Zeichenkettenwerte.

colorsFarbe oder Farben oder None, Standard: None

Die Farben der Beschriftung.

• Wenn None, entspricht die Farbe jeder Beschriftung der Farbe der entsprechenden Kontur.

• Wenn eine einzelne Farbzeichenkette, z.B. colors = 'r' oder colors = 'red', werden alle Beschriftungen in dieser Farbe gezeichnet.

• Wenn ein Tupel von Farben (Zeichenkette, Float, RGB, etc.), werden verschiedene Beschriftungen in unterschiedlichen Farben in der angegebenen Reihenfolge gezeichnet.

inlinebool, Standard: True

Wenn True, wird die darunterliegende Kontur entfernt, wo die Beschriftung platziert wird.

inline_spacingfloat, Standard: 5

Abstand in Pixel auf jeder Seite der Beschriftung beim Inline-Platzieren.

Dieser Abstand ist exakt für Beschriftungen an geraden Konturstellen, weniger exakt für Beschriftungen an gekrümmten Konturen.

fmtFormatter oder str oder callable oder dict, optional

Wie die Levels formatiert werden.

• Wenn ein Formatter, wird er verwendet, um alle Levels auf einmal zu formatieren, unter Verwendung seiner Formatter.format_ticks Methode.

• Wenn eine Zeichenkette, wird sie als %-formatierte Zeichenkette interpretiert.

• Wenn ein Callable, wird es mit einem Level nach dem anderen aufgerufen und sollte die entsprechende Beschriftung zurückgeben.

• Wenn ein Dict, sollte es Levels direkt auf Beschriftungen abbilden.

Der Standardwert ist die Verwendung eines Standard-ScalarFormatter.

manualbool oder iterierbar, Standard: False

Wenn True, werden Konturbeschriftungen manuell per Mausklick platziert. Klicken Sie mit der ersten Maustaste in die Nähe einer Kontur, um eine Beschriftung hinzuzufügen, klicken Sie mit der zweiten Maustaste (oder potenziell mit beiden Maustasten gleichzeitig), um das Hinzufügen von Beschriftungen abzuschließen. Die dritte Maustaste kann verwendet werden, um die zuletzt hinzugefügte Beschriftung zu entfernen, aber nur, wenn Beschriftungen nicht inline sind. Alternativ kann die Tastatur verwendet werden, um Beschriftungspositionen auszuwählen (Enter zum Beenden der Beschriftungsplatzierung, Löschen oder Rücktaste verhalten sich wie die dritte Maustaste, und jede andere Taste wählt eine Beschriftungsposition aus).

manual kann auch ein iterierbares Objekt von (x, y) Tupeln sein. Konturbeschriftungen werden erstellt, als ob die Maus an jeder (x, y) Position geklickt hätte.

rightside_upbool, Standard: True

Wenn True, werden die Beschriftungsrotationen immer um plus oder minus 90 Grad vom Level gedreht.

use_clabeltextbool, Standard: False

Wenn True, wird Text.set_transform_rotates_text verwendet, um sicherzustellen, dass die Beschriftungsrotation aktualisiert wird, wenn sich das Achsenverhältnis ändert.

zorderfloat oder None, Standard: (2 + contour.get_zorder())

zorder der Konturbeschriftungen.

Gibt zurück:

labels

Eine Liste von Text-Instanzen für die Beschriftungen.

get_text(lev, fmt)

Gibt den Text der Beschriftung zurück.

labels(inline, inline_spacing)

locate_label(linecontour, labelwidth)

Findet eine gute Stelle, um eine Beschriftung zu zeichnen (relativ flacher Teil der Kontur).

pop_label(index=-1)

Entfernt standardmäßig die letzte Beschriftung, kann aber jeder Index sein.

print_label(linecontour, labelwidth)

Gibt zurück, ob eine Kontur lang genug ist, um eine Beschriftung aufzunehmen.

remove()

too_close(x, y, lw)

Gibt zurück, ob sich bereits eine Beschriftung in dieser Nähe befindet.

class matplotlib.contour.ContourSet(ax, *args, levels=None, filled=False, linewidths=None, linestyles=None, hatches=(None,), alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, colorizer=None, extend='neither', antialiased=None, nchunk=0, locator=None, transform=None, negative_linestyles=None, clip_path=None, **kwargs)

Basiert auf: ContourLabeler, Collection

Speichert eine Menge von Konturlinien oder gefüllten Bereichen.

Vom Benutzer aufrufbar: clabel

Parameter:

axAxes

levels[level0, level1, ..., leveln]

Eine Liste von Gleitkommazahlen, die die Konturlevel angeben.

allsegs[level0segs, level1segs, ...]

Liste aller Polygonsegmente für alle levels. Für Konturlinien ist len(allsegs) == len(levels), und für gefüllte Konturbereiche ist len(allsegs) = len(levels)-1. Die Listen sollten wie folgt aussehen:

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkindsNone oder [level0kinds, level1kinds, ...]

Optionale Liste aller Polygon-Schematypen (Code-Typen), wie in Path beschrieben und verwendet. Dies wird verwendet, um mehrfach verbundene Pfade wie Löcher innerhalb gefüllter Polygone zu ermöglichen. Wenn nicht None, ist len(allkinds) == len(allsegs). Die Listen sollten wie folgt aussehen:

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

Wenn allkinds nicht None ist, werden normalerweise alle Polygone für ein bestimmtes Konturlevel gruppiert, sodass level0segs = [polygon0] und level0kinds = [polygon0kinds].

**kwargs

Schlüsselwortargumente sind wie im Docstring von contour beschrieben.

Attribute:

levelsarray

Die Werte der Konturlevel.

layersarray

Gleich wie levels für Linienkonturen; auf halbem Weg zwischen den Levels für gefüllte Konturen. Siehe ContourSet._process_colors.

Zeichnet Konturlinien oder gefüllte Bereiche, abhängig davon, ob das Schlüsselwortargument filled False (Standard) oder True ist.

Aufruf-Signatur

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parameter:

axAxes

Das zu zeichnende Axes-Objekt.

levels[level0, level1, ..., leveln]

Eine Liste von Gleitkommazahlen, die die Konturlevel angeben.

allsegs[level0segs, level1segs, ...]

Liste aller Polygonsegmente für alle levels. Für Konturlinien ist len(allsegs) == len(levels), und für gefüllte Konturbereiche ist len(allsegs) = len(levels)-1. Die Listen sollten wie folgt aussehen:

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds[level0kinds, level1kinds, ...], optional

Optionale Liste aller Polygon-Schematypen (Code-Typen), wie in Path beschrieben und verwendet. Dies wird verwendet, um mehrfach verbundene Pfade wie Löcher innerhalb gefüllter Polygone zu ermöglichen. Wenn nicht None, ist len(allkinds) == len(allsegs). Die Listen sollten wie folgt aussehen:

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

Wenn allkinds nicht None ist, werden normalerweise alle Polygone für ein bestimmtes Konturlevel gruppiert, sodass level0segs = [polygon0] und level0kinds = [polygon0kinds].

**kwargs

Schlüsselwortargumente sind wie im Docstring von contour beschrieben.

property allkinds

property allsegs

property alpha

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

draw(renderer)

Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (Artist.get_visible gibt False zurück).

Parameter:

rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

find_nearest_contour(x, y, indices=None, pixel=True)

Findet den Punkt im Konturdiagramm, der (x, y) am nächsten liegt.

Diese Methode unterstützt keine gefüllten Konturen.

Parameter:

x, yfloat

Der Referenzpunkt.

indicesListe von int oder None, Standard: None

Indizes der zu berücksichtigenden Konturlevel. Wenn None (Standard), werden alle Level berücksichtigt.

pixelbool, Standard: True

Wenn True, wird die Entfernung im Pixel (Bildschirm)-Raum gemessen, was für manuelle Konturbeschriftungen nützlich ist; andernfalls wird die Entfernung im Achsenraum gemessen.

Gibt zurück:

pathint

Der Index des Pfades, der (x, y) am nächsten liegt. Jeder Pfad entspricht einem Konturlevel.

subpathint

Der Index innerhalb dieses nächsten Pfades des Unterpfades, der (x, y) am nächsten liegt. Jeder Unterpfad entspricht einer ununterbrochenen Konturlinie.

indexint

Der Index der Vertices innerhalb dieses Unterpfades, die (x, y) am nächsten liegen.

xmin, yminfloat

Der Punkt im Konturdiagramm, der (x, y) am nächsten liegt.

d2float

Das quadrierte Entfernung von (xmin, ymin) zu (x, y).

get_transform()

Gibt die von diesem ContourSet verwendete Transform-Instanz zurück.

legend_elements(variable_name='x', str_format=<class 'str'>)

Gibt eine Liste von Künstlern und Beschriftungen zurück, die für die Weitergabe an legend geeignet sind und diesen ContourSet darstellen.

Die Beschriftungen haben die Form "0 < x <= 1" und geben die Datenbereiche an, die die Künstler darstellen.

Parameter:

variable_namestr

Die Zeichenkette, die innerhalb der Ungleichung für die Beschriftungen verwendet wird.

str_formatfunktion: float -> str

Funktion, die zum Formatieren der Zahlen in den Beschriftungen verwendet wird.

Gibt zurück:

artistsliste[Artist]

Eine Liste der Künstler.

labelsliste[str]

Eine Liste der Beschriftungen.

property linestyles

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	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
alpha	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
edgecolor oder ec oder edgecolors	Farbe oder Liste von Farben oder 'face'
facecolor oder facecolors oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder dashes oder linestyles oder ls	str oder Tupel oder Liste davon
linewidth oder linewidths oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

Klasse matplotlib.contour.QuadContourSet(ax, *args, levels=None, filled=False, linewidths=None, linestyles=None, hatches=(None,), alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, colorizer=None, extend='neither', antialiased=None, nchunk=0, locator=None, transform=None, negative_linestyles=None, clip_path=None, **kwargs)

Basen: ContourSet

Erstellt und speichert eine Menge von Konturlinien oder gefüllten Regionen.

Diese Klasse wird typischerweise nicht direkt vom Benutzer instanziiert, sondern von contour und contourf.

Attribute:

levelsarray

Die Werte der Konturlevel.

layersarray

Gleich wie levels für Linienkonturen; auf halbem Weg zwischen den Levels für gefüllte Konturen. Siehe ContourSet._process_colors.

Zeichnet Konturlinien oder gefüllte Bereiche, abhängig davon, ob das Schlüsselwortargument filled False (Standard) oder True ist.

Aufruf-Signatur

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parameter:

axAxes

Das zu zeichnende Axes-Objekt.

levels[level0, level1, ..., leveln]

Eine Liste von Gleitkommazahlen, die die Konturlevel angeben.

allsegs[level0segs, level1segs, ...]

Liste aller Polygonsegmente für alle levels. Für Konturlinien ist len(allsegs) == len(levels), und für gefüllte Konturbereiche ist len(allsegs) = len(levels)-1. Die Listen sollten wie folgt aussehen:

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds[level0kinds, level1kinds, ...], optional

Optionale Liste aller Polygon-Schematypen (Code-Typen), wie in Path beschrieben und verwendet. Dies wird verwendet, um mehrfach verbundene Pfade wie Löcher innerhalb gefüllter Polygone zu ermöglichen. Wenn nicht None, ist len(allkinds) == len(allsegs). Die Listen sollten wie folgt aussehen:

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

Wenn allkinds nicht None ist, werden normalerweise alle Polygone für ein bestimmtes Konturlevel gruppiert, sodass level0segs = [polygon0] und level0kinds = [polygon0kinds].

**kwargs

Schlüsselwortargumente sind wie im Docstring von contour beschrieben.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	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
alpha	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
edgecolor oder ec oder edgecolors	Farbe oder Liste von Farben oder 'face'
facecolor oder facecolors oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder dashes oder linestyles oder ls	str oder Tupel oder Liste davon
linewidth oder linewidths oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float