matplotlib.text#

図にテキストを含めるためのクラス。

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

拠点:Artist

ウィンドウまたはデータ座標でのテキストの格納と描画を処理します。

文字列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

浮く

含む(マウスイベント) [ソース] #

テキストの軸に沿ったバウンディング ボックス内でマウス イベントが発生したかどうかを返します。

draw (レンダラー) [ソース] #

指定されたレンダラーを使用してアーティスト (およびその子) を描画します。

アーティストが表示されていない場合、これは効果がありません ( Artist.get_visible False を返します)。

パラメータ:
レンダラーRendererBaseのサブクラス。

ノート

このメソッドは Artist サブクラスでオーバーライドされます。

get_bbox_patch ( ) [ソース] #

bbox パッチを返すか、作成されてpatches.FancyBboxPatch いない場合は None を返します。

get_c ( ) [ソース] #

のエイリアスget_color

get_color ( ) [ソース] #

テキストの色を返します。

get_family ( ) [ソース] #

のエイリアスget_fontfamily

get_font ( ) [ソース] #

のエイリアスget_fontproperties

get_font_properties ( ) [ソース] #

のエイリアスget_fontproperties

get_fontfamily ( ) [ソース] #

フォント ルックアップに使用されるフォント ファミリのリストを返します。

こちらもご覧ください

font_manager.FontProperties.get_family
get_fontname ( ) [ソース] #

フォント名を文字列として返します。

こちらもご覧ください

font_manager.FontProperties.get_name
get_fontproperties ( ) [ソース] #

を返しますfont_manager.FontProperties

get_fontsize ( ) [ソース] #

フォント サイズを整数で返します。

こちらもご覧ください

font_manager.FontProperties.get_size_in_points
get_fontstyle ( ) [ソース] #

フォント スタイルを文字列として返します。

こちらもご覧ください

font_manager.FontProperties.get_style
get_fontvariant ( ) [ソース] #

フォント バリアントを文字列として返します。

こちらもご覧ください

font_manager.FontProperties.get_variant
get_fontweight ( ) [ソース] #

文字列または数値としてフォントの太さを返します。

こちらもご覧ください

font_manager.FontProperties.get_weight
get_ha ( ) [ソース] #

のエイリアスget_horizontalalignment

get_horizo​​ntalalignment ( ) [ソース] #

水平方向の配置を文字列として返します。「左」、「中央」、または「右」のいずれかになります。

get_math_fontfamily ( ) [ソース] #

Matplotlib によってレンダリングされる数学テキストのフォント ファミリ名を返します。

デフォルト値はrcParams["mathtext.fontset"](デフォルト: 'dejavusans') です。

こちらもご覧ください

set_math_fontfamily
get_name ( ) [ソース] #

のエイリアスget_fontname

get_parse_math ( ) [ソース] #

この に対して数学テキストの解析が考慮されるかどうかを返しますText

get_position ( ) [ソース] #

テキストの (x, y) 位置を返します。

get_prop_tup ( renderer = None ) [source] #

[非推奨] プロパティのハッシュ可能なタプルを返します。

人間が判読できるようにすることは意図していませんが、テキストに関する派生情報 (レイアウトなど) をキャッシュしたいバックエンドや、テキストが変更されたかどうかを知る必要があるバックエンドに役立ちます。

ノート

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

get_rotation ( ) [ソース] #

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

get_rotation_mode ( ) [ソース] #

テキストの回転モードを返します。

get_size ( ) [ソース] #

のエイリアスget_fontsize

get_stretch ( ) [ソース] #

フォント ストレッチを文字列または数値として返します。

こちらもご覧ください

font_manager.FontProperties.get_stretch
get_style ( ) [ソース] #

のエイリアスget_fontstyle

get_text ( ) [ソース] #

テキスト文字列を返します。

get_transform_rotates_text ( ) [ソース] #

変換の回転がテキストの方向に影響するかどうかを返します。

get_unitless_position ( ) [ソース] #

テキストの (x, y) 単位なしの位置を返します。

get_usetex ( ) [ソース] #

Textこのオブジェクトがレンダリングに TeX を使用するかどうかを返します。

get_va ( ) [ソース] #

のエイリアスget_verticalalignment

get_variant ( ) [ソース] #

のエイリアスget_fontvariant

get_verticalalignment ( ) [ソース] #

垂直方向の配置を文字列として返します。「top」、「center」、「bottom」、「baseline」、または「center_baseline」のいずれかになります。

get_weight ( ) [ソース] #

のエイリアスget_fontweight

get_window_extent ( renderer = None , dpi = None ) [source] #

Bboxテキストの境界を表示単位で返します。

内部で使用するだけでなく、Web ページの png ファイルでクリック可能な領域を指定する場合にも役立ちます。

パラメータ:
レンダラーレンダラー、オプション

境界ボックスを計算するにはレンダラーが必要です。アーティストが既に描画されている場合、レンダラーはキャッシュされます。get_window_extent したがって、最初の描画の前に呼び出すときにのみ、この引数を渡す必要があります。実際には、通常は最初にドローをトリガーする方が簡単です。たとえば、 draw_without_renderingまたはを呼び出しplt.show()ます。

dpi float、オプション

bbox を計算するための dpi 値。デフォルトは self.figure.dpi(レンダラーの dpi ではありません)。カスタム dpi 値で保存された図と領域を一致させる場合などに設定する必要があります。

get_wrap ( ) [ソース] #

テキストを折り返すことができるかどうかを返します。

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

わからない

clip_on

わからない

clip_path

わからない

color

figure

Figure

fontfamily

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

fontproperties

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

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

visible

ブール

wrap

ブール

x

浮く

y

浮く

zorder

浮く

set_backgroundcolor () [ソース] #

bbox を更新して、テキストの背景色を設定します。

パラメータ:
カラーカラー

こちらもご覧ください

set_bbox

境界ボックスの位置を変更するには

set_bbox ( rectprops ) [ソース] #

自分自身の周りにバウンディング ボックスを描画します。

パラメータ:
プロパティを持つrectprops dictpatches.FancyBboxPatch

デフォルトのボックス スタイルは「正方形」です。の変異スケールはpatches.FancyBboxPatchfontsize に設定されます。

t.set_bbox(dict(facecolor='red', alpha=0.5))
set_c () [ソース] #

のエイリアスset_color

set_clip_box (クリップボックス) [ソース] #

アーティストのクリップを設定しますBbox

パラメータ:
クリップボックスBbox
set_clip_on ( b ) [ソース] #

アーティストがクリッピングを使用するかどうかを設定します。

False アーティストが Axes の外側に表示されると、予期しない結果が生じる可能性があります。

パラメータ:
ブール
set_clip_path (パス変換=なし) [ソース] #

アーティストのクリップ パスを設定します。

パラメータ:
パスPatchまたはPathまたはTransformedPathまたは なし

クリップ パス。が指定されている場合はPath変換も提供する必要があります。Noneの場合、以前に設定されたクリップ パスは削除されます。

変換Transform、オプション

pathが の場合にのみ使用されます。Pathこの場合、指定Path されたものはTransformedPathusing transformに変換されます。

ノート

効率化のため、パスが の場合、Rectangleこのメソッドはクリッピング ボックスを対応する四角形に設定し、クリッピング パスを に設定しNoneます。

技術的な理由 ( のサポートset) により、タプル ( pathtransform ) も単一の位置パラメーターとして受け入れられます。

set_color () [ソース] #

テキストの前景色を設定する

パラメータ:
カラーカラー
set_family (フォント名) [ソース] #

のエイリアスset_fontfamily

set_font ( fp ) [ソース] #

のエイリアスset_fontproperties

set_font_properties ( fp ) [ソース] #

のエイリアスset_fontproperties

set_fontfamily (フォント名) [ソース] #

フォントファミリーを設定します。単一の文字列、または優先度の低い文字列のリストのいずれかです。各文字列は、実際のフォント名または一般的なフォント クラス名のいずれかです。後者の場合、特定のフォント名が対応する rcParams で検索されます。

Textインスタンスが で構築されている場合fontfamily=None、フォントはrcParams["font.family"](デフォルト: ) に設定され、既存の インスタンスで が呼び出さ['sans-serif']れたときにも同じことが行われます。set_fontfamily()Text

パラメータ:
fontname {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

こちらもご覧ください

font_manager.FontProperties.set_family
set_fontname ( fontname ) [ソース] #

のエイリアスset_family

一方向のエイリアスのみ: getter が異なります。

パラメータ:
fontname {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

こちらもご覧ください

font_manager.FontProperties.set_family
set_fontproperties ( fp ) [ソース] #

テキストを制御するフォント プロパティを設定します。

パラメータ:
fpfont_manager.FontPropertiesまたはstrまたはpathlib.Path

の場合、strによって解析された fontconfig パターンとして解釈され FontPropertiesます。の場合、pathlib.Pathフォント ファイルへの絶対パスとして解釈されます。

set_fontsize ( fontsize ) [ソース] #

フォントサイズを設定します。

パラメータ:
fontsize float または {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

float の場合、ポイント単位のフォント サイズ。文字列値は、デフォルトのフォント サイズに対する相対的なサイズを示します。

こちらもご覧ください

font_manager.FontProperties.set_size
set_fontstretch (ストレッチ) [ソース] #

フォントストレッチ(横の縮小または拡大)を設定します。

パラメータ:
Stretch {0 ~ 1000 の範囲の数値、「超凝縮」、「超凝縮」、「凝縮」、「半圧縮」、「通常」、「半拡張」、「拡張」、「超圧縮」拡張された'、'超拡張された'}

こちらもご覧ください

font_manager.FontProperties.set_stretch
set_fontstyle ( fontstyle ) [ソース] #

フォント スタイルを設定します。

パラメータ:
fontstyle {'normal', 'italic', 'oblique'}

こちらもご覧ください

font_manager.FontProperties.set_style
set_fontvariant (バリアント) [ソース] #

フォントバリアントを設定します。

パラメータ:
バリアント{'normal', 'small-caps'}

こちらもご覧ください

font_manager.FontProperties.set_variant
set_fontweight (ウェイト) [ソース] #

フォントの太さを設定します。

パラメータ:
weight {0 ~ 1000 の範囲の数値、'ultralight'、'light'、'normal'、'regular'、'book'、'medium'、'roman'、'semibold'、'demibold'、'demi' , '太字', '重い', '極太字', '黒'}

こちらもご覧ください

font_manager.FontProperties.set_weight
set_ha (整列) [ソース] #

のエイリアスset_horizontalalignment

set_horizo​​ntalalignment (整列) [ソース] #

アンカー ポイントを基準にして水平方向の配置を設定します。

テキストの配置も参照してください。

パラメータ:
整列{'左', '中央', '右'}
set_linespacing (間隔) [ソース] #

行間隔をフォント サイズの倍数として設定します。

デフォルトの行間隔は 1.2 です。

パラメータ:
間隔フロート (フォント サイズの倍数)
set_ma (整列) [ソース] #

のエイリアスset_multialignment

set_math_fontfamily ( fontfamily ) [ソース] #

Matplotlib によってレンダリングされる数学テキストのフォント ファミリを設定します。

これは、Matplotlib 独自の数学レンダラーにのみ影響します。TeX ( ) でレンダリングする場合は効果がありませんusetex=True

パラメータ:
fontfamily str

フォントファミリーの名前。

利用可能なフォント ファミリは、 matplotlibrc.template ファイルで定義されています。

こちらもご覧ください

get_math_fontfamily
set_multialignment (整列) [ソース] #

マルチ テキストのテキスト配置を設定します。

すべての線の境界ボックスのレイアウトは、 horizo​​ntalalignment および verticalalignment プロパティによって決定されます。このプロパティは、そのボックス内のテキスト行の配置を制御します。

パラメータ:
整列{'左', '右', '中央'}
set_name (フォント名) [ソース] #

のエイリアスset_fontname

set_parse_math ( parse_math ) [ソース] #

この の数学テキストの解析を無効にするには、スイッチをオーバーライドしますText

パラメータ:
parse_mathブール

False の場合、Text数学テキストは使用されません。True の場合、エスケープされていないドル記号が偶数個ある場合に mathtext が使用されます。

set_position ( xy ) [ソース] #

テキストの ( x , y ) 位置を設定します。

パラメータ:
xy (フロート、フロート)
set_rotation ( s ) [ソース] #

テキストの回転を設定します。

パラメータ:
float または {'vertical', 'horizo​​ntal' }

数学的に正の方向 (反時計回り) の度単位の回転角度。「水平」は 0、「垂直」は 90 です。

set_rotation_mode ( m ) [ソース] #

テキストの回転モードを設定します。

パラメータ:
m {なし、「デフォルト」、「アンカー」}

Noneまたはの場合"default"、テキストは最初に回転され、次に水平方向と垂直方向の配置に従って配置されます。の場合 "anchor"、位置合わせは回転の前に行われます。

set_size ( fontsize ) [ソース] #

のエイリアスset_fontsize

set_stretch (ストレッチ) [ソース] #

のエイリアスset_fontstretch

set_style ( fontstyle ) [ソース] #

のエイリアスset_fontstyle

set_text ( s ) [ソース] #

テキスト文字列sを設定します。

改行 ( \n) または LaTeX 構文の数式を含めることができます。

パラメータ:
オブジェクト

空の文字列に変換されるものをstr除いて、 すべてのオブジェクトがその表現に変換されます。None

set_transform_rotates_text ( t ) [ソース] #

変換の回転がテキストの方向に影響するかどうか。

パラメータ:
ブール
set_usetex ( usetex ) [ソース] #
パラメータ:
usetex bool または None

TeX を使用してレンダリングするかどうか、使用するNoneことを意味します rcParams["text.usetex"](デフォルト: False)。

set_va (整列) [ソース] #

のエイリアスset_verticalalignment

set_variant (バリアント) [ソース] #

のエイリアスset_fontvariant

set_verticalalignment (整列) [ソース] #

アンカー ポイントを基準にして垂直方向の配置を設定します。

テキストの配置も参照してください。

パラメータ:
align {'bottom', 'baseline', 'center', 'center_baseline', 'top'}
set_weight ( weight ) [ソース] #

のエイリアスset_fontweight

set_wrap (ラップ) [ソース] #

テキストを折り返すかどうかを設定します。

パラメータ:
ラップブール

ノート

ラッピングは ( IPython/Jupyter で内部的にも使用されます)と一緒には機能しません 。'tight' 設定では、すべてのコンテンツに対応するようにキャンバスが再スケーリングされ、ラップの前に行われます。savefig(..., bbox_inches='tight')%matplotlib inline

set_x ( x ) [ソース] #

テキストのx位置を設定します。

パラメータ:
×フロート
set_y ( y ) [ソース] #

テキストのy位置を設定します。

パラメータ:
yフロート
更新( kwargs ) [ソース] #

このアーティストのプロパティを dict propsから更新します。

パラメータ:
小道具の口述
update_bbox_position_size (レンダラー) [ソース] #

bbox の場所とサイズを更新します。

このメソッドは、bbox を実際に描画する前に、bbox の位置とサイズを更新する必要がある場合に使用する必要があります。

update_from (その他) [ソース] #

プロパティをotherからselfにコピーします。

ズオーダ= 3 #
クラス matplotlib.text. Annotation ( text , xy , xytext = None , xycoords = 'data' , textcoords = None , arrowprops = None , annotation_clip = None , ** kwargs ) [source] #

塩基: Text,_AnnotationBase

AnAnnotationText、特定の位置xyを参照できる aです。オプションで、テキストからxyを指す矢印を描くことができます。

属性:
XY

注釈付きの位置。

xy座標

xyの座標系。

arrow_patch

xytextからxyFancyArrowPatchを指すA 。

ポイントxyにテキストtextで注釈を付けます。

最も単純な形式では、テキストはxyに配置されます。

オプションで、テキストを別の位置xytextに表示できます。テキストから注釈付きの点xyを指す矢印は、 arrowpropsを定義することで追加できます。

パラメータ:
テキスト文字列

注釈のテキスト。

xy (フロート、フロート)

注釈を付ける点(x, y) 。座標系はxycoordsによって決定されます。

xytext (float、float)、デフォルト: xy

テキストを配置する位置(x, y) 。座標系はtextcoordsによって決定されます。

xycoords str or Artistor Transformor callable or (float, float), default: 'data'

xyが与えられる座標系。次のタイプの値がサポートされています。

  • 次のいずれかの文字列:

    価値

    説明

    「フィギュアポイント」

    図の左下からのポイント

    「図形ピクセル」

    図の左下からのピクセル

    「数字の分数」

    図の端数を左下から

    「サブフィギュア ポイント」

    サブフィギュアの左下からのポイント

    'サブフィギュア ピクセル'

    サブフィギュアの左下からのピクセル

    'サブフィギュア分数'

    サブフィギュアの左下からの端数

    「軸ポイント」

    軸の左下隅からのポイント

    「軸ピクセル」

    軸の左下隅からのピクセル

    「軸分数」

    左下からの軸の分数

    'データ'

    注釈が付けられているオブジェクトの座標系を使用 (デフォルト)

    「極性」

    (シータ、r)ネイティブの「データ」座標でない場合

    'サブフィギュア ピクセル' と 'フィギュア ピクセル' は親 Figure で同じであるため、サブフィギュアで使用できるコードが必要なユーザーは 'サブフィギュア ピクセル' を使用できることに注意してください。

  • An Artist: xyは、アーティストの の分数として解釈され Bboxます。たとえば、(0, 0)はバウンディング ボックスの左下隅になり、(0.5, 1)はバウンディング ボックスの中央上部になります。

  • xyを画面座標Transformに変換するA。

  • 次のシグネチャのいずれかを持つ関数:

    def transform(renderer) -> Bbox
    def transform(renderer) -> Transform
    

    rendererRendererBaseサブクラスです。

    Artist関数の結果は、上記のおよび Transformケースのように解釈されます。

  • xyの別々の座標系を指定するタプル(xcoords, ycoords)xcoordsycoordsは、それぞれ上記のタイプのいずれかでなければなりません。

詳細については、高度な注釈を参照してください。

textcoords str or Artistor Transformor callable or (float, float), デフォルト: xycoordsの値

xytextが与えられる座標系。

すべてのxycoords値と次の文字列が有効です。

価値

説明

「オフセットポイント」

xy値からのオフセット (ポイント単位)

「オフセット ピクセル」

xy値からのオフセット (ピクセル単位)

arrowprops dict、オプション

位置xyxytextFancyArrowPatchの間に矢印を描画するために使用されるプロパティ。デフォルトは None です。つまり、矢印は描画されません。

歴史的な理由から、矢印を指定するには、「シンプル」と「ファンシー」の 2 つの異なる方法があります。

単純な矢印:

arrowpropsにキー 'arrowstyle' が含まれていない場合、許可されるキーは次のとおりです。

説明

ポイント単位の矢印の幅

ヘッド幅

矢印の基部のポイント単位の幅

頭の長さ

ポイント単位の矢頭の長さ

縮む

両端から収縮する全長の割合

?

任意のキーmatplotlib.patches.FancyArrowPatch

矢印はテキスト ボックスの端に取り付けられ、正確な位置 (角または中央) は、それが指している場所によって異なります。

ファンシーアロー:

これは、「arrowstyle」が arrowprops で提供されている場合に使用されます

有効なキーは次のFancyArrowPatch パラメーターです。

説明

アロースタイル

矢印のスタイル

接続スタイル

接続スタイル

relpos

下記参照; デフォルトは (0.5, 0.5) です

パッチA

デフォルトはテキストの境界ボックスです

パッチB

デフォルトはなし

シュリンクA

デフォルトは 2 ポイントです

シュリンクB

デフォルトは 2 ポイントです

突然変異スケール

デフォルトはテキストサイズ (ポイント単位)

突然変異の側面

デフォルトは 1 です。

?

任意のキーmatplotlib.patches.PathPatch

矢印の正確な始点位置は relposによって定義されます。これはテキスト ボックスの相対座標のタプルで、(0, 0) は左下隅、(1, 1) は右上隅です。<0 および >1 の値がサポートされており、テキスト ボックスの外側のポイントを指定します。デフォルト (0.5, 0.5) では、開始点はテキスト ボックスの中央にあります。

Annotation_clip bool または None、デフォルト: None

注釈ポイントxyが軸領域の外側にある場合に、注釈をクリップする (つまり、描画しない) かどうか。

  • Trueの場合、 xyが軸の外側にある場合、注釈はクリップされます。

  • Falseの場合、注釈は常に描画されます。

  • Noneの場合、 xyが軸の外にあり、xycoordsが 'data' の場合、注釈はクリップされます。

**kwargs

追加の kwargs が に渡されTextます。

戻り値:
Annotation

こちらもご覧ください

高度な注釈
プロパティ anncoords #

に使用する座標系Annotation.xyann

含む(イベント) [ソース] #

テキストの軸に沿ったバウンディング ボックス内でマウス イベントが発生したかどうかを返します。

draw (レンダラー) [ソース] #

指定されたレンダラーを使用してアーティスト (およびその子) を描画します。

アーティストが表示されていない場合、これは効果がありません ( Artist.get_visible False を返します)。

パラメータ:
レンダラーRendererBaseのサブクラス。

ノート

このメソッドは Artist サブクラスでオーバーライドされます。

get_anncoords ( ) [ソース] #

に使用する座標系を返しますAnnotation.xyann

のxycoordsも参照してくださいAnnotation

get_tightbbox ( renderer = None ) [source] #

と同様Artist.get_window_extentですが、クリッピングが含まれます。

パラメータ:
レンダラーRendererBaseサブクラス

図形の描画に使用されるレンダラー (つまり fig.canvas.get_renderer())

戻り値:
Bbox

囲んでいる境界ボックス (Figure のピクセル座標)。

get_window_extent ( renderer = None ) [source] #

Bboxテキストの境界を表示単位で返します。

内部で使用するだけでなく、Web ページの png ファイルでクリック可能な領域を指定する場合にも役立ちます。

パラメータ:
レンダラーレンダラー、オプション

境界ボックスを計算するにはレンダラーが必要です。アーティストが既に描画されている場合、レンダラーはキャッシュされます。get_window_extent したがって、最初の描画の前に呼び出すときにのみ、この引数を渡す必要があります。実際には、通常は最初にドローをトリガーする方が簡単です。たとえば、 draw_without_renderingまたはを呼び出しplt.show()ます。

dpi float、オプション

bbox を計算するための dpi 値。デフォルトは self.figure.dpi(レンダラーの dpi ではありません)。カスタム dpi 値で保存された図と領域を一致させる場合などに設定する必要があります。

set ( * agg_filter=<UNSET> alpha=<UNSET> animated=<UNSET> anncoords=<UNSET> annotation_clip=<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>picker=<UNSET>position=<UNSET > 、 rasterized=< UNSET>rotation=<UNSET>rotation_mode=<UNSET>sketch_params=<UNSET>snap=<設定解除> ,text=<UNSET> ,transform=<UNSET> , 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

ブール

anncoords

わからない

annotation_clip

ブールまたはなし

backgroundcolor

bbox

プロパティを持つdictpatches.FancyBboxPatch

clip_box

Bbox

clip_on

ブール

clip_path

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

colorまたはc

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

浮く

set_anncoords ( coords ) [ソース] #

に使用する座標系を設定しますAnnotation.xyann

のxycoordsも参照してくださいAnnotation

set_figure () [ソース] #

Figureアーティストが属するインスタンスを設定します。

パラメータ:
Figure
update_positions (レンダラー) [ソース] #

注釈テキストと矢印パッチのピクセル位置を更新します。

プロパティ xyann #

テキストの位置。

のxytextも参照してくださいAnnotation

プロパティ xycoords #
クラス matplotlib.text. OffsetFrom (アーティスト ref_coordユニット= 'ポイント' ) [ソース] #

拠点:object

を操作するための呼び出し可能なヘルパー クラスAnnotation

パラメータ:
アーティストArtistまたはBboxBaseまたはTransform

オフセットを計算するオブジェクト。

ref_coord (フロート、フロート)

artistArtistまたはの場合BboxBase、この値は アーティストのバウンディング ボックスの端数で表したオフセット原点の位置です。

アーティストがトランスフォームの場合、オフセット原点はこの値に適用されるトランスフォームです。

単位{'points, 'pixels'}、デフォルト: 'points'

オフセット入力に使用するスクリーン単位 (ピクセルまたはポイント)。

get_unit ( ) [ソース] #

で使用される変換への入力の単位を返し__call__ます。

set_unit (ユニット) [ソース] #

で使用される変換への入力の単位を設定し__call__ます。

パラメータ:
単位{'ポイント', 'ピクセル'}