HOWTO · Matplotlib

如何在 Matplotlib 中的第二 Y 軸上新增 Y 軸標籤

我們可以通過與 axes 物件互動並直接使用 pandas.DataFrame.plot 方法在 Matplotlib 中的次要 y 軸上新增 y 軸標籤。

本頁內容

在 Matplotlib 中為次要 y 軸加上標籤時,請對 Axes.twinx() 傳回的次要 axes 呼叫 set_ylabel()。傳回的 axes 物件會與圖表共用 x 軸,並在另一側提供獨立的 y 軸。標籤應清楚描述數值;若加上單位有助於區分不同測量值,也請一併標示。

使用 twinx() 為次要 y 軸加上標籤

使用 ax.twinx() 建立第二個 axes,將第二組資料繪製在上面,並直接設定它的標籤。這個完整範例會定義兩條線的顏色,並使用 tight_layout() 為標籤留出空間。

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 5, 100)
fig, ax = plt.subplots()
ax.plot(x, np.sin(x), color="tab:blue")
ax.set_xlabel("Time (s)")
ax.set_ylabel("sin(x)", color="tab:blue")
ax.tick_params(axis="y", labelcolor="tab:blue")

ax2 = ax.twinx()
ax2.plot(x, np.cos(x), color="tab:orange")
ax2.set_ylabel("cos(x)", color="tab:orange")
ax2.tick_params(axis="y", labelcolor="tab:orange")

fig.tight_layout()
plt.show()

圖表左側藍色 y 軸標示 sin(x),右側橘色次要 y 軸標示 cos(x),兩條曲線皆以 Time (s) 為橫軸繪製。

ax2 是次要 axes,因此 ax2.set_ylabel(...) 會將標籤放在右側 y 軸。若改為對 ax 呼叫 set_ylabel(),變更的就是主要的左側標籤。讓標籤與刻度的顏色和對應曲線一致是選擇性的做法,但有助於讀者分辨兩組刻度。

顯示第一個範例時,水平軸標示為 Time (s)。藍色正弦曲線使用左側 y 軸,橘色餘弦曲線使用右側 y 軸。兩條曲線涵蓋相同的時間值,但各自的垂直尺度要看圖表對應的一側。範例程式碼中的軸標籤維持英文,會顯示為 Time (s)。本文的主圖則是另一張插圖,呈現 Height 和 Weight 軸,並未顯示這兩條正弦與餘弦曲線。

自訂 y 軸標籤,讓資訊更清楚

標籤文字應指出測量的項目與單位,例如 Temperature (°C) 或 Pressure (kPa)。樣式設定是選擇性的:若有助於閱讀,可將 color、fontsize 或 fontweight 等引數傳給 set_ylabel()。兩側標籤應有所區別,也不要只靠顏色說明各組資料對應哪個刻度。

以下範例將這些樣式選項套用到一張圖表:左側刻度表示攝氏溫度,右側刻度表示千帕壓力:

import matplotlib.pyplot as plt
import numpy as np

hours = np.arange(0, 24, 2)
temperature = 18 + 4 * np.sin((hours - 9) * np.pi / 12)
pressure = 101.3 + 0.8 * np.cos((hours - 6) * np.pi / 12)

fig, ax = plt.subplots()
ax.plot(hours, temperature, color="tab:red", marker="o")
ax.set_xlabel("Hour of day")
ax.set_ylabel(
    "Temperature (°C)", color="tab:red", fontsize=12, fontweight="bold"
)
ax.tick_params(axis="y", labelcolor="tab:red")

ax2 = ax.twinx()
ax2.plot(hours, pressure, color="tab:green", marker="s")
ax2.set_ylabel(
    "Pressure (kPa)", color="tab:green", fontsize=12, fontweight="bold"
)
ax2.tick_params(axis="y", labelcolor="tab:green")

fig.tight_layout()
plt.show()

圖表左側 y 軸為粗體紅色標籤 Temperature (°C),右側次要 y 軸為粗體綠色標籤 Pressure (kPa)。

每個標籤都應簡短說明讀者從圖表該側讀取的數值,如上方範例所示。文字與單位能說明數字的意義;讓標籤顏色和曲線一致,則可提供額外的視覺提示。若標籤顯得擁擠,tight_layout() 可以調整圖表間距;不過,標籤太長時,可能仍需放大圖表或縮短文字。

使用 DataFrame.plot 為次要 y 軸加上標籤

處理 pandas 資料時,繪製第二組資料並指定 secondary_y=True,同時透過 ax 傳入第一次繪圖所用的 axes。每次呼叫 DataFrame.plot 都會傳回一個 axes 物件:第一次呼叫傳回主要 axes,第二次則傳回次要 axes。請分別在對應的物件上設定標籤。

import matplotlib.pyplot as plt
import pandas as pd

frame = pd.DataFrame({
    "age": [10, 20, 30, 40],
    "height": [120, 140, 160, 170],
    "weight": [30, 45, 60, 70],
})

ax = frame.plot(x="age", y="height", color="tab:blue")
ax2 = frame.plot(
    x="age", y="weight", secondary_y=True, ax=ax, color="tab:orange"
)
ax.set_ylabel("Height (cm)")
ax2.set_ylabel("Weight (kg)")
plt.tight_layout()
plt.show()

pandas DataFrame.plot 圖表,左側 y 軸為 Height (cm),右側次要 y 軸為 Weight (kg),兩組資料皆以 age 為橫軸繪製。

在此範例中,secondary_y 會將 weight 指派至右側刻度,而 ax=ax 則讓這組資料疊加在同一張圖中。若使用不同的欄位名稱或單位,請同時更新 y 引數與標籤,讓標籤能正確描述繪製的資料。

依照範例中的數值,圖表以 age 為水平軸,左側標示 Height (cm),右側標示 Weight (kg)。藍色的 height 線在四個年齡點之間上升,橘色的 weight 線也同樣上升;閱讀這兩條線時,應分別參照各自的 y 軸標籤與刻度。範例程式碼中的軸標籤維持英文,會顯示為 Height (cm) 和 Weight (kg)。標籤應配合實際繪製的欄位;若選取的欄位或單位有所變更,也請相應修改標籤。傳入現有的 ax 會讓兩組資料留在同一張圖中,而 secondary_y=True 會將第二組資料指派至右側刻度。