matplotlib.axis

Klassen für die Ticks und x- und y-Achsen.

Vererbung

Axis Objekte

class matplotlib.axis.Axis(axes, *, pickradius=15, clear=True)

Basisklasse für XAxis und YAxis.

Attribute:

isDefault_labelbool

axesAxes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

majorTicker

Bestimmt die Positionen der Haupt-Ticks und deren Label-Format.

minorTicker

Bestimmt die Positionen der Neben-Ticks und deren Label-Format.

callbacksCallbackRegistry

labelText

Die Achsenbeschriftung.

labelpadfloat

Der Abstand zwischen der Achsenbeschriftung und den Tick-Labels. Standardmäßig rcParams["axes.labelpad"] (Standardwert: 4.0).

offsetTextText

Ein Text-Objekt, das den Daten-Offset der Ticks (falls vorhanden) enthält.

pickradiusfloat

Der Akzeptanzradius für Containment-Tests.

majorTicksListe von Tick

Die Haupt-Ticks.

Warnung

Ticks sind nicht garantiert persistent. Verschiedene Operationen können Tick-Instanzen erstellen, löschen und modifizieren. Es besteht die unmittelbare Gefahr, dass Änderungen an einzelnen Ticks nicht erhalten bleiben, wenn Sie weiter an der Figur arbeiten (einschließlich des Schwenkens/Zooms auf einer angezeigten Figur).

Das Arbeiten an einzelnen Ticks ist eine Methode der letzten Instanz. Verwenden Sie stattdessen set_tick_params, wenn möglich.

minorTicksListe von Tick

Die Neben-Ticks.

Parameter:

axesAxes

Die Axes, zu denen die erstellte Achse gehört.

pickradiusfloat

Der Akzeptanzradius für Containment-Tests. Siehe auch Axis.contains.

clearbool, Standard: True

Ob die Achse bei der Erstellung gelöscht werden soll. Dies ist nicht erforderlich, z.B. beim Erstellen einer Achse als Teil einer Achseninstanz, da Axes.clear Axis.clear aufruft. .. versionadded:: 3.8

class matplotlib.axis.XAxis(*args, **kwargs)

Parameter:

axesAxes

Die Axes, zu denen die erstellte Achse gehört.

pickradiusfloat

Der Akzeptanzradius für Containment-Tests. Siehe auch Axis.contains.

clearbool, Standard: True

Ob die Achse bei der Erstellung gelöscht werden soll. Dies ist nicht erforderlich, z.B. beim Erstellen einer Achse als Teil einer Achseninstanz, da Axes.clear Axis.clear aufruft. .. versionadded:: 3.8

class matplotlib.axis.YAxis(*args, **kwargs)

Parameter:

axesAxes

Die Axes, zu denen die erstellte Achse gehört.

pickradiusfloat

Der Akzeptanzradius für Containment-Tests. Siehe auch Axis.contains.

clearbool, Standard: True

Ob die Achse bei der Erstellung gelöscht werden soll. Dies ist nicht erforderlich, z.B. beim Erstellen einer Achse als Teil einer Achseninstanz, da Axes.clear Axis.clear aufruft. .. versionadded:: 3.8

class matplotlib.axis.Ticker

Ein Container für die Objekte, die die Position und das Format von Ticks definieren.

Attribute:

locatorLocator Unterklasse

Bestimmt die Positionen der Ticks.

formatterFormatter Unterklasse

Bestimmt das Format der Tick-Labels.

Axis.clear	Löscht die Achse.
Axis.get_scale	Gibt die Skala dieser Achse (als String) zurück.

Formatierer und Lokalisierer

Axis.get_major_formatter	Ruft den Formatierer des Haupt-Tickers ab.
Axis.get_major_locator	Ruft den Lokalisierer des Haupt-Tickers ab.
Axis.get_minor_formatter	Ruft den Formatierer des Neben-Tickers ab.
Axis.get_minor_locator	Ruft den Lokalisierer des Neben-Tickers ab.
Axis.set_major_formatter	Setzt den Formatierer des Haupt-Tickers.
Axis.set_major_locator	Setzt den Lokalisierer des Haupt-Tickers.
Axis.set_minor_formatter	Setzt den Formatierer des Neben-Tickers.
Axis.set_minor_locator	Setzt den Lokalisierer des Neben-Tickers.
Axis.remove_overlapping_locs	Wenn Neben-Ticker-Positionen, die mit Haupt-Ticker-Positionen überlappen, abgeschnitten werden sollen.
Axis.get_remove_overlapping_locs
Axis.set_remove_overlapping_locs

Achsenbeschriftung

Axis.label	Das Text-Objekt der Achsenbeschriftung.
Axis.set_label_coords	Setzt die Koordinaten der Beschriftung.
Axis.set_label_position	Setzt die Position der Beschriftung (oben oder unten)
Axis.set_label_text	Setzt den Textwert der Achsenbeschriftung.
Axis.get_label_position	Gibt die Position der Beschriftung zurück (oben oder unten)
Axis.get_label_text	Gibt den Text der Beschriftung zurück.

Ticks, Tick-Beschriftungen und Offset-Text

Axis.get_major_ticks	Gibt die Liste der Haupt-Ticks zurück.
Axis.get_majorticklabels	Gibt die Haupt-Tick-Labels dieser Achse als Liste von Text zurück.
Axis.get_majorticklines	Gibt die Haupt-Tick-Linien dieser Achse als Liste von Line2Ds zurück.
Axis.get_majorticklocs	Gibt die Positionen der Haupt-Ticks dieser Achse in Datenkoordinaten zurück.
Axis.get_minor_ticks	Gibt die Liste der Neben-Ticks zurück.
Axis.get_minorticklabels	Gibt die Neben-Tick-Labels dieser Achse als Liste von Text zurück.
Axis.get_minorticklines	Gibt die Neben-Tick-Linien dieser Achse als Liste von Line2Ds zurück.
Axis.get_minorticklocs	Gibt die Positionen der Neben-Ticks dieser Achse in Datenkoordinaten zurück.
Axis.get_offset_text	Gibt den Achsen-Offset-Text als Text-Instanz zurück.
Axis.get_tick_padding
Axis.get_tick_params	Ruft Erscheinungsparameter für Ticks, Tick-Labels und Gitterlinien ab.
Axis.get_ticklabels	Ruft die Tick-Labels dieser Achse ab.
Axis.get_ticklines	Gibt die Tick-Linien dieser Achse als Liste von Line2Ds zurück.
Axis.get_ticklocs	Gibt die Tick-Positionen dieser Achse in Datenkoordinaten zurück.
Axis.get_gridlines	Gibt die Gitterlinien dieser Achse als Liste von Line2Ds zurück.
Axis.grid	Konfiguriert die Gitterlinien.
Axis.set_tick_params	Setzt Erscheinungsparameter für Ticks, Tick-Labels und Gitterlinien.
Axis.axis_date	Konfiguriert Ticks und Labels der Achse so, dass die Daten entlang dieser Achse als Daten behandelt werden.
Axis.minorticks_off	Entfernt Neben-Ticks von der Achse.
Axis.minorticks_on	Zeigt standardmäßige Neben-Ticks auf der Achse an, abhängig von der Skala (get_scale).

Daten- und Ansichtsintervalle

Axis.get_data_interval	Gibt die Datenlimits (min, max) dieser Achse zurück.
Axis.get_view_interval	Gibt die Ansichtslimits (min, max) dieser Achse zurück.
Axis.get_inverted	Gibt zurück, ob diese Achse in der "invertierten" Richtung orientiert ist.
Axis.set_data_interval	Setzt die Datenlimits der Achse.
Axis.set_view_interval	Setzt die Ansichtslimits der Achse.
Axis.set_inverted	Setzt, ob diese Achse in der "invertierten" Richtung orientiert ist.

Rendering-Hilfen

Axis.get_minpos
Axis.get_tick_space	Gibt die geschätzte Anzahl von Ticks zurück, die auf die Achse passen.
Axis.get_tightbbox	Gibt eine Bounding Box zurück, die die Achse umschließt.

Interaktiv

Axis.contains	Testet, ob der Künstler das Mausereignis enthält.
Axis.pickradius	Der Akzeptanzradius für Containment-Tests.
Axis.get_pickradius	Gibt die Tiefe der Achse zurück, die vom Picker verwendet wird.
Axis.set_pickradius	Setzt die Tiefe der Achse, die vom Picker verwendet wird.

Einheiten

Axis.convert_units
Axis.set_units	Setzt die Einheiten für die Achse.
Axis.get_units	Gibt die Einheiten für die Achse zurück.
Axis.set_converter	Setzt den Einheitenkonverter für die Achse.
Axis.get_converter	Ruft den Einheitenkonverter für die Achse ab.
Axis.update_units	Untersucht Daten auf Einheitenkonverter und aktualisiert die axis.get_converter Instanz bei Bedarf.

X-Achse Spezifisch

XAxis.axis_name	Schreibgeschützter Name, der die Achse identifiziert.
XAxis.get_ticks_position	Gibt die Position der Ticks zurück ("top", "bottom", "default" oder "unknown").
XAxis.set_ticks_position	Setzt die Position der Ticks.
XAxis.set_label_position	Setzt die Position der Beschriftung (oben oder unten)
XAxis.tick_bottom	Bewegt Ticks und Tick-Labels (falls vorhanden) an die Unterseite der Achseninstanz.
XAxis.tick_top	Bewegt Ticks und Tick-Labels (falls vorhanden) an die Oberseite der Achseninstanz.

Y-Achse Spezifisch

YAxis.axis_name	Schreibgeschützter Name, der die Achse identifiziert.
YAxis.get_ticks_position	Gibt die Position der Ticks zurück ("left", "right", "default" oder "unknown").
YAxis.set_offset_position
YAxis.set_ticks_position	Setzt die Position der Ticks.
YAxis.set_label_position	Setzt die Position der Beschriftung (links oder rechts)
YAxis.tick_left	Bewegt Ticks und Tick-Labels (falls vorhanden) an die linke Seite der Achseninstanz.
YAxis.tick_right	Bewegt Ticks und Tick-Labels (falls vorhanden) an die rechte Seite der Achseninstanz.

Andere

Axis.OFFSETTEXTPAD
Axis.axes	Die Axes-Instanz, in der sich der Artist befindet, oder None.
Axis.limit_range_for_scale	Gibt den Bereich *vmin*, *vmax* zurück, der auf die vom aktuellen Skalentyp unterstützte Domäne beschränkt ist.
Axis.reset_ticks	Initialisiert die Listen der Haupt- und Neben-Ticks neu.
Axis.set_clip_path	Legt den Beschneidungspfad des Artists fest.
Axis.set_default_intervals	Setzt die Standardgrenzen für das Daten- und Ansichtsintervall der Achse, wenn sie noch nicht geändert wurden.

Abgeraten

Diese Methoden sollten mit Vorsicht zusammen verwendet werden. Rufen Sie set_ticks auf, um die gewünschten Tick-Positionen anzugeben, **bevor** Sie set_ticklabels aufrufen, um eine passende Reihe von Labels anzugeben. Das Aufrufen von set_ticks erstellt einen FixedLocator; seine Positionsliste wird dann von set_ticklabels verwendet, um einen geeigneten FuncFormatter zu erstellen.

Axis.get_label	Gibt die Achsenbeschriftung als Text-Instanz zurück.
Axis.set_label	Das Zuweisen von Legenden-Labels wird nicht unterstützt.
Axis.set_ticks	Setzt die Tick-Positionen dieser Achse und optional Tick-Labels.
Axis.set_ticklabels	[Abgeraten] Setzt die Tick-Labels dieser Achse mit einer Liste von String-Labels.

Tick Objekte

class matplotlib.axis.Tick(axes, loc, *, size=None, width=None, color=None, tickdir=None, pad=None, labelsize=None, labelcolor=None, labelfontfamily=None, zorder=None, gridOn=None, tick1On=True, tick2On=True, label1On=True, label2On=False, major=True, labelrotation=0, grid_color=None, grid_linestyle=None, grid_linewidth=None, grid_alpha=None, **kwargs)

Abstrakte Basisklasse für die Achsen-Ticks, Gitterlinien und Labels.

Ticks markieren eine Position auf einer Achse. Sie enthalten zwei Linien als Markierungen und zwei Labels; eine für die untere und eine für die obere Position (bei einer XAxis) oder für die linke und rechte Position (bei einer YAxis).

Attribute:

tick1lineLine2D

Die linke/untere Tick-Markierung.

tick2lineLine2D

Die rechte/obere Tick-Markierung.

gridlineLine2D

Die Gitterlinie, die der Label-Position zugeordnet ist.

label1Text

Das linke/untere Tick-Label.

label2Text

Das rechte/obere Tick-Label.

bbox ist die Bound2D Bounding Box in Anzeige-Koordinaten der Achsenloc ist die Tick-Position in Datenkoordinaten size ist die Tick-Größe in Punkten

class matplotlib.axis.XTick(*args, **kwargs)

Enthält alle Künstler, die für einen X-Tick benötigt werden – die Tick-Linie, den Label-Text und die Gitterlinie.

bbox ist die Bound2D Bounding Box in Anzeige-Koordinaten der Achsenloc ist die Tick-Position in Datenkoordinaten size ist die Tick-Größe in Punkten

class matplotlib.axis.YTick(*args, **kwargs)

Enthält alle Künstler, die für einen Y-Tick benötigt werden – die Tick-Linie, den Label-Text und die Gitterlinie.

bbox ist die Bound2D Bounding Box in Anzeige-Koordinaten der Achsenloc ist die Tick-Position in Datenkoordinaten size ist die Tick-Größe in Punkten

Tick.get_loc	Gibt die Tick-Position (Datenkoordinaten) als Skalar zurück.
Tick.get_pad	Ruft den Wert des Tick-Label-Pads in Punkten ab.
Tick.get_tick_padding	Ruft die Länge des Ticks außerhalb der Achseninstanz ab.
Tick.get_tickdir
Tick.get_view_interval	Gibt die Ansichtslimits (min, max) der Achse zurück, zu der der Tick gehört.
Tick.set_clip_path	Legt den Beschneidungspfad des Artists fest.
Tick.set_pad	Setzt den Tick-Label-Pad in Punkten.
Tick.set_url	Setzt die URL von label1 und label2.
Tick.update_position	Setzt die Position des Ticks in Datenkoordinaten mit dem Skalar *loc*.