matplotlib.pyplot.pcolormesh #

matplotlib.pyplot. 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

pcolormeshもう 1 つの違いは、では使用できないグーロー シェーディングのサポートです pcolor。