`matplotlib.units`#

Les classes ici fournissent un support pour l'utilisation de classes personnalisées avec Matplotlib, par exemple, celles qui n'exposent pas l'interface de tableau mais savent se convertir en tableaux. Il prend également en charge les classes avec conversion d'unités et d'unités. Les cas d'utilisation incluent des convertisseurs pour des objets personnalisés, par exemple, une liste d'objets datetime, ainsi que pour des objets qui reconnaissent l'unité. Nous n'assumons aucune implémentation d'unités particulières ; une implémentation d'unités doit plutôt s'inscrire auprès du dictionnaire du convertisseur de registre et fournir un fichier ConversionInterface. Par exemple, voici une implémentation complète qui prend en charge le traçage avec des objets datetime natifs :

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 ) [source] #

Socles :object

Informations pour prendre en charge l'étiquetage des axes par défaut, l'étiquetage des graduations et les limites.

Une instance de cette classe doit être retournée par ConversionInterface.axisinfo.

Paramètres :

majloc, localisateur minloc, facultatif: Localisateurs de tiques pour les tiques majeures et mineures.
majfmt, formateur minfmt , facultatif: Formateurs de ticks pour les ticks majeurs et mineurs.
label str, facultatif: L'étiquette d'axe par défaut.
default_limits facultatif: Les limites min et max par défaut de l'axe si aucune donnée n'a été tracée.

Remarques

Si l'un des éléments ci-dessus est None, l'axe utilisera simplement la valeur par défaut.

exception matplotlib.units. Erreur de conversion [source] #: Socles :TypeError

classe matplotlib.units. Interface de conversion [source] #

Socles :object

L'interface minimale permettant à un convertisseur de prendre des types de données personnalisés (ou séquences) et de les convertir en valeurs que Matplotlib peut utiliser.

static axisinfo ( unité , axe ) [source] #: Renvoie un AxisInfopour l'axe avec les unités spécifiées.

conversion statique ( obj , unité , axe ) [source] #

Convertir obj en utilisant l' unité pour l' axe spécifié .

Si obj est une séquence, renvoie la séquence convertie. La sortie doit être une séquence de scalaires pouvant être utilisée par la couche de tableau numpy.

static default_units ( x , axe ) [source] #: Renvoie l'unité par défaut pour x ou Nonepour l'axe donné.

static is_numlike ( x ) [source] #

[ Obsolète ] Le datalim Matplotlib, la mise à l'échelle automatique, les localisateurs, etc. fonctionnent avec des scalaires qui sont les unités converties en flottants compte tenu de l'unité actuelle. Le convertisseur peut recevoir ces flottants, ou des tableaux de ceux-ci, même lorsque les unités sont définies.

Remarques

Obsolète depuis la version 3.5.

classe matplotlib.units. DécimalConverter [source] #

Socles :ConversionInterface

Convertisseur pour les données décimales.Décimales à flotter.

conversion statique ( valeur , unité , axe ) [source] #

Convertir les décimaux en flottants.

Les arguments d'unité et d' axe ne sont pas utilisés.

Paramètres :

valeur décimal.Decimal ou itérable: La décimale ou la liste de décimales doivent être converties

classe matplotlib.units. Registre [source] #

Socles :dict

Enregistrez les types avec l'interface de conversion.

get_converter ( x ) [source] #: Obtenez l'instance d'interface du convertisseur pour x ou None.

matplotlib.units#

`matplotlib.units`#