`matplotlib.units`#

ここにあるクラスは、Matplotlib でカスタムクラスを使用するためのサポートを提供します。たとえば、配列インターフェイスを公開していないが、自分自身を配列に変換する方法を知っているクラスです。また、単位と単位変換を含むクラスもサポートしています。ユースケースには、カスタムオブジェクト (datetime オブジェクトのリストなど) のコンバーターや、ユニットを認識するオブジェクトのコンバーターが含まれます。特定のユニットの実装は想定していません。むしろ、ユニットの実装はレジストリコンバータディクショナリに登録し、ConversionInterface. たとえば、ネイティブの datetime オブジェクトを使用したプロットをサポートする完全な実装は次のとおりです。

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 =なし, minloc =なし, majfmt =なし, minfmt =なし, label =なし, default_limits =なし) [source] #

拠点:object

デフォルトの軸のラベル付け、目盛りのラベル付け、および範囲をサポートするための情報。

このクラスのインスタンスはによって返される必要があります ConversionInterface.axisinfo。

パラメータ:

majloc、minlocロケータ、オプション: 大目盛と小目盛のティックロケーター。
majfmt、minfmtフォーマッタ、オプション: 大目盛と小目盛のティックフォーマッタ。
ラベル文字列、オプション: デフォルトの軸ラベル。
default_limitsオプション: データがプロットされていない場合の軸のデフォルトの最小制限と最大制限。

ノート

上記のいずれかがの場合None、軸は単にデフォルト値を使用します。

例外 matplotlib.units。ConversionError [ソース] #: 拠点:TypeError

クラス matplotlib.units。ConversionInterface [ソース] #

拠点:object

コンバーターがカスタムデータ型 (またはシーケンス) を取り、それらを Matplotlib が使用できる値に変換するための最小限のインターフェイス。

static axisinfo ( unit , axis ) [ソース] #: AxisInfo指定された単位で軸のを返します。

static convert ( obj , unit , axis ) [source] #

指定されたaxisのunitを使用してobjを変換します。

objがシーケンスの場合、変換されたシーケンスを返します。出力は、numpy 配列レイヤーで使用できる一連のスカラーでなければなりません。

static default_units ( x , axis ) [ソース] #: xまたはNone指定された軸のデフォルトの単位を返します。

static is_numlike ( x ) [ソース] #

[非推奨] Matplotlib の datalim、自動スケーリング、ロケーターなどは、現在の単位を指定して float に変換された単位であるスカラーを操作します。コンバーターには、単位が設定されている場合でも、これらの float またはそれらの配列が渡される場合があります。

ノート

バージョン 3.5 以降は非推奨です。

クラス matplotlib.units。DecimalConverter [ソース] #

拠点:ConversionInterface

10 進数のコンバーター。10 進数データを float に変換します。

static convert ( value , unit , axis ) [source] #

Decimal を float に変換します。

unitおよびaxis引数は使用されません。

パラメータ:

値decimal.Decimal または iterable: Decimal または Decimal のリストを変換する必要があります

クラス matplotlib.units。レジストリ[ソース] #

拠点:dict

型を変換インターフェースに登録します。

get_converter ( x ) [ソース] #: xまたは Noneのコンバーターインターフェイスインスタンスを取得します。

matplotlib.units#

`matplotlib.units`#