matplotlib.pyplot.tricontour #

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

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

呼び出し署名:

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

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

三角形を位置的に渡すことができます。ただし、これはお勧めできません。より明確にするために、キーワード引数を介して三角形を渡します。tricontour(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です。

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

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

「どちらでもない」場合、レベル範囲外の値は色付けされません。'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) から取得されます。

linewidths float または array-like、デフォルト: rcParams["contour.linewidth"](デフォルト: None)

等高線の線幅。

数値の場合、すべてのレベルがこの線幅でプロットされます。

シーケンスの場合、昇順のレベルが、指定された順序の線幅でプロットされます。

rcParams["lines.linewidth"]None の場合、これは(デフォルト: 1.5)にフォールバックします。

linestyles { None , 'solid', 'dashed', 'dashdot', 'dotted'}, オプション

linestylesがNoneの場合、線がモノクロでない限り、デフォルトは 'solid' です。その場合、負の等高線はrcParams["contour.negative_linestyle"](デフォルト: 'dashed') 設定から線種を取得します。

linestylesは、使用する線種のセットを指定する上記の文字列の iterable にすることもできます。この iterable が輪郭レベルの数よりも短い場合、必要に応じて繰り返されます。