matplotlib.pyplot.pcolor #

matplotlib.pyplot. pcolor ( * args , shading = None , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , data = None , ** kwargs ) [source] #

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

呼び出し署名:

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としてプロットされます。