Matplotlib レイアウトと設定関数


Matplotlib 参考文档Matplotlib リファレンスドキュメント

レイアウト関数はサブプロットの間隔と配置を制御し、設定関数は Matplotlib のグローバルパラメータを管理します。

関数一覧

レイアウト関数

関数機能
subplots_adjust()サブプロットの間隔を手動で調整
tight_layout()自動コンパクトレイアウト
margins()データ余白を設定(座標軸の両端の空白)
subplot_tool()インタラクティブなサブプロット調整ツールを起動

設定関数

関数機能
rc()rc パラメータを設定(一括設定に対応)
rc_context()rc パラメータを一時的に設定するコンテキストマネージャー
rcdefaults()すべての rc パラメータをデフォルト値に戻す

カラーマッピング関数

関数機能
clim()カラーマッピングのデータ範囲を設定
get_cmap()指定した名前の colormap を取得
set_cmap()デフォルトの colormap を設定
gci()現在のカラーマッピング可能なオブジェクトを取得
sci()現在のカラーマッピング可能なオブジェクトを設定
imread()ファイルから画像を読み込んで配列にする
imsave()配列を画像ファイルとして保存

出力と対話関数

関数機能
show()開いているすべての Figure を表示
draw()現在の Figure を強制的に再レンダリング
draw_if_interactive()対話モードで Figure をレンダリング
pause()指定秒数一時停止(その間に GUI イベントを処理)
ion() / ioff()対話モードのオン/オフ
isinteractive()対話モードかどうかを確認
install_repl_displayhook()REPL 表示フックをインストール
uninstall_repl_displayhook()REPL 表示フックをアンインストール
switch_backend()Matplotlib バックエンドを切り替え

レイアウト関数の例

subplots_adjust() / tight_layout() / margins()

matplotlib.pyplot.subplots_adjust(left=None, bottom=None, right=None,
    top=None, wspace=None, hspace=None)
matplotlib.pyplot.tight_layout(*, pad=1.08, h_pad=None, w_pad=None,
    rect=None)
matplotlib.pyplot.margins(*margins, x=None, y=None, tight=True)

例

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)

fig, axes = plt.subplots(2, 2, figsize=(10, 8))

# subplots_adjust 手動制御
fig.subplots_adjust(left=0.1, right=0.95,
                     top=0.9, bottom=0.1,
                     hspace=0.4, wspace=0.3)

for i, ax in enumerate(axes.flatten()):
    ax.plot(x, np.sin(x + i))
    ax.set_title(f'Plot {i+1}')
    ax.set_xlabel('A long x label')
    ax.set_ylabel('A long y label')
    # 余白を設定
    ax.margins(x=0.1, y=0.15)

fig.suptitle('subplots_adjust() + margins()', fontsize=14)
plt.show()
print("サンプル: layout example")

設定関数の例

rc() / rc_context() / rcdefaults()

matplotlib.pyplot.rc(group, **kwargs)
matplotlib.pyplot.rc_context(rc=None, fname=None)
matplotlib.pyplot.rcdefaults()

例

import matplotlib.pyplot as plt
import numpy as np

# 方法1:rcParams をグローバルに設定
plt.rcParams['font.size'] = 12
plt.rcParams['axes.grid'] = True

# 方法2:rc() で一括設定
plt.rc('lines', linewidth=2, color='steelblue')
plt.rc('axes', titlesize=14, grid=True)

x = np.linspace(0, 10, 50)

# rc_context による一時設定(with ブロック内でのみ有効)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
                                layout='constrained')

# ax1 はグローバルな rc 設定を使用
ax1.plot(x, np.sin(x))
ax1.set_title('Global rc settings')

# ax2 は一時的なスタイルで上書き
with plt.rc_context({'lines.color': 'coral',
                      'lines.linestyle': '--',
                      'axes.facecolor': '#f0f0f0'}):
    ax2.plot(x, np.cos(x))
    ax2.set_title('rc_context() overrides')

plt.show()

# デフォルトに戻す
plt.rcdefaults()
print("サンプル: rc settings restored to defaults")

カラーマッピング関数の例

clim() / get_cmap() / set_cmap()

matplotlib.pyplot.clim(vmin=None, vmax=None)
matplotlib.pyplot.get_cmap(name=None, lut=None)
matplotlib.pyplot.set_cmap(cmap)

例

import matplotlib.pyplot as plt
import numpy as np

data = np.random.rand(10, 10)

# 現在のデフォルト colormap を確認
print('Default cmap:', plt.rcParams['image.cmap'])

# 特定の colormap を取得
cmap = plt.get_cmap('plasma')
print('Got cmap:', cmap.name)

fig, ax = plt.subplots(figsize=(5, 4), layout='constrained')

im = ax.imshow(data, cmap='hot', vmin=0.2, vmax=0.8)
# clim() でも範囲を変更できる
plt.clim(0.1, 0.9)

fig.colorbar(im, ax=ax, label='Value')
ax.set_title('imshow with clim()')
plt.show()

# グローバルなデフォルト colormap を設定
plt.set_cmap('Blues')
print('New default cmap:', plt.rcParams['image.cmap'])
Default cmap: viridis
Got cmap: plasma
New default cmap: Blues

imread() / imsave()

matplotlib.pyplot.imread(fname, format=None)
matplotlib.pyplot.imsave(fname, arr, **kwargs)

例

import matplotlib.pyplot as plt
import numpy as np

# 画像データを作成
img = np.random.rand(50, 50)

# PNG として保存(Figure 不要)
plt.imsave('サンプル_temp_image.png', img,
           cmap='viridis')
print("サンプル: image saved via imsave()")

# 読み戻す
loaded = plt.imread('サンプル_temp_image.png')
print("Loaded shape:", loaded.shape)
print("サンプル: image loaded via imread()")
Loaded shape: (50, 50, 4)

出力と対話関数の例

ion() / ioff() / pause() / draw()

matplotlib.pyplot.ion()    # 开启交互模式
matplotlib.pyplot.ioff()   # 关闭交互模式
matplotlib.pyplot.isinteractive()  # 检查状态
matplotlib.pyplot.pause(interval)  # 暂停并处理事件
matplotlib.pyplot.draw()           # 强制重绘

例

import matplotlib.pyplot as plt
import numpy as np

# 対話モードの例(対話をサポートする環境で実行)
print('Interactive mode:', plt.isinteractive())

# 非対話モードでの手動レンダリング制御
plt.ioff()
fig, ax = plt.subplots()
x = np.linspace(0, 10, 100)

for i in range(3):
    ax.clear()
    ax.plot(x, np.sin(x + i * 0.5))
    ax.set_title(f'Frame {i+1}')
    plt.draw()              # 手動レンダリング
    plt.pause(0.5)          # 0.5 秒一時停止

plt.show()
print("サンプル: animation complete")

switch_backend()

matplotlib.pyplot.switch_backend(newbackend)

switch_backend() は、pyplot を最初にインポートした後、Figure を作成する前にのみ呼び出せます。Figure を作成した後にバックエンドを切り替えるには、実験的なmatplotlib.use()。


Matplotlib 参考文档Matplotlib リファレンスドキュメント

その他の拡張