seaborn.objects.Plot.label#

Plot.label(*, title=None, legend=None, **variables)#

控制坐標軸、圖例和子圖的標籤和標題。

額外的關鍵字對應到圖表中定義的變數。數值可以是下列類型之一

  • 字串（按字面使用；傳遞“”來清除預設標籤）

  • 函式（在預設標籤上呼叫）

對於坐標變數，數值會設定坐標軸標籤。對於語義變數，數值會設定圖例標題。對於分面變數，title= 會修改特定子圖的標籤，而 col= 和/或 row= 會為分面變數新增標籤。

當使用單一子圖時，title= 會設定其標題。

legend= 參數會設定「圖層」圖例的標題（即，當在 Plot.add() 中使用 label 時）。

範例

使用字串覆寫預設標籤

p = (
    so.Plot(penguins, x="bill_length_mm", y="bill_depth_mm")
    .add(so.Dot(), color="species")
)
p.label(x="Length", y="Depth", color="")
../_images/objects.Plot.label_1_0.png

傳遞函式來修改預設標籤

p.label(color=str.capitalize)
../_images/objects.Plot.label_3_0.png

使用此方法設定單軸圖的標題

p.label(title="Penguin species exhibit distinct bill shapes")
../_images/objects.Plot.label_5_0.png

當分面時，title 參數會修改預設標題

p.facet("sex").label(title=str.upper)
../_images/objects.Plot.label_7_0.png

而 col/row 參數會為每個分面的標題新增標籤

p.facet("sex").label(col="Sex:")
../_images/objects.Plot.label_9_0.png

如果需要更多自訂，可以使用格式字串

p.facet("sex").label(title="{} penguins".format)
../_images/objects.Plot.label_11_0.png 
p
../_images/objects.Plot.label_12_0.png

當為每個圖層新增標籤時，legend= 參數會設定圖例的標題

(
    so.Plot(penguins, x="species")
    .add(so.Line(color="C1"), so.Agg(), y="bill_length_mm", label="length")
    .add(so.Line(color="C2"), so.Agg(), y="bill_depth_mm", label="depth")
    .label(legend="Measurement")
)
../_images/objects.Plot.label_14_0.png