matplotlib.axes.Axes.set_prop_cycle #
- 軸。set_prop_cycle ( *引数, ** kwargs ) [ソース] #
Axes のプロパティ サイクルを設定します。
プロパティ サイクルは、今後のプロット コマンドの色、マーカー、線種などのスタイル プロパティを制御します。Axes に既に追加されているデータのスタイル プロパティは変更されません。
呼び出し署名:
set_prop_cycle(cycler) set_prop_cycle(label=values[, label2=values2[, ...]]) set_prop_cycle(label, values)
フォーム 1 は、指定された
Cycler
オブジェクトを設定します。フォーム 2 は、
Cycler
1 つ以上のプロパティを同時に循環する を作成し、それを Axes のプロパティ サイクルとして設定します。複数のプロパティが指定されている場合、それらの値リストは同じ長さでなければなりません。これは、サイクラーを明示的に作成して関数に渡すための単なるショートカットです。つまり、 の略です 。set_prop_cycle(cycler(label=values label2=values2, ...))
フォーム 3 は
Cycler
、単一のプロパティに対して を作成し、それを Axes のプロパティ サイクルとして設定します。cycler.cycler
このフォームは、元のインターフェイスとの互換性のために存在します。kwarg 形式、つまりset_prop_cycle(label=values)
.- パラメータ:
- サイクラーサイクラー
指定された Cycler を設定します。Noneは、現在のスタイルによって定義されたサイクルにリセットされます。
- ラベル文字列
プロパティ キー。有効なプロパティである必要があり
Artist
ます。たとえば、'color' や 'linestyle' などです。'color' の 'c' や 'linewidth' の 'lw' などのエイリアスを使用できます。- 反復可能な値
プロパティ値の反復可能な有限長。これらの値は検証され、無効な場合は ValueError が発生します。
こちらもご覧ください
matplotlib.rcsetup.cycler
プロパティの検証済みサイクラーを作成するための便利な関数。
cycler.cycler
検証されていないサイクラーを作成するための元の関数。
例
単一のプロパティのプロパティ サイクルの設定:
>>> ax.set_prop_cycle(color=['red', 'green', 'blue'])
複数のプロパティを同時に循環させるためのプロパティ サイクルの設定 (例: 赤丸、緑プラス、青十字):
>>> ax.set_prop_cycle(color=['red', 'green', 'blue'], ... marker=['o', '+', 'x'])