matplotlib.units#

这里的类为使用 Matplotlib 的自定义类提供支持,例如,那些不公开数组接口但知道如何将自己转换为数组的类。它还支持具有单位和单位转换的类。用例包括自定义对象的转换器,例如日期时间对象列表,以及单元感知对象。我们不假设任何特定的单元实现;而是一个单元实现必须在注册表转换器字典中注册并提供一个ConversionInterface. 例如,这是一个完整的实现,它支持使用本机日期时间对象进行绘图:

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()
matplotlib.units。AxisInfo ( majloc = None , minloc = None , majfmt = None , minfmt = None , label = None , default_limits = None ) [来源] #

基地:object

支持默认轴标签、刻度标签和限制的信息。

此类的实例必须由 ConversionInterface.axisinfo.

参数
majloc, minloc定位器,可选

主要和次要刻度的刻度定位器。

majfmt,minfmt格式化程序,可选

主要和次要刻度的刻度格式化程序。

标签str,可选

默认轴标签。

default_limits可选

如果未绘制数据,则轴的默认最小和最大限制。

笔记

如果上述任何一个是None,轴将简单地使用默认值。

异常 matplotlib.units。ConversionError [来源] #

基地:TypeError

matplotlib.units。ConversionInterface [来源] #

基地:object

转换器采用自定义数据类型(或序列)并将它们转换为 Matplotlib 可以使用的值的最小接口。

静态 轴信息单位[来源] #

为具有指定单位的轴返回一个AxisInfo

静态 转换( obj , unit , axis ) [来源] #

使用指定轴的单位转换obj

如果obj是一个序列,则返回转换后的序列。输出必须是 numpy 数组层可以使用的标量序列。

静态 default_units ( x , axis ) [来源] #

返回xNone给定轴的默认单位。

静态 is_numlike ( x ) [来源] #

[已弃用] Matplotlib datalim、自动缩放、定位器等与标量一起使用,标量是在给定当前单位的情况下转换为浮点数的单位。即使设置了单位,转换器也可以传递这些浮点数或它们的数组。

笔记

自 3.5 版起已弃用。

matplotlib.units。DecimalConverter [来源] #

基地:ConversionInterface

十进制的转换器。十进制数据浮动。

静态 转换(,单位,) [来源] #

将小数转换为浮点数。

不使用单位参数。

参数
十进制值。十进制或可迭代

需要转换的十进制或十进制列表

matplotlib.units。注册表[来源] #

基地:dict

使用转换接口注册类型。

get_converter ( x ) [来源] #

获取x或 None 的转换器接口实例。