matplotlib.pyplot.tricontourf #

matplotlib.pyplot. tricontourf ( *引数, ** kwargs ) [ソース] #

構造化されていない三角形のグリッドに等高線領域を描画します。

呼び出し署名:

tricontourf(triangulation, Z, [levels], ...)
tricontourf(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)

三角グリッドは、Triangulation オブジェクトを最初のパラメーターとして渡すか、ポイントx、yおよびオプションで三角形とmaskを渡すことによって指定できます。Triangulationこれらのパラメータの説明については、を参照してください。三角形分割も 三角形も指定されていない場合、三角形分割はオンザフライで計算されます。

三角形を位置的 に渡すことができます。ただし、これはお勧めできません。より明確にするために、キーワード引数を介して三角形を渡します。tricontourf(x, y, triangles, Z, ...)

パラメータ:
三角測量Triangulation、オプション

作成済みの三角グリッド。

x、y、三角形、マスク

三角グリッドを定義するパラメータ。を参照してくださいTriangulation。これは、 triangulationの指定と相互に排他的です。

Z配列のような

等高線が描画される高さの値。カラーマッピングは、cmap、norm、vmin、およびvmaxによって制御されます。

level int または array-like、オプション

等高線/領域の数と位置を決定します。

int nの場合、 を使用します。これは、 vminとvmaxの間でn+1MaxNLocatorを超えない「適切な」等高線レベル を自動的に選択しようとします。

配列状の場合、指定されたレベルで等高線を描画します。値は昇順でなければなりません。

戻り値:
TriContourSet
その他のパラメータ:
色色の文字列または色のシーケンス、オプション

レベルの色、つまり輪郭領域。

シーケンスはレベルごとに昇順で繰り返されます。シーケンスがレベル​​数より短い場合は、それが繰り返されます。

ショートカットとして、単一の色の文字列を 1 つの要素のリストの代わりに使用できます。つまり、すべてのレベルを同じ色で色付けする'red'代わりに使用できます。['red']このショートカットは、色を指定する他の方法ではなく、色の文字列に対してのみ機能します。

デフォルト (値None ) では、cmapで指定されたカラーマップが使用されます。

アルファフロート、デフォルト: 1

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

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

vminまたはvmaxが指定されていない場合、デフォルトのカラー スケーリングはレベルに基づいてい ます。

色が設定されている場合、このパラメーターは無視されます。

origin {なし, 'upper', 'lower', 'image'}, デフォルト: なし

の位置を指定して、Zの方向と正確な位置を決定します。これは、 X、Yが指定されていない場合にのみ関係します。Z[0, 0]

  • なし:左下隅の X=0、Y=0 にあります。Z[0, 0]

  • 「lower」:左下隅の X=0.5、Y=0.5 にあります。Z[0, 0]

  • 'upper':左上隅の X=N+0.5、Y=0.5 にあります。Z[0, 0]

  • 'image': からの値を使用しますrcParams["image.origin"](既定値: 'upper')。

範囲(x0、x1、y0、y1)、オプション

originがNoneでない場合、範囲は のように解釈されimshowます: 外側のピクセル境界を示します。この場合、Z[0, 0] の位置はピクセルの中心であり、コーナーではありません。originがNoneの場合、( x0 , y0 ) は Z[0, 0] の位置、( x1 , y1 ) は Z[-1, -1] の位置です。

この引数は、contour の呼び出しでXとYが指定されている場合は無視されます。

locator ticker.Locator サブクラス、オプション

等高線レベルがレベルで明示的に指定されていない場合、ロケータを使用して等高線レベルを決定します。デフォルトはMaxNLocatorです。

拡張{'どちらでもない', '両方', '最小', '最大'}, デフォルト: 'どちらでもない'

レベル範囲tricontourf外の値の色付けを 決定します。

「どちらでもない」場合、レベル範囲外の値は色付けされません。'min'、'max'、または 'both' の場合、レベル範囲の下、上、または下と上の値に色を 付けます。

上下の値はmin(levels)、 の上下の値max(levels)にマッピングされますColormap。ほとんどのカラーマップにはデフォルトで専用の色がないことに注意してください。そのため、オーバー値とアンダー値はカラーマップのエッジ値になります。Colormap.set_underおよびを使用して、これらの値を明示的に設定することができますColormap.set_over。

ノート

TriContourSetカラーマップのプロパティが変更された場合、既存のは通知されません。したがって、 ContourSet.changed()カラーマップを変更した後は、 を明示的に呼び出す必要があります。TriContourSet内部で を呼び出すため、カラーバーが に割り当てられている場合は、明示的な呼び出しを省略することができ ますContourSet.changed()。

xunits、yunits登録単位、オプション

のインスタンスを指定して、軸の単位をオーバーライドします matplotlib.units.ConversionInterface。

アンチエイリアスブール値、オプション

アンチエイリアシングを有効にして、デフォルトをオーバーライドします。塗りつぶされた等高線の場合、デフォルトはTrueです。線の輪郭の場合はrcParams["lines.antialiased"](デフォルト: True) から取得されます。

ハッチリスト[文字列]、オプション

塗りつぶされた領域で使用するクロス ハッチング パターンのリスト。None の場合、輪郭にハッチングは追加されません。ハッチングは、PostScript、PDF、SVG、および Agg バックエンドでのみサポートされています。

ノート

tricontourf上部が閉じている間隔を埋めます。つまり、境界z1およびz2の場合、塗りつぶされた領域は次のようになります。

z1 < Z <= z2

ただし、両側が閉じている最小区間は除きます (つまり、最小値が含まれます)。