目盛りラベル設定・取得
set_xticklabels・set_yticklabels【xy軸目盛りラベル 設定】3.3 / 3.5
get_xticklabels・get_yticklabels【xy軸目盛りラベル 取得】3.3 / 3.6
get_xmajorticklabels・get_ymajorticklabels【xy軸目盛りラベル 取得 (主)】3.3 / 3.6
get_xminorticklabels・get_yminorticklabels【xy軸目盛りラベル 取得 (補助)】3.3 / 3.6

関連: 目盛り設定・取得 目盛りフォーマット設定・取得 (各種目盛りフォーマッタ)

axes.Axes.set_xticklabels【x軸目盛りラベル 設定】3.3・3.5
axes.Axes.set_yticklabels【y軸目盛りラベル 設定】3.3・3.5

メモ

構文

axes.set_xticklabels(
    labels,
    *3.3 推奨3.5,
    fontdict=None,
    minor=False,
    **kwargs)
axes.set_yticklabels(同上)
戻り値 (list[str])目盛りラベルのリスト

labels (list[str])目盛りラベルのリスト
以下位置引数は非推奨 3.3
以下キーワード引数 3.5
fontdict (dict)外観 (省略:以下のデフォルト値)
    'fontsize'【フォントサイズ】:rcParams['axes.titlesize']
    'fontweight'【フォントの太さ】:rcParams['axes.titleweight']
    'verticalalignment'【垂直方向の配置】:'baseline'
    'horizontalalignment'【水平方向の配置】:loc
minor補助目盛りの指定 (False:主目盛り / True:補助目盛り)
kwargsText【テキスト】プロパティ

目盛りラベル設定のサンプル画像

import matplotlib.pyplot as plt

# 初期設定
plt.rcParams['font.family'] = 'sans-serif'
plt.rcParams['font.sans-serif'] =\
    ['Yu Gothic', 'Hiragino Maru Gothic Pro', 'Noto Sans CJK JP']
fig, axs = plt.subplots(
    1, 3,
    figsize=(9, 3),
    tight_layout=True,
)
x = [0, 1, 2, 3]
y = [0, 30, 10, 20]

# グラフ0
axs[0].set_title('目盛りラベル (主) 設定')
axs[0].plot(x, y)
axs[0].set_xticks([0, 1, 2, 3, 4])
axs[0].set_xticklabels(['x0', 'x1', 'x2', 'x3', 'x4'])
axs[0].set_yticks([0, 10, 20, 30, 40])
axs[0].set_yticklabels(['y0', 'y1', 'y2', 'y3', 'y4'])

# グラフ1
axs[1].set_title('目盛りラベル (補助) 設定')
axs[1].plot(x, y)
axs[1].set_xticks([0, 1, 2, 3, 4])
axs[1].set_xticklabels(['x0', 'x1', 'x2', 'x3', 'x4'])
axs[1].set_xticks([0.5, 1.5, 2.5, 3.5], minor=True)
axs[1].set_xticklabels(
    ['xa', 'xb', 'xc', 'xd'],
    minor=True,
    size='small',
)
axs[1].set_yticks([0, 10, 20, 30, 40])
axs[1].set_yticklabels(['y0', 'y1', 'y2', 'y3', 'y4'])
axs[1].set_yticks([5, 15, 25, 35], minor=True)
axs[1].set_yticklabels(
    ['ya', 'yb', 'yc', 'yd'],
    minor=True,
    size='small',
)

# グラフ2
axs[2].set_title('目盛りラベル (フォント) 設定')
axs[2].plot(x, y)
axs[2].set_xticks([0, 1, 2, 3, 4])
axs[2].set_xticklabels(
    ['x0', 'x1', 'x2', 'x3', 'x4'],
    size='large',
    color='red',
)
axs[2].set_xticks([0.5, 1.5, 2.5, 3.5], minor=True)
axs[2].set_xticklabels(
    ['xa', 'xb', 'xc', 'xd'],
    minor=True,
    fontdict={
        'color': 'blue',
        'fontsize': 'small',
        'fontweight': 'bold',
        'horizontalalignment': 'right',
        'rotation': 45,
    }
)
axs[2].set_yticks([0, 10, 20, 30, 40])
axs[2].set_yticklabels(
    ['y0', 'y1', 'y2', 'y3', 'y4'],
    size='large',
    color='red',
)
axs[2].set_yticks([5, 15, 25, 35], minor=True)
axs[2].set_yticklabels(
    ['ya', 'yb', 'yc', 'yd'],
    minor=True,
    fontdict={
        'color': 'blue',
        'fontsize': 'small',
        'fontweight': 'bold',
        'rotation': 45,
        'verticalalignment': 'bottom',
    }
)

# 表示
plt.show()

axes.Axes.get_xticklabels【x軸目盛りラベル 取得】3.3 / 3.6
axes.Axes.get_yticklabels【y軸目盛りラベル 取得】3.3 / 3.6

メモ

  • x軸・y軸目盛りラベルの取得
  • 目盛り設定前の取得 (描画前)
    • 空文字列を取得3.6
      自動で最適な目盛り設定が行われ、その時点の目盛りラベルを取得 3.6

構文

axes.get_xticklabels(minor=False, which=None)
axes.get_yticklabels(同上)
戻り値目盛りラベルのリスト
    型cbook.silent_list[Text] (matplotlib の拡張リスト) 3.3
    型list[Text]3.3

minor (bool)補助目盛りの指定 (False:主目盛り / True:補助目盛り)
which対象目盛りラベル (指定でminor (補助目盛りの指定)より優先)
    None未指定
    'minor'補助ラベル
    'major'主ラベル
    'both'主ラベル・補助ラベル 両方

目盛りラベル取得のサンプル画像

import matplotlib.pyplot as plt

# 初期設定
plt.rcParams['font.family'] = 'sans-serif'
plt.rcParams['font.sans-serif'] =\
    ['Yu Gothic', 'Hiragino Maru Gothic Pro', 'Noto Sans CJK JP']
fig, axs = plt.subplots(
    1, 2,
    figsize=(6, 3),
    tight_layout=True,
)
x = [0, 1, 2, 3]
y = [0, 30, 10, 20]

# グラフ0
axs[0].set_title('目盛りラベル (主) 取得')
axs[0].plot(x, y)
axs[0].set_xticks([0, 1, 2, 3, 4])
axs[0].set_xticklabels(['x0', 'x1', 'x2', 'x3', 'x4'])
axs[0].set_yticks([0, 10, 20, 30, 40])
axs[0].set_yticklabels(['y0', 'y1', 'y2', 'y3', 'y4'])

labels = axs[0].get_xticklabels()
print(labels)
# 出力:[Text(0, 0, 'x0'), Text(1, 0, 'x1'), Text(2, 0, 'x2'), Text(3, 0, 'x3'), Text(4, 0, 'x4')]
labels[1].set_color('red')
labels[1].set_size('x-large')
labels[1].set_rotation(45)
labels = axs[0].get_xticklabels(minor=True)
print(labels)
# 出力:[]
labels = axs[0].get_xticklabels(which='major')
print(labels)
# 出力:[Text(0, 0, 'x0'), Text(1, 0, 'x1'), Text(2, 0, 'x2'), Text(3, 0, 'x3'), Text(4, 0, 'x4')]
labels = axs[0].get_xticklabels(which='minor')
print(labels)
# 出力:[]
labels = axs[0].get_xticklabels(which='both')
print(labels)
# 出力:[Text(0, 0, 'x0'), Text(1, 0, 'x1'), Text(2, 0, 'x2'), Text(3, 0, 'x3'), Text(4, 0, 'x4')]

labels = axs[0].get_yticklabels()
print(labels)
# 出力:[Text(0, 0, 'y0'), Text(0, 10, 'y1'), Text(0, 20, 'y2'), Text(0, 30, 'y3'), Text(0, 40, 'y4')]
labels[3].set_color('red')
labels[3].set_size('x-large')
labels[3].set_rotation(45)
labels = axs[0].get_yticklabels(minor=True)
print(labels)
# 出力:[]
labels = axs[0].get_yticklabels(which='major')
print(labels)
# 出力:[Text(0, 0, 'y0'), Text(0, 10, 'y1'), Text(0, 20, 'y2'), Text(0, 30, 'y3'), Text(0, 40, 'y4')]
labels = axs[0].get_yticklabels(which='minor')
print(labels)
# 出力:[]
labels = axs[0].get_yticklabels(which='both')
print(labels)
# 出力:[Text(0, 0, 'y0'), Text(0, 10, 'y1'), Text(0, 20, 'y2'), Text(0, 30, 'y3'), Text(0, 40, 'y4')]

# グラフ1
axs[1].set_title('目盛りラベル (補助) 取得')
axs[1].plot(x, y)
axs[1].set_xticks([0, 1, 2, 3, 4])
axs[1].set_xticklabels(['x0', 'x1', 'x2', 'x3', 'x4'])
axs[1].set_xticks([0.5, 1.5, 2.5, 3.5], minor=True)
axs[1].set_xticklabels(
    ['xa', 'xb', 'xc', 'xd'],
    minor=True,
    size='small',
)
axs[1].set_yticks([0, 10, 20, 30, 40])
axs[1].set_yticklabels(['y0', 'y1', 'y2', 'y3', 'y4'])
axs[1].set_yticks([5, 15, 25, 35], minor=True)
axs[1].set_yticklabels(
    ['ya', 'yb', 'yc', 'yd'],
    minor=True,
    size='small',
)

labels = axs[1].get_xticklabels()
print(labels)
# 出力:[Text(0, 0, 'x0'), Text(1, 0, 'x1'), Text(2, 0, 'x2'), Text(3, 0, 'x3'), Text(4, 0, 'x4')]
labels = axs[1].get_xticklabels(minor=True)
print(labels)
# 出力:[Text(0.5, 0, 'xa'), Text(1.5, 0, 'xb'), Text(2.5, 0, 'xc'), Text(3.5, 0, 'xd')]
labels = axs[1].get_xticklabels(which='major')
print(labels)
# 出力:[Text(0, 0, 'x0'), Text(1, 0, 'x1'), Text(2, 0, 'x2'), Text(3, 0, 'x3'), Text(4, 0, 'x4')]
labels = axs[1].get_xticklabels(which='minor')
print(labels)
# 出力:[Text(0.5, 0, 'xa'), Text(1.5, 0, 'xb'), Text(2.5, 0, 'xc'), Text(3.5, 0, 'xd')]
labels = axs[1].get_xticklabels(which='both')
print(labels)
# 出力:[Text(0, 0, 'x0'), ... Text(4, 0, 'x4'), Text(0.5, 0, 'xa'), ... Text(3.5, 0, 'xd')]

labels = axs[1].get_yticklabels()
print(labels)
# 出力:[Text(0, 0, 'y0'), Text(0, 10, 'y1'), Text(0, 20, 'y2'), Text(0, 30, 'y3'), Text(0, 40, 'y4')]
labels = axs[1].get_yticklabels(minor=True)
print(labels)
# 出力:[Text(0, 5, 'ya'), Text(0, 15, 'yb'), Text(0, 25, 'yc'), Text(0, 35, 'yd')]
labels = axs[1].get_yticklabels(which='major')
print(labels)
# 出力:[Text(0, 0, 'y0'), Text(0, 10, 'y1'), Text(0, 20, 'y2'), Text(0, 30, 'y3'), Text(0, 40, 'y4')]
labels = axs[1].get_yticklabels(which='minor')
print(labels)
# 出力:[Text(0, 5, 'ya'), Text(0, 15, 'yb'), Text(0, 25, 'yc'), Text(0, 35, 'yd')]
labels = axs[1].get_yticklabels(which='both')
print(labels)
# 出力:[Text(0, 0, 'y0'), ... Text(0, 40, 'y4'), Text(0, 5, 'ya'), ... Text(0, 35, 'yd')]

# 表示
plt.show()

axes.Axes.get_xmajorticklabels【x軸目盛りラベル 取得 (主)】3.3 / 3.6
axes.Axes.get_ymajorticklabels【y軸目盛りラベル 取得 (主)】3.3 / 3.6
axes.Axes.get_xminorticklabels【x軸目盛りラベル 取得 (補助)】3.3 / 3.6
axes.Axes.get_yminorticklabels【y軸目盛りラベル 取得 (補助)】3.3 / 3.6

メモ

  • x軸・y軸目盛りラベル (主・補助) の取得
  • 目盛り設定前の取得 (描画前)
    • 空文字列を取得3.6
      自動で最適な目盛り設定が行われ、その時点の目盛りラベルを取得 3.6

構文

axes.get_xmajorticklabels( )
axes.get_ymajorticklabels( )
axes.get_xminorticklabels( )
axes.get_yminorticklabels( )
戻り値目盛りラベルのリスト
    silent_list[Text] (matplotlib の拡張リスト) 3.3
    型list[Text]3.3

目盛りラベル取得 (主・補助)のサンプル画像

import matplotlib.pyplot as plt

# 初期設定
plt.rcParams['font.family'] = 'sans-serif'
plt.rcParams['font.sans-serif'] =\
    ['Yu Gothic', 'Hiragino Maru Gothic Pro', 'Noto Sans CJK JP']
fig, axs = plt.subplots(
    1, 2,
    figsize=(6, 3),
    tight_layout=True,
)
x = [0, 1, 2, 3]
y = [0, 30, 10, 20]

# グラフ0
axs[0].set_title('目盛りラベル (主) 取得')
axs[0].plot(x, y)
axs[0].set_xticks([0, 1, 2, 3, 4])
axs[0].set_xticklabels(['x0', 'x1', 'x2', 'x3', 'x4'])
axs[0].set_yticks([0, 10, 20, 30, 40])
axs[0].set_yticklabels(['y0', 'y1', 'y2', 'y3', 'y4'])

labels = axs[0].get_xmajorticklabels()
print(labels)
# 出力:[Text(0, 0, 'x0'), Text(1, 0, 'x1'), Text(2, 0, 'x2'), Text(3, 0, 'x3'), Text(4, 0, 'x4')]
labels = axs[0].get_xminorticklabels()
print(labels)
# 出力:[]

labels = axs[0].get_ymajorticklabels()
print(labels)
# 出力:[Text(0, 0, 'y0'), Text(0, 10, 'y1'), Text(0, 20, 'y2'), Text(0, 30, 'y3'), Text(0, 40, 'y4')]
labels = axs[0].get_yminorticklabels()
print(labels)
# 出力:[]

# グラフ1
axs[1].set_title('目盛りラベル (補助) 取得')
axs[1].plot(x, y)
axs[1].set_xticks([0, 1, 2, 3, 4])
axs[1].set_xticklabels(['x0', 'x1', 'x2', 'x3', 'x4'])
axs[1].set_xticks([0.5, 1.5, 2.5, 3.5], minor=True)
axs[1].set_xticklabels(
    ['xa', 'xb', 'xc', 'xd'],
    minor=True,
    size='small',
)
axs[1].set_yticks([0, 10, 20, 30, 40])
axs[1].set_yticklabels(['y0', 'y1', 'y2', 'y3', 'y4'])
axs[1].set_yticks([5, 15, 25, 35], minor=True)
axs[1].set_yticklabels(
    ['ya', 'yb', 'yc', 'yd'],
    minor=True,
    size='small',
)

labels = axs[1].get_xmajorticklabels()
print(labels)
# 出力:[Text(0, 0, 'x0'), Text(1, 0, 'x1'), Text(2, 0, 'x2'), Text(3, 0, 'x3'), Text(4, 0, 'x4')]
labels = axs[1].get_xminorticklabels()
print(labels)
# 出力:[Text(0.5, 0, 'xa'), Text(1.5, 0, 'xb'), Text(2.5, 0, 'xc'), Text(3.5, 0, 'xd')]

labels = axs[1].get_ymajorticklabels()
print(labels)
# 出力:[Text(0, 0, 'y0'), Text(0, 10, 'y1'), Text(0, 20, 'y2'), Text(0, 30, 'y3'), Text(0, 40, 'y4')]
labels = axs[1].get_yminorticklabels()
print(labels)
# 出力:[Text(0, 5, 'ya'), Text(0, 15, 'yb'), Text(0, 25, 'yc'), Text(0, 35, 'yd')]

# 表示
plt.show()