matplotlib.units#

Le classi qui forniscono supporto per l'utilizzo di classi personalizzate con Matplotlib, ad esempio quelle che non espongono l'interfaccia dell'array ma sanno come convertirsi in array. Supporta anche classi con unità e conversione di unità. I casi d'uso includono convertitori per oggetti personalizzati, ad esempio un elenco di oggetti datetime, nonché per oggetti che riconoscono l'unità. Non assumiamo nessuna particolare implementazione di unità; piuttosto un'implementazione di unità deve registrarsi con il dizionario del convertitore di registro e fornire un file ConversionInterface. Ad esempio, ecco un'implementazione completa che supporta la stampa con oggetti datetime nativi:

import matplotlib.units as units
import matplotlib.dates as dates
import matplotlib.ticker as ticker
import datetime

class DateConverter(units.ConversionInterface):

    @staticmethod
    def convert(value, unit, axis):
        "Convert a datetime value to a scalar or array."
        return dates.date2num(value)

    @staticmethod
    def axisinfo(unit, axis):
        "Return major and minor tick locators and formatters."
        if unit != 'date':
            return None
        majloc = dates.AutoDateLocator()
        majfmt = dates.AutoDateFormatter(majloc)
        return units.AxisInfo(majloc=majloc, majfmt=majfmt, label='date')

    @staticmethod
    def default_units(x, axis):
        "Return the default unit for x or None."
        return 'date'

# Finally we register our object type with the Matplotlib units registry.
units.registry[datetime.date] = DateConverter()
classe matplotlib.units. AxisInfo ( majloc = None , minloc = None , majfmt = None , minfmt = None , label = None , default_limits = None ) [fonte] #

Basi:object

Informazioni per supportare l'etichettatura dell'asse predefinita, l'etichettatura dei tick e i limiti.

Un'istanza di questa classe deve essere restituita da ConversionInterface.axisinfo.

Parametri :
majloc, minloc Localizzatore, facoltativo

Localizzatori di zecche per le zecche maggiori e minori.

majfmt, minfmt Formatter, facoltativo

Tick ​​formattatori per i tick maggiori e minori.

etichetta str, facoltativo

L'etichetta predefinita dell'asse.

default_limits facoltativo

I limiti minimo e massimo predefiniti dell'asse se non sono stati tracciati dati.

Appunti

Se uno qualsiasi dei precedenti è None, l'asse utilizzerà semplicemente il valore predefinito.

eccezione matplotlib.units. ConversionError [fonte] #

Basi:TypeError

classe matplotlib.units. ConversionInterface [fonte] #

Basi:object

L'interfaccia minima per un convertitore per prendere tipi di dati personalizzati (o sequenze) e convertirli in valori che Matplotlib può usare.

info asse statico ( unità , asse ) [fonte] #

Restituisce un AxisInfoper l'asse con le unità specificate.

conversione statica ( oggetto , unità , asse ) [fonte] #

Converti obj utilizzando l' unità per l' asse specificato .

Se obj è una sequenza, restituisce la sequenza convertita. L'output deve essere una sequenza di scalari che possono essere utilizzati dal livello dell'array numpy.

static default_units ( x , axis ) [fonte] #

Restituisce l'unità predefinita per x o Noneper l'asse specificato.

static is_numlike ( x ) [fonte] #

[ Deprecato ] Il datalim Matplotlib, il ridimensionamento automatico, i localizzatori ecc. Funzionano con scalari che sono le unità convertite in float data l'unità corrente. Al convertitore possono essere passati questi float, o array di essi, anche quando le unità sono impostate.

Appunti

Deprecato dalla versione 3.5.

classe matplotlib.units. DecimalConverter [fonte] #

Basi:ConversionInterface

Convertitore per dati decimal.Decimal in virgola mobile.

conversione statica ( valore , unità , asse ) [fonte] #

Converti decimali in float.

Gli argomenti unità e asse non vengono utilizzati.

Parametri :
valore decimal.Decimal o iterabile

Decimal o elenco di Decimal devono essere convertiti

classe matplotlib.units. Registro [fonte] #

Basi:dict

Registra i tipi con l'interfaccia di conversione.

get_converter ( x ) [fonte] #

Ottieni l'istanza dell'interfaccia del convertitore per x o None.