matplotlib.pyplot

matplotlib.pyplotmatplotlib への状態ベースのインターフェイスです。これは、MATLAB に似た暗黙的なプロット方法を提供します。また、Figure を画面に開き、Figure GUI マネージャーとして機能します。

pyplot は、主にインタラクティブなプロットと、プログラムによるプロット生成の単純なケースを対象としています。

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)

明示的なオブジェクト指向 API は、複雑なプロットに推奨されますが、pyplot は通常、図と多くの場合図の軸を作成するために使用されます。Figureを作成する pyplot.figureには、pyplot.subplots、および を参照してください。Axesのプロット メソッドについては、Axes APIを参照してください。pyplot.subplot_mosaic

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

暗黙的インターフェイスと明示的インターフェイスの間のトレードオフの説明については、Matplotlib アプリケーション インターフェイス (API)を参照してください。

コマンドのプロット

acorr	xの自己相関をプロットします。
angle_spectrum	角度スペクトルをプロットします。
annotate	ポイントxyにテキストtextで注釈を付けます。
arrow	Axes に矢印を追加します。
autoscale	軸ビューをデータに自動スケールします (トグル)。
axes	Axes を現在の Figure に追加し、現在の Axes にします。
axhline	軸を横切る水平線を追加します。
axhspan	軸全体に水平スパン (長方形) を追加します。
axis	一部の軸プロパティを取得または設定する便利なメソッド。
axline	無限に長い直線を追加します。
axvline	軸を横切る垂直線を追加します。
axvspan	軸全体に垂直スパン (長方形) を追加します。
bar	棒グラフを作成します。
bar_label	棒グラフにラベルを付けます。
barbs	バーブの 2D フィールドをプロットします。
barh	横棒グラフを作成します。
box	現在の座標軸で座標軸ボックスをオンまたはオフにします。
boxplot	箱ひげ図を描きます。
broken_barh	長方形の水平シーケンスをプロットします。
cla	現在の軸をクリアします。
clabel	等高線図にラベルを付けます。
clf	現在の図形をクリアします。
clim	現在の画像の色の範囲を設定します。
close	Figure ウィンドウを閉じます。
cohere	xとyの間のコヒーレンスをプロットします。
colorbar	カラーバーをプロットに追加します。
contour	等高線をプロットします。
contourf	塗りつぶされた等高線をプロットします。
csd	クロス スペクトル密度をプロットします。
delaxes	AxesFigure から (既定では現在の座標軸) を削除します。
draw	現在の図を再描画します。
draw_if_interactive	対話モードの場合、現在の Figure を再描画します。
errorbar	y 対 x を線および/またはエラーバー付きのマーカーとしてプロットします。
eventplot	指定された位置に同一の平行線をプロットします。
figimage	リサンプリングされていないイメージを Figure に追加します。
figlegend	図に凡例を配置します。
fignum_exists	指定された ID の Figure が存在するかどうかを返します。
figtext	図にテキストを追加します。
figure	新しいフィギュアを作成するか、既存のフィギュアをアクティブにします。
fill	塗りつぶされた多角形をプロットします。
fill_between	2 つの水平曲線の間の領域を塗りつぶします。
fill_betweenx	2 つの縦断曲線の間の領域を塗りつぶします。
findobj	アーティスト オブジェクトを検索します。
gca	現在の軸を取得します。
gcf	現在の図を取得します。
gci	現在の着色可能なアーティストを取得します。
get	Artistのプロパティの値を返すか、それらすべてを出力します。
get_cmap	nameが Noneの場合、デフォルトで rc 値になる、カラーマップ インスタンスを取得します。
get_figlabels	既存の Figure ラベルのリストを返します。
get_fignums	既存の図番号のリストを返します。
getp	Artistのプロパティの値を返すか、それらすべてを出力します。
grid	グリッド線を構成します。
hexbin	点x、yの 2D 六角ビニング プロットを作成します。
hist	ヒストグラムを計算してプロットします。
hist2d	2D ヒストグラム プロットを作成します。
hlines	xminからxmaxまでの各yに水平線をプロットします。
imread	ファイルから配列にイメージを読み取ります。
imsave	配列をイメージ ファイルとして保存します。
imshow	データを画像として、つまり 2D の通常のラスター上に表示します。
install_repl_displayhook	現在のシェルの表示フックに接続します。
ioff	対話モードを無効にします。
ion	対話モードを有効にします。
isinteractive	プロット コマンドごとにプロットが更新されるかどうかを返します。
legend	Axes に凡例を配置します。
locator_params	主目盛りロケーターの動作を制御します。
loglog	x 軸と y 軸の両方で対数スケーリングを使用してプロットを作成します。
magnitude_spectrum	振幅スペクトルをプロットします。
margins	自動スケーリングのマージンを設定または取得します。
matshow	新しい Figure ウィンドウに配列を行列として表示します。
minorticks_off	軸からマイナー ティックを削除します。
minorticks_on	軸にマイナー ティックを表示します。
pause	interval秒間、GUI イベント ループを実行します。
pcolor	非規則的な長方形グリッドを使用して疑似カラー プロットを作成します。
pcolormesh	非規則的な長方形グリッドを使用して疑似カラー プロットを作成します。
phase_spectrum	位相スペクトルをプロットします。
pie	円グラフをプロットします。
plot	y 対 x を線やマーカーとしてプロットします。
plot_date	[お勧めしません] floatを日付として扱うように軸を強制してプロットします。
polar	極座標プロットを作成します。
psd	パワー スペクトル密度をプロットします。
quiver	矢印の 2D フィールドをプロットします。
quiverkey	quiver プロットにキーを追加します。
rc	現在の を設定しrcParamsます。groupは rc のグループ化です。たとえば、lines.linewidthgroup is lines、 for axes.facecolor、 group isaxesなどです。Group は、グループ名のリストまたはタプル ( xtick、ytick ) の場合もあります。kwargsは、:: などのディクショナリ属性の名前と値のペアです。
rc_context	rcParams を一時的に変更するためのコンテキスト マネージャーを返します。
rcdefaults	rcParamsMatplotlib の内部デフォルト スタイルから を復元します。
rgrids	現在の極座標プロットの放射状グリッド線を取得または設定します。
savefig	現在の Figure を保存します。
sca	現在の Axes をaxに設定し、現在の Figure をaxの親に設定します。
scatter	y対の散布図
sci	現在の画像を設定します。
semilogx	x 軸に対数スケーリングを使用してプロットを作成します。
semilogy	y 軸を対数スケーリングしてプロットを作成します。
set_cmap	デフォルトのカラーマップを設定し、現在の画像があればそれを適用します。
set_loglevel	Matplotlib のルート ロガーとルート ロガー ハンドラー レベルを設定し、まだ存在しない場合はハンドラーを作成します。
setp	に 1 つ以上のプロパティを設定するかArtist、許可される値をリストします。
show	開いているすべての Figure を表示します。
specgram	スペクトログラムをプロットします。
spy	2D 配列のスパース パターンをプロットします。
stackplot	積み上げ面プロットを描画します。
stairs	境界エッジまたは塗りつぶされたプロットを持つラインとしてのステップワイズ定数関数。
stem	ステム プロットを作成します。
step	ステップ プロットを作成します。
streamplot	ベクトル フローの流線を描画します。
subplot	現在の Figure に Axes を追加するか、既存の Axes を取得します。
subplot2grid	通常のグリッド内の特定の場所にサブプロットを作成します。
subplot_mosaic	ASCII アートまたはネストされたリストに基づいて Axes のレイアウトを構築します。
subplot_tool	Figure のサブプロット ツール ウィンドウを起動します。
subplots	Figure と一連のサブプロットを作成します。
subplots_adjust	サブプロット レイアウト パラメーターを調整します。
suptitle	図に中央揃えの字幕を追加します。
switch_backend	開いているすべての Figure を閉じて、Matplotlib バックエンドを設定します。
table	にテーブルを追加しますAxes。
text	Axes にテキストを追加します。
thetagrids	現在の極座標プロットの theta グリッド線を取得または設定します。
tick_params	目盛り、目盛りラベル、およびグリッド線の外観を変更します。
ticklabel_format	ScalarFormatter線形軸にデフォルトで使用される を構成します。
tight_layout	サブプロットの間および周囲のパディングを調整します。
title	軸のタイトルを設定します。
tricontour	構造化されていない三角形のグリッドに等高線を描画します。
tricontourf	構造化されていない三角形のグリッドに等高線領域を描画します。
tripcolor	非構造化三角形グリッドの疑似カラー プロットを作成します。
triplot	構造化されていない三角形のグリッドを線やマーカーとして描画します。
twinx	x軸を共有する 2 番目の軸を作成して返します。
twiny	y軸を共有する 2 番目の軸を作成して返します。
uninstall_repl_displayhook	現在のシェルの表示フックから切断します。
violinplot	バイオリンのプロットを作成します。
vlines	yminからymaxまでの各xに垂直線をプロットします。
xcorr	xとyの間の相互相関をプロットします。
xkcd	xkcdスケッチ スタイルの描画モードをオンにします。
xlabel	x 軸のラベルを設定します。
xlim	現在の軸の x 範囲を取得または設定します。
xscale	xaxis のスケールを設定します。
xticks	x 軸の現在の目盛りの位置とラベルを取得または設定します。
ylabel	y 軸のラベルを設定します。
ylim	現在の軸の y 制限を取得または設定します。
yscale	y 軸のスケールを設定します。
yticks	y 軸の現在の目盛りの位置とラベルを取得または設定します。

その他のコマンド

connect	関数funcをイベントsにバインドします。
disconnect	ID cidのコールバックを切断します。
get_current_fig_manager	現在の Figure の Figure マネージャーを返します。
ginput	Figure を操作するための呼び出しをブロックしています。
new_figure_manager	新しいフィギュア マネージャー インスタンスを作成します。
waitforbuttonpress	Figure を操作するための呼び出しをブロックしています。

カラーマップ

カラーマップは colormap registry から入手できますmatplotlib.colormaps。便宜上、このレジストリは次の形式で利用できますpyplot。

matplotlib.pyplot. カラーマップ

名前で Matplotlib に知られているカラーマップのコンテナー。

実験的

API が最終版になることを期待していますが、必要に応じて API を 3.6 に適応させるオプションを残しておきたいため、正式に 3.5 の実験的なものとしてマークします。

ユニバーサル レジストリのインスタンスはmatplotlib.colormapsです。ユーザーが自分自身をインスタンス化する必要はありませんColormapRegistry。

読み取りアクセスは、名前をColormapsにマッピングする dict のようなインターフェースを使用します。

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

返さColormapれる はコピーであるため、変更によってカラーマップのグローバル定義が変更されることはありません。

次の方法で追加のカラーマップを追加できますColormapRegistry.register。

mpl.colormaps.register(my_colormap)

さらに、組み込みのカラーマップを設定するためのショートカット関数があります。例えば plt.viridis()​​と同等plt.set_cmap('viridis')です。

matplotlib.pyplot. color_sequences

Matplotlib が名前で認識している一連の色のコンテナー。

ユニバーサル レジストリのインスタンスはmatplotlib.color_sequencesです。ユーザーが自分自身をインスタンス化する必要はありませんColorSequenceRegistry 。

読み取りアクセスは、名前を色のリストにマッピングする dict のようなインターフェイスを使用します。

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

返されるリストはコピーであるため、変更によってカラー シーケンスのグローバルな定義が変更されることはありません。

追加のカラー シーケンスは、次の方法で追加できます ColorSequenceRegistry.register。

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])