matplotlib.contour#

Axes クラスの等高線図とラベリングをサポートするクラス。

クラス matplotlib.contour。ClabelText ( x = 0 , y = 0 , text = '' , * , color =なし, verticalalignment = 'baseline' , horizo ​​ntalalignment = 'left' , multialignment =なし, fontproperties =なし, rotation =なし, linespacing =なし, rotation_mode =なし, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs ) [source] #

拠点:Text

通常のテキストとは異なり、get_rotation は、入力回転がデータ座標 (または任意の変換セット) の角度であると仮定して、ピクセル座標で更新された角度を返します。

文字列textでxyTextにインスタンスを作成します。

テキストは、 (デフォルト: 'left') および (デフォルト: 'bottom' ) に従って、アンカー ポイント ( xy ) に対して相対的に配置されます。テキストの配置も参照してください 。horizontalalignmentverticalalignment

Text は「label」キーワード引数を受け入れますが、デフォルトでは凡例のハンドルには追加されません。

有効なキーワード引数は次のとおりです。

財産

説明

agg_filter

(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数

alpha

スカラーまたはなし

animated

ブール

backgroundcolor

bbox

プロパティを持つdictpatches.FancyBboxPatch

clip_box

わからない

clip_on

わからない

clip_path

わからない

colorまたはc

figure

Figure

fontfamilyまたは家族

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontpropertiesまたは font または font_properties

font_manager.FontPropertiesまたはstrまたはpathlib.Path

fontsizeまたはサイズ

float または {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

fontstretchまたはストレッチ

{範囲 0 ~ 1000 の数値、「超凝縮」、「超凝縮」、「凝縮」、「半圧縮」、「通常」、「半拡張」、「拡張」、「超拡張」 ', '超拡張'}

fontstyleまたはスタイル

{'normal', 'italic', 'oblique'}

fontvariantまたはバリアント

{'normal', 'small-caps'}

fontweightまたは重量

{0 ~ 1000 の範囲の数値、'ultralight'、'light'、'normal'、'regular'、'book'、'medium'、'roman'、'semibold'、'demibold'、'demi'、 'bold', 'heavy', 'extra bold', 'black'}

gid

horizontalalignmentまたはは

{'左', '中央', '右'}

in_layout

ブール

label

物体

linespacing

float (フォントサイズの倍数)

math_fontfamily

mouseover

ブール

multialignmentまたはま

{'左', '右', '中央'}

parse_math

ブール

path_effects

AbstractPathEffect

picker

None または bool または float または callable

position

(浮く、浮く)

rasterized

ブール

rotation

float または {'vertical', 'horizo​​ntal'}

rotation_mode

{なし、「デフォルト」、「アンカー」}

sketch_params

(位取り: float、長さ: float、乱数: float)

snap

ブールまたはなし

text

物体

transform

Transform

transform_rotates_text

ブール

url

usetex

ブールまたはなし

verticalalignmentまたはva

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

ブール

wrap

ブール

x

浮く

y

浮く

zorder

浮く

get_rotation ( ) [ソース] #

テキストの角度を 0 ~ 360 度で返します。

set ( * , agg_filter=<UNSET> , alpha=<UNSET > , animation=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box = <UNSET > , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET > , fontstyle=<UNSET > , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<UNSET>, horizo​​ntalalignment=<UNSET>, in_layout=<UNSET> , label=<UNSET> , linespacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> ,ピッカー=<UNSET>position=<UNSET > 、 rasterized=<UNSET >rotation=<UNSET>rotation_mode=<UNSET>sketch_params=<UNSET>snap=<UNSET>text=<UNSET>transform=<設定解除> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> ) [ソース] #

一度に複数のプロパティを設定します。

サポートされているプロパティは

財産

説明

agg_filter

(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数

alpha

スカラーまたはなし

animated

ブール

backgroundcolor

bbox

プロパティを持つdictpatches.FancyBboxPatch

clip_box

Bbox

clip_on

ブール

clip_path

パッチまたは (パス、変換) またはなし

colorまたはc

figure

Figure

fontfamilyまたは家族

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontpropertiesまたは font または font_properties

font_manager.FontPropertiesまたはstrまたはpathlib.Path

fontsizeまたはサイズ

float または {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

fontstretchまたはストレッチ

{範囲 0 ~ 1000 の数値、「超凝縮」、「超凝縮」、「凝縮」、「半圧縮」、「通常」、「半拡張」、「拡張」、「超拡張」 ', '超拡張'}

fontstyleまたはスタイル

{'normal', 'italic', 'oblique'}

fontvariantまたはバリアント

{'normal', 'small-caps'}

fontweightまたは重量

{0 ~ 1000 の範囲の数値、'ultralight'、'light'、'normal'、'regular'、'book'、'medium'、'roman'、'semibold'、'demibold'、'demi'、 'bold', 'heavy', 'extra bold', 'black'}

gid

horizontalalignmentまたはは

{'左', '中央', '右'}

in_layout

ブール

label

物体

linespacing

float (フォントサイズの倍数)

math_fontfamily

mouseover

ブール

multialignmentまたはま

{'左', '右', '中央'}

parse_math

ブール

path_effects

AbstractPathEffect

picker

None または bool または float または callable

position

(浮く、浮く)

rasterized

ブール

rotation

float または {'vertical', 'horizo​​ntal'}

rotation_mode

{なし、「デフォルト」、「アンカー」}

sketch_params

(位取り: float、長さ: float、乱数: float)

snap

ブールまたはなし

text

物体

transform

Transform

transform_rotates_text

ブール

url

usetex

ブールまたはなし

verticalalignmentまたはva

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

ブール

wrap

ブール

x

浮く

y

浮く

zorder

浮く

クラス matplotlib.contour。ContourLabeler [ソース] #

拠点:object

にラベル付け機能を提供するための Mixin ContourSet

add_label ( x , y ,回転, lev , cvalue ) [ソース] #

Textクラスを使用して等高線ラベルを追加します。

add_label_clabeltext ( x , y ,回転, lev , cvalue ) [ソース] #

ClabelTextクラスを使用して等高線ラベルを追加します。

add_label_near ( x , y , inline = True , inline_spacing = 5 , transform = None ) [source] #

ポイントの近くにラベルを追加します。(x, y)

パラメータ:
x、yフロート

ラベルのおおよその位置。

インラインブール、デフォルト: True

Trueの場合、ラベルの下の輪郭のセグメントを削除します。

inline_spacing int、デフォルト: 5

インラインで配置するときに、ラベルの両側に残すスペース (ピクセル単位)。この間隔は、等高線が直線である場所のラベルでは正確ですが、曲線の等高線上のラベルでは正確ではありません。

変換TransformまたはFalse、デフォルト:self.axes.transData

ラベル付けの前に適用される変換。デフォルトでは、データ座標として解釈されます。 の同義語です。つまり、表示座標として解釈する必要があります。(x, y)(x, y)FalseIdentityTransform(x, y)

calc_label_rot_and_inline ( slc , ind , lw , lc =なし,間隔= 5 ) [source] #

スクリーン単位のラインコンター座標、ラベル位置のインデックス、およびラベル幅を指定して、適切なラベル回転を計算します。

lcが None または空でない場合、輪郭を分割してインライン化を計算します。

間隔は、ラベルの周囲に残す空白スペース (ピクセル単位) です。

パスの長さを複数回計算するのを避けるために、両方のタスクが一緒に実行されます。これは比較的コストがかかります。

ここで使用される方法では、輪郭に沿ったパスの長さをピクセル座標で計算し、中心点からおよそ (ラベル幅 / 2) 離れて回転を決定し、必要に応じて輪郭を分割します。

clabel ( level = None , * , fontsize = None , inline = True , inline_spacing = 5 , fmt = None , colors = None , use_clabeltext = False , manual = False , rightside_up = True , zorder = None ) [source] #

等高線図にラベルを付けます。

this の線の輪郭にラベルを追加しますContourSet(これは、この mixin クラスから継承されます)。

パラメータ:
level配列のような、オプション

ラベルを付ける必要があるレベル値のリスト。リストは のサブセットである必要がありますcs.levels。指定しない場合、すべてのレベルにラベルが付けられます。

fontsize str または float、デフォルト: rcParams["font.size"](デフォルト: 10.0)

ポイント単位のサイズまたは相対的なサイズ (例: 'smaller'、'x-large')。Text.set_size受け入れられる文字列値については、を参照してください。

色または色またはなし、デフォルト: なし

ラベルの色:

  • Noneの場合、各ラベルの色は対応する等高線の色と一致します。

  • 1 つの文字列の色 (たとえば、colors = 'r' またはcolors = 'red') の場合、すべてのラベルがこの色でプロットされます。

  • 色のタプル (string、float、rgb など) の場合、異なるラベルが指定された順序で異なる色でプロットされます。

インラインブール、デフォルト: True

Trueラベルが配置されている場所の下にある輪郭が削除された場合。

inline_spacing float、デフォルト: 5

インラインで配置するときに、ラベルの両側に残すスペース (ピクセル単位)。

この間隔は、等高線が直線である場所のラベルでは正確ですが、曲線の等高線上のラベルでは正確ではありません。

fmtFormatterまたは str または callable または dict、オプション

レベルのフォーマット方法:

  • の場合、そのメソッドFormatterを使用してすべてのレベルを一度にフォーマットするために使用されます。Formatter.format_ticks

  • str の場合、% スタイルのフォーマット文字列として解釈されます。

  • callable の場合、一度に 1 つのレベルで呼び出され、対応するラベルを返す必要があります。

  • 辞書の場合、レベルをラベルに直接マップする必要があります。

デフォルトでは、標準を使用しますScalarFormatter

manual bool または iterable、デフォルト: False

の場合True、等高線ラベルはマウス クリックを使用して手動で配置されます。等高線の近くにある最初のボタンをクリックしてラベルを追加し、2 番目のボタン (または場合によっては両方のマウス ボタンを同時に) をクリックして、ラベルの追加を終了します。3 番目のボタンは、最後に追加されたラベルを削除するために使用できますが、ラベルがインラインでない場合のみです。別の方法として、キーボードを使用してラベルの位置を選択することもできます (Enter でラベルの配置を終了し、削除またはバックスペースはマウスの 3 番目のボタンのように機能し、その他のキーはラベルの位置を選択します)。

manualは、(x, y) タプルの反復可能なオブジェクトにすることもできます。マウスが各 (x, y) 位置でクリックされたかのように、等高線ラベルが作成されます。

rightside_up bool、デフォルト: True

の場合True、ラベルの回転は常にレベルからプラスまたはマイナス 90 度になります。

use_clabeltext bool、デフォルト: False

の場合TrueClabelText( の代わりにText) class を使用してラベルを作成します。ClabelText描画時にテキストの回転角度を再計算するため、軸のアスペクトが変化した場合に使用できます。

zorder float または None、デフォルト:(2 + contour.get_zorder())

等高線ラベルの zorder。

戻り値:
ラベル

Textラベルのインスタンスのリスト。

get_label_width ( lev , fmt , fsize ) [ソース] #

[非推奨] ラベルの幅をポイント単位で返します。

ノート

バージョン 3.5 以降は非推奨です。

get_text ( lev , fmt ) [ソース] #

ラベルのテキストを取得します。

ラベル( inline inline_spacing ) [ソース] #
locate_label ( linecontour , labelwidth ) [ソース] #

ラベルを描くのに適した場所 (輪郭の比較的平坦な部分) を見つけます。

pop_label (インデックス= -1 ) [ソース] #

デフォルトでは最後のラベルを削除しますが、任意のインデックスを指定できます

print_label ( linecontour , labelwidth ) [ソース] #

輪郭がラベルを保持するのに十分な長さかどうかを返します。

set_label_props ( label , text , color ) [source] #

ラベルのプロパティ (色、フォントサイズ、テキスト) を設定します。

too_close ( x , y , lw ) [ソース] #

ラベルがすでにこの場所の近くにあるかどうかを返します。

クラス matplotlib.contour。ContourSet ( ax , * args ,レベル=なし,塗りつぶし= False ,線幅=なし,線スタイル=なし,ハッチ= (なし,) ,アルファ=なし,原点=なし,範囲=なし, cmap =なし,=なし,ノルム=なし vmin =なし vmax =なし extend = 'neither' antialiased =なし nchunk = 0 locator =なし transform =なし negative_linestyles =なし ** kwargs ) [source] #

塩基: ScalarMappable,ContourLabeler

等高線または塗りつぶし領域のセットを保存します。

ユーザーが呼び出し可能なメソッド:clabel

パラメータ:
Axes
レベル[レベル 0、レベル 1、...、レベル n]

等高線レベルを示す浮動小数点数のリスト。

allsegs [level0segs, level1segs, ...]

すべてのレベルのすべてのポリゴン セグメントのリスト。等高線用、および塗りつぶされた等高線領域用。リストは次のようになりますlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkindsNoneまたは [level0kinds, level1kinds, ...]

パスで説明および使用されている、すべてのポリゴン頂点の種類 (コード タイプ) のオプション リスト。これは、塗りつぶされたポリゴン内の穴など、複数接続されたパスを許可するために使用されます。そうでない場合はNone、. リストは次のようになりますlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

allkindsが でない場合None、通常、特定の等高線レベルのすべてのポリゴンがグループ化され、 と.level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

キーワード引数は、 の docstring で説明されているとおりです contour

属性:
Axes

等高線が描画される Axes オブジェクト。

コレクションsilent_list_PathCollection

Artist輪郭を表す s 。PathCollectionこれは、線と塗りつぶされた等高線の両方の のリストです 。

レベル配列

コンター レベルの値。

レイヤー配列

等高線のレベルと同じ。塗りつぶされた等高線のレベルの中間。を参照してくださいContourSet._process_colors

キーワードargfilledFalse(デフォルト)か に応じて、等高線または塗りつぶされた領域を描画しますTrue

呼び出し署名:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)
パラメータ:
Axes

Axes描画するオブジェクト。

レベル[レベル 0、レベル 1、...、レベル n]

等高線レベルを示す浮動小数点数のリスト。

allsegs [level0segs, level1segs, ...]

すべてのレベルのすべてのポリゴン セグメントのリスト。等高線用、および塗りつぶされた等高線領域用。リストは次のようになりますlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkinds [level0kinds, level1kinds, ...], オプション

パスで説明および使用されている、すべてのポリゴン頂点の種類 (コード タイプ) のオプション リスト。これは、塗りつぶされたポリゴン内の穴など、複数接続されたパスを許可するために使用されます。そうでない場合はNone、. リストは次のようになりますlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

allkindsが でない場合None、通常、特定の等高線レベルのすべてのポリゴンがグループ化され、 と.level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

キーワード引数は、 の docstring で説明されているとおりです contour

変更( ) [ソース] #

mappable が変更されるたびにこれを呼び出して、すべての callbackSM リスナーに「変更された」シグナルを通知します。

find_nearest_contour ( x , y ,インデックス=なし,ピクセル= True ) [ソース] #

に最も近い等高線図の点を見つけます。(x, y)

このメソッドは、塗りつぶされた等高線をサポートしていません。

パラメータ:
x、yフロート

基準点。

int または None のインデックスリスト、デフォルト: None

考慮する等高線レベルのインデックス。None (デフォルト) の場合、すべてのレベルが考慮されます。

ピクセルブール値、デフォルト: True

Trueの場合、ピクセル (スクリーン) 空間で距離を測定します。これは、手動の等高線ラベル付けに役立ちます。それ以外の場合は、軸空間で距離を測定します。

戻り値:
輪郭Collection

に最も近い輪郭。(x, y)

セグメント整数

に最も近い Pathインコンターのインデックス。(x, y)

インデックス整数

に最も近い セグメント内のパス セグメントのインデックス。(x, y)

xmin、ymin float

に最も近い等高線図の点。(x, y)

d2フロート

からまでの二乗距離。(xmin, ymin)(x, y)

get_alpha ( ) [ソース] #

すべての ContourSet アーティストに適用されるアルファを返します。

get_transform ( ) [ソース] #

Transformこの ContourSet で使用されるインスタンスを返します。

legend_elements ( variable_name='x' , str_format=<class 'str'> ) [source] #

legendこの ContourSet を表すパススルーに適したアーティストとラベルのリストを返します。

ラベルの形式は「0 < x <= 1」で、アーティストが表すデータ範囲を示しています。

パラメータ:
variable_name str

ラベルで使用される不等式の内部で使用される文字列。

str_format関数: float -> str

ラベルの数値をフォーマットするために使用される関数。

戻り値:
アーティスト一覧[ Artist]

アーティスト一覧です。

ラベルリスト[文字列]

ラベルのリスト。

set_alpha (アルファ) [ソース] #

すべての ContourSet アーティストのアルファ ブレンディング値を設定します。 alphaは 0 (透明) から 1 (不透明) の間でなければなりません。

クラス matplotlib.contour。QuadContourSet ( ax , * args ,レベル=なし,塗りつぶし= False ,線幅=なし,線種=なし,ハッチ= (なし,) ,アルファ=なし,原点=なし,範囲=なし, cmap =なし,=なし,ノルム=なし vmin =なし vmax =なし extend = 'neither' antialiased =なし nchunk = 0 locator =なし transform =なし negative_linestyles =なし ** kwargs ) [source] #

拠点:ContourSet

一連の等高線​​または塗りつぶし領域を作成して保存します。

通常、このクラスはユーザーによって直接インスタンス化されるのではなく、 contourおよびによってインスタンス化されますcontourf

属性:
Axes

等高線が描画される Axes オブジェクト。

コレクションsilent_list_PathCollection

Artist輪郭を表す s 。PathCollectionこれは、線と塗りつぶされた等高線の両方の のリストです 。

レベル配列

コンター レベルの値。

レイヤー配列

等高線のレベルと同じ。塗りつぶされた等高線のレベルの中間。を参照してくださいContourSet._process_colors

キーワードargfilledFalse(デフォルト)か に応じて、等高線または塗りつぶされた領域を描画しますTrue

呼び出し署名:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)
パラメータ:
Axes

Axes描画するオブジェクト。

レベル[レベル 0、レベル 1、...、レベル n]

等高線レベルを示す浮動小数点数のリスト。

allsegs [level0segs, level1segs, ...]

すべてのレベルのすべてのポリゴン セグメントのリスト。等高線用、および塗りつぶされた等高線領域用。リストは次のようになりますlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkinds [level0kinds, level1kinds, ...], オプション

パスで説明および使用されている、すべてのポリゴン頂点の種類 (コード タイプ) のオプション リスト。これは、塗りつぶされたポリゴン内の穴など、複数接続されたパスを許可するために使用されます。そうでない場合はNone、. リストは次のようになりますlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

allkindsが でない場合None、通常、特定の等高線レベルのすべてのポリゴンがグループ化され、 と.level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

キーワード引数は、 の docstring で説明されているとおりです contour