seaborn.objects.Plot.theme#

Plot.theme(config, /)#

プロット内の要素の外観を制御します。

注釈

プロットの外観をカスタマイズするための API はまだ確定していません。現在、唯一有効な引数は matplotlib rc パラメータの辞書です。（この辞書は位置引数として渡す必要があります。）

このメソッドは今後のリリースで強化される可能性があります。

Matplotlib rc パラメータについては、次のページで説明されています：https://matplotlib.org/stable/tutorials/introductory/customizing.html

例

デフォルトのテーマでは、追加の引数なしで seaborn.set_theme() と同じパラメータを使用します

p = (
    so.Plot(anscombe, "x", "y", color="dataset")
    .facet("dataset", wrap=2)
    .add(so.Line(), so.PolyFit(order=1))
    .add(so.Dot())
)
p
../_images/objects.Plot.theme_1_0.png

プロットの外観を変更するには、rc パラメータの辞書を渡します

p.theme({"axes.facecolor": "w", "axes.edgecolor": "slategray"})
../_images/objects.Plot.theme_3_0.png

多くの（すべてではありませんが）マークのプロパティは、デフォルトでテーマパラメータを反映します

p.theme({"lines.linewidth": 4})
../_images/objects.Plot.theme_5_0.png

スタイル関数からの出力を渡すことによって、seaborn スタイルを適用します

from seaborn import axes_style
p.theme(axes_style("ticks"))
../_images/objects.Plot.theme_7_0.png

または、matplotlib に付属のスタイルを適用します

from matplotlib import style
p.theme(style.library["fivethirtyeight"])
../_images/objects.Plot.theme_9_0.png

複数のパラメータ辞書は、同じ関数呼び出しに渡す必要があります。Python 3.9 以降では、このために辞書結合構文を使用できます

from seaborn import plotting_context
p.theme(axes_style("whitegrid") | plotting_context("talk"))
../_images/objects.Plot.theme_11_0.png

すべての Plot インスタンスのデフォルトのテーマは、Plot.config 属性を使用して変更できます

so.Plot.config.theme.update(axes_style("white"))
p
../_images/objects.Plot.theme_13_0.png

詳細については、プロット設定を参照してください。