matplotlib.table

テーブルの描画。

ノート

Matplotlib でのテーブルの実装は簡単に維持されます。より機能的なテーブルの実装については、blumeを試してみてください。

factory 関数tableを使用して、テキストから既製のテーブルを作成します。さらに制御が必要な場合は、Tableクラスとそのメソッドを使用してください。

テーブルは、(行、列) によってインデックス付けされたセルのグリッドで構成されます。セル (0, 0) は左上に配置されます。

クラスとテーブルを提供してくれた John Gill に感謝します。

クラス matplotlib.table。Cell ( xy , width , height , * , edgecolor = 'k' , facecolor = 'w' , fill = True , text = '' , loc = None , fontproperties = None , visible_edges = 'closed' )

拠点:Rectangle

セルは、Rectangle関連付けられTextた です。

ユーザーとして、自分でセルを作成することはおそらくないでしょう。代わりに、tableファクトリ関数または のいずれかを使用する必要がありますTable.add_cell。

パラメータ:

xy 2 タプル

セルの左下隅の位置。

幅フロート

セルの幅。

高さフロート

セルの高さ。

エッジの色

セルの境界線の色。

フェイスカラーカラー

セルの facecolor。

ブールを埋める

セルの背景が塗りつぶされているかどうか。

テキスト文字列

セルのテキスト。

loc {'left', 'center', 'right'}, デフォルト: 'right'

セル内のテキストの配置。

フォントプロパティ辞書

テキストのフォント プロパティを定義する辞書。サポートされているキーと値は、 で受け入れられるキーワード引数FontPropertiesです。

visible_edges str、デフォルト: 'closed'

線で描画されるセルの端: 'BRTL' (下、右、上、左) の部分文字列、または 'open' (端が描画されない)、'closed' (すべての端が描画される)、'horizo​​ntal' のいずれか(下と上)、「垂直」(右と左)。

パッド= 0.1

テキストと四角形の間のパディング。

auto_set_font_size (レンダラー)

テキストがセル幅に収まるまでフォント サイズを縮小します。

draw (レンダラー)

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

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

パラメータ:

レンダラーRendererBaseのサブクラス。

ノート

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

get_fontsize ( )

セルのフォントサイズを返します。

get_path ( )

Pathに対して aを返しvisible_edgesます。

get_required_width (レンダラー)

セルに必要な最小幅を返します。

get_text ( )

Textセルインスタンスを返します。

get_text_bounds ( renderer )

テーブル座標の (x、y、幅、高さ)としてテキスト境界を返します。

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , angle=< UNSET> , animation=<UNSET> , antialiased=<UNSET> , bounds=<UNSET> ,capstyle = < UNSET > , clip_box = <UNSET > , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , fill=<UNSET> , fontsize=<UNSET> , gid=<UNSET> ,ハッチ=<UNSET> ,高さ=<未設定> ,in_layout=<UNSET> , joinstyle=<UNSET> , label=< UNSET> , linestyle=< UNSET> , linewidth=<UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET > , rasterized = <UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text_props=<UNSET> , transform=<UNSET> , url=<UNSET> , visible=<UNSET> , width=<UNSET> , x=<UNSET > , xy=<UNSET> , y=<UNSET> , zorder=<UNSET> )

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

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

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	スカラーまたはなし
angle	わからない
animated	ブール
antialiasedまたはああ	ブールまたはなし
bounds	(左、下、幅、高さ)
capstyle	CapStyleまたは {'butt', 'projecting', 'round'}
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
color	色
edgecolorまたはec	色またはなし
facecolorまたはfc	色またはなし
figure	わからない
fill	ブール
fontsize	わからない
gid	力
hatch	{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
height	わからない
in_layout	ブール
joinstyle	JoinStyleまたは {'miter', 'round', 'bevel'}
label	物体
linestyleまたは ls	{'-', '--', '-.', ':', '', (オフセット, オンオフシーケンス), ...}
linewidthまたはlw	float または None
mouseover	ブール
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
text_props	わからない
transform	わからない
url	力
visible	ブール
width	わからない
x	わからない
xy	(浮く、浮く)
y	わからない
zorder	浮く

set_figure (図)

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

パラメータ:

図Figure

set_fontsize (サイズ)

テキストのフォントサイズを設定します。

set_text_props ( ** kwargs )

テキスト プロパティを更新します。

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

財産	説明
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	浮く

set_transform (トランス)

アーティスト トランスフォームを設定します。

パラメータ:

tTransform

プロパティ visible_edges

線で描画されるセルの端。

このプロパティを読み取ると、'BRTL' (下、右、上、左) の部分文字列が返されます。

このプロパティを設定する場合、'BRTL' の部分文字列、または {'open', 'closed', 'horizo​​ntal', 'vertical'} のいずれかを使用できます。

matplotlib.table. CustomCell

のエイリアスCell

クラス matplotlib.table。テーブル( ax、 loc =なし、 bbox =なし、 ** kwargs )

拠点:Artist

セルのテーブル。

テーブルは、(行、列) によってインデックス付けされたセルのグリッドで構成されます。

単純なテーブルの場合、(0, 0) から (num_rows-1, num_cols-1) までのインデックスを持つセルのフル グリッドがあり、セル (0, 0) が左上に配置されます。ただし、負のインデックスを持つセルを追加することもできます。すべてのグリッド位置にセルを追加する必要がないため、穴のあるテーブルを作成できます。

注: 通常、最初から空のテーブルを作成することはありません。代わりに table、データからテーブルを作成するために使用します。

パラメータ:

斧matplotlib.axes.Axes

Axesテーブルをプロットする。

ロック文字列

axに対するセルの位置。これは のいずれかである必要がありますcodes。

bboxBboxまたはなし

テーブルを描画するバウンディング ボックス。これがNoneでない場合、これはlocをオーバーライドします。

その他のパラメータ:

**kwargs

Artistプロパティ。

AXESPAD = 0.02

Axes 単位での Axes とテーブル エッジの間の境界。

フォントサイズ= 10

add_cell (行,列, *引数, ** kwargs )

セルを作成し、テーブルに追加します。

パラメータ:

行の整数

行インデックス。

列int

列インデックス。

*引数、**kwargs

他のすべてのパラメータは に渡されCellます。

戻り値:

Cell

作成されたセル。

auto_set_column_width ( col )

特定の列の幅を最適なサイズに自動的に設定します。

パラメータ:

col int または int のシーケンス

自動スケーリングする列のインデックス。

auto_set_font_size ( value = True )

フォントサイズを自動設定。

コード= {'最高': 0, '下': 17, '左下': 12, '右下': 13, '中央': 9, '中央左': 5, '中央右': 6, '左': 15, '下中央': 7, '左下': 3, '右下': 4, '右': 14, '上': 16, '左上': 11, '右上': 10、「アッパーセンター」：8、「左上」：2、 ' 右上': 1}

Axes を基準にしてテーブルを配置する可能な値。

含む(マウスイベント)

アーティストにマウス イベントが含まれているかどうかをテストします。

パラメータ:

マウスイベントmatplotlib.backend_bases.MouseEvent

戻り値:

ブール値を含む

値が半径内にあるかどうか。

詳細辞書

ピック半径に含まれるポイントなど、イベント コンテキストの詳細に関するアーティスト固有のディクショナリ。詳細については、個々のアーティスト サブクラスを参照してください。

draw (レンダラー)

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

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

パラメータ:

レンダラーRendererBaseのサブクラス。

ノート

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

プロパティの エッジ

visible_edgesを使用して新しく追加されたセルのデフォルト値add_cell。

ノート

この設定は現在、 を使用して新しく作成されたセルにのみ影響し add_cellます。

既存のセルを変更するには、エッジを明示的に設定する必要があります。

for c in tab.get_celld().values():
    c.visible_edges = 'horizontal'

get_celld ( )

テーブル マッピング(行、列)内のセルの辞書を Cellsに返します。

ノート

Table オブジェクトに直接インデックスを付けて、個々のセルにアクセスすることもできます。

cell = table[row, col]

get_children ( )

テーブルに含まれるアーティストを返します。

get_window_extent ( renderer = None )

表示スペースでアーティストのバウンディング ボックスを取得します。

境界ボックスの幅と高さは負ではありません。

サブクラスは、境界ボックスの「タイトな」計算に含めるためにオーバーライドする必要があります。デフォルトでは、0, 0 で空のバウンディング ボックスを返します。

この関数を使用するときは注意してください。アーティストのアーティスト ウィンドウ範囲が変更された場合、結果は更新されません。範囲は、座標軸の範囲、Figure のサイズ、または使用されるキャンバス (Figure の保存時に行われる) の変更など、変換スタック内の変更によって変更される可能性があります。これにより、インタラクティブな Figure が画面上で正常に表示されても、正しく保存されないという予期しない動作が発生する可能性があります。

スケール( xscale , yscale )

列の幅をxscaleで、行の高さをyscaleでスケーリングします。

set ( * , agg_filter=<UNSET> , alpha=<UNSET > , animation=<UNSET> , clip_box=<UNSET> ,clip_on =<UNSET> , clip_path=<UNSET> , fontsize=<UNSET> , gid=<UNSET > , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET > , rasterized=<UNSET > , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> ,url=<未設定> ,visible=<UNSET> , zorder=<UNSET> )

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

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

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	スカラーまたはなし
animated	ブール
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
figure	Figure
fontsize	浮く
gid	力
in_layout	ブール
label	物体
mouseover	ブール
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
visible	ブール
zorder	浮く

set_fontsize (サイズ)

セル テキストのフォント サイズをポイント単位で設定します。

パラメータ:

サイズフロート

ノート

自動フォント サイズが無効になっていない限り、テキストがセルに水平方向に収まるように値が切り取られます。

を使用して、この動作を無効にすることができますauto_set_font_size。

>>> the_table.auto_set_font_size(False)
>>> the_table.set_fontsize(20)

ただし、テキストがセル境界を超える可能性があるため、行の高さの自動スケーリングは行われません。

matplotlib.table. table ( ax , cellText = None , cellColours = None , cellLoc = 'right' , colWidths = None , rowLabels = None , rowColours = None , rowLoc = 'left' , colLabels = None , colColours = None , colLoc = 'center' , loc = '下' , bbox=なし、 edge = 'closed'、 ** kwargs )

にテーブルを追加しますAxes。

cellTextまたはcellColoursの少なくとも 1 つを指定する必要があります。これらのパラメーターは 2D リストである必要があり、外側のリストが行を定義し、内側のリストが行ごとの列の値を定義します。各行には同じ数の要素が含まれている必要があります。

テーブルにはオプションで行ヘッダーと列ヘッダーを含めることができます。これらは、それぞれ rowLabels 、rowColours、rowLocおよびcolLabels、colColours、 colLocを使用して構成されます。

テーブルをより細かく制御するには、Tableクラスを使用して、 で軸に追加しAxes.add_tableます。

パラメータ:

cellText str の 2D リスト、オプション

表のセルに配置するテキスト。

注: 現在、文字列の改行は考慮されていないため、テキストがセルの境界を超えることになります。

cellColours色の 2D リスト、オプション

セルの背景色。

cellLoc {'左', '中央', '右'}, デフォルト: '右'

セル内のテキストの配置。

フロートのcolWithsリスト、オプション

軸の単位での列幅。指定しない場合、すべての列の幅は1 / ncolsになります。

str のrowLabelsリスト、オプション

行ヘッダー セルのテキスト。

rowColours色のリスト、オプション

行ヘッダー セルの色。

rowLoc {'left', 'center', 'right'}, デフォルト: 'left'

行ヘッダー セルのテキスト配置。

str のcolLabelsリスト、オプション

列ヘッダー セルのテキスト。

colColours色のリスト、オプション

列ヘッダー セルの色。

colLoc {'left', 'center', 'right'}, デフォルト: 'left'

列ヘッダー セルのテキスト配置。

loc str、オプション

axに対するセルの位置。これは のいずれかである必要がありますcodes。

bbox Bbox、オプション

テーブルを描画するバウンディング ボックス。これがNoneでない場合、これはlocをオーバーライドします。

'BRTL' または {'open', 'closed', 'horizo​​ntal', 'vertical'} のエッジ部分文字列

線で描画されるセルの端。も参照してください visible_edges。

戻り値:

Table

作成したテーブル。

その他のパラメータ:

**kwargs

Tableプロパティ。

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	スカラーまたはなし
animated	ブール
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
figure	Figure
fontsize	浮く
gid	力
in_layout	ブール
label	物体
mouseover	ブール
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
visible	ブール
zorder	浮く