matplotlib.ticker
#
Häkchen finden und formatieren #
Dieses Modul enthält Klassen zum Konfigurieren der Lokalisierung und Formatierung von Ticks. Generische Tick-Locators und -Formatierer werden bereitgestellt, ebenso wie domänenspezifische benutzerdefinierte.
Obwohl die Locators nichts über große oder kleine Ticks wissen, werden sie von der Axis-Klasse verwendet, um das Auffinden und Formatieren von großen und kleinen Ticks zu unterstützen.
Kreuzen Sie die Lokalisierung an #
Die Locator-Klasse ist die Basisklasse für alle Tick-Locators. Die Positionsgeber handhaben die automatische Skalierung der Ansichtsbegrenzungen basierend auf den Datenbegrenzungen und die Auswahl von Tick-Positionen. Ein nützlicher halbautomatischer Zeckenfinder ist
MultipleLocator
. Es wird mit einer Basis initialisiert, z. B. 10, und es wählt Achsengrenzen und Ticks aus, die Vielfache dieser Basis sind.
Die hier definierten Locator-Unterklassen sind:
|
|
Findet bis zu einer maximalen Anzahl von Intervallen mit Häkchen an schönen Stellen. |
|
Space tickt gleichmäßig von min bis max. |
|
Space tickt logarithmisch von min nach max. |
|
Ticks und Range sind ein Vielfaches der Basis; entweder Integer oder Float. |
|
Zeckenpositionen sind festgelegt. |
|
Locator für Indexplots (z. B. wo
). |
|
Keine Zecken. |
|
Locator zur Verwendung mit der Symlog-Norm; funktioniert wie
|
|
Locator zur Verwendung mit der Asinh-Norm, der versucht, Ticks ungefähr gleichmäßig zu verteilen. |
|
Locator für Logit-Skalierung. |
|
Locator für kleine Teilstriche, wenn die Achse linear ist und die großen Teilstriche gleichmäßig beabstandet sind. Unterteilt das große Tick-Intervall in eine bestimmte Anzahl kleinerer Intervalle, standardmäßig 4 oder 5, abhängig vom großen Intervall. |
Es gibt eine Reihe von Locators, die auf Datumsorte spezialisiert sind - siehe dates
Modul.
Sie können Ihren eigenen Locator definieren, indem Sie von Locator ableiten. Sie müssen die __call__
Methode überschreiben, die eine Folge von Positionen zurückgibt, und wahrscheinlich möchten Sie die Methode für die automatische Skalierung überschreiben, um die Anzeigebeschränkungen von den Datenbeschränkungen festzulegen.
Wenn Sie den Standard-Locator überschreiben möchten, verwenden Sie einen der obigen oder einen benutzerdefinierten Locator und übergeben Sie ihn an die Instanz der x- oder y-Achse. Die relevanten Methoden sind:
ax.xaxis.set_major_locator(xmajor_locator)
ax.xaxis.set_minor_locator(xminor_locator)
ax.yaxis.set_major_locator(ymajor_locator)
ax.yaxis.set_minor_locator(yminor_locator)
Der voreingestellte Minor-Locator ist NullLocator
, dh standardmäßig sind keine Minor-Ticks aktiviert.
Notiz
Locator
-Instanzen sollten nicht mit mehr als einem
Axis
oder verwendet werden Axes
. Also statt:
locator = MultipleLocator(5)
ax.xaxis.set_major_locator(locator)
ax2.xaxis.set_major_locator(locator)
mach stattdessen folgendes:
ax.xaxis.set_major_locator(MultipleLocator(5))
ax2.xaxis.set_major_locator(MultipleLocator(5))
Formatierung ankreuzen #
Die Tick-Formatierung wird durch von Formatter abgeleitete Klassen gesteuert. Der Formatierer arbeitet mit einem einzelnen Tick-Wert und gibt eine Zeichenkette an die Achse zurück.
Keine Etiketten auf den Zecken. |
|
Legen Sie die Zeichenfolgen für die Labels manuell fest. |
|
Benutzerdefinierte Funktion legt die Etiketten fest. |
|
Verwenden Sie die String- |
|
Verwenden Sie eine sprintf-Formatzeichenfolge im alten Stil. |
|
Standardformatierer für Skalare: Automatische Auswahl der Formatzeichenfolge. |
|
Formatierer für Log-Achsen. |
|
Formatieren Sie Werte für die Log-Achse mit
. |
|
Formatieren Sie Werte für die Log-Achse mithilfe
von mathematischem Text. |
|
Werte für die logarithmische Achse in wissenschaftlicher Notation formatieren. |
|
Wahrscheinlichkeitsformatierer. |
|
Formatieren Sie Etiketten in technischer Notation. |
|
Etiketten als Prozentsatz formatieren. |
Sie können Ihren eigenen Formatierer von der Formatter-Basisklasse ableiten, indem Sie einfach die __call__
Methode überschreiben. Die Formatiererklasse hat Zugriff auf die Achsenansicht und die Datengrenzen.
Verwenden Sie eine der folgenden Methoden, um die Beschriftungsformate für Haupt- und Nebenstriche zu steuern:
ax.xaxis.set_major_formatter(xmajor_formatter)
ax.xaxis.set_minor_formatter(xminor_formatter)
ax.yaxis.set_major_formatter(ymajor_formatter)
ax.yaxis.set_minor_formatter(yminor_formatter)
Neben einer Formatter
Instanz akzeptieren set_major_formatter
und
auch eine oder-Funktion. input wird intern durch eine automatisch generierte mit der input ersetzt . Für die Funktionseingabe wird ein mit der Eingabefunktion generiert und verwendet.set_minor_formatter
str
str
StrMethodFormatter
str
FuncFormatter
Ein Beispiel für das Setzen von großen und kleinen Ticks finden Sie unter Major and Minor Ticks . matplotlib.dates
Weitere Informationen und Beispiele zur Verwendung von Datumslokatoren und -formatierern finden Sie im Modul.
- Klasse matplotlib.ticker. AsinhLocator ( linear_width , numticks = 11 , symthresh = 0.2 , base = 10 , subs = None ) [Quelle] #
Basen:
Locator
Ein auf die Invers-Sinh-Skala spezialisierter Achsen-Tick-Locator
Es ist sehr unwahrscheinlich, dass dies über den
AsinhScale
Unterricht hinaus einen Nutzen hat.Notiz
Diese API ist vorläufig und kann in Zukunft basierend auf frühem Benutzerfeedback überarbeitet werden.
- Parameter :
- linear_width Float
Der Skalierungsparameter, der die Ausdehnung des quasi-linearen Bereichs definiert.
- numticks int, Standard: 11
Die ungefähre Anzahl der Hauptstriche, die entlang der gesamten Achse passen
- Symthresh- Float, Standard: 0,2
Der Teilschwellenwert, unter dem Daten, die einen Bereich abdecken, der ungefähr symmetrisch um Null ist, Ticks haben, die genau symmetrisch sind.
- Basis int, Standard: 10
Die Zahlenbasis, die zum Runden von Tick-Positionen auf einer logarithmischen Skala verwendet wird. Wenn dieser kleiner als eins ist, wird auf das nächste ganzzahlige Vielfache von Zehnerpotenzen gerundet.
- Sub- Tupel, Standard: Keine
Vielfache der Zahlenbasis, typischerweise verwendet für die kleinen Ticks, zB (2, 5) wenn Basis=10.
- set_params ( numticks = None , symthresh = None , base = None , subs = None ) [Quelle] #
Legen Sie Parameter innerhalb dieses Locators fest.
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. AutoLocator [Quelle] #
Basen:
MaxNLocator
Finden Sie dynamisch wichtige Tick-Positionen. Dies ist eigentlich eine Unterklasse von
MaxNLocator
, mit den Parametern nbins = 'auto' und steps = [1, 2, 2.5, 5, 10] .Um die Werte der nicht-öffentlichen Parameter zu erfahren, werfen Sie bitte einen Blick auf die Standardwerte von
MaxNLocator
.
- Klasse matplotlib.ticker. AutoMinorLocator ( n = None ) [Quelle] #
Basen:
Locator
Finden Sie dynamisch kleine Tick-Positionen basierend auf den Positionen von großen Ticks. Die Skala muss linear sein mit gleichmäßig verteilten Hauptstrichen.
n ist die Anzahl der Unterteilungen des Intervalls zwischen großen Ticks; zB n=2 platziert einen einzelnen kleinen Tick in der Mitte zwischen großen Ticks.
Wenn n weggelassen wird oder None ist, wird es auf 5 oder 4 gesetzt.
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. EngFormatter ( unit = '' , places = None , sep = ' ' , * , usetex = None , useMathText = None ) [source] #
Basen:
Formatter
Formatieren Sie Achsenwerte mit technischen Präfixen, um Potenzen von 1000 plus einer bestimmten Einheit darzustellen, z. B. 10 MHz anstelle von 1e7.
- Parameter :
- Einheit str, Standard: ""
Zu verwendendes Einheitensymbol, geeignet für die Verwendung mit Einzelbuchstabendarstellungen von Potenzen von 1000. Zum Beispiel „Hz“ oder „m“.
- stellt int, Standard: Keine
Genauigkeit, mit der die Zahl angezeigt werden soll, angegeben in Ziffern nach dem Dezimalkomma (es gibt zwischen einer und drei Ziffern vor dem Dezimalkomma). Wenn es None ist, greift die Formatierung auf das Fließkommaformat '%g' zurück, das bis zu 6 signifikante Stellen anzeigt, dh der äquivalente Wert für Stellen variiert zwischen 0 und 5 (einschließlich).
- sep str, Standard: " "
Trennzeichen, das zwischen dem Wert und dem Präfix/der Einheit verwendet wird. Zum Beispiel erhält man „3,14 mV“, wenn
sep
„ “ (Standard) ist, und „ 3,14 mV“, wennsep
„“ ist. Neben dem Standardverhalten können einige andere nützliche Optionen sein:sep=""
Präfix/Einheit direkt an den Wert anhängen;sep="\N{THIN SPACE}"
(U+2009
);sep="\N{NARROW NO-BREAK SPACE}"
(U+202F
);sep="\N{NO-BREAK SPACE}"
(U+00A0
).
- usetex bool, Standard:
rcParams["text.usetex"]
(Standard:False
) Zum Aktivieren/Deaktivieren der Verwendung des mathematischen Modus von TeX zum Rendern der Zahlen im Formatierer.
- useMathText bool, Standard:
rcParams["axes.formatter.use_mathtext"]
(Standard:False
) Um die Verwendung von mathtext zum Rendern der Zahlen im Formatierer zu aktivieren/deaktivieren.
- ENG_PREFIXES = {-24: 'y', -21: 'z', -18: 'a', -15: 'f', -12: 'p', -9: 'n', -6: 'µ ', -3: 'm', 0: '', 3: 'k', 6: 'M', 9: 'G', 12: 'T', 15: 'P', 18: 'E', 21: 'Z', 24: 'Y'} #
- format_eng ( num ) [Quelle] #
Formatieren Sie eine Zahl in technischer Notation, indem Sie einen Buchstaben anhängen, der die Potenz von 1000 der ursprünglichen Zahl darstellt. Einige Beispiele:
>>> format_eng(0) # for self.places = 0 '0'
>>> format_eng(1000000) # for self.places = 1 '1.0 M'
>>> format_eng("-1e-6") # for self.places = 2 '-1.00 µ'
- Eigenschaft useMathText #
- Eigenschaft usetex #
- Klasse matplotlib.ticker. FixedFormatter ( seq ) [Quelle] #
Basen:
Formatter
Gibt feste Zeichenfolgen für Tick-Labels zurück, die nur auf der Position basieren, nicht auf dem Wert.
Notiz
FixedFormatter
sollte nur zusammen mit verwendet werdenFixedLocator
. Andernfalls können die Etiketten an unerwarteten Positionen landen.Legen Sie die Sequenzsequenz von Zeichenfolgen fest, die für Beschriftungen verwendet werden.
- Klasse matplotlib.ticker. FixedLocator ( locs , nbins = None ) [Quelle] #
Basen:
Locator
Zeckenpositionen sind festgelegt. Wenn nbins nicht None ist, wird das Array möglicher Positionen unterabgetastet, um die Anzahl der Ticks <= nbins +1 zu halten. Die Unterabtastung wird so durchgeführt, dass sie den kleinsten Absolutwert enthält; Wenn zum Beispiel Null im Array der Möglichkeiten enthalten ist, dann ist es garantiert einer der ausgewählten Ticks.
- Klasse matplotlib.ticker. FormatStrFormatter ( fmt ) [Quelle] #
Basen:
Formatter
Verwenden Sie eine Formatzeichenfolge im alten Stil ('%'-Operator), um das Tick zu formatieren.
Die Formatzeichenfolge sollte ein einzelnes Variablenformat (%) enthalten. Es wird auf den Wert (nicht die Position) des Ticks angewendet.
Negative numerische Werte verwenden einen Bindestrich, kein Unicode-Minus; Verwenden Sie mathtext, um ein Unicode-Minus zu erhalten, indem Sie den Formatbezeichner mit $ umschließen (z. B. "$%g$").
- Klasse matplotlib.ticker. Formatierer [Quelle] #
Basen:
TickHelper
Erstellen Sie eine Zeichenfolge basierend auf einem Tick-Wert und einer Position.
- statisch fix_minus ( s ) [Quelle] #
Einige Klassen möchten möglicherweise einen Bindestrich für Minus durch das richtige Unicode-Symbol (U + 2212) für typografische Korrektheit ersetzen. Dies ist eine Hilfsmethode, um eine solche Ersetzung durchzuführen, wenn sie über aktiviert ist
rcParams["axes.unicode_minus"]
(Standard:True
).
- format_data ( wert ) [Quelle] #
Gibt die vollständige Zeichenfolgendarstellung des Werts ohne Angabe der Position zurück.
- format_data_short ( wert ) [Quelle] #
Gibt eine kurze Zeichenfolgenversion des Tick-Werts zurück.
Standardmäßig der positionsunabhängige Long-Wert.
- locs = [] #
- Klasse matplotlib.ticker. FuncFormatter ( func ) [Quelle] #
Basen:
Formatter
Verwenden Sie eine benutzerdefinierte Funktion zur Formatierung.
Die Funktion sollte zwei Eingaben annehmen (einen Tick-Wert
x
und eine Positionpos
) und einen String zurückgeben, der das entsprechende Tick-Label enthält.
- Klasse matplotlib.ticker. IndexLocator ( Basis , Offset ) [Quelle] #
Basen:
Locator
Setzen Sie ein Häkchen auf jedes Vielfache einer bestimmten Grundzahl von Punkten, z. B. auf jeden fünften Punkt. Es wird davon ausgegangen, dass Sie Indexplots durchführen; dh die Achse ist 0, len(data). Dies ist hauptsächlich für x Ticks nützlich.
Platzieren Sie Ticks an jedem Basisdatenpunkt , beginnend bei offset .
- set_params ( base = None , offset = None ) [Quelle] #
Legen Sie Parameter innerhalb dieses Locators fest
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. LinearLocator ( numticks = None , Presets = None ) [Quelle] #
Basen:
Locator
Bestimmen Sie die Zeckenpositionen
Wenn diese Funktion zum ersten Mal aufgerufen wird, versucht sie, die Anzahl der Ticks festzulegen, um eine schöne Tick-Partitionierung zu erreichen. Danach wird die Anzahl der Häkchen festgelegt, damit die interaktive Navigation schön wird
Verwenden Sie Voreinstellungen, um Loks basierend auf Lom festzulegen. Ein Diktat, das vmin, vmax->locs zuordnet
- Eigenschaft Nummernzeichen #
- set_params ( numticks = None , presets = None ) [source] #
Legen Sie Parameter innerhalb dieses Locators fest.
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. Locator [Quelle] #
Basen:
TickHelper
Bestimmen Sie die Tick-Positionen;
Beachten Sie, dass derselbe Locator nicht für mehrere verwendet werden sollte,
Axis
da der Locator Verweise auf die Achsendaten und Anzeigegrenzen speichert.- MAXTICKS = 1000 #
- Nichtsingular ( v0 , v1 ) [Quelle] #
Passen Sie einen Bereich nach Bedarf an, um Singularitäten zu vermeiden.
Diese Methode wird während der automatischen Skalierung aufgerufen, wobei die Datengrenzen für die Achsen festgelegt werden, wenn die Achsen Daten enthalten oder nicht.
(v0, v1)
(-inf, +inf)
Wenn (möglicherweise bis zu einem gewissen Fließkommaabfall), gibt diese Methode ein erweitertes Intervall um diesen Wert zurück.
v0 == v1
Wenn , gibt diese Methode geeignete Standardansichtsgrenzen zurück.
(v0, v1) == (-inf, +inf)
Andernfalls wird unverändert zurückgegeben.
(v0, v1)
- raise_if_exceeds ( locs ) [Quelle] #
Protokollieren Sie auf WARNING-Ebene, wenn locs länger als ist
Locator.MAXTICKS
.Dies soll unmittelbar vor der Rückgabe von locs aufgerufen
__call__
werden , um Benutzer zu informieren, falls ihr Locator eine große Anzahl von Ticks zurückgibt, wodurch Matplotlib nicht mehr genügend Speicher zur Verfügung steht.Der "seltsame" Name dieser Methode stammt aus der Zeit, als sie eine Ausnahme auslöste, anstatt ein Protokoll auszugeben.
- set_params ( ** kwargs ) [Quelle] #
Nichts tun und eine Warnung aussprechen. Jede Locator-Klasse, die die Funktion set_params() nicht unterstützt, ruft dies auf.
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. LogFormatter ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None ) [Quelle] #
Basen:
Formatter
Basisklasse zum Formatieren von Ticks auf einer Log- oder Symlog-Skala.
Es kann direkt instanziiert oder in Unterklassen umgewandelt werden.
- Parameter :
- Basisfloat , Standard: 10.
Basis des in allen Berechnungen verwendeten Logarithmus.
- labelOnlyBase bool, Standard: False
Wenn True, markiert Ticks nur bei ganzzahligen Potenzen der Basis. Dies ist normalerweise True für große Ticks und False für kleinere Ticks.
- minor_thresholds (Teilmenge, alle), Standard: (1, 0,4)
Wenn labelOnlyBase False ist, steuern diese beiden Zahlen die Kennzeichnung von Ticks, die keine ganzzahligen Potenzen der Basis sind; Normalerweise sind dies die kleinen Ticks. Der steuernde Parameter ist das Protokoll des Achsendatenbereichs. In dem typischen Fall, in dem die Basis 10 ist, ist dies die Anzahl der Dekaden, die von der Achse überspannt werden, also können wir sie „numdez“ nennen. Wenn , werden alle kleinen Ticks beschriftet. Wenn , dann wird nur eine Teilmenge kleiner Ticks beschriftet, um eine Überfüllung zu vermeiden. Wenn dann keine kleinen Häkchen markiert werden.
numdec <= all
all < numdec <= subset
numdec > subset
- linthresh Keine oder Float, Standard: Keine
Wenn eine symmetrische logarithmische Skalierung verwendet wird,
linthresh
muss ihr Parameter hier angegeben werden.
Anmerkungen
Die
set_locs
Methode muss aufgerufen werden, um die durch denminor_thresholds
Parameter gesteuerte Subsetting-Logik zu aktivieren.In einigen Fällen, wie z. B. dem Farbbalken, gibt es keine Unterscheidung zwischen großen und kleinen Ticks; Die Tick-Positionen können manuell gesetzt werden oder durch einen Lokalisierer, der Ticks bei ganzzahligen Potenzen der Basis und an Zwischenpositionen setzt. Deaktivieren Sie für diese Situation die Logik minor_thresholds mithilfe von , sodass alle Ticks beschriftet werden.
minor_thresholds=(np.inf, np.inf)
Verwenden Sie , um die Kennzeichnung kleiner Ticks zu deaktivieren, wenn „labelOnlyBase“ False ist . Dies ist die Voreinstellung für den "klassischen" Stil.
minor_thresholds=(0, 0)
Beispiele
Verwenden Sie , um eine Teilmenge kleiner Teilstriche zu beschriften, wenn die Ansichtsgrenzen bis zu 2 Dekaden umfassen, und alle Teilstriche, wenn Sie auf 0,5 Dekaden oder weniger hineinzoomen .
minor_thresholds=(2, 0.5)
Verwenden Sie , um alle kleineren Ticks zu beschriften, wenn die Anzeigegrenzen bis zu 1,5 Dekaden umfassen .
minor_thresholds=(1.5, 1.5)
- Basis ( Basis ) [Quelle] #
[ Veraltet ] Ändern Sie die Basis für die Beschriftung.
Warnung
Sollte immer mit der verwendeten Basis übereinstimmen
LogLocator
Anmerkungen
Veraltet seit Version 3.6: Verwenden Sie stattdessen set_base().
- format_data ( wert ) [Quelle] #
Gibt die vollständige Zeichenfolgendarstellung des Werts ohne Angabe der Position zurück.
- format_data_short ( wert ) [Quelle] #
Gibt eine kurze Zeichenfolgenversion des Tick-Werts zurück.
Standardmäßig der positionsunabhängige Long-Wert.
- label_minor ( labelOnlyBase ) [Quelle] #
[ Veraltet ] Schalten Sie die Markierung kleiner Ticks ein oder aus.
- Parameter :
- labelOnlyBase bool
Wenn True, markiert Ticks nur bei ganzzahligen Potenzen der Basis.
Anmerkungen
Veraltet seit Version 3.6: Verwenden Sie stattdessen set_label_minor().
- set_base ( Basis ) [Quelle] #
Ändern Sie die Basis für die Beschriftung.
Warnung
Sollte immer mit der verwendeten Basis übereinstimmen
LogLocator
- Klasse matplotlib.ticker. LogFormatterExponent ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None ) [Quelle] #
Basen:
LogFormatter
Formatieren Sie Werte für die Log-Achse mit .
exponent = log_base(value)
- Klasse matplotlib.ticker. LogFormatterMathtext ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None ) [Quelle] #
Basen:
LogFormatter
Formatieren Sie Werte für die Log-Achse mit .
exponent = log_base(value)
- Klasse matplotlib.ticker. LogFormatterSciNotation ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None ) [Quelle] #
Basen:
LogFormatterMathtext
Formatieren Sie Werte nach wissenschaftlicher Notation in einer logarithmischen Achse.
- Klasse matplotlib.ticker. LogLocator ( base = 10.0 , subs = (1.0,) , numdecs = 4 , numticks = None ) [Quelle] #
Basen:
Locator
Bestimmen Sie die Tick-Positionen für Log-Achsen
Kreuzen Sie die Stellen an: subs[j] * base**i
- Parameter :
- Basisfloat , Standard: 10,0
Die Basis des verwendeten Protokolls, also werden große Ticks bei
base**n
, n Integer platziert.- subs None oder str oder Float-Folge, Standard: (1.0,)
Gibt die Vielfachen ganzzahliger Potenzen der Basis an, an der Ticks platziert werden. Die Standardeinstellung platziert Ticks nur bei ganzzahligen Potenzen der Basis. Die zulässigen Zeichenfolgenwerte sind
'auto'
und'all'
, die beide einen Algorithmus verwenden, der auf den Grenzen der Achsenansicht basiert, um zu bestimmen, ob und wie Häkchen zwischen ganzzahligen Potenzen der Basis gesetzt werden. Bei'auto'
werden Ticks nur zwischen ganzzahligen Potenzen gesetzt; mit'all'
werden die ganzzahligen Potenzen eingeschlossen. Der Wert None entspricht'auto'
.- numticks Keine oder int, Standard: Keine
Die maximal zulässige Anzahl von Ticks auf einer bestimmten Achse. Die Voreinstellung von
None
versucht, intelligent zu wählen, solange dieser Locator bereits einer Achse mit zugewiesenget_tick_space
wurde, fällt aber ansonsten auf 9 zurück.
- Basis ( Basis ) [Quelle] #
[ Veraltet ] Legen Sie die Protokollbasis fest (großer Tick alle
base**i
, i ganze Zahl).Anmerkungen
Veraltet seit Version 3.6: Verwenden Sie stattdessen set_params(base=...).
- Nichtsingular ( vmin , vmax ) [Quelle] #
Passen Sie einen Bereich nach Bedarf an, um Singularitäten zu vermeiden.
Diese Methode wird während der automatischen Skalierung aufgerufen, wobei die Datengrenzen für die Achsen festgelegt werden, wenn die Achsen Daten enthalten oder nicht.
(v0, v1)
(-inf, +inf)
Wenn (möglicherweise bis zu einem gewissen Fließkommaabfall), gibt diese Methode ein erweitertes Intervall um diesen Wert zurück.
v0 == v1
Wenn , gibt diese Methode geeignete Standardansichtsgrenzen zurück.
(v0, v1) == (-inf, +inf)
Andernfalls wird unverändert zurückgegeben.
(v0, v1)
- set_params ( base = None , subs = None , numdecs = None , numticks = None ) [source] #
Legen Sie Parameter innerhalb dieses Locators fest.
- subs ( subs ) [Quelle] #
[ Veraltet ] Setzt die kleinen Ticks für die Log-Skalierung alle
base**i*subs[j]
.Anmerkungen
Veraltet seit Version 3.6: Verwenden Sie stattdessen set_params(subs=...).
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. LogitFormatter ( * , use_overline = False , one_half = '\\frac{1}{2}' , minor = False , minor_threshold = 25 , minor_number = 6 ) [source] #
Basen:
Formatter
Wahrscheinlichkeitsformatierer (unter Verwendung von mathematischem Text).
- Parameter :
- use_overline bool, Standard: False
Wenn x > 1/2, mit x = 1-v, geben Sie an, ob x als $overline{v}$ angezeigt werden soll. Standardmäßig wird $1-v$ angezeigt.
- one_half str, Standard: r"frac{1}{2}"
Die Zeichenfolge, die zur Darstellung von 1/2 verwendet wird.
- Minor Bool, Standard: False
Geben Sie an, ob der Formatierer kleinere Ticks formatiert oder nicht. Grundsätzlich werden kleine Ticks nicht beschriftet, außer wenn nur wenige Ticks vorhanden sind, werden Ticks mit dem meisten Abstand zu benachbarten Ticks beschriftet. Siehe andere Parameter, um das Standardverhalten zu ändern.
- minor_threshold int, Standard: 25
Maximale Anzahl von Locs zum Beschriften einiger kleinerer Ticks. Dieser Parameter hat keine Wirkung, wenn Minor False ist.
- minor_number int, Standard: 6
Anzahl der Ticks, die markiert werden, wenn die Anzahl der Ticks unter dem Schwellenwert liegt.
- format_data_short ( wert ) [Quelle] #
Gibt eine kurze Zeichenfolgenversion des Tick-Werts zurück.
Standardmäßig der positionsunabhängige Long-Wert.
- set_locs ( locs ) [Quelle] #
Legen Sie die Positionen der Häkchen fest.
Diese Methode wird aufgerufen, bevor die Tick-Beschriftungen berechnet werden, da einige Formatierer dafür alle Tick-Positionen kennen müssen.
- set_minor_number ( minor_number ) [Quelle] #
Legen Sie die Anzahl der zu beschriftenden Nebenstriche fest, wenn einige Nebenstriche beschriftet sind.
- Parameter :
- Minor_Nummer int
Anzahl der Ticks, die markiert werden, wenn die Anzahl der Ticks unter dem Schwellenwert liegt.
- set_minor_threshold ( minor_threshold ) [Quelle] #
Legen Sie den Schwellenwert für die Kennzeichnung von Minor-Ticks fest.
- Parameter :
- minor_threshold int
Maximale Anzahl von Stellen zum Beschriften einiger kleiner Häkchen. Dieser Parameter hat keine Wirkung, wenn Minor False ist.
- Klasse matplotlib.ticker. LogitLocator ( minor = False , * , nbins = 'auto' ) [Quelle] #
Basen:
MaxNLocator
Bestimmen Sie die Tick-Positionen für Logit-Achsen
Setzen Sie Häkchen an den Logit-Standorten
- Parameter :
- nbins int oder 'auto', optional
Anzahl der Ticks. Wird nur verwendet, wenn Minor False ist.
- Minor Bool, Standard: False
Geben Sie an, ob dieser Locator für kleinere Ticks gedacht ist oder nicht.
- Eigenschaft Minor #
- Nichtsingular ( vmin , vmax ) [Quelle] #
Passen Sie einen Bereich nach Bedarf an, um Singularitäten zu vermeiden.
Diese Methode wird während der automatischen Skalierung aufgerufen, wobei die Datengrenzen für die Achsen festgelegt werden, wenn die Achsen Daten enthalten oder nicht.
(v0, v1)
(-inf, +inf)
Wenn (möglicherweise bis zu einem gewissen Fließkommaabfall), gibt diese Methode ein erweitertes Intervall um diesen Wert zurück.
v0 == v1
Wenn , gibt diese Methode geeignete Standardansichtsgrenzen zurück.
(v0, v1) == (-inf, +inf)
Andernfalls wird unverändert zurückgegeben.
(v0, v1)
- set_params ( minor = None , ** kwargs ) [Quelle] #
Legen Sie Parameter innerhalb dieses Locators fest.
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. MaxNLocator ( nbins = None , ** kwargs ) [Quelle] #
Basen:
Locator
Finden Sie schöne Tick-Positionen, bei denen nicht mehr als N innerhalb der Sichtgrenzen liegen. Standorte außerhalb der Grenzen werden hinzugefügt, um die automatische Skalierung zu unterstützen.
- Parameter :
- nbins int oder 'auto', Standard: 10
Maximale Anzahl Intervalle; eins weniger als die maximale Anzahl von Ticks. Wenn die Zeichenfolge „auto“ ist, wird die Anzahl der Bins automatisch basierend auf der Länge der Achse bestimmt.
- Schritte Array-artig, optional
Eine Reihe schöner Zahlen, die mit 1 beginnen und mit 10 enden; zB [1, 2, 4, 5, 10], wobei die Werte akzeptable Vielfache von Ticks sind. dh für das Beispiel wären 20, 40, 60 ein akzeptabler Satz von Ticks, ebenso wie 0,4, 0,6, 0,8, da sie Vielfache von 2 sind. 30, 60, 90 wären jedoch nicht zulässig, da 3 nicht darin vorkommt die Liste der Schritte.
- Integer bool, Standard: False
Wenn True, nehmen Ticks nur ganzzahlige Werte an, vorausgesetzt, dass mindestens min_n_ticks Ganzzahlen innerhalb der Anzeigegrenzen gefunden werden.
- Symmetric Bool, Standard: False
Wenn True, führt die automatische Skalierung zu einem Bereich, der symmetrisch um Null ist.
- prune {'lower', 'upper', 'both', None}, Standard: None
Kantenmarkierungen entfernen – nützlich für gestapelte oder verbundene Diagramme, bei denen sich die obere Markierung einer Achse mit der unteren Markierung der darüber liegenden Achsen überschneidet, hauptsächlich wenn
rcParams["axes.autolimit_mode"]
(Standard:'data'
) ist'round_numbers'
. Wennprune=='lower'
, wird das kleinste Häkchen entfernt. Wenn , wird das größte Häkchen entfernt. Wenn , werden die größten und kleinsten Häkchen entfernt. Wenn prune None ist , werden keine Häkchen entfernt.prune == 'upper'
prune == 'both'
- min_n_ticks int, Standard: 2
Lockern Sie bei Bedarf die Beschränkungen für nbins und Integer , um diese Mindestanzahl von Ticks zu erhalten.
- default_params = {'integer': False, 'min_n_ticks': 2, 'nbins': 10, 'prune': None, 'steps': None, 'symmetric': False} #
- set_params ( ** kwargs ) [Quelle] #
Legen Sie die Parameter für diesen Locator fest.
- Parameter :
- nbins int oder 'auto', optional
sehen
MaxNLocator
- Schritte Array-artig, optional
sehen
MaxNLocator
- Ganzzahl bool, optional
sehen
MaxNLocator
- Symmetric Bool, optional
sehen
MaxNLocator
- prune {'lower', 'upper', 'both', None}, optional
sehen
MaxNLocator
- min_n_ticks int, optional
sehen
MaxNLocator
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. MultipleLocator ( Basis = 1.0 ) [Quelle] #
Basen:
Locator
Setzen Sie ein Häkchen auf jedes ganzzahlige Vielfache einer Basis innerhalb des Betrachtungsintervalls.
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. NullFormatter [Quelle] #
Basen:
Formatter
Gibt immer den leeren String zurück.
- Klasse matplotlib.ticker. PercentFormatter ( xmax = 100 , decimals = None , symbol = '%' , is_latex = False ) [source] #
Basen:
Formatter
Zahlen als Prozent formatieren.
- Parameter :
- xmax Schwimmer
Legt fest, wie die Zahl in einen Prozentsatz umgewandelt wird. xmax ist der Datenwert, der 100 % entspricht. Prozentsätze werden berechnet als . Wenn die Daten also bereits auf Prozentsätze skaliert sind, ist xmax 100. Eine andere häufige Situation ist, wenn xmax 1,0 ist.
x / xmax * 100
- Dezimalstellen Keine oder int
Die Anzahl der Dezimalstellen nach dem Komma. Bei None (Standardeinstellung) wird die Zahl automatisch berechnet.
- symbol str oder None
Eine Zeichenfolge, die an das Label angehängt wird. Es kann None oder leer sein, um anzugeben, dass kein Symbol verwendet werden soll. LaTeX-Sonderzeichen werden im Symbol maskiert , wenn der Latexmodus aktiviert ist, es sei denn, is_latex ist True .
- is_latex bool
Bei False werden reservierte LaTeX-Zeichen im Symbol maskiert.
- format_pct ( x , Anzeigebereich ) [Quelle] #
Formatieren Sie die Zahl als Prozentzahl mit der richtigen Anzahl an Dezimalstellen und fügen Sie gegebenenfalls das Prozentzeichen hinzu.
Wenn
self.decimals
istNone
, wird die Anzahl der Nachkommastellen basierend auf dem Anzeigebereich der Achse wie folgt festgelegt:anzeigebereich
Dezimalstellen
Probe
>50
0
x = 34.5
=> 35%>5
1
x = 34.5
=> 34,5 %>0,5
2
x = 34.5
=> 34,50 %...
...
...
Diese Methode ist für kleine oder extrem große Achsbereiche nicht sehr gut. Es wird davon ausgegangen, dass die Werte im Diagramm Prozentsätze sind, die in einem angemessenen Maßstab angezeigt werden.
- Eigenschaftssymbol # _
Das konfigurierte Prozentzeichen als Zeichenfolge.
Wenn LaTeX über aktiviert ist
rcParams["text.usetex"]
(Standard:False
), werden die Sonderzeichen automatisch im String maskiert.{'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'}
- Klasse matplotlib.ticker. ScalarFormatter ( useOffset = None , useMathText = None , useLocale = None ) [Quelle] #
Basen:
Formatter
Tick-Werte als Zahl formatieren.
- Parameter :
- useOffset bool oder float, Standard:
rcParams["axes.formatter.useoffset"]
(Standard:True
) Ob die Offset-Notation verwendet werden soll. Siehe
set_useOffset
.- useMathText bool, Standard:
rcParams["axes.formatter.use_mathtext"]
(Standard:False
) Ob ausgefallene mathematische Formatierung verwendet werden soll. Siehe
set_useMathText
.- useLocale bool, Standard:
rcParams["axes.formatter.use_locale"]
(Standard:False
). Ob Gebietsschemaeinstellungen für Dezimalzeichen und positives Vorzeichen verwendet werden sollen. Siehe
set_useLocale
.
- useOffset bool oder float, Standard:
Anmerkungen
Zusätzlich zu den oben genannten Parametern kann die Formatierung von wissenschaftlicher vs. Fließkommadarstellung über
set_scientific
und konfiguriert werdenset_powerlimits
.Offsetnotation und wissenschaftliche Notation
Offsetnotation und wissenschaftliche Notation sehen auf den ersten Blick recht ähnlich aus. Beide trennen einige Informationen von den formatierten Tick-Werten und zeigen sie am Ende der Achse an.
Die wissenschaftliche Notation zerlegt die Größenordnung, also einen multiplikativen Skalierungsfaktor, zB
1e6
.Die Offset-Notation trennt eine additive Konstante, zB
+1e6
.+
Der Beschriftung der Offset-Notation wird immer ein oder -Zeichen vorangestellt-
und ist somit von der Beschriftung der Größenordnung unterscheidbar.
Das folgende Diagramm mit x-Grenzen veranschaulicht die unterschiedliche Formatierung
1_000_000
.1_000_010
Beachten Sie die Beschriftungen am rechten Rand der x-Achse.- format_data ( wert ) [Quelle] #
Gibt die vollständige Zeichenfolgendarstellung des Werts ohne Angabe der Position zurück.
- format_data_short ( wert ) [Quelle] #
Gibt eine kurze Zeichenfolgenversion des Tick-Werts zurück.
Standardmäßig der positionsunabhängige Long-Wert.
- get_useLocale ( ) [Quelle] #
Gibt zurück, ob Gebietsschemaeinstellungen für die Formatierung verwendet werden.
Siehe auch
- get_useMathText ( ) [Quelle] #
Geben Sie zurück, ob ausgefallene mathematische Formatierungen verwendet werden sollen.
Siehe auch
- get_useOffset ( ) [Quelle] #
Gibt zurück, ob der automatische Modus für die Offset-Notation aktiv ist.
Dies gibt True zurück, wenn
set_useOffset(True)
; es gibt False zurück, wenn ein expliziter Offset gesetzt wurde, zBset_useOffset(1000)
.Siehe auch
- set_locs ( locs ) [Quelle] #
Legen Sie die Positionen der Häkchen fest.
Diese Methode wird aufgerufen, bevor die Tick-Beschriftungen berechnet werden, da einige Formatierer dafür alle Tick-Positionen kennen müssen.
- set_powerlimits ( lims ) [Quelle] #
Legen Sie Größenschwellenwerte für die wissenschaftliche Notation fest.
- Parameter :
- lims (int, int)
Ein Tupel (min_exp, max_exp) , das die Zehnerpotenzen enthält, die die Umschaltschwelle bestimmen. Für eine Zahl darstellbar als \(a \times 10^\mathrm{exp}\)mit\(1 <= |a| < 10\), wird die wissenschaftliche Schreibweise verwendet, wenn oder .
exp <= min_exp
exp >= max_exp
Die Standardgrenzen werden gesteuert durch
rcParams["axes.formatter.limits"]
(Standard: ).[-5, 6]
Insbesondere Zahlen mit exp gleich den Schwellenwerten werden in wissenschaftlicher Notation geschrieben.
Typischerweise ist min_exp negativ und max_exp positiv.
Beispielsweise wird die folgende Formatierung bereitgestellt:
formatter.set_powerlimits((-3, 4))
\(1 \times 10^{-3}, 9.9 \times 10^{-3}, 0.01,\) \(9999, 1 \times 10^4\).
Siehe auch
- set_scientific ( b ) [Quelle] #
Schalten Sie die wissenschaftliche Notation ein oder aus.
Siehe auch
- set_useLocale ( val ) [Quelle] #
Legen Sie fest, ob Gebietsschemaeinstellungen für das Dezimalzeichen und das positive Vorzeichen verwendet werden sollen.
- Parameter :
- val bool oder None
Keine wird zurückgesetzt auf
rcParams["axes.formatter.use_locale"]
(Standard:False
).
- set_useMathText ( val ) [Quelle] #
Legen Sie fest, ob ausgefallene mathematische Formatierungen verwendet werden sollen.
Wenn aktiv, wird die wissenschaftliche Schreibweise als formatiert\(1.2 \times 10^3\).
- Parameter :
- val bool oder None
Keine wird zurückgesetzt auf
rcParams["axes.formatter.use_mathtext"]
(Standard:False
).
- set_useOffset ( val ) [Quelle] #
Legen Sie fest, ob die Offset-Notation verwendet werden soll.
Beim Formatieren einer Menge von Zahlen, deren Wert im Vergleich zu ihrem Bereich groß ist, kann der Formatierer eine additive Konstante trennen. Dadurch können die formatierten Zahlen gekürzt werden, sodass es weniger wahrscheinlich ist, dass sie sich überlappen, wenn sie auf einer Achse gezeichnet werden.
- Parameter :
- val bool oder float
Bei False keine Offset-Notation verwenden.
Wenn True (=automatischer Modus), verwenden Sie die Offset-Notation, wenn dadurch die Restzahlen erheblich kürzer werden können. Das genaue Verhalten wird durch
rcParams["axes.formatter.offset_threshold"]
(Standard:4
) gesteuert.Wenn es sich um eine Zahl handelt, wird ein Offset des angegebenen Werts erzwungen.
Beispiele
Bei aktiver Offset-Notation werden die Werte
100_000, 100_002, 100_004, 100_006, 100_008
wird als plus Offset formatiert , der an den Rand der Achse geschrieben wird.
0, 2, 4, 6, 8
+1e5
- Eigenschaft useLocale #
Gibt zurück, ob Gebietsschemaeinstellungen für die Formatierung verwendet werden.
Siehe auch
- Eigenschaft useMathText #
Geben Sie zurück, ob ausgefallene mathematische Formatierungen verwendet werden sollen.
Siehe auch
- Eigenschaft useOffset #
Gibt zurück, ob der automatische Modus für die Offset-Notation aktiv ist.
Dies gibt True zurück, wenn
set_useOffset(True)
; es gibt False zurück, wenn ein expliziter Offset gesetzt wurde, zBset_useOffset(1000)
.Siehe auch
- Klasse matplotlib.ticker. StrMethodFormatter ( fmt ) [Quelle] #
Basen:
Formatter
Verwenden Sie eine neue Formatzeichenfolge (wie sie von verwendet wird
str.format
), um das Tick zu formatieren.Das für den Tick-Wert verwendete Feld muss mit x und das für die Tick-Position verwendete Feld mit pos bezeichnet werden .
- Klasse matplotlib.ticker. SymmetricLogLocator ( transform = None , subs = None , linthresh = None , base = None ) [Quelle] #
Basen:
Locator
Bestimmen Sie die Tick-Positionen für symmetrische Log-Achsen.
- Parameter :
- transformieren
SymmetricalLogTransform
, optional Wenn gesetzt, definiert es die Basis und Linthresh der Symlog-Transformation.
- Sockel, Linthresh- Schwimmer, optional
Basis und Linthresh der Symlog-Transformation, wie für
SymmetricalLogScale
. Diese Parameter werden nur verwendet, wenn transform nicht gesetzt ist.- subs Folge von Float, Standard: [1]
Die Vielfachen ganzzahliger Potenzen der Basis, an der Ticks platziert werden, dh Ticks werden bei platziert .
[sub * base**i for i in ... for sub in subs]
- transformieren
Anmerkungen
Es muss entweder transform oder sowohl base als auch linthresh angegeben werden.
- set_params ( subs = None , numticks = None ) [Quelle] #
Legen Sie Parameter innerhalb dieses Locators fest.
- tick_values ( vmin , vmax ) [Quelle] #
Gibt die Werte der lokalisierten Ticks bei vmin und vmax zurück .
Notiz
Um Tick-Positionen mit den automatisch für die zugehörigen vmin- und vmax-Werte definierten vmin- und vmax-Werten zu erhalten,
axis
rufen Sie einfach die Locator-Instanz auf:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- Klasse matplotlib.ticker. TickHelper [Quelle] #
Basen:
object
- Achse = Keine #
- set_bounds ( vmin , vmax ) [Quelle] #
[ Veraltet ]
Anmerkungen
Veraltet seit Version 3.5: Verwenden Sie stattdessen
Axis.set_view_interval
und .Axis.set_data_interval
- set_data_interval ( vmin , vmax ) [Quelle] #
[ Veraltet ]
Anmerkungen
Veraltet seit Version 3.5: Verwenden Sie
Axis.set_data_interval
stattdessen.
- set_view_interval ( vmin , vmax ) [Quelle] #
[ Veraltet ]
Anmerkungen
Veraltet seit Version 3.5: Verwenden Sie
Axis.set_view_interval
stattdessen.