matplotlib.axes.Axes.tricontour #
- 軸。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+1
MaxNLocatorを超えない「適切な」等高線レベル を自動的に選択しようとします。配列状の場合、指定されたレベルで等高線を描画します。値は昇順でなければなりません。
- 三角測量
- 戻り値:
- その他のパラメータ:
- 色色の文字列または色のシーケンス、オプション
レベルの色、つまり等高線。
シーケンスはレベルごとに昇順で繰り返されます。シーケンスがレベル数より短い場合は、それが繰り返されます。
ショートカットとして、単一の色の文字列を 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と 一緒にノルム名を使用することは許容されます)。
strvminまたは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 が輪郭レベルの数よりも短い場合、必要に応じて繰り返されます。
