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")
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")
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'])
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()")
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")
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 リファレンスドキュメント