matplotlib.axes.Axes.pcolormesh #

軸。pcolormesh ( * args , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , shading = None , antialiased = False , data = None , ** kwargs ) [source] #

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

呼び出し署名:

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

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

ヒント

pcolormeshに似ていpcolorます。これははるかに高速で、ほとんどの場合に好まれます。違いの詳細については、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'gouraud'の次元はCの次元と同じでなければなりません (そうでない場合は、ValueError が発生します)。色はを中心にしています。の場合、四角形のコーナー間で滑らかな補間が実行されます。'nearest'C[i, j](X[i, j], Y[i, j])'gouraud'

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

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 (不透明) までのアルファブレンディング値。

shading {'flat', 'nearest', 'gouraud', 'auto'}, オプション

四角形の塗りつぶしスタイル。デフォルトは 'flat' または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と同じでなければなりません。
'gouraud': 各クワッドはグーローシェーディングになります: 角 (i', j') の色はで与えられます。間の領域のカラー値は、コーナーの値から補間されます。XとYの次元はCと同じでなければなりません。グーローシェーディングを使用すると、edgecolorsは無視されます。C[i', j']
'auto': XとYの次元がCよりも 1 大きい場合は、'flat' を選択します。次元が同じ場合は、「最も近い」を選択します。

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

snap bool、デフォルト: False

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

ラスタ化されたブール値、オプション

ベクターグラフィックスを描画するときに pcolormesh をラスタライズします。これにより、レンダリングが高速化され、大きなデータセットに対して小さなファイルが生成されます。ベクターグラフィックスのラスタライズも参照してください。

戻り値:

matplotlib.collections.QuadMesh

その他のパラメータ:

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

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

**kwargs

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

財産	説明
`agg_filter`	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
`alpha`	配列状またはスカラーまたはなし
`animated`	ブール
`antialiased`または aa またはアンチエイリアス	bool または bool のリスト
`array`	(M, N) 配列状または M*N 配列状
`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`
`picker`	None または bool または float または callable
`pickradius`	わからない
`rasterized`	ブール
`sketch_params`	(位取り: float、長さ: float、乱数: float)
`snap`	ブールまたはなし
`transform`	`Transform`
`url`	力
`urls`	str または None のリスト
`visible`	ブール
`zorder`	浮く

こちらもご覧ください

pcolor: わずかに異なる機能を持つ代替実装。違いの詳細については、pcolor() と pcolormesh()の違いを参照してください。
imshow: XとYがそれぞれ等距離である場合imshowは、より高速な代替手段となる可能性があります。

ノート

マスクされた配列

Cは、マスクされた配列の場合があります。がマスクされている場合、対応する四角形が透明になります。XとYのマスキングはサポートされていません。この機能が必要な場合に使用します。C[i, j]pcolor

グリッドの向き

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

pcolor() と pcolormesh() の違い

どちらの方法も、四角形を使用して 2D 配列の疑似カラープロットを作成するために使用されます。

主な違いは、作成されたオブジェクトと内部データの処理にありpcolorます。後者は、特定の目的により特化しているため、高速です。ほとんどの場合、優先されるはずです。PolyCollectionpcolormeshQuadMesh

マスクされた配列の処理にもわずかな違いがあります。との両方がCのマスクされた配列をサポートしpcolorます。ただし、X およびYのマスクされた配列のみをサポートします。その理由は、マスクされた値の内部処理にあります。 PolyCollection からそれぞれのポリゴンを除外します。マスクされた要素の facecolor を透明に設定します。edgecolors を使用すると違いがわかります。QuadMesh ではマスキングに関係なくすべてのエッジが描画されますが、PolyCollection には対応するポリゴンが存在しないため、2 つの隣接するマスクされた四角形の間のエッジは描画されません。pcolormeshpcolorpcolorpcolormeshpcolor