matplotlib【グラフ描画ライブラリ】

メモ ( インストール方法 実行バージョンの取得 ) 全体操作 グラフ モジュール・クラス 設定・グラフパーツ ウィジェット

メモ

グラフ描画ライブラリ

  • このドキュメントは、v3.4.2 (2021-05-08)対応  (最新)
    Python・NumPy【科学技術計算】ライブラリ の最小対応バージョン
    Matplotlib
    (3.4.2:2021-5-8)
    Python
    (3.9.6:2021-6-28)
    NumPy
    (1.21:2021-6-22)
    3.43.61.16.0
    3.33.61.15.0
    3.23.61.11.0
    3.13.61.11.0
    3.03.51.10.0
  • 実行バージョンの取得〔
    • matplotlib: matplotlib.__version__  参照
    • Python: platform.python_version()  ( Python 実行バージョン も参照 )
    • NumPy: numpy.__version__
  • インストール方法については、 Installation (英語) 参照

各種一覧

全体操作

操作pyplot.figure.Figure.その他
図(フィギュア)作成figure【図作成】
サブプロット subplots【サブプロット作成】
subplot【サブプロット取得・設定】
delaxes【サブプロット 削除】
subplots_adjust【余白設定】
tight_layout【レイアウト自動調整】
subplot2grid
gcf【現在フィギュア取得】
gca【現在座標系 取得】
subplots
add_subplot【サブプロット追加】
tight_layout【レイアウト自動調整】
set_tight_layout【レイアウト自動調整 設定】
figure.Figure.gca【現在座標系 取得】
figure.SubFigure.gca【現在座標系 取得】
表示 show【図表示】
pause【一定時間図表示】
ion【インタラクティブモード オン】
ioff【インタラクティブモード オフ】
close【図ウィンドウ クローズ】
show【図表示】
アニメーション animation.ArtistAnimation【アニメーション (固定セット)】
animation.FuncAnimation【アニメーション (関数)】
ファイル保存 savefig【ファイル保存】
手書き風 xkcd【手書き風】
スタイル style.use【スタイル設定】
アーティスト プロパティ getp【アーティスト プロパティ取得】
setp【アーティスト プロパティ設定】
set
バックエンド use【バックエンド選択】
get_backend【バックエンド名取得】
設定値 RcParams【設定値クラス】
rcParams【設定値データ】
get_configdir【設定ファイルディレクトリ取得】
matplotlib_fname【設定ファイル位置取得】
rcsetup【設定値検証】
備考
詳細は、color【色定義】参照
マーカー詳細は、marker【マーカー定義】参照
日本語デフォルトのフォントは、日本語に対応していない為、設定が必要
TeXTeXの使用が可能

グラフ

グラフ (基本グラフ)pyplot.axes.Axes.
mpl_toolkits.mplot3d.axes3d.
棒グラフ barのサンプル
barhのサンプル
bar【棒グラフ (縦)】
barh【棒グラフ (横)】
応用
積み上げ棒グラフ
極座標グラフ
円グラフ
ドーナツチャート
broken_barhのサンプル broken_barh【棒グラフ (横・非連続)】
bar2dのサンプル Axes3D.bar【2D棒グラフ】
bar3dのサンプル Axes3D.bar3d【3D棒グラフ】
応用
3Dヒストグラム
風向・風速 barbsのサンプル barbs【風向・風速 (ノット)】
箱ひげ図 boxplot【箱ひげ図】
bxp【箱ひげ図】
コヒーレンス cohereのサンプル cohere【コヒーレンス】
等高線 contour【等高線】
contourf【等高線 (塗りつぶし)】
tricontour【非構造三角形 等高線】
tricontourf【非構造三角形 等高線 (塗りつぶし)】
Axes3D.contour (contour3D)【3D等高線】
Axes3D.contourf (contourf3D)【3D等高線 (塗りつぶし)】
Axes3D.tricontour【3D非構造三角形 等高線】
Axes3D.tricontourf【3D非構造三角形 等高線 (塗りつぶし)】
相関グラフ acorr【自己相関グラフ】
xcorr【相互相関グラフ】
エラーバー errorbarのサンプル errorbar【エラーバー】
Axes3D.errorbarのサンプル Axes3D.errorbar【3Dエラーバー】
スパイクラスター
ドットラスター
ラスタープロット
eventplot【イベントプロット】
六角形ビニング図 hexbinのサンプル hexbin【六角形ビニング図】
ヒストグラム histのサンプル hist【ヒストグラム】
histのサンプル hist2d【2次元ヒストグラム】
画像データ imshow【画像データ表示】
matshow【配列画像表示】
pcolor【疑似カラープロット】
pcolormesh【疑似カラープロット (高速)】
pcolorfast【疑似カラープロット (最速:実験的)】
tripcolor【疑似カラープロット (非構造化三角グリッド)】
対数グラフ loglog【両対数グラフ】
semilogx【x軸片対数グラフ】
semilogy【y軸片対数グラフ】
円グラフ pieのサンプル pie【円グラフ】3.1・3.3
応用
ドーナツチャート
折れ線グラフ plotのサンプル plot【折れ線グラフ】
応用
散布図
レーダーチャート
タイムライン
plotのサンプル step【ステップ折れ線グラフ】
stairs【段階的定数値】3.4
plot_date【時系列プロット】
stackplot【積み上げ折れ線グラフ】
plot3Dのサンプル Axes3D.plot (plot3D)【3D折れ線グラフ】
応用
3D散布図
polar【極座標プロット】(projection)
3D面 plot_surfaceのサンプル Axes3D.plot_surface【3D曲面】
plot_trisurfのサンプル Axes3D.plot_trisurf【3D三角面】
plot_wireframeのサンプル Axes3D.plot_wireframe【ワイヤーフレーム】
ベクトル quiverのサンプル quiver【ベクトル】
Axes3D.quiver (quiver3D)【3Dベクトル】
散布図 scatterのサンプル scatter【散布図】
Axes3D.scatter (scatter3D)のサンプル Axes3D.scatter (scatter3D)【3D散布図】
スペクトログラム specgramのサンプル specgram【スペクトログラム】
angle_spectrum【角度スペクトル】
magnitude_spectrum【振幅スペクトル】
phase_spectrum【位相スペクトル】
csd【クロススペクトル密度】
psd【パワースペクトル密度】
疎行列 spy【疎行列プロット】
ステム プロット stem【ステム プロット】
Axes3D.stem (stem3D)【3Dステム プロット】
流線グラフ streamplotのサンプル streamplot【流線グラフ】
バイオリン図 violinplotのサンプル violinplot【バイオリン図】 violinplot【バイオリン図】
violin
ボクセル voxelsのサンプル Axes3D.voxels【ボクセル】

モジュール・クラス

グラフの引数・戻り値等 (一部抜粋)

モジュール・クラス等
matplotlib.
説明関連グラフ等
image.AxesImage imshow【画像データ表示】
matshow【配列画像表示】
pcolorfast【疑似カラープロット (最速:実験的)】
specgram【スペクトログラム】
spy【疎行列プロット】
quiver.Barbsbarbs【風向・風速 (ノット)】
container.BarContainer バーコンテナ bar【棒グラフ (縦)】
barh【棒グラフ (横)】
collections.BrokenBarHCollection broken_barh【棒グラフ (横・非連続)】
collections.Collection pcolor【疑似カラープロット】
scatter【散布図】
Axes3D.scatter3D【3D散布図】
tripcolor【疑似カラープロット (非構造化三角グリッド)】
colors 3.1・3.2・3.3 色関連モジュール
詳細は、color【色定義】 参照
全般
axes.Axes.contour contour【等高線】
contourf【等高線 (塗りつぶし)】
Axes3D.contour[3D]【3D等高線】
Axes3D.contourf[3D]【3D等高線 (塗りつぶし)】
container.ErrorbarContainerエラーバーコンテナerrorbar【エラーバー】
collections.EventCollectioneventplot【イベントプロット】
lines.Line2D 折れ線 cohere【コヒーレンス】
acorr【自己相関グラフ】
xcorr【相互相関グラフ】
errorbar【エラーバー】
plot【折れ線グラフ】
step【ステップ折れ線グラフ】
plot_date【時系列プロット】
Axes3D.plot[3D]【3D折れ線グラフ】
polar【極座標プロット】
angle_spectrum【角度スペクトル】
magnitude_spectrum【振幅スペクトル】
phase_spectrum【位相スペクトル】
csd【クロススペクトル密度】
psd【パワースペクトル密度】
spy【疎行列プロット】
mpl_toolkits.mplot3d.art3d.Line3D 3D折れ線 Axes3D.errorbar【3Dエラーバー】
Axes3D.plot3D【3D折れ線グラフ】
loglog【両対数グラフ】
semilogx【x軸片対数グラフ】
semilogy【y軸片対数グラフ】
mpl_toolkits.mplot3d.art3d.Line3DCollection Axes3D.plot_wireframe【ワイヤーフレーム】
collections.LineCollection Axes3D.quiver[3D]【3Dベクトル】
streamplot【流線グラフ】
violinplot【バイオリン図】
violin
markers マーカー関連モジュール
詳細は、marker【マーカー定義】 参照
mpl_toolkits.mplot3d.art3d.Patch3DCollectionAxes3D.bar【2D棒グラフ追加】
collections.PathCollection scatter【散布図】
Axes3D.scatter[3D]【3D散布図】
streamplot【流線グラフ】
image.PcolorImagepcolorfast【疑似カラープロット (最速:実験的)】
axes.Axes.pcolormeshhist2d【2次元ヒストグラム】
mpl_toolkits.mplot3d.art3d.Poly3DCollection Axes3D.bar3d【3D棒グラフ】
Axes3D.voxels【ボクセル】
collections.PolyCollectionhexbin【六角形ビニング図】
pcolor【疑似カラープロット】
stackplot【積み上げ折れ線グラフ】
tripcolor【疑似カラープロット (非構造化三角グリッド)】
Axes3D.plot_surface【3D曲面】
Axes3D.plot_trisurf【3D三角面】
quiver【ベクトル】
violinplot【バイオリン図】
violin
contour.QuadContourSet contour【等高線】
contourf【等高線 (塗りつぶし)】
Axes3D.contour[3D]【3D等高線】
Axes3D.contourf[3D]【3D等高線 (塗りつぶし)】
collections.QuadMesh hist2d【2次元ヒストグラム】
pcolormesh【疑似カラープロット (高速)】
pcolorfast【疑似カラープロット (最速:実験的)】
patches.Rectangle 長方形 bar【棒グラフ (縦)】
barh【棒グラフ (横)】
Axes3D.bar【2D棒グラフ追加】
container.StemContainer stem【ステム プロット】
Axes3D.stem[3D]【3Dステム プロット】
patches.StepPatchstairs【段階的定数値】3.4
text.Textテキスト タイトル
ラベル
pie【円グラフ】
tri.Triangulation tricontour【非構造三角形 等高線】
tricontourf【非構造三角形 等高線 (塗りつぶし)】
Axes3D.tricontour【3D非構造三角形 等高線】
Axes3D.tricontourf【3D非構造三角形 等高線 (塗りつぶし)】
tripcolor【疑似カラープロット (非構造化三角グリッド)】
Axes3D.plot_trisurf【3D三角面】
tri.TriContourSet tricontour【非構造三角形 等高線】
tricontourf【非構造三角形 等高線 (塗りつぶし)】
Axes3D.tricontour【3D非構造三角形 等高線】
Axes3D.tricontourf【3D非構造三角形 等高線 (塗りつぶし)】
patches.Wedgeくさび形pie【円グラフ】

設定・グラフパーツ

pyplot.axes.Axes.
mpl_toolkits.mplot3d.axes3d.
その他
タイトルsuptitle【タイトル設定 (全体)】
title【タイトル設定】
set_title【タイトル設定】
get_title【タイトル取得】
Axes3D.set_title【タイトル設定】
figure.Figure.suptitle【タイトル設定 (全体)】
figure.SubFigure.suptitle
凡例legend【凡例 設定】
quiverkey【ベクトルの凡例 追加】
figure.Figure.legend【凡例 設定 (全体)】
PathCollection.legend_elements【凡例項目作成】
get_legend【凡例 取得】
get_legend_handles_labels【凡例 取得 (ハンドル・ラベル)】
軸ラベルxlabel【x軸ラベル 設定】
ylabel【y軸ラベル 設定】
set_xlabel【x軸ラベル 設定】
set_ylabel【y軸ラベル 設定】
Axes3D.set_zlabel【z軸ラベル 設定】

get_xlabel【x軸ラベル 取得】
get_ylabel【y軸ラベル 取得】
Axes3D.get_zlabel【z軸ラベル 取得】
figure.Figure.supxlabel【x軸ラベル(全体) 追加】
figure.Figure.supylabel【y軸ラベル(全体) 追加】
figure.SubFigure.supxlabel
figure.SubFigure.supylabel
clabel【等高線ラベル 設定】
bar_label【バーラベル】
グリッドgrid【グリッド設定】grid【グリッド設定】
get_xgridlines【x軸グリッド線取得】
get_ygridlines【y軸グリッド線取得】
(Axes3D.grid【3Dグリッド取得・設定】)
Axes3D.get_zgridlines【z軸グリッド線取得】
axis.Axis.get_gridlines【軸グリッド線取得】
triplot【三角形分割】
rgrids【放射状グリッド線 取得・設定】
thetagrid【放射状シータグリッド線 取得・設定】
projections.polar.PolarAxes.set_rgrids【放射状グリッド線 設定】
projections.polar.PolarAxes.set_thetagrid【放射状シータグリッド線 設定】
表示範囲xlim【x軸表示範囲 設定】
ylim【y軸表示範囲 設定】
axis【表示範囲等 取得・設定】
set_xlim【x軸表示範囲 設定】
set_ylim【y軸表示範囲 設定】
get_xlim【x軸表示範囲 取得】
get_ylim【y軸表示範囲 取得】
axis【表示範囲等 取得・設定】
projections.polar.PolarAxes.set_rlim【極座標範囲 設定】
Axes3D.set_xlim【3D x軸表示範囲 設定】
Axes3D.set_xlim3d【3D x軸表示範囲 設定】
Axes3D.set_ylim【3D y軸表示範囲 設定】
Axes3D.set_ylim3d【3D y軸表示範囲 設定】
Axes3D.set_zlim【3D z軸表示範囲 設定】
Axes3D.set_zlim3d【3D z軸表示範囲 設定】
Axes3D.get_xlim3d【3D x軸表示範囲 取得】
Axes3D.get_ylim3d【3D y軸表示範囲 取得】
Axes3D.get_zlim3d【3D z軸表示範囲 取得】
データ上限・下限set_xbound【x軸データ上限・下限 設定】
set_ybound【y軸データ上限・下限 設定】
get_xbound【x軸データ上限・下限 取得】
get_ybound【y軸データ上限・下限 取得】
projections.polar.PolarAxes.set_rmax【極座標上限 設定】
projections.polar.PolarAxes.set_rmin【極座標下限 設定】
目盛りxticks【x軸目盛り 取得・設定】
yticks【y軸目盛り 取得・設定】
locator_params【目盛り制御】
set_xticks【x軸目盛り 設定】
set_yticks【y軸目盛り 設定】
Axes3D.set_zticks【z軸目盛り 設定】

set_xticklabels【x軸目盛りラベル 設定】
set_yticklabels【y軸目盛りラベル 設定】
Axes3D.set_zticklabels【z軸目盛りラベル 設定】

set_major_formatter
set_minor_formatter

get_xticks【x軸目盛り 取得】
get_yticks【y軸目盛り 取得】
Axes3D.get_zticks【z軸目盛り 取得】

get_xticklabels【x軸目盛りラベル 取得】
get_yticklabels【y軸目盛りラベル 取得】
Axes3D.get_zticklabels【z軸目盛りラベル 取得】

get_xmajorticklabels【x軸目盛りラベル 取得 (主)】
get_ymajorticklabels【y軸目盛りラベル 取得 (主)】
get_xminorticklabels【x軸目盛りラベル 取得 (補助)】
get_yminorticklabels【y軸目盛りラベル 取得 (補助)】
get_xticklines
xaxis_date
get_yticklines
yaxis_date
get_ticklocs
get_ticklabels
minorticks_on
minorticks_off
ticklabel_format
tick_params
locator_params【目盛り制御】
ticker【目盛りモジュール】
axis.XAxis.set_ticks_position【x軸目盛り位置 設定】
axis.YAxis.set_ticks_position【y軸目盛り位置 設定】
Axes3D.locator_params【目盛り制御】
表示関連 box【外枠表示 設定】 set_axis_on【軸関連 表示】
set_axis_off【軸関連 非表示】
set_frame_on【外枠表示 設定】
get_frame_on【外枠表示 取得】
set_axisbelow
get_axisbelow
Axes3D.view_init【軸回転】
軸スケール xscale【x軸スケール 設定】
yscale【y軸スケール 設定】
set_xscale【x軸スケール 設定】
set_yscale【y軸スケール 設定】
Axes3D.set_zscale【z軸スケール 設定】
get_xscale【x軸スケール 取得】
get_yscale【y軸スケール 取得】
Axes3D.get_zscale【z軸スケール 取得】
軸移動 ax1.spines['left'].set_position('zero')
ax1.spines['bottom'].set_position('zero')
axes.Axes.set_position
軸方向invert_xaxis【x軸方向反転】
xaxis_inverted【x軸方向取得】
invert_yaxis【y軸方向反転】
yaxis_inverted【y軸方向取得】
軸共有 twinx【x軸共有】
twiny【y軸共有】
別軸 secondary_xaxis【第2x軸追加】
secondary_yaxis【第2y軸追加】
inset_axes【子軸挿入】
indicate_inset【インジケータ長方形追加】
indicate_inset_zoom【ズームインジケータ長方形追加】
直線・範囲axhline【x軸追加】
axhspan【x軸範囲追加】
hlines【水平線追加】
axvline【y軸追加】
axvspan【y軸範囲追加】
vlines【垂直線追加】
axline【補助線追加】
アノテーション annotate【アノテーション】
テキスト text【テキスト追加】
figtext【フィギュアテキスト追加】
text【テキスト追加】
Axes3D.text2D【テキスト追加】
Axes3D.text (text3D)【3Dテキスト追加】
table
背景色 set_facecolor【背景色 設定】
get_facecolor【背景色 取得】
カラーバーcolorbar【カラーバー追加】
塗り潰し fill【ポリゴンの塗り潰し】
fill_between【水平曲線領域の塗り潰し】
fill_betweenx【垂直曲線領域の塗り潰し】
図形 arrow【矢印】
add_patch【図形追加】 patches.Arc【弧】
patches.ArrowStyle【矢印コンテナ】
patches.Arrow【矢印】
patches.BoxStyle【ボックスコンテナ】
patches.CirclePolygon【多角形円】
patches.Circle【円】
patches.ConnectionPatch【接続パッチ】
patches.ConnectionStyle【接続コンテナ】
patches.Ellipse【楕円】
patches.FancyArrowPatch【】
patches.FancyArrow【装飾矢印】
patches.FancyBboxPatch【装飾長方形】
patches.Patch【パッチ】
patches.PathPatch【パス】
patches.Polygon【多角形】
patches.Rectangle【長方形】
patches.RegularPolygon【正多角形】
patches.Shadow【影】
patches.StepPatch【階段状】
patches.Wedge【くさび形】

ウィジェット

widgets.
ウィジェット Button【ボタン】
CheckButtons【チェックボタン】
Cursor【カーソル】
Lasso【自由曲線】
MultiCursor【マルチカーソル】
RadioButtons【ラジオボタン】
RangeSlider【範囲スライダー】3.4
Slider【スライダー】
TextBox【テキストボックス】
Widget【ウィジェット抽象基本クラス】
セレクタ EllipseSelector【楕円セレクタ】
LassoSelector【自由曲線セレクタ】
PolygonSelector【多角形セレクタ】
RectangleSelector【長方形セレクタ】
SpanSelector【範囲セレクタ】

実行バージョン

import matplotlib
print(f'{matplotlib.__version__ = }')
# 出力例:matplotlib.__version__ = '3.4.2'

import platform
print(f'{platform.python_version() = }')
# 出力例:platform.python_version() = '3.9.2'

import numpy
print(f'{numpy.__version__ = }')
# 出力例:numpy.__version__ = '1.20.2'