matplotlib.ticker

Tick ​​localizzazione e formattazione

Questo modulo contiene classi per configurare la localizzazione e la formattazione dei tick. Vengono forniti localizzatori e formattatori di tick generici, oltre a quelli personalizzati specifici del dominio.

Sebbene i localizzatori non sappiano nulla sui tick maggiori o minori, vengono utilizzati dalla classe Axis per supportare la localizzazione e la formattazione dei tick maggiori e minori.

Spuntare la localizzazione

La classe Locator è la classe base per tutti i tick locator. I localizzatori gestiscono il ridimensionamento automatico dei limiti di visualizzazione in base ai limiti dei dati e la scelta delle posizioni dei tick. Un utile localizzatore di tick semiautomatico è MultipleLocator. Viene inizializzato con una base, ad esempio 10, e seleziona i limiti dell'asse e le tacche che sono multipli di quella base.

Le sottoclassi di Locator qui definite sono:

AutoLocator	MaxNLocatorcon semplici impostazioni predefinite. Questo è il localizzatore di tick predefinito per la maggior parte dei tracciati.
MaxNLocator	Trova fino a un numero massimo di intervalli con zecche in posizioni piacevoli.
LinearLocator	Lo spazio scorre uniformemente dal minimo al massimo.
LogLocator	Lo spazio scorre logaritmicamente dal minimo al massimo.
MultipleLocator	I tick e il range sono multipli della base; intero o float.
FixedLocator	Le posizioni dei tick sono fisse.
IndexLocator	Localizzatore per grafici indice (ad esempio, where ).x = range(len(y))
NullLocator	Nessun segno di spunta.
SymmetricalLogLocator	Localizzatore da utilizzare con la norma symlog; funziona come LogLocatorper la parte fuori soglia e aggiunge 0 se dentro i limiti.
AsinhLocator	Localizzatore da utilizzare con la norma asinh, che tenta di distanziare le zecche in modo approssimativamente uniforme.
LogitLocator	Localizzatore per il ridimensionamento logit.
AutoMinorLocator	Localizzatore per tick minori quando l'asse è lineare e i tick principali sono distanziati uniformemente. Suddivide l'intervallo di tick principale in un numero specificato di intervalli minori, per impostazione predefinita 4 o 5 a seconda dell'intervallo maggiore.

Ci sono un certo numero di localizzatori specializzati per le località delle date - vedi il datesmodulo.

È possibile definire il proprio localizzatore derivando da Locator. Devi eseguire l'override del __call__metodo, che restituisce una sequenza di posizioni, e probabilmente vorrai eseguire l'override del metodo di scalabilità automatica per impostare i limiti di visualizzazione dai limiti dei dati.

Se si desidera sovrascrivere il localizzatore predefinito, utilizzare uno dei precedenti o un localizzatore personalizzato e passarlo all'istanza dell'asse x o y. I metodi rilevanti sono:

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)

Il localizzatore minore predefinito è NullLocator, cioè nessun segno di spunta minore è attivato per impostazione predefinita.

Nota

Locatorle istanze non devono essere utilizzate con più di uno Axiso Axes. Quindi invece di:

locator = MultipleLocator(5)
ax.xaxis.set_major_locator(locator)
ax2.xaxis.set_major_locator(locator)

fai invece quanto segue:

ax.xaxis.set_major_locator(MultipleLocator(5))
ax2.xaxis.set_major_locator(MultipleLocator(5))

Spunta la formattazione

La formattazione del segno di spunta è controllata da classi derivate da Formatter. Il formattatore opera su un singolo valore tick e restituisce una stringa all'asse.

NullFormatter	Nessuna etichetta sulle zecche.
FixedFormatter	Impostare manualmente le stringhe per le etichette.
FuncFormatter	La funzione definita dall'utente imposta le etichette.
StrMethodFormatter	formatUsa il metodo delle stringhe .
FormatStrFormatter	Usa una stringa di formato sprintf vecchio stile.
ScalarFormatter	Formattatore predefinito per scalari: seleziona automaticamente la stringa di formato.
LogFormatter	Formattatore per assi logaritmici.
LogFormatterExponent	Formattare i valori per l'asse logaritmico utilizzando .exponent = log_base(value)
LogFormatterMathtext	Formatta i valori per l'asse logaritmico usando il testo matematico.exponent = log_base(value)
LogFormatterSciNotation	Formattare i valori per l'asse logaritmico utilizzando la notazione scientifica.
LogitFormatter	Formattatore di probabilità.
EngFormatter	Formattare le etichette in notazione ingegneristica.
PercentFormatter	Formatta le etichette come percentuale.

È possibile derivare il proprio formattatore dalla classe base Formatter semplicemente eseguendo l'override del __call__metodo. La classe del formattatore ha accesso alla vista dell'asse e ai limiti dei dati.

Per controllare i formati delle etichette di spunta principali e secondari, utilizzare uno dei seguenti metodi:

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)

Oltre a Formatterun'istanza, set_major_formatteraccetta set_minor_formatteranche una strfunzione o. strinput verrà sostituito internamente con un file generato automaticamente StrMethodFormattercon input str. Per FuncFormatterl'input di funzione, verrà generato e utilizzato a con la funzione di input.

Vedere Gradi maggiori e minori per un esempio di impostazione dei gradi maggiori e minori. Consulta il matplotlib.datesmodulo per ulteriori informazioni ed esempi di utilizzo di data locator e formattatori.

classe matplotlib.ticker. AsinhLocator ( linear_width , numticks = 11 , symthresh = 0.2 , base = 10 , subs = None )

Basi:Locator

Un localizzatore di tick dell'asse specializzato per la scala inverse-sinh

È molto improbabile che questo abbia qualche utilità oltre la AsinhScaleclasse.

Nota

Questa API è provvisoria e potrebbe essere rivista in futuro in base al feedback iniziale degli utenti.

Parametri :

float_larghezza_lineare _

Il parametro di scala che definisce l'estensione della regione quasi lineare.

numticks int, predefinito: 11

Il numero approssimativo di tick principali che si adatteranno lungo l'intero asse

symthresh float, predefinito: 0.2

La soglia frazionaria al di sotto della quale i dati che coprono un intervallo approssimativamente simmetrico rispetto allo zero avranno tick esattamente simmetrici.

base int, predefinito: 10

La base numerica utilizzata per arrotondare le posizioni dei tick su una scala logaritmica. Se questo è minore di uno, allora l'arrotondamento è al multiplo intero più vicino di potenze di dieci.

sottotupla , default: Nessuno

Multipli della base numerica, tipicamente usati per i tick minori, es. (2, 5) quando base=10.

set_params ( numticks = None , symthresh = None , base = None , subs = None )

Imposta i parametri all'interno di questo localizzatore.

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. Localizzatore automatico

Basi:MaxNLocator

Trova dinamicamente le principali posizioni dei tick. Questa è in realtà una sottoclasse di MaxNLocator, con parametri nbins = 'auto' e steps = [1, 2, 2.5, 5, 10] .

Per conoscere i valori dei parametri non pubblici, consultare i valori predefiniti di MaxNLocator.

classe matplotlib.ticker. AutoMinorLocator ( n = Nessuno )

Basi:Locator

Trova dinamicamente le posizioni dei tick minori in base alle posizioni dei tick principali. La scala deve essere lineare con le tacche principali equidistanti.

n è il numero di suddivisioni dell'intervallo tra i tick principali; ad esempio, n=2 posizionerà un singolo tick minore a metà strada tra i tick maggiori.

Se n è omesso o Nessuno, sarà impostato su 5 o 4.

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. EngFormatter ( unità = '' , luoghi = None , sep = ' ' , * , usetex = None , useMathText = None )

Basi:Formatter

Formattare i valori degli assi utilizzando prefissi ingegneristici per rappresentare le potenze di 1000, più un'unità specificata, ad esempio 10 MHz invece di 1e7.

Parametri :

unità str, predefinito: ""

Simbolo di unità da utilizzare, adatto per l'uso con rappresentazioni a lettera singola delle potenze di 1000. Ad esempio, "Hz" o "m".

posti int, predefinito: Nessuno

Precisione con cui visualizzare il numero, specificata in cifre dopo la virgola (ci saranno da una a tre cifre prima della virgola). Se è None, la formattazione ricade nel formato a virgola mobile '%g', che visualizza fino a 6 cifre significative , ovvero il valore equivalente per le posizioni varia tra 0 e 5 (inclusi).

sep str, predefinito: " "

Separatore utilizzato tra il valore e il prefisso/unità. Ad esempio, si ottiene '3.14 mV' se sepè " " (predefinito) e '3.14mV' se sepè "". Oltre al comportamento predefinito, alcune altre opzioni utili potrebbero essere:

• sep=""per aggiungere direttamente il prefisso/unità al valore;

• sep="\N{THIN SPACE}"( U+2009);

• sep="\N{NARROW NO-BREAK SPACE}"( U+202F);

• sep="\N{NO-BREAK SPACE}"( U+00A0).

usetex bool, predefinito: rcParams["text.usetex"](predefinito: False)

Per abilitare/disabilitare l'uso della modalità matematica di TeX per rendere i numeri nel formattatore.

useMathText bool, predefinito: rcParams["axes.formatter.use_mathtext"](predefinito: False)

Per abilitare/disabilitare l'uso di mathtext per il rendering dei numeri nel formattatore.

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 )

Formatta un numero in notazione ingegneristica, aggiungendo una lettera che rappresenta la potenza di 1000 del numero originale. Qualche esempio:

>>> 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 µ'

get_useMathText ( )

get_usetex ( )

set_useMathText ( val )

set_usetex ( val )

proprietà useMathText

proprietà usetex

classe matplotlib.ticker. FixedFormatter ( seq )

Basi:Formatter

Restituisci stringhe fisse per etichette tick basate solo sulla posizione, non sul valore.

Nota

FixedFormatterdovrebbe essere usato solo insieme a FixedLocator. In caso contrario, le etichette potrebbero finire in posizioni impreviste.

Imposta la sequenza seq di stringhe che verranno utilizzate per le etichette.

get_offset ( )

set_offset_string ( ofs )

classe matplotlib.ticker. FixedLocator ( locs , nbins = None )

Basi:Locator

Le posizioni dei tick sono fisse. Se nbins non è None, l'array delle possibili posizioni verrà sottocampionato per mantenere il numero di tick <= nbins +1. Il sottocampionamento sarà effettuato in modo da includere il valore assoluto più piccolo; ad esempio, se zero è incluso nell'array di possibilità, allora è garantito che sia uno dei tick scelti.

set_params ( nbins = None )

Imposta i parametri all'interno di questo localizzatore.

tick_values ​​( vmin , vmax )

Restituisci le posizioni delle zecche.

Nota

Poiché i valori sono fissi, vmin e vmax non vengono utilizzati in questo metodo.

classe matplotlib.ticker. FormatStrFormatter ( fmt )

Basi:Formatter

Utilizzare una stringa di formato vecchio stile (operatore '%') per formattare il segno di spunta.

La stringa di formato deve contenere un unico formato variabile (%). Verrà applicato al valore (non alla posizione) del tick.

I valori numerici negativi useranno un trattino, non un meno Unicode; usa il testo matematico per ottenere un meno Unicode avvolgendo l'identificatore di formato con $ (es. "$%g$").

classe matplotlib.ticker. Formattatore

Basi:TickHelper

Crea una stringa basata su un valore tick e una posizione.

fix_minus statico ( s )

Alcune classi potrebbero voler sostituire un trattino per meno con il simbolo Unicode appropriato (U+2212) per correttezza tipografica. Questo è un metodo di supporto per eseguire tale sostituzione quando è abilitato tramite rcParams["axes.unicode_minus"](predefinito: True).

format_data ( valore )

Restituisce la rappresentazione di stringa completa del valore con la posizione non specificata.

format_data_short ( valore )

Restituisce una versione stringa breve del valore tick.

L'impostazione predefinita è il valore long indipendente dalla posizione.

format_ticks ( valori )

Restituisci le etichette dei tick per tutti i tick contemporaneamente.

get_offset ( )

loc = []

set_locs ( locs )

Imposta le posizioni delle zecche.

Questo metodo viene chiamato prima di calcolare le etichette dei tick perché alcuni formattatori devono conoscere tutte le posizioni dei tick per farlo.

classe matplotlib.ticker. FuncFormatter ( func )

Basi:Formatter

Utilizzare una funzione definita dall'utente per la formattazione.

La funzione dovrebbe accettare due input (un valore tick xe una posizione pos) e restituire una stringa contenente l'etichetta tick corrispondente.

get_offset ( )

set_offset_string ( ofs )

classe matplotlib.ticker. IndexLocator ( base , offset )

Basi:Locator

Metti un segno di spunta su ogni multiplo di un numero base di punti tracciati, ad esempio, ogni 5 punti. Si presume che tu stia eseguendo il tracciamento dell'indice; cioè, l'asse è 0, len(data). Questo è utile principalmente per x tick.

Place ticks ogni punto dati di base , a partire da offset .

set_params ( base = Nessuno , offset = Nessuno )

Imposta i parametri all'interno di questo localizzatore

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. LinearLocator ( numticks = Nessuno , preset = Nessuno )

Basi:Locator

Determina le posizioni delle zecche

La prima volta che questa funzione viene chiamata proverà a impostare il numero di tick per creare un buon partizionamento dei tick. Successivamente il numero di tick verrà fissato in modo che la navigazione interattiva sia piacevole

Usa le preimpostazioni per impostare i luoghi in base a lom. Una mappatura dict vmin, vmax->locs

numeri di proprietà

set_params ( numticks = Nessuno , preset = Nessuno )

Imposta i parametri all'interno di questo localizzatore.

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Prova a scegliere i limiti di visualizzazione in modo intelligente.

classe matplotlib.ticker. Localizzatore

Basi:TickHelper

Determinare le posizioni dei tick;

Si noti che lo stesso localizzatore non deve essere utilizzato su più Axissiti perché il localizzatore memorizza i riferimenti ai dati dell'asse e visualizza i limiti.

MAXTICK = 1000

non singolare ( v0 , v1 )

Regola un intervallo secondo necessità per evitare singolarità.

Questo metodo viene chiamato durante il ridimensionamento automatico, con l'impostazione sui limiti di dati sugli assi se gli assi contengono dati o in caso contrario.(v0, v1)(-inf, +inf)

• If (possibilmente fino a qualche pendenza in virgola mobile), questo metodo restituisce un intervallo espanso attorno a questo valore.v0 == v1

• If , questo metodo restituisce i limiti di visualizzazione predefiniti appropriati.(v0, v1) == (-inf, +inf)

• In caso contrario, viene restituito senza modifiche.(v0, v1)

raise_if_exceeds ( locs )

Accedi al livello WARNING se locs è più lungo di Locator.MAXTICKS.

Questo deve essere chiamato immediatamente prima di restituire locs da __call__per informare gli utenti nel caso in cui il loro Locator restituisca un numero enorme di tick, causando l'esaurimento della memoria di Matplotlib.

Lo "strano" nome di questo metodo risale a quando sollevava un'eccezione invece di emettere un log.

set_params ( ** kwargs )

Non fare nulla e lancia un avvertimento. Qualsiasi classe locator che non supporti la funzione set_params() chiamerà this.

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Selezionare una scala per l'intervallo da vmin a vmax.

Le sottoclassi dovrebbero eseguire l'override di questo metodo per modificare il comportamento del localizzatore.

classe matplotlib.ticker. LogFormatter ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Basi:Formatter

Classe base per la formattazione dei tick su una scala log o symlog.

Può essere istanziato direttamente o sottoclasse.

Parametri :

base mobile, predefinito: 10.

Base del logaritmo utilizzato in tutti i calcoli.

labelOnlyBase bool, predefinito: False

Se True, l'etichetta spunta solo a potenze di base intere. Questo è normalmente True per i tick maggiori e False per i tick minori.

minor_thresholds (sottoinsieme, tutto), default: (1, 0.4)

Se labelOnlyBase è False, questi due numeri controllano l'etichettatura dei tick che non sono potenze di base intere; normalmente questi sono i tick minori. Il parametro di controllo è il registro dell'intervallo di dati dell'asse. Nel caso tipico in cui base è 10 è il numero di decadi attraversate dall'asse, quindi possiamo chiamarlo 'numdec'. Se , verranno etichettati tutti i tick minori. Se , verrà etichettato solo un sottoinsieme di tick minori, in modo da evitare l'affollamento. In tal caso non verranno etichettati segni di spunta minori.numdec <= allall < numdec <= subsetnumdec > subset

linthresh Nessuno o float, default: Nessuno

Se è in uso una scala logaritmica simmetrica, il suo linthresh parametro deve essere fornito qui.

Appunti

Il set_locsmetodo deve essere chiamato per abilitare la logica di sottoimpostazione controllata dal minor_thresholdsparametro.

In alcuni casi, come la barra dei colori, non c'è distinzione tra tick maggiori e minori; le posizioni dei tick potrebbero essere impostate manualmente o da un localizzatore che inserisce i tick a potenze intere di base e in posizioni intermedie. Per questa situazione, disabilitare la logica minor_thresholds utilizzando , in modo che tutti i tick vengano etichettati.minor_thresholds=(np.inf, np.inf)

Per disabilitare l'etichettatura dei tick minori quando 'labelOnlyBase' è False, usa . Questa è l'impostazione predefinita per lo stile "classico".minor_thresholds=(0, 0)

Esempi

Per etichettare un sottoinsieme di tick minori quando i limiti di visualizzazione si estendono fino a 2 decadi e tutti i tick quando vengono ingranditi fino a 0,5 decadi o meno, utilizzare .minor_thresholds=(2, 0.5)

Per etichettare tutti i tick minori quando i limiti di visualizzazione si estendono fino a 1,5 decenni, utilizza .minor_thresholds=(1.5, 1.5)

base ( base )

[ Deprecato ] Cambia la base per l'etichettatura.

Avvertimento

Deve sempre corrispondere alla base utilizzata perLogLocator

Appunti

Deprecato dalla versione 3.6: Usa invece set_base().

format_data ( valore )

Restituisce la rappresentazione di stringa completa del valore con la posizione non specificata.

format_data_short ( valore )

Restituisce una versione stringa breve del valore tick.

L'impostazione predefinita è il valore long indipendente dalla posizione.

label_minor ( labelOnlyBase )

[ Deprecato ] Attiva o disattiva l'etichettatura dei segni di spunta minori.

Parametri :

labelOnlyBase bool

Se True, l'etichetta spunta solo a potenze di base intere.

Appunti

Deprecato dalla versione 3.6: Usa invece set_label_minor().

set_base ( base )

Cambia la base per l'etichettatura.

Avvertimento

Deve sempre corrispondere alla base utilizzata perLogLocator

set_label_minor ( labelOnlyBase )

Attiva o disattiva l'etichettatura dei tick minori.

Parametri :

labelOnlyBase bool

Se True, l'etichetta spunta solo a potenze di base intere.

set_locs ( locs = None )

Usa i limiti della vista dell'asse per controllare quali graduazioni sono etichettate.

Il parametro locs è ignorato nel presente algoritmo.

classe matplotlib.ticker. LogFormatterExponent ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Basi:LogFormatter

Formattare i valori per l'asse logaritmico utilizzando .exponent = log_base(value)

classe matplotlib.ticker. LogFormatterMathtext ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Basi:LogFormatter

Formattare i valori per l'asse logaritmico utilizzando .exponent = log_base(value)

classe matplotlib.ticker. LogFormatterSciNotation ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Basi:LogFormatterMathtext

Formatta i valori seguendo la notazione scientifica su un asse logaritmico.

classe matplotlib.ticker. LogLocator ( base = 10.0 , subs = (1.0,) , numdecs = 4 , numticks = None )

Basi:Locator

Determinare le posizioni dei tick per gli assi logaritmici

Metti i segni di spunta sulle posizioni: subs[j] * base**i

Parametri :

base float, predefinito: 10.0

La base del log utilizzato, quindi i tick principali sono posizionati su base**n, n numero intero.

subs None o str o sequenza di float, default: (1.0,)

Fornisce i multipli delle potenze intere della base su cui posizionare i tick. L'impostazione predefinita posiziona i tick solo alle potenze intere della base. I valori di stringa consentiti sono 'auto'e 'all', entrambi utilizzano un algoritmo basato sui limiti della vista dell'asse per determinare se e come inserire i segni di spunta tra le potenze intere della base. Con 'auto', i tick vengono inseriti solo tra potenze intere; con 'all', le potenze intere sono incluse. Un valore Nessuno equivale a 'auto'.

numticks Nessuno o int, predefinito: Nessuno

Il numero massimo di tick consentiti su un determinato asse. L'impostazione predefinita di Noneproverà a scegliere in modo intelligente fintanto che questo Locatore è già stato assegnato a un asse utilizzando get_tick_space, ma altrimenti torna a 9.

base ( base )

[ Deprecato ] Imposta la base logaritmica (segno di spunta maggiore ogni base**i, i intero).

Appunti

Deprecato dalla versione 3.6: utilizzare invece set_params(base=...).

non singolare ( vmin , vmax )

Regola un intervallo secondo necessità per evitare singolarità.

Questo metodo viene chiamato durante il ridimensionamento automatico, con l'impostazione sui limiti di dati sugli assi se gli assi contengono dati o in caso contrario.(v0, v1)(-inf, +inf)

• If (possibilmente fino a qualche pendenza in virgola mobile), questo metodo restituisce un intervallo espanso attorno a questo valore.v0 == v1

• If , questo metodo restituisce i limiti di visualizzazione predefiniti appropriati.(v0, v1) == (-inf, +inf)

• In caso contrario, viene restituito senza modifiche.(v0, v1)

set_params ( base = None , subs = None , numdecs = None , numticks = None )

Imposta i parametri all'interno di questo localizzatore.

sottotitoli ( sottotitoli )

[ Deprecato ] Imposta i segni di spunta minori per il ridimensionamento del registro ogni base**i*subs[j].

Appunti

Deprecato dalla versione 3.6: utilizzare invece set_params(subs=...).

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Prova a scegliere i limiti di visualizzazione in modo intelligente.

classe matplotlib.ticker. LogitFormatter ( * , use_overline = False , one_half = '\\frac{1}{2}' , minor = False , minor_threshold = 25 , minor_number = 6 )

Basi:Formatter

Formattatore di probabilità (usando il testo matematico).

Parametri :

use_overline booleano, predefinito: falso

Se x > 1/2, con x = 1-v, indicare se x deve essere visualizzato come $overline{v}$. L'impostazione predefinita è visualizzare $1-v$.

one_half str, predefinito: r"frac{1}{2}"

La stringa usata per rappresentare 1/2.

minor bool, default: False

Indica se il formattatore sta formattando tick minori o meno. Fondamentalmente i segni di spunta minori non sono etichettati, tranne quando vengono forniti solo pochi segni di spunta, i segni di spunta con la maggior parte dello spazio con i segni di spunta vicini sono etichettati. Vedere altri parametri per modificare il comportamento predefinito.

minor_threshold int, predefinito: 25

Numero massimo di loc per etichettare alcuni tick minori. Questo parametro non ha effetto se minor è False.

minor_number int, predefinito: 6

Numero di tick etichettati quando il numero di tick è inferiore alla soglia.

format_data_short ( valore )

Restituisce una versione stringa breve del valore tick.

L'impostazione predefinita è il valore long indipendente dalla posizione.

set_locs ( locs )

Imposta le posizioni delle zecche.

Questo metodo viene chiamato prima di calcolare le etichette dei tick perché alcuni formattatori devono conoscere tutte le posizioni dei tick per farlo.

set_numero_minore ( numero_minore )

Imposta il numero di tick minori da etichettare quando vengono etichettati alcuni tick minori.

Parametri :

numero_minore int

Numero di tick etichettati quando il numero di tick è inferiore alla soglia.

set_minor_threshold ( minor_threshold )

Imposta la soglia per l'etichettatura delle zecche minori.

Parametri :

soglia_minore int

Numero massimo di posizioni per l'etichettatura di alcuni tick minori. Questo parametro non ha effetto se minor è False.

set_one_half ( one_half )

Imposta il modo in cui viene visualizzata una metà.

one_half str, predefinito: r"frac{1}{2}"

La stringa usata per rappresentare 1/2.

use_overline ( use_overline )

Cambia modalità di visualizzazione con sopralineatura per l'etichettatura p>1/2.

Parametri :

use_overline booleano, predefinito: falso

Se x > 1/2, con x = 1-v, indicare se x deve essere visualizzato come $overline{v}$. L'impostazione predefinita è visualizzare $1-v$.

classe matplotlib.ticker. LogitLocator ( minor = False , * , nbins = 'auto' )

Basi:MaxNLocator

Determinare le posizioni dei tick per gli assi logit

Metti i segni di spunta sulle posizioni logit

Parametri :

nbins int o 'auto', facoltativo

Numero di tick. Usato solo se minore è falso.

minor bool, default: False

Indica se questo localizzatore è per tick minori o meno.

proprietà minore

non singolare ( vmin , vmax )

Regola un intervallo secondo necessità per evitare singolarità.

Questo metodo viene chiamato durante il ridimensionamento automatico, con l'impostazione sui limiti di dati sugli assi se gli assi contengono dati o in caso contrario.(v0, v1)(-inf, +inf)

• If (possibilmente fino a qualche pendenza in virgola mobile), questo metodo restituisce un intervallo espanso attorno a questo valore.v0 == v1

• If , questo metodo restituisce i limiti di visualizzazione predefiniti appropriati.(v0, v1) == (-inf, +inf)

• In caso contrario, viene restituito senza modifiche.(v0, v1)

set_params ( minor = None , ** kwargs )

Imposta i parametri all'interno di questo localizzatore.

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. MaxNLocator ( nbins = None , ** kwargs )

Basi:Locator

Trova belle posizioni di tick con non più di N entro i limiti di visualizzazione. Le posizioni oltre i limiti vengono aggiunte per supportare la scalabilità automatica.

Parametri :

nbins int o 'auto', predefinito: 10

Numero massimo di intervalli; uno in meno rispetto al numero massimo di tick. Se la stringa 'auto', il numero di bin verrà determinato automaticamente in base alla lunghezza dell'asse.

steps simile a un array, facoltativo

Sequenza di bei numeri che iniziano con 1 e finiscono con 10; ad esempio, [1, 2, 4, 5, 10], dove i valori sono multipli di tick accettabili. ad esempio, 20, 40, 60 sarebbero un insieme accettabile di tick, così come 0.4, 0.6, 0.8, perché sono multipli di 2. Tuttavia, 30, 60, 90 non sarebbero consentiti perché 3 non appare in l'elenco dei passi.

intero booleano, predefinito: falso

Se True, i tick prenderanno solo valori interi, a condizione che vengano trovati almeno min_n_ticks interi entro i limiti di visualizzazione.

bool simmetrico , predefinito: False

Se True, il ridimensionamento automatico risulterà in un intervallo simmetrico intorno allo zero.

prune {'lower', 'upper', 'both', None}, predefinito: Nessuno

Rimuovi i segni di spunta dal bordo: utile per i grafici sovrapposti o raggruppati in cui il segno di spunta superiore di un asse si sovrappone al segno di spunta inferiore degli assi sopra di esso, principalmente quando rcParams["axes.autolimit_mode"](impostazione predefinita: 'data') è 'round_numbers'. Se prune=='lower', verrà rimosso il segno di spunta più piccolo. Se , il segno di spunta più grande verrà rimosso. Se , i segni di graduazione più grandi e più piccoli verranno rimossi. Se prune è None , non verrà rimosso alcun segno di spunta.prune == 'upper'prune == 'both'

min_n_ticks int, predefinito: 2

Rilassare i vincoli nbins e integer se necessario per ottenere questo numero minimo di tick.

default_params = {'integer': False, 'min_n_ticks': 2, 'nbins': 10, 'prune': Nessuno, 'steps': Nessuno, 'symmetric': False}

set_params ( ** kwargs )

Imposta i parametri per questo localizzatore.

Parametri :

nbins int o 'auto', facoltativo

vedereMaxNLocator

steps simile a un array, facoltativo

vedereMaxNLocator

intero bool, facoltativo

vedereMaxNLocator

bool simmetrico , facoltativo

vedereMaxNLocator

prune {'lower', 'upper', 'both', None}, facoltativo

vedereMaxNLocator

min_n_ticks int, facoltativo

vedereMaxNLocator

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( dmin , dmax )

Selezionare una scala per l'intervallo da vmin a vmax.

Le sottoclassi dovrebbero eseguire l'override di questo metodo per modificare il comportamento del localizzatore.

classe matplotlib.ticker. MultipleLocator ( base = 1.0 )

Basi:Locator

Imposta un segno di spunta su ogni multiplo intero di una base all'interno dell'intervallo di visualizzazione.

set_params ( base )

Imposta i parametri all'interno di questo localizzatore.

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( dmin , dmax )

Imposta i limiti di visualizzazione sui multipli di base più vicini che contengono i dati.

classe matplotlib.ticker. NullFormatter

Basi:Formatter

Restituisce sempre la stringa vuota.

classe matplotlib.ticker. NullLocator

Basi:Locator

Nessun segno di spunta

tick_values ​​( vmin , vmax )

Restituisci le posizioni delle zecche.

Nota

Poiché i valori sono Null, vmin e vmax non vengono utilizzati in questo metodo.

classe matplotlib.ticker. PercentFormatter ( xmax = 100 , decimals = None , symbol = '%' , is_latex = False )

Basi:Formatter

Formatta i numeri come percentuale.

Parametri :

galleggiante xmax

Determina come il numero viene convertito in una percentuale. xmax è il valore del dato che corrisponde al 100%. Le percentuali sono calcolate come . Quindi, se i dati sono già ridimensionati in percentuale, xmax sarà 100. Un'altra situazione comune è dove xmax è 1.0.x / xmax * 100

decimali Nessuno o int

Il numero di cifre decimali da inserire dopo il punto. Se Nessuno (impostazione predefinita), il numero verrà calcolato automaticamente.

simbolo str o Nessuno

Una stringa che verrà aggiunta all'etichetta. Può essere Nessuno o vuoto per indicare che non deve essere utilizzato alcun simbolo. I caratteri speciali LaTeX vengono sfuggiti in simbolo ogni volta che la modalità latex è abilitata, a meno che is_latex non sia True .

is_latex bool

Se False , i caratteri LaTeX riservati in symbol verranno sottoposti a escape.

convert_to_pct ( x )

format_pct ( x , display_range )

Formatta il numero come percentuale con il numero corretto di decimali e aggiungi il simbolo di percentuale, se presente.

Se self.decimalsè None, il numero di cifre dopo la virgola viene impostato in base al display_range dell'asse come segue:

display_range	decimali	campione
>50	0	x = 34.5=> 35%
>5	1	x = 34.5=> 34,5%
>0,5	2	x = 34.5=> 34,50%
...	...	...

Questo metodo non sarà molto adatto per intervalli di assi piccoli o estremamente grandi. Presuppone che i valori sul grafico siano percentuali visualizzate su una scala ragionevole.

simbolo di proprietà

Il simbolo di percentuale configurato come stringa.

Se LaTeX è abilitato tramite rcParams["text.usetex"](predefinito: False), i caratteri speciali vengono automaticamente sottoposti a escape nella stringa.{'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'}

classe matplotlib.ticker. ScalarFormatter ( useOffset = None , useMathText = None , useLocale = None )

Basi:Formatter

Formatta i valori tick come un numero.

Parametri :

useOffset bool o float, default: rcParams["axes.formatter.useoffset"](default: True)

Se utilizzare la notazione offset. Vedi set_useOffset.

useMathText bool, predefinito: rcParams["axes.formatter.use_mathtext"](predefinito: False)

Se utilizzare una formattazione matematica elaborata. Vedi set_useMathText.

useLocale bool, predefinito: rcParams["axes.formatter.use_locale"](predefinito: False).

Se utilizzare le impostazioni locali per il segno decimale e il segno positivo. Vedi set_useLocale.

Appunti

Oltre ai parametri di cui sopra, la formattazione della rappresentazione scientifica rispetto a quella in virgola mobile può essere configurata tramite set_scientific e set_powerlimits).

Notazione offset e notazione scientifica

La notazione offset e la notazione scientifica sembrano abbastanza simili a prima vista. Entrambi dividono alcune informazioni dai valori di tick formattati e le visualizzano alla fine dell'asse.

• La notazione scientifica scompone l'ordine di grandezza, cioè un fattore di scala moltiplicativo, ad es 1e6.

• La notazione offset separa una costante additiva, ad esempio +1e6. L'etichetta della notazione offset è sempre preceduta dal segno +o -ed è quindi distinguibile dall'etichetta dell'ordine di grandezza.

1_000_000Il grafico seguente con limiti x 1_000_010illustra la diversa formattazione. Nota le etichette sul bordo destro dell'asse x.

( Codice sorgente , png )

format_data ( valore )

Restituisce la rappresentazione di stringa completa del valore con la posizione non specificata.

format_data_short ( valore )

Restituisce una versione stringa breve del valore tick.

L'impostazione predefinita è il valore long indipendente dalla posizione.

get_offset ( )

Restituisce la notazione scientifica, più l'offset.

get_useLocale ( )

Indica se le impostazioni locali vengono utilizzate per la formattazione.

Guarda anche

ScalarFormatter.set_useLocale

get_useMathText ( )

Restituisce se utilizzare una formattazione matematica elaborata.

Guarda anche

ScalarFormatter.set_useMathText

get_useOffset ( )

Indica se è attiva la modalità automatica per la notazione offset.

Questo restituisce True if set_useOffset(True); restituisce False se è stato impostato un offset esplicito, ad esempio set_useOffset(1000).

Guarda anche

ScalarFormatter.set_useOffset

set_locs ( locs )

Imposta le posizioni delle zecche.

Questo metodo viene chiamato prima di calcolare le etichette dei tick perché alcuni formattatori devono conoscere tutte le posizioni dei tick per farlo.

set_powerlimits ( lims )

Imposta le soglie di dimensione per la notazione scientifica.

Parametri :

lim (int, int)

Una tupla (min_exp, max_exp) contenente le potenze di 10 che determinano la soglia di commutazione. Per un numero rappresentabile come \(a \times 10^\mathrm{exp}\)insieme a\(1 <= |a| < 10\), verrà utilizzata la notazione scientifica se o .exp <= min_expexp >= max_exp

I limiti predefiniti sono controllati da rcParams["axes.formatter.limits"](predefinito: ).[-5, 6]

In particolare i numeri con exp pari alle soglie sono scritti in notazione scientifica.

In genere, min_exp sarà negativo e max_exp sarà positivo.

Ad esempio, fornirà la seguente formattazione: formatter.set_powerlimits((-3, 4))\(1 \times 10^{-3}, 9.9 \times 10^{-3}, 0.01,\) \(9999, 1 \times 10^4\).

Guarda anche

ScalarFormatter.set_scientific

set_scientific ( b )

Attiva o disattiva la notazione scientifica.

Guarda anche

ScalarFormatter.set_powerlimits

set_useLocale ( val )

Imposta se utilizzare le impostazioni locali per il segno decimale e il segno positivo.

Parametri :

val bool o Nessuno

Nessuno si reimposta su rcParams["axes.formatter.use_locale"](predefinito: False).

set_useMathText ( val )

Imposta se utilizzare una formattazione matematica elaborata.

Se attiva, la notazione scientifica è formattata come\(1.2 \times 10^3\).

Parametri :

val bool o Nessuno

Nessuno si reimposta su rcParams["axes.formatter.use_mathtext"](predefinito: False).

set_useOffset ( val )

Imposta se utilizzare la notazione offset.

Quando si formatta un insieme di numeri il cui valore è grande rispetto al loro intervallo, il formattatore può separare una costante additiva. Ciò può accorciare i numeri formattati in modo che sia meno probabile che si sovrappongano quando vengono disegnati su un asse.

Parametri :

val bool o float

• Se False, non utilizzare la notazione offset.

• Se True (= modalità automatica), usa la notazione offset se può accorciare significativamente i numeri residui. Il comportamento esatto è controllato da rcParams["axes.formatter.offset_threshold"](predefinito: 4).

• Se è un numero, forza un offset del valore dato.

Esempi

Con la notazione offset attiva, i valori

100_000, 100_002, 100_004, 100_006, 100_008

sarà formattato come più un offset , che viene scritto sul bordo dell'asse.0, 2, 4, 6, 8+1e5

uso proprietàLocale

Indica se le impostazioni locali vengono utilizzate per la formattazione.

Guarda anche

ScalarFormatter.set_useLocale

proprietà useMathText

Restituisce se utilizzare una formattazione matematica elaborata.

Guarda anche

ScalarFormatter.set_useMathText

proprietà useOffset

Indica se è attiva la modalità automatica per la notazione offset.

Questo restituisce True if set_useOffset(True); restituisce False se è stato impostato un offset esplicito, ad esempio set_useOffset(1000).

Guarda anche

ScalarFormatter.set_useOffset

classe matplotlib.ticker. StrMethodFormatter ( fmt )

Basi:Formatter

Utilizzare una stringa di formato di nuovo stile (come quella utilizzata da str.format) per formattare il segno di spunta.

Il campo utilizzato per il valore tick deve essere etichettato x e il campo utilizzato per la posizione tick deve essere etichettato pos .

classe matplotlib.ticker. SymmetricalLogLocator ( transform = None , subs = None , linthresh = None , base = None )

Basi:Locator

Determinare le posizioni delle zecche per gli assi logaritmici simmetrici.

Parametri :

trasformare SymmetricalLogTransform, facoltativo

Se impostato, definisce la base e il linthresh della trasformazione symlog.

base, galleggiante linthresh , opzionale

La base e il linthresh della trasformazione symlog, come documentato per SymmetricalLogScale. Questi parametri vengono utilizzati solo se transform non è impostato.

subs sequenza di float, default: [1]

I multipli delle potenze intere della base dove sono posti i tick, cioè i tick sono posti a .[sub * base**i for i in ... for sub in subs]

Appunti

Devono essere dati transform o entrambi base e linthresh .

set_params ( subs = None , numticks = None )

Imposta i parametri all'interno di questo localizzatore.

tick_values ​​( vmin , vmax )

Restituisce i valori dei tick individuati dati vmin e vmax .

Nota

Per ottenere le posizioni dei tick con i valori vmin e vmax definiti automaticamente per gli associati, axisbasta chiamare l'istanza Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Prova a scegliere i limiti di visualizzazione in modo intelligente.

classe matplotlib.ticker. TickHelper

Basi:object

asse = Nessuno

create_dummy_axis ( ** kwargs )

set_axis ( axis )

imposta_limiti ( vmin , vmax )

[ Deprecato ]

Appunti

Deprecato dalla versione 3.5: utilizzare Axis.set_view_intervale Axis.set_data_intervalinvece.

set_data_interval ( vmin , vmax )

[ Deprecato ]

Appunti

Deprecato dalla versione 3.5: utilizzare Axis.set_data_intervalinvece.

set_view_interval ( vmin , vmax )

[ Deprecato ]

Appunti

Deprecato dalla versione 3.5: utilizzare Axis.set_view_intervalinvece.