matplotlib.axes.Axes.pcolor

軸。pcolor ( * args , shading = None , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , data = None , ** kwargs )

非規則的な長方形グリッドを使用して疑似カラー プロットを作成します。

呼び出し署名:

pcolor([X, Y,] C, **kwargs)

XとYを使用して、四角形の角を指定できます。

ヒント

pcolor()大きな配列では非常に遅くなる可能性があります。ほとんどの場合、 pcolormesh代わりに、類似しているがはるかに高速な を使用する必要があります。相違点については、pcolor() と pcolormesh() の相違点を参照してください 。

パラメータ:

C 2D 配列のような

カラーマップされた値。カラーマッピングは、cmap、 norm、vmin、およびvmaxによって制御されます。

X、Y配列のような、オプション

pcolormesh の四角形の角の座標:

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      +-----+
                      |     |
                      +-----+
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

列インデックスは x 座標に対応し、行インデックスは y に対応することに注意してください。詳細については、以下の 注記セクションを参照してください。

XとYshading='flat'の次元がCの次元より 1 大きい場合、四角形は の値により色付けされます。X 、Y、およびCの次元が等しい場合、警告が発生し、 Cの最後の行と列は無視されます。C[i, j]

の場合shading='nearest'、XとYの次元はCの次元と同じでなければなりません (そうでない場合は、ValueError が発生します)。色は を中心にします。C[i, j](X[i, j], Y[i, j])

Xおよび/またはYが 1 次元配列または列ベクトルの場合、必要に応じて適切な 2 次元配列に展開され、長方形のグリッドが作成されます。

shading {'flat', 'nearest', 'auto'}, デフォルト: rcParams["pcolor.shading"](デフォルト: 'auto')

四角形の塗りつぶしスタイル。可能な値:

• 'flat': 各クワッドに単色が使用されます。四角形 (i, j), (i+1, j), (i, j+1), (i+1, j+1) の色は で与えられ ます。XとYの次元は、 Cの次元より 1 大きくする必要があります。それらがCと同じである場合、非推奨の警告が発生し、 Cの最後の行と列が削除されます。C[i, j]

• 'nearest': 各グリッド ポイントは、隣接するグリッドの中心の中間まで広がる色を中心に配置されます。XとYの次元はCと同じでなければなりません。

• 'auto': XとYの次元がCよりも 1 大きい場合は、'flat' を選択します。次元が同じ場合は、「最も近い」を選択します。

詳細については、pcolormesh グリッドとシェーディング を参照してください。

cmap str またはColormap、デフォルト: rcParams["image.cmap"](デフォルト: 'viridis')

スカラー データを色にマップするために使用される Colormap インスタンスまたは登録済みのカラーマップ名。

ノルムstr またはNormalize、オプション

cmapを使用して色にマッピングする前に、スカラー データを [0, 1] の範囲にスケーリングするために使用される正規化方法。デフォルトでは、線形スケーリングが使用され、最小値が 0 に、最大値が 1 にマッピングされます。

指定する場合、これは次のいずれかになります。

• のインスタンスNormalizeまたはそのサブクラスの 1 つ ( Colormap Normalizationを参照)。

• スケール名。つまり、「linear」、「log」、「symlog」、「logit」などのいずれかです。使用可能なスケールのリストについては、 を呼び出しますmatplotlib.scale.get_scale_names()。その場合、適切なNormalizeサブクラスが動的に生成され、インスタンス化されます。

vmin、vmax float、オプション

スカラー データを使用し、明示的なnormを使用しない場合、vminとvmaxはカラーマップがカバーするデータ範囲を定義します。デフォルトでは、カラーマップは提供されたデータの値の範囲全体をカバーします。ノルムインスタンスが指定されているときにvmin / vmaxを使用するとエラーになります (ただし、 vmin / vmaxと 一緒にノルム名を使用することは許容されます)。str

edgecolors {'none', None, 'face', color, color sequence}, オプション

エッジの色。デフォルトは「なし」です。可能な値:

• 'none' または '': エッジなし。

• なし: rcParams["patch.edgecolor"](デフォルト: 'black') が使用されます。これが機能するには、現在 rcParams["patch.force_edgecolor"](デフォルト: False) が True でなければならないことに注意してください。

• 'face': 隣接する面の色を使用します。

• 色または色のシーケンスによって、エッジの色が設定されます。

単数形のedgecolorはエイリアスとして機能します。

アルファフロート、デフォルト: なし

面の色のアルファ ブレンディング値で、0 (透明) と 1 (不透明) の間です。注: 現在、edgecolor はこの影響を受けません。

snap bool、デフォルト: False

メッシュをピクセル境界にスナップするかどうか。

戻り値:

matplotlib.collections.Collection

その他のパラメータ:

antialiaseds bool、デフォルト: False

デフォルトのedgecolors ="none" が使用されている場合、デフォルトのアンチエイリアスは False です 。これにより、パッチ境界での人為的な線が削除され、アルファの値に関係なく機能します。edgecolorsが「none」でない場合、デフォルトのアンチエイリアスが (デフォルト: ) から取得されます。alphaが 1 の場合はエッジをなでることが推奨されますが、それ以外の場合はアーティファクトが発生します。rcParams["patch.antialiased"]True

データのインデックス可能なオブジェクト、オプション

指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]

**kwargs

さらに、次の引数が許可されます。PolyCollectionそれらはコンストラクターに渡されます。

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	配列状またはスカラーまたはなし
animated	ブール
antialiasedまたは aa またはアンチエイリアス	bool または bool のリスト
array	配列のようなものまたはなし
capstyle	CapStyleまたは {'butt', 'projecting', 'round'}
clim	(vmin: float、vmax: float)
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
cmap	Colormapまたは str または None
color	色または rgba タプルのリスト
edgecolorまたは ec または edgecolors	色または色のリストまたは「顔」
facecolorまたはfacecolorsまたはfc	色または色のリスト
figure	Figure
gid	力
hatch	{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
in_layout	ブール
joinstyle	JoinStyleまたは {'miter', 'round', 'bevel'}
label	物体
linestyleまたはダッシュまたはラインスタイルまたはls	str またはタプルまたはそのリスト
linewidthまたは線幅または lw	float または float のリスト
mouseover	ブール
norm	Normalizeまたは str または None
offset_transformまたはtransOffset	わからない
offsets	(N, 2) または (2,) 配列のようなもの
path_effects	AbstractPathEffect
paths	配列ライクのリスト
picker	None または bool または float または callable
pickradius	わからない
rasterized	ブール
sizes	ndarray またはなし
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
urls	str または None のリスト
verts	配列ライクのリスト
verts_and_codes	わからない
visible	ブール
zorder	浮く

こちらもご覧ください

pcolormesh

pcolor と pcolormesh の違いの説明。

imshow

XとYがそれぞれ等距離である場合imshowは、より高速な代替手段となる可能性があります。

ノート

マスクされた配列

X、Y、およびCは、マスクされた配列の場合があります。、または周囲の頂点( XまたはY at ) のいずれかがマスクされている場合、何もプロットされません。C[i, j]C[i, j][i, j], [i+1, j], [i, j+1], [i+1, j+1]

グリッドの向き

グリッドの方向は、標準の行列規則に従います。 形状 (nrows, ncolumns) の配列Cは、列番号をX、行番号をYとしてプロットされます。

を使用した例matplotlib.axes.Axes.pcolor

Pcolor デモ

Pcolor デモ

margin と sticky_edges を使用してビュー制限を制御する

margin と sticky_edges を使用してビュー制限を制御する