matplotlib.pyplot.subplot #

matplotlib.pyplot. subplot ( * args , ** kwargs ) [source] #

現在の Figure に Axes を追加するか、既存の Axes を取得します。

Figure.add_subplotこれは、暗黙の API を操作するときに追加の動作を提供するラッパーです(注のセクションを参照してください)。

呼び出し署名:

subplot(nrows, ncols, index, **kwargs)
subplot(pos, **kwargs)
subplot(**kwargs)
subplot(ax)

パラメータ:

*args int、(int、int、index )、またはSubplotSpec、デフォルト: (1, 1, 1)

次のいずれかによって記述されるサブプロットの位置

3 つの整数 ( nrows、ncols、index )。サブプロットは、 nrows行とncols列のグリッド上のインデックス位置を取ります。 indexは左上隅の 1 から始まり、右に向かって増加します。indexは、サブプロットの ( first、 last ) インデックス (1 ベースで、lastを含む) を指定する 2 つのタプルにすることもできます。たとえば、 Figure の上部 2/3 にまたがるサブプロットを作成します。fig.add_subplot(3, 1, (1, 2))
3 桁の整数。数字は、3 つの 1 桁の整数として別々に与えられたかのように解釈されます。つまりfig.add_subplot(235)、と同じです。これは、サブプロットが 9 つ以下の場合にのみ使用できることに注意してください。fig.add_subplot(2, 3, 5)
A. SubplotSpec_

射影{なし、'aitoff'、'hammer'、'lambert'、'mollweide'、'polar'、'rectilinear'、str}、オプション

サブプロットの射影タイプ ( Axes)。strは、カスタムプロジェクションの名前です。を参照してくださいprojections。デフォルトの None は、「直線的な」投影になります。

極ブール値、デフォルト: False

True の場合、projection='polar' と同等です。

sharex、sharey Axes、オプション

x または yaxisを sharex および/または sharey と共有します。軸には、共有軸の軸と同じ制限、目盛り、およびスケールがあります。

ラベル文字列

返された軸のラベル。

戻り値:

axes.SubplotBase、または別のサブクラスAxes: サブプロットの軸。返される座標軸の基底クラスは、使用される射影によって異なります。これはAxes、直線投影が使用されているprojections.polar.PolarAxes場合と、極投影が使用されている場合です。返された軸は、基本クラスのサブプロットサブクラスです。

その他のパラメータ:

**kwargs

このメソッドは、返された軸の基本クラスのキーワード引数も受け取ります。figure引数を除きます。次の表に、rectilinear 基本クラスのキーワード引数をAxes示しますが、別の射影が使用されている場合は、他のキーワード引数も存在する可能性があります。

財産	説明
`adjustable`	{'ボックス', 'データリム'}
`agg_filter`	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
`alpha`	スカラーまたはなし
`anchor`	(float, float) または {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	ブール
`aspect`	{'auto', 'equal'} または float
`autoscale_on`	ブール
`autoscalex_on`	わからない
`autoscaley_on`	わからない
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	ブールまたは「行」
`box_aspect`	float または None
`clip_box`	`Bbox`
`clip_on`	ブール
`clip_path`	パッチまたは (パス、変換) またはなし
`facecolor`またはfc	色
`figure`	`Figure`
`frame_on`	ブール
`gid`	力
`in_layout`	ブール
`label`	物体
`mouseover`	ブール
`navigate`	ブール
`navigate_mode`	わからない
`path_effects`	`AbstractPathEffect`
`picker`	None または bool または float または callable
`position`	[左、下、幅、高さ] または`Bbox`
`prop_cycle`	わからない
`rasterization_zorder`	float または None
`rasterized`	ブール
`sketch_params`	(位取り: float、長さ: float、乱数: float)
`snap`	ブールまたはなし
`title`	力
`transform`	`Transform`
`url`	力
`visible`	ブール
`xbound`	わからない
`xlabel`	力
`xlim`	（下：浮き、上：浮き）
`xmargin`	-0.5 より大きい float
`xscale`	わからない
`xticklabels`	わからない
`xticks`	わからない
`ybound`	わからない
`ylabel`	力
`ylim`	（下：浮き、上：浮き）
`ymargin`	-0.5 より大きい float
`yscale`	わからない
`yticklabels`	わからない
`yticks`	わからない
`zorder`	浮く

こちらもご覧ください

Figure.add_subplot
pyplot.subplots
pyplot.axes
Figure.subplots

ノート

新しい Axes を作成すると、境界の共有を超えて重複する既存の Axes が削除されます。

import matplotlib.pyplot as plt
# plot a line, implicitly creating a subplot(111)
plt.plot([1, 2, 3])
# now create a subplot which represents the top plot of a grid
# with 2 rows and 1 column. Since this subplot will overlap the
# first, the plot (and its axes) previously created, will be removed
plt.subplot(211)

この動作が望ましくない場合は、代わりにFigure.add_subplotメソッドまたは関数を使用してください。pyplot.axes

kwargsが渡されず、 argsで指定された場所に Axes が存在する場合、新しい Axes が作成されるのではなく、その Axes が返されます。

kwargsが渡され、 argsで指定された場所に Axes が存在し、射影タイプが同じで、 kwargsが既存の Axes と一致する場合、既存の Axes が返されます。それ以外の場合は、指定されたパラメーターで新しい Axes が作成されます。この比較に使用するkwargsへの参照を保存します。kwargsのいずれかの値が変更可能である場合、変更されたケースは検出されません。このような場合Figure.add_subplot、暗黙的な pyplot API ではなく、明示的な Axes API を使用することをお勧めします。

例

plt.subplot(221)

# equivalent but more general
ax1 = plt.subplot(2, 2, 1)

# add a subplot with no frame
ax2 = plt.subplot(222, frameon=False)

# add a polar subplot
plt.subplot(223, projection='polar')

# add a red subplot that shares the x-axis with ax1
plt.subplot(224, sharex=ax1, facecolor='red')

# delete ax2 from the figure
plt.delaxes(ax2)

# add ax2 to the figure again
plt.subplot(ax2)

# make the first axes "current" again
plt.subplot(221)