pyvista.Plotter.add_legend

Plotter.add_legend(

labels=None,

bcolor=None,

border=False,

size=(0.2, 0.2),

name=None,

loc='upper right',

face=None,

font_family=None,

background_opacity=1.0,

)

凡例をレンダリングウィンドウに追加します．

エントリは，項目ごとに1つの文字列とカラーエントリを含みますリストである必要があります．

パラメータ:

labelslist, optional

None に設定すると，次で指定した既存のラベルが使用されます．

• add_mesh

• add_lines

• add_points

リストには，凡例に追加する各アイテムのエントリが含まれています．各エントリには，以下のいずれかが含まれることがあります．

• 2つの文字列 ([label, color]) ， label は追加するアイテムの名前， color は追加するラベルの色．

• Three strings ([label, color, face]) where label is the name of the item to add, color is the color of the label to add, and face is a string which defines the face (i.e. circle, triangle, box, etc.). face could be also "none" (no face shown for the entry), or a pyvista.PolyData.

• キー label を持つ辞書．オプションでキー color と face を追加することもできます．これらのキーの値は文字列にすることができます． face キーの場合， pyvista.PolyData にすることもできます．

bcolorColorLike, default: (0.5, 0.5, 0.5)

背景色．3つの項目0から1のRGBカラーリスト，またはmatplotlibカラー文字列(例:白色の場合は 'w' または 'white' )のいずれかです．Noneの場合，凡例の背景は使用不可になります．

borderbool, default: False

凡例の周囲に境界線を表示するかどうかをコントロールします．デフォルトはFalseです．

sizesequence[float], default: (0.2, 0.2)

2つの浮動小数点シーケンスで，それぞれが0と1の間の浮動小数点です．たとえば， (0.1, 0.1) と指定すると，凡例は図形ウィンドウ全体のサイズの10%のサイズになります．

namestr, optional

簡単に更新できるように，追加したアクターの名前．この名前のアクターがレンダリングウィンドウに既に存在する場合は，新しいアクターに置き換えられます．

locstr, default: "upper right"

位置情報の文字列です． 以下のいずれかになります:

• 'upper right'

• 'upper left'

• 'lower left'

• 'lower right'

• 'center left'

• 'center right'

• 'lower center'

• 'upper center'

• 'center'

facestr | pyvista.PolyData, optional

Face shape of legend face. Defaults to a triangle for most meshes, with the exception of glyphs where the glyph is shown (e.g. arrows).

You may set it to one of the following:

• None: "none"

• 線: "-" か "line"

• 3角形: "^" か 'triangle'

• 円: "o" か 'circle'

• 長方形: "r" か 'rectangle'

• カスタム: pyvista.PolyData

Passing "none" removes the legend face. A custom face can be created using pyvista.PolyData. This will be rendered from the XY plane.

font_familystr, optional

フォントファミリ． 'courier', 'times', または arial'`` のいずれかでなければなりません．デフォルトは pyvista.global_theme.font.family です．

background_opacityfloat, default: 1.0

背景の不透明度を設定します．

戻り値:

vtk.vtkLegendBoxActor

凡例のアクター．

参考

凡例とグリフ

例

add_mesh を使用する際に，メッシュにラベルを付けて凡例を作成します．

>>> import pyvista as pv
>>> from pyvista import examples
>>> sphere = pv.Sphere(center=(0, 0, 1))
>>> cube = pv.Cube()
>>> plotter = pv.Plotter()
>>> _ = plotter.add_mesh(sphere, 'grey', smooth_shading=True, label='Sphere')
>>> _ = plotter.add_mesh(cube, 'r', label='Cube')
>>> _ = plotter.add_legend(bcolor='w', face=None)
>>> plotter.show()

スタティックシーン

インタラクティブなシーン

また，プロッタにラベルを貼ることもできます．

>>> plotter = pv.Plotter()
>>> _ = plotter.add_mesh(sphere, 'grey', smooth_shading=True)
>>> _ = plotter.add_mesh(cube, 'r')
>>> legend_entries = []
>>> legend_entries.append(['My Mesh', 'w'])
>>> legend_entries.append(['My Other Mesh', 'k'])
>>> _ = plotter.add_legend(legend_entries)
>>> plotter.show()

スタティックシーン

インタラクティブなシーン