matplotlib.axes.Axes.pcolorfast #

軸。pcolorfast ( * args , alpha =なし, norm =なし, cmap =なし, vmin =なし, vmax =なし, data =なし, ** kwargs ) [source] #

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

呼び出し署名:

ax.pcolorfast([X, Y], C, /, **kwargs)

pcolorこの方法は、およびに似ていpcolormeshます。Agg バックエンドで最速の pcolor タイプのプロットを提供するように設計されています。これを実現するために、入力グリッド (通常の長方形、非通常の長方形、または任意の四角形) の複雑さに応じて、内部で異なるアルゴリズムを使用します。

警告

この方法は実験的なものです。と比較して、pcolorまたは pcolormeshいくつかの制限があります。

  • フラット シェーディングのみをサポートします (アウトラインなし)。

  • 軸の対数スケーリングはサポートされていません。

  • pyplot ラッパーを持っていません。

パラメータ:
C配列ライク

画像データです。サポートされている配列形状は次のとおりです。

  • (M, N): スカラー データを含む画像。カラーマッピングは、cmap、norm、vmin、およびvmaxによって制御されます。

  • (M, N, 3): RGB 値 (0 ～ 1 float または 0 ～ 255 int) を持つイメージ。

  • (M, N, 4): RGBA 値 (0 ～ 1 float または 0 ～ 255 int) を持つ画像。つまり、透明度を含みます。

最初の 2 つの次元 (M、N) は、イメージの行と列を定義します。

このパラメーターは、位置指定でのみ渡すことができます。

X、Yタプルまたは配列のようなもの、デフォルト: 、(0, N)(0, M)

XとYは、四角形の座標を指定するために使用されます。これにはさまざまな方法があります。

  • タプルとを使用して、一様な長方形のグリッドを定義します。X=(xmin, xmax)Y=(ymin, ymax)

    タプルは、グリッドの外縁を定義します。個々の四角形はすべて同じサイズになります。これは最速のバージョンです。

  • 1D 配列X、Yを使用して、一様でない長方形のグリッドを指定します。

    この場合、 XとYは長さ N+1とM+1の単調な 1D 配列で、セルの x と y の境界を指定する必要があります。

    速度は中程度です。注: グリッドがチェックされ、均一であることが判明した場合は、高速バージョンが使用されます。

  • 任意の四角形グリッドが必要な場合(つまり、四角形が長方形でない場合) は、 2D 配列X、Yを使用します。

    この場合、 XとYは形状 (M + 1, N + 1) の 2D 配列で、色付きの四角形の角の x 座標と y 座標を指定します。

    これは最も一般的ですが、レンダリングが最も遅くなります。ただし、ps、pdf、および svg バックエンドを使用すると、より高速でコンパクトな出力が生成される場合があります。

これらの引数は、位置的にのみ渡すことができます。

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

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

Cが RGB(A) の場合、このパラメーターは無視されます。

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

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

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

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

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

Cが RGB(A) の場合、このパラメーターは無視されます。

vmin、vmax float、オプション

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

Cが RGB(A) の場合、このパラメーターは無視されます。

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

0 (透明) から 1 (不透明) までのアルファ ブレンディング値。

snap bool、デフォルト: False

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

戻り値:
AxesImageまたはPcolorImageまたはQuadMesh

戻り値のタイプは、グリッドのタイプによって異なります。

  • AxesImage通常の長方形グリッドの場合。

  • PcolorImage非規則的な長方形グリッドの場合。

  • QuadMesh非長方形グリッドの場合。

その他のパラメータ:
データのインデックス可能なオブジェクト、オプション

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

**kwargs

サポートされる追加パラメーターは、グリッドのタイプによって異なります。詳細については、画像の戻り値の型を参照してください。

#を使用した例matplotlib.axes.Axes.pcolorfast

Pcolor デモ

Pcolor デモ

Pcolor デモ