matplotlib.ticker

目盛りの位置とフォーマット

このモジュールには、目盛りの検索と書式設定を構成するためのクラスが含まれています。ドメイン固有のカスタムのものだけでなく、一般的な目盛りロケーターとフォーマッターも提供されています。

ロケーターは大目盛りまたは小目盛りについて何も認識しませんが、大目盛りおよび小目盛りの検索と書式設定をサポートするために Axis クラスによって使用されます。

目盛りの位置

Locator クラスは、すべての目盛りロケーターの基本クラスです。ロケーターは、データ制限に基づくビュー制限の自動スケーリングと目盛りの位置の選択を処理します。便利な半自動目盛りロケーターは MultipleLocator. これは、10 などの基数で初期化され、その基数の倍数である軸の範囲と目盛りを選択します。

ここで定義されている Locator サブクラスは次のとおりです。

AutoLocator	MaxNLocatorシンプルなデフォルトで。これは、ほとんどのプロットのデフォルトの目盛りロケーターです。
MaxNLocator	適切な位置の目盛りで最大数の間隔を検索します。
LinearLocator	スペースは、最小から最大まで均等に刻みます。
LogLocator	スペースは、最小から最大まで対数的に刻みます。
MultipleLocator	ティックと範囲はベースの倍数です。整数または浮動小数点数。
FixedLocator	目盛りの位置は固定です。
IndexLocator	インデックス プロットのロケーター (例: where )。x = range(len(y))
NullLocator	ダニはありません。
SymmetricalLogLocator	symlog 標準で使用するロケーター。LogLocatorしきい値の外側の部分と同様に機能 し、制限内の場合は 0 を追加します。
AsinhLocator	asinh ノルムで使用するロケーターで、ティックの間隔をほぼ均一にしようとします。
LogitLocator	ロジットスケーリングのロケーター。
AutoMinorLocator	軸が線形で、主目盛りが等間隔である場合の副目盛りのロケーター。主目盛り間隔を、指定された数の副間隔に分割します。既定値は、主間隔に応じて 4 または 5 です。

日付の場所に特化したロケーターが多数あります -datesモジュールを参照してください。

Locator から派生させることで、独自のロケーターを定義できます。一連の場所を返すメソッドをオーバーライドする必要があります。また__call__、自動スケーリング メソッドをオーバーライドして、データ制限からビュー制限を設定することをお勧めします。

デフォルトのロケーターをオーバーライドする場合は、上記のいずれかまたはカスタム ロケーターを使用して、x または y 軸のインスタンスに渡します。関連するメソッドは次のとおりです。

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)

デフォルトのマイナー ロケータはNullLocatorです。つまり、デフォルトではマイナー ティックはオンになっていません。

ノート

Locatorインスタンスを複数の Axisまたはとともに使用しないでくださいAxes。したがって、代わりに：

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

代わりに次のようにします。

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

目盛りのフォーマット

ティックの書式設定は、Formatter から派生したクラスによって制御されます。フォーマッタは 1 つの目盛り値で動作し、文字列を軸に返します。

NullFormatter	目盛りにラベルはありません。
FixedFormatter	ラベルの文字列を手動で設定します。
FuncFormatter	ユーザー定義関数がラベルを設定します。
StrMethodFormatter	文字列formatメソッドを使用します。
FormatStrFormatter	古いスタイルの sprintf フォーマット文字列を使用します。
ScalarFormatter	スカラーのデフォルトのフォーマッタ: フォーマット文字列を自動選択します。
LogFormatter	対数軸のフォーマッタ。
LogFormatterExponent	を使用して対数軸の値をフォーマットします 。exponent = log_base(value)
LogFormatterMathtext	Math テキストを使用して対数軸の値をフォーマットし ます。exponent = log_base(value)
LogFormatterSciNotation	指数表記を使用して対数軸の値をフォーマットします。
LogitFormatter	確率フォーマッタ。
EngFormatter	工学表記法でラベルをフォーマットします。
PercentFormatter	ラベルをパーセンテージで書式設定します。

__call__メソッドをオーバーライドするだけで、Formatter 基本クラスから独自のフォーマッタを派生させることができます。フォーマッタ クラスは、軸ビューとデータ制限にアクセスできます。

大目盛りと小目盛りのラベル形式を制御するには、次のいずれかの方法を使用します。

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)

Formatterインスタンスにset_major_formatter加え て、または関数set_minor_formatterも受け入れます。input は、 inputで自動生成されたものに内部的に置き換えられます。関数入力の場合、入力関数を持つ が生成されて使用されます。strstrStrMethodFormatterstrFuncFormatter

大目盛りと小目盛りの設定例については、大目盛りと小目盛りを参照してください。matplotlib.dates日付ロケーターとフォーマッターの使用の詳細と例については、モジュールを参照してください。

クラス matplotlib.ticker。AsinhLocator ( linear_width , numticks = 11 , symthresh = 0.2 , base = 10 , subs = None )

拠点:Locator

逆サインスケールに特化した軸ティックロケーター

AsinhScaleこれがクラスを超えて使用される可能性はほとんどありません。

ノート

この API は暫定的なものであり、初期のユーザー フィードバックに基づいて将来改訂される可能性があります。

パラメータ:

linear_width float

準線形領域の範囲を定義するスケール パラメーター。

numticks int、デフォルト: 11

軸全体に沿って収まる主目盛りのおおよその数

symthresh float、デフォルト: 0.2

ゼロを中心にほぼ対称な範囲をカバーするデータが、正確に対称な目盛りを持つ分数しきい値です。

基本整数、デフォルト: 10

対数スケールで目盛りの位置を丸めるために使用される基数。これが 1 未満の場合、丸めは最も近い 10 の累乗の整数倍になります。

サブタプル、デフォルト: なし

基数の倍数。通常、マイナー ティックに使用されます。たとえば、base=10 の場合は (2, 5) です。

set_params ( numticks =なし, symthresh =なし, base =なし, subs =なし)

このロケーター内でパラメーターを設定します。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

クラス matplotlib.ticker。AutoLocator

拠点:MaxNLocator

大目盛りの位置を動的に見つけます。これは実際には のサブクラスでありMaxNLocator、パラメーターnbins = 'auto' およびsteps = [1, 2, 2.5, 5, 10]を持ちます。

非パブリック パラメータの値を知るには、 のデフォルトを確認してくださいMaxNLocator。

クラス matplotlib.ticker。AutoMinorLocator ( n =なし)

拠点:Locator

大目盛りの位置に基づいて、小目盛りの位置を動的に見つけます。目盛りは等間隔に配置された線形である必要があります。

nは、主ティック間の間隔の細分数です。たとえば、n=2 は、メジャー ティックの中間に 1 つのマイナー ティックを配置します。

nを省略するか、None を指定すると、5 または 4 に設定されます。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

クラス matplotlib.ticker。EngFormatter ( unit = '' , places =なし, sep = ' ' , * , usetex =なし, useMathText =なし)

拠点:Formatter

工学プレフィックスを使用して軸の値をフォーマットし、1000 の累乗に指定の単位を加えたものを表します (例: 1e7 の代わりに 10 MHz)。

パラメータ:

単位文字列、デフォルト: ""

使用する単位記号。1000 のべき乗の 1 文字表現での使用に適しています。たとえば、'Hz' や 'm' です。

int を配置、デフォルト: なし

数値を表示する精度。小数点以下の桁数で指定します (小数点以下の桁数は 1 ～ 3 桁です)。None の場合、フォーマットは浮動小数点フォーマット '%g' にフォールバックします。これは最大 6 桁の有効数字を表示します。つまり、桁数に相当する値は 0 から 5 (両端を含む) の間で変化します。

9 月文字列、デフォルト: " "

値と接頭辞/単位の間に使用されるセパレータ。たとえば、sep" " (デフォルト) の場合は '3.14 mV' になり、"" の場合sepは '3.14mV' になります。デフォルトの動作以外に、次の便利なオプションがあります。

• sep=""接頭辞/単位を値に直接追加します。

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

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

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

usetex bool、デフォルト: rcParams["text.usetex"](デフォルト: False)

フォーマッタで数値をレンダリングするための TeX の数学モードの使用を有効/無効にします。

useMathText bool、デフォルト: rcParams["axes.formatter.use_mathtext"](デフォルト: False)

フォーマッタで数値をレンダリングするための mathtext の使用を有効または無効にします。

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 )

元の数値の 1000 乗を表す文字を追加して、数値を工学表記でフォーマットします。いくつかの例：

>>> 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 )

プロパティ useMathText

プロパティ usetex

クラス matplotlib.ticker。FixedFormatter ( seq )

拠点:Formatter

値ではなく位置のみに基づいて目盛りラベルの固定文字列を返します。

ノート

FixedFormatterと一緒にのみ使用してFixedLocatorください。そうしないと、ラベルが予期しない位置に配置される可能性があります。

ラベルに使用される文字列のシーケンスseqを設定します。

get_offset ( )

set_offset_string ( ofs )

クラス matplotlib.ticker。FixedLocator ( locs , nbins = None )

拠点:Locator

目盛りの位置は固定です。nbins が None でない場合、ティック数 <= nbins +1 を維持するために、可能な位置の配列がサブサンプリングされます。サブサンプリングは、最小の絶対値を含むように行われます。たとえば、ゼロが可能性の配列に含まれている場合、選択されたティックの 1 つであることが保証されます。

set_params ( nbins =なし)

このロケーター内でパラメーターを設定します。

tick_values ( vmin , vmax )

目盛りの位置を返します。

ノート

値は固定であるため、このメソッドでは vmin と vmax は使用されません。

クラス matplotlib.ticker。FormatStrFormatter ( fmt )

拠点:Formatter

古いスタイル ('%' 演算子) のフォーマット文字列を使用して、ティックをフォーマットします。

フォーマット文字列には、単一の変数フォーマット (%) が含まれている必要があります。目盛りの値 (位置ではない) に適用されます。

負の数値は、Unicode マイナスではなく、ダッシュを使用します。$ でフォーマット指定子をラップすることにより、mathtext を使用して Unicode マイナスを取得します (例: "$%g$")。

クラス matplotlib.ticker。フォーマッタ

拠点:TickHelper

目盛りの値と位置に基づいて文字列を作成します。

static fix_minus ( s )

一部のクラスでは、マイナス記号のハイフンを適切な Unicode 記号 (U+2212) に置き換えて、誤字脱字を修正したい場合があります。rcParams["axes.unicode_minus"]これは、 (デフォルト: True)を介して有効になっている場合に、そのような置換を実行するヘルパー メソッド です。

format_data (値)

位置が指定されていない値の完全な文字列表現を返します。

format_data_short (値)

ティック値の短い文字列バージョンを返します。

デフォルトは、位置に依存しない long 値です。

format_ticks (値)

一度にすべての目盛りの目盛りラベルを返します。

get_offset ( )

locs = []

set_locs ( locs )

目盛りの位置を設定します。

このメソッドは、目盛りラベルを計算する前に呼び出されます。一部のフォーマッタは、すべての目盛り位置を知る必要があるためです。

クラス matplotlib.ticker。FuncFormatter ( func )

拠点:Formatter

書式設定にはユーザー定義関数を使用します。

この関数は 2 つの入力 (目盛り値xと位置pos) を受け取り、対応する目盛りラベルを含む文字列を返す必要があります。

get_offset ( )

set_offset_string ( ofs )

クラス matplotlib.ticker。IndexLocator (ベース、オフセット)

拠点:Locator

プロットされたポイントの基本数の倍数ごとに、たとえば 5 番目のポイントごとに目盛りを付けます。インデックス プロットを行っていることを前提としています。つまり、軸は 0、len(data) です。これは主に x ティックに役立ちます。

offsetから始まるすべての基本データ ポイントに目盛りを配置します。

set_params (ベース=なし、オフセット=なし)

このロケーター内でパラメーターを設定します

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

クラス matplotlib.ticker。LinearLocator ( numticks =なし、プリセット=なし)

拠点:Locator

目盛りの位置を決定する

この関数が最初に呼び出されると、適切なティック パーティションを作成するためにティック数を設定しようとします。その後、インタラクティブなナビゲーションがうまくいくように、ティック数が固定されます

プリセットを使用して、lom に基づいて loc を設定します。dict マッピング vmin, vmax->locs

プロパティ numticks

set_params ( numticks =なし、プリセット=なし)

このロケーター内でパラメーターを設定します。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

view_limits ( vmin , vmax )

ビューの制限を賢く選択するようにしてください。

クラス matplotlib.ticker。ロケーター

拠点:TickHelper

目盛りの位置を決定します。

Axisロケーターは軸データとビュー制限への参照を格納するため、同じロケーターを複数で使用しないでください 。

MAXTICKS = 1000

非特異( v0 , v1 )

特異点を避けるために、必要に応じて範囲を調整します。

このメソッドは、軸にデータが含まれている場合、または含まれていない場合は、軸のデータ制限に設定されて、 自動スケーリング中に呼び出されます。(v0, v1)(-inf, +inf)

• (場合によっては浮動小数点スロップまで)、このメソッドはこの値の周りの拡張された間隔を返します。v0 == v1

• の場合、このメソッドは適切なデフォルトのビュー制限を返します。(v0, v1) == (-inf, +inf)

• それ以外の場合は、変更せずに返却されます。(v0, v1)

raise_if_exceeds ( locs )

locsが よりも長い場合、WARNING レベルでログに記録しますLocator.MAXTICKS。

これは、ユーザーの Locator が膨大な数のティックを返し、Matplotlib がメモリ不足になる場合に備えて、locを 返す直前に呼び出されることを意図しています。__call__

このメソッドの「奇妙な」名前は、ログを出力する代わりに例外を発生させたときにさかのぼります。

set_params ( ** kwargs )

何もせず、警告を発します。set_params() 関数をサポートしていないロケーター クラスは、これを呼び出します。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

view_limits ( vmin , vmax )

vmin から vmax までの範囲のスケールを選択します。

ロケータの動作を変更するには、サブクラスでこのメソッドをオーバーライドする必要があります。

クラス matplotlib.ticker。LogFormatter ( base = 10.0、 labelOnlyBase = False、 minor_thresholds =なし、 linthresh =なし)

拠点:Formatter

ログまたは symlog スケールでティックをフォーマットするための基本クラス。

直接インスタンス化することも、サブクラス化することもできます。

パラメータ:

基本フロート、デフォルト: 10。

すべての計算で使用される対数の底。

labelOnlyBase bool、デフォルト: False

True の場合、ラベルは基数の整数乗でのみ刻みます。これは通常、メジャー ティックの場合は True、マイナー ティックの場合は False です。

minor_thresholds (サブセット、すべて)、デフォルト: (1, 0.4)

labelOnlyBase が False の場合、これらの 2 つの数値は、基数の整数乗でない目盛りのラベル付けを制御します。通常、これらはマイナー ティックです。制御パラメータは、軸データ範囲のログです。基数が 10 である典型的なケースでは、軸がまたがる 10 年の数であるため、「numdec」と呼ぶことができます。の場合、すべてのマイナー ティックにラベルが付けられます。の場合、密集を避けるために、マイナー ティックのサブセットのみがラベル付けされます。その場合、マイナー ティックはラベル付けされません。numdec <= allall < numdec <= subsetnumdec > subset

linthresh None または float、デフォルト: None

対称対数スケールが使用されている場合、そのlinthresh パラメーターをここで指定する必要があります。

ノート

set_locsパラメータによって制御されるサブセット化ロジックを有効にするには、メソッドを呼び出す必要がありますminor_thresholds。

カラーバーなどの一部のケースでは、メジャー ティックとマイナー ティックの区別がありません。目盛りの位置は、手動で設定するか、基数の整数乗と中間位置に目盛りを配置するロケーターによって設定できます。この状況では、 を使用して minor_thresholds ロジックを無効にして、すべての目盛りにラベルが付けられるようにします。minor_thresholds=(np.inf, np.inf)

'labelOnlyBase' が False の場合にマイナー ティックのラベル付けを無効にするには、 を使用します。これは、「クラシック」スタイルのデフォルトです。minor_thresholds=(0, 0)

例

ビューの範囲が最大 2 ディケードに及ぶ場合はマイナー ティックのサブセットにラベルを付け、0.5 ディケード以下にズームインした場合はすべてのティックにラベルを付けるには、 を使用します。minor_thresholds=(2, 0.5)

ビューの範囲が最大 1.5 ディケードに及ぶ場合に、すべてのマイナー ティックにラベルを付けるには、 を使用します。minor_thresholds=(1.5, 1.5)

ベース(ベース)

[非推奨]ラベル付けのベースを変更します。

警告

常に使用されるベースと一致する必要がありますLogLocator

ノート

バージョン 3.6 で非推奨:代わりに set_base() を使用してください。

format_data (値)

位置が指定されていない値の完全な文字列表現を返します。

format_data_short (値)

ティック値の短い文字列バージョンを返します。

デフォルトは、位置に依存しない long 値です。

label_minor ( labelOnlyBase )

[非推奨] 小目盛りのラベル付けのオンとオフを切り替えます。

パラメータ:

labelOnlyBase bool

True の場合、ラベルは基数の整数乗でのみ刻みます。

ノート

バージョン 3.6 以降非推奨:代わりに set_label_minor() を使用してください。

set_base (ベース)

ラベリングのベースを変更します。

警告

常に使用されるベースと一致する必要がありますLogLocator

set_label_minor ( labelOnlyBase )

小目盛りのラベル付けのオンとオフを切り替えます。

パラメータ:

labelOnlyBase bool

True の場合、ラベルは基数の整数乗でのみ刻みます。

set_locs ( locs =なし)

軸ビューの制限を使用して、どの目盛りにラベルを付けるかを制御します。

現在のアルゴリズムでは、 locsパラメータは無視されます。

クラス matplotlib.ticker。LogFormatterExponent ( base = 10.0、 labelOnlyBase = False、 minor_thresholds = None、 linthresh = None )

拠点:LogFormatter

を使用して対数軸の値をフォーマットします。exponent = log_base(value)

クラス matplotlib.ticker。LogFormatterMathtext ( base = 10.0、 labelOnlyBase = False、 minor_thresholds = None、 linthresh = None )

拠点:LogFormatter

を使用して対数軸の値をフォーマットします。exponent = log_base(value)

クラス matplotlib.ticker。LogFormatterSciNotation ( base = 10.0、 labelOnlyBase = False、 minor_thresholds = None、 linthresh = None )

拠点:LogFormatterMathtext

対数軸の指数表記に従って値をフォーマットします。

クラス matplotlib.ticker。LogLocator ( base = 10.0 , subs = (1.0,) , numdecs = 4 , numticks = None )

拠点:Locator

対数軸の目盛りの位置を決定する

位置に目盛りを付けます: subs[j] * base**i

パラメータ:

基本フロート、デフォルト: 10.0

使用される対数の底。メジャー ティックは base**n, n 整数に配置されます。

subs None または str または float のシーケンス、デフォルト: (1.0,)

ティックを配置する基数の整数乗の倍数を指定します。デフォルトでは、基数の整数乗にのみティックが配置されます。許可される文字列値は'auto'と'all'で、どちらも軸ビューの制限に基づくアルゴリズムを使用して、基数の整数乗の間にティックを配置するかどうか、およびその方法を決定します。を使用'auto'すると、ティックは整数のべき乗の間にのみ配置されます。で'all'、整数べき乗が含まれます。None の値は と同等'auto'です。

numticks None または int、デフォルト: None

指定された軸で許可されるティックの最大数。デフォルトのNoneは、このロケータが を使用して軸にすでに割り当てられている限りインテリジェントに選択しようとします get_tick_spaceが、それ以外の場合は 9 に戻ります。

ベース(ベース)

[非推奨] 対数ベースを設定します (主目盛りごとbase**i、i 整数)。

ノート

バージョン 3.6 以降非推奨:代わりに set_params(base=...) を使用してください。

非特異( vmin、 vmax )

特異点を避けるために、必要に応じて範囲を調整します。

このメソッドは、軸にデータが含まれている場合、または含まれていない場合は、軸のデータ制限に設定されて、 自動スケーリング中に呼び出されます。(v0, v1)(-inf, +inf)

• (場合によっては浮動小数点スロップまで)、このメソッドはこの値の周りの拡張された間隔を返します。v0 == v1

• の場合、このメソッドは適切なデフォルトのビュー制限を返します。(v0, v1) == (-inf, +inf)

• それ以外の場合は、変更せずに返却されます。(v0, v1)

set_params ( base =なし, subs =なし, numdecs =なし, numticks =なし)

このロケーター内でパラメーターを設定します。

潜水艦(潜水艦)

[非推奨] ログ スケーリングのマイナー ティックを設定しますbase**i*subs[j]。

ノート

バージョン 3.6 で非推奨:代わりに set_params(subs=...) を使用してください。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

view_limits ( vmin , vmax )

ビューの制限を賢く選択するようにしてください。

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

拠点:Formatter

確率フォーマッタ (Math テキストを使用)。

パラメータ:

use_overline bool、デフォルト: False

x > 1/2 で x = 1-v の場合、x を $overline{v}$ として表示するかどうかを示します。デフォルトでは、$1-v$ が表示されます。

one_half str、デフォルト: r"frac{1}{2}"

1/2 を表すために使用される文字列。

マイナーブール値、デフォルト: False

フォーマッタがマイナー ティックをフォーマットしているかどうかを示します。基本的にマイナー ティックはラベル付けされませんが、少数のティックのみが提供される場合を除いて、隣接するティックとのほとんどのスペースを持つティックがラベル付けされます。デフォルトの動作を変更するには、他のパラメーターを参照してください。

minor_threshold int、デフォルト: 25

一部のマイナー ティックにラベルを付けるためのロックの最大数。minor が False の場合、このパラメータは無効です。

マイナー番号int、デフォルト: 6

ティック数がしきい値を下回ったときにラベル付けされるティック数。

format_data_short (値)

ティック値の短い文字列バージョンを返します。

デフォルトは、位置に依存しない long 値です。

set_locs ( locs )

目盛りの位置を設定します。

このメソッドは、目盛りラベルを計算する前に呼び出されます。一部のフォーマッタは、すべての目盛り位置を知る必要があるためです。

set_minor_number (マイナー番号)

一部のマイナー ティックにラベルが付けられている場合に、ラベルを付けるマイナー ティックの数を設定します。

パラメータ:

マイナー番号int

ティック数がしきい値を下回ったときにラベル付けされるティック数。

set_minor_threshold ( minor_threshold )

マイナー ティックのラベル付けのしきい値を設定します。

パラメータ:

minor_threshold int

一部の小目盛りにラベルを付けるための位置の最大数。minor が False の場合、このパラメータは無効です。

set_one_half ( one_half )

半分の表示方法を設定します。

one_half str、デフォルト: r"frac{1}{2}"

1/2 を表すために使用される文字列。

use_overline ( use_overline )

p>1/2 のラベリングにオーバーラインを使用して表示モードを切り替えます。

パラメータ:

use_overline bool、デフォルト: False

x > 1/2 で x = 1-v の場合、x を $overline{v}$ として表示するかどうかを示します。デフォルトでは、$1-v$ が表示されます。

クラス matplotlib.ticker。LogitLocator (マイナー= False , * , nbins = 'auto' )

拠点:MaxNLocator

ロジット軸の目盛りの位置を決定する

ロジットの場所に目盛りを付けます

パラメータ:

nbins int または 'auto'、オプション

ティック数。マイナーが False の場合にのみ使用されます。

マイナーブール値、デフォルト: False

このロケーターがマイナー ティック用かどうかを示します。

プロパティ マイナー

非特異( vmin、 vmax )

特異点を避けるために、必要に応じて範囲を調整します。

このメソッドは、軸にデータが含まれている場合、または含まれていない場合は、軸のデータ制限に設定されて、 自動スケーリング中に呼び出されます。(v0, v1)(-inf, +inf)

• (場合によっては浮動小数点スロップまで)、このメソッドはこの値の周りの拡張された間隔を返します。v0 == v1

• の場合、このメソッドは適切なデフォルトのビュー制限を返します。(v0, v1) == (-inf, +inf)

• それ以外の場合は、変更せずに返却されます。(v0, v1)

set_params (マイナー=なし、 ** kwargs )

このロケーター内でパラメーターを設定します。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

クラス matplotlib.ticker。MaxNLocator ( nbins = None , ** kwargs )

拠点:Locator

ビューの制限内に N 以下の適切な目盛り位置を見つけます。自動スケーリングをサポートするために、制限を超える場所が追加されます。

パラメータ:

nbins int または 'auto'、デフォルト: 10

間隔の最大数。ティックの最大数より 1 つ少ない。文字列 'auto' の場合、ビンの数は軸の長さに基づいて自動的に決定されます。

ステップ配列のような、オプション

1 で始まり 10 で終わる素敵な数字のシーケンス。例: [1, 2, 4, 5, 10] の場合、値は許容可能な目盛りの倍数です。たとえば、20、40、60 は 2 の倍数であるため、0.4、0.6、0.8 と同様に許容されるティックのセットになります。ただし、30、60、90 は許可されません。ステップのリスト。

整数ブール値、デフォルト: False

True の場合、少なくとも min_n_ticks整数がビュー制限内で見つかった場合、ティックは整数値のみを取ります。

対称ブール、デフォルト: False

True の場合、自動スケーリングはゼロを中心に対称な範囲になります。

prune {'lower', 'upper', 'both', None}, デフォルト: なし

rcParams["axes.autolimit_mode"]エッジの目盛りを削除 - 主に(default: 'data') が の場合、1 つの軸の上部の目盛りがその上の軸の下部の目盛りと重なる、積み上げまたはギャング プロットに役立ちます'round_numbers'。の場合prune=='lower'、最小の目盛りが削除されます。の場合、最大の目盛りが削除されます。の場合、最大および最小の目盛りが削除されます。pruneがNoneの場合、ダニは削除されません。prune == 'upper'prune == 'both'

min_n_ticks int、デフォルト: 2

この最小の目盛り数を取得するために、必要に応じて nbins と整数の制約を緩和します。

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

set_params ( ** kwargs )

このロケーターのパラメーターを設定します。

パラメータ:

nbins int または 'auto'、オプション

見るMaxNLocator

ステップ配列のような、オプション

見るMaxNLocator

整数ブール値、オプション

見るMaxNLocator

対称ブール、オプション

見るMaxNLocator

prune {'lower', 'upper', 'both', None}, オプション

見るMaxNLocator

min_n_ticks int、オプション

見るMaxNLocator

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

view_limits ( dmin , dmax )

vmin から vmax までの範囲のスケールを選択します。

ロケータの動作を変更するには、サブクラスでこのメソッドをオーバーライドする必要があります。

クラス matplotlib.ticker。MultipleLocator ( base = 1.0 )

拠点:Locator

ビュー間隔内の底の各整数倍に目盛りを設定します。

set_params (ベース)

このロケーター内でパラメーターを設定します。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

view_limits ( dmin , dmax )

ビュー制限を、データを含むベースの最も近い倍数に設定します。

クラス matplotlib.ticker。NullFormatter

拠点:Formatter

常に空の文字列を返します。

クラス matplotlib.ticker。NullLocator

拠点:Locator

目盛りなし

tick_values ( vmin , vmax )

目盛りの位置を返します。

ノート

値が Null であるため、このメソッドでは vmin と vmax は使用されません。

クラス matplotlib.ticker。PercentFormatter ( xmax = 100、小数= None、記号= '%'、 is_latex = False )

拠点:Formatter

数値をパーセンテージで書式設定します。

パラメータ:

xmaxフロート

数値をパーセンテージに変換する方法を決定します。 xmaxは 100% に対応するデータ値です。パーセンテージは次のように計算されます。したがって、データが既にパーセンテージにスケーリングされている場合、xmaxは 100 になります。もう 1 つの一般的な状況は、xmaxが 1.0 の場合です。x / xmax * 100

小数None または int

ポイントの後に配置する小数点以下の桁数。None (デフォルト) の場合、数値は自動的に計算されます。

シンボルstr または None

ラベルに追加される文字列。シンボルを使用しないことを示すために、 Noneまたは空にすることができます。 is_latexがTrueでない限り、 LaTeX の特殊文字は、ラテックス モードが有効になっている場合はいつでも記号でエスケープされます。

is_latexブール

Falseの場合、シンボル内の LaTeX 予約文字はエスケープされます。

convert_to_pct ( x )

format_pct ( x , display_range )

数値を正しい小数点以下の桁数のパーセンテージとして書式設定し、パーセント記号があれば追加します。

が の場合、小数点以下の桁数は、軸の display_range に基づいて次のように設定さself.decimalsれます。None

表示範囲	小数	サンプル
>50	0	x = 34.5=> 35%
>5	1	x = 34.5=> 34.5%
>0.5	2	x = 34.5=> 34.50%
...	...	...

この方法は、軸の範囲が小さい場合や非常に大きい場合にはあまり適していません。グラフの値は、適切なスケールで表示されたパーセンテージであると想定しています。

プロパティ 記号

文字列として構成されたパーセント記号。

rcParams["text.usetex"](デフォルト: )を介して LaTeX が有効になっている場合False、特殊文字 は文字列内で自動的にエスケープされます。{'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'}

クラス matplotlib.ticker。ScalarFormatter ( useOffset = None , useMathText = None , useLocale = None )

拠点:Formatter

目盛り値を数値としてフォーマットします。

パラメータ:

useOffset bool または float、デフォルト: rcParams["axes.formatter.useoffset"](デフォルト: True)

オフセット表記を使用するかどうか。を参照してくださいset_useOffset。

useMathText bool、デフォルト: rcParams["axes.formatter.use_mathtext"](デフォルト: False)

凝った数学フォーマットを使用するかどうか。を参照してくださいset_useMathText。

useLocale bool、デフォルト: rcParams["axes.formatter.use_locale"](デフォルト: False)。

小数点および正符号にロケール設定を使用するかどうか。を参照してくださいset_useLocale。

ノート

set_scientific 上記のパラメータに加えて、科学的表現と浮動小数点表現の書式設定は、とで構成できますset_powerlimits)。

オフセット表記と科学表記

オフセット表記と科学的表記は、一見非常によく似ています。どちらも、フォーマットされた目盛り値から一部の情報を分割し、軸の最後に表示します。

• 科学的表記法は、大きさの桁を分割します。つまり、乗法倍率1e6です。

• オフセット表記は、加算定数を区切り+1e6ます。+オフセット表記ラベルには常にまたは記号が前に付いて-いるため、大きさの順序ラベルと区別できます。

次の x 制限付きのプロットは、さまざまな書式設定1_000_000を示しています。1_000_010x 軸の右端にあるラベルに注意してください。

(ソースコード、png )

format_data (値)

位置が指定されていない値の完全な文字列表現を返します。

format_data_short (値)

ティック値の短い文字列バージョンを返します。

デフォルトは、位置に依存しない long 値です。

get_offset ( )

科学表記法とオフセットを返します。

get_useLocale ( )

書式設定にロケール設定が使用されるかどうかを返します。

こちらもご覧ください

ScalarFormatter.set_useLocale

get_useMathText ( )

派手な数学フォーマットを使用するかどうかを返します。

こちらもご覧ください

ScalarFormatter.set_useMathText

get_useOffset ( )

オフセット表記の自動モードがアクティブかどうかを返します。

これは、次の場合に True を返しますset_useOffset(True)。たとえば、明示的なオフセットが設定されている場合は False を返しますset_useOffset(1000)。

こちらもご覧ください

ScalarFormatter.set_useOffset

set_locs ( locs )

目盛りの位置を設定します。

このメソッドは、目盛りラベルを計算する前に呼び出されます。一部のフォーマッタは、すべての目盛り位置を知る必要があるためです。

set_powerlimits ( lims )

科学表記法のサイズのしきい値を設定します。

パラメータ:

lims (int, int)

スイッチオーバーのしきい値を決定する 10 のべき乗を含むタプル(min_exp、max_exp) 。として表現可能な数の場合 \(a \times 10^\mathrm{exp}\)と\(1 <= |a| < 10\)、または の場合は科学的表記法が使用されます。exp <= min_expexp >= max_exp

デフォルトの制限はrcParams["axes.formatter.limits"](デフォルト: ) によって制御されます。[-5, 6]

特に、 expがしきい値に等しい数値は、科学表記法で記述されます。

通常、min_expは負になり、max_expは正になります。

たとえば、次のフォーマットが提供されます。 formatter.set_powerlimits((-3, 4))\(1 \times 10^{-3}, 9.9 \times 10^{-3}, 0.01,\) \(9999, 1 \times 10^4\).

こちらもご覧ください

ScalarFormatter.set_scientific

set_scientific ( b )

科学表記法をオンまたはオフにします。

こちらもご覧ください

ScalarFormatter.set_powerlimits

set_useLocale ( val )

小数点および正符号のロケール設定を使用するかどうかを設定します。

パラメータ:

val bool または None

なしrcParams["axes.formatter.use_locale"](デフォルト: False)にリセットされます。

set_useMathText ( val )

派手な数式フォーマットを使用するかどうかを設定します。

アクティブな場合、科学表記法は次のようにフォーマットされます。\(1.2 \times 10^3\).

パラメータ:

val bool または None

なしrcParams["axes.formatter.use_mathtext"](デフォルト: False)にリセットされます。

set_useOffset ( val )

オフセット表記を使用するかどうかを設定します。

範囲に比べて値が大きいセット数値をフォーマットする場合、フォーマッタは加算定数を分離できます。これにより、書式設定された数値が短くなり、軸上に描画されたときに重複する可能性が低くなります。

パラメータ:

val bool または float

• False の場合、オフセット表記を使用しません。

• True (= 自動モード) の場合、残りの数を大幅に短くできる場合はオフセット表記を使用します。正確な動作はrcParams["axes.formatter.offset_threshold"](デフォルト: 4) によって制御されます。

• 数値の場合、指定された値のオフセットを強制します。

例

アクティブ オフセット表記では、値は

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

は、軸の端に書き込まれるオフセットに加えてフォーマットされます。0, 2, 4, 6, 8+1e5

プロパティ useLocale

書式設定にロケール設定が使用されるかどうかを返します。

こちらもご覧ください

ScalarFormatter.set_useLocale

プロパティ useMathText

派手な数学フォーマットを使用するかどうかを返します。

こちらもご覧ください

ScalarFormatter.set_useMathText

プロパティ useOffset

オフセット表記の自動モードがアクティブかどうかを返します。

これは、次の場合に True を返しますset_useOffset(True)。たとえば、明示的なオフセットが設定されている場合は False を返しますset_useOffset(1000)。

こちらもご覧ください

ScalarFormatter.set_useOffset

クラス matplotlib.ticker。StrMethodFormatter ( fmt )

拠点:Formatter

新しいスタイルのフォーマット文字列 ( で使用されているstr.format) を使用して、目盛りをフォーマットします。

目盛り値に使用するフィールドにはxというラベルを付け、目盛り位置に使用するフィールドにはposというラベルを付ける必要があります。

クラス matplotlib.ticker。SymmetricalLogLocator ( transform =なし, subs =なし, linthresh =なし, base =なし)

拠点:Locator

対称対数軸の目盛りの位置を決定します。

パラメータ:

変換SymmetricalLogTransform、オプション

設定されている場合、symlog 変換のベースとlinthreshを定義します。

ベース、リンスレッシュフロート、オプション

に記載されている symlog 変換のベースとlinthreshSymmetricalLogScale。これらのパラメータは、変換が設定されていない場合にのみ使用さ れます。

float のsubsシーケンス、デフォルト: [1]

目盛りが配置される基数の整数乗の倍数。つまり、目盛りは に配置され ます。[sub * base**i for i in ... for sub in subs]

ノート

transformまたはbaseとlinthreshの両方を指定する必要があります。

set_params ( subs = None , numticks = None )

このロケーター内でパラメーターを設定します。

tick_values ( vmin , vmax )

指定されたvminおよびvmaxにある目盛りの値を返します。

ノート

関連する vmin と vmax の値が自動的に定義された目盛りの位置を取得するには、axis単に Locator インスタンスを呼び出します。

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

view_limits ( vmin , vmax )

ビューの制限を賢く選択するようにしてください。

クラス matplotlib.ticker。TickHelper

拠点:object

軸=なし

create_dummy_axis ( ** kwargs )

set_axis (軸)

set_bounds ( vmin , vmax )

[非推奨]

ノート

バージョン 3.5 以降非推奨:代わりにAxis.set_view_intervalandを使用してください。Axis.set_data_interval

set_data_interval ( vmin , vmax )

[非推奨]

ノート

バージョン 3.5 以降非推奨:Axis.set_data_interval代わりに使用してください。

set_view_interval ( vmin , vmax )

[非推奨]

ノート

バージョン 3.5 以降非推奨:Axis.set_view_interval代わりに使用してください。