matplotlib.pyplot.subplot #

matplotlib.pyplot. 서브플롯 ( * args , ** kwargs ) [소스] #

현재 Figure에 축을 추가하거나 기존 축을 검색합니다.

이는 암시적 API로 작업할 때 추가 동작을 제공하는 래퍼입니다 Figure.add_subplot(참고 섹션 참조).

호출 서명:

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

매개변수 :

*args int, (int, int, index ) 또는 SubplotSpec, 기본값: (1, 1, 1)

다음 중 하나가 설명하는 서브플롯의 위치

세 개의 정수( nrows , ncols , index ). 서브플롯은 nrows 행과 ncols 열 이 있는 그리드 에서 인덱스 위치를 차지합니다 . 인덱스 는 왼쪽 상단 모서리에서 1부터 시작하여 오른쪽으로 증가합니다. 인덱스 는 서브플롯의 ( first , last ) 인덱스(1 기반 및 last 포함)를 지정하는 2-튜플일 수도 있습니다. 예를 들어 그림의 상위 2/3에 걸쳐 있는 서브플롯을 만듭니다.fig.add_subplot(3, 1, (1, 2))
3자리 정수입니다. 숫자는 3개의 단일 숫자 정수로 별도로 제공된 것처럼 해석됩니다. 즉, fig.add_subplot(235)는 와 동일합니다 . 서브플롯이 9개 이하인 경우에만 사용할 수 있습니다.fig.add_subplot(2, 3, 5)
에이 SubplotSpec.

투영 {None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, 선택 사항

서브플롯의 투영 유형( Axes). str 은 사용자 정의 프로젝션의 이름입니다. 를 참조하십시오 projections. 기본 없음은 '직선' 투영을 생성합니다.

극좌표 부울, 기본값: False

True인 경우 projection='polar'와 동일합니다.

쉐어엑스, 쉐어리, Axes옵션

axissharex 및/또는 sharey와 x 또는 y를 공유합니다 . 축은 공유 축의 축과 동일한 제한, 눈금 및 배율을 갖습니다.

레이블 문자열

반환된 축의 레이블입니다.

반환 :

axes.SubplotBase, 또는 다른 하위 클래스Axes: 서브플롯의 축입니다. 반환된 축 기본 클래스는 사용된 프로젝션에 따라 다릅니다. Axes직선 투영을 사용하는 경우와 극좌표 projections.polar.PolarAxes투영을 사용하는 경우입니다. 반환된 축은 기본 클래스의 서브플롯 하위 클래스입니다.

기타 매개변수 :

**kwargs

이 메서드는 반환된 축 기본 클래스에 대한 키워드 인수도 사용합니다. 그림 인수 를 제외하고 . 직선 기본 클래스에 대한 키워드 인수 Axes는 다음 표에서 찾을 수 있지만 다른 프로젝션이 사용되는 경우 다른 키워드 인수가 있을 수도 있습니다.

재산	설명
`adjustable`	{'박스', '데이터림'}
`agg_filter`	(m, n, 3) 부동 소수점 배열과 dpi 값을 사용하고 (m, n, 3) 배열과 이미지의 왼쪽 하단에서 두 오프셋을 반환하는 필터 함수
`alpha`	스칼라 또는 없음
`anchor`	(플로트, 플로트) 또는 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	부울
`aspect`	{'auto', 'equal'} 또는 부동
`autoscale_on`	부울
`autoscalex_on`	알려지지 않은
`autoscaley_on`	알려지지 않은
`axes_locator`	Callable[[축, 렌더러], Bbox]
`axisbelow`	부울 또는 '라인'
`box_aspect`	부동 또는 없음
`clip_box`	`Bbox`
`clip_on`	부울
`clip_path`	패치 또는 (경로, 변환) 또는 없음
`facecolor`또는 fc	색깔
`figure`	`Figure`
`frame_on`	부울
`gid`	str
`in_layout`	부울
`label`	물체
`mouseover`	부울
`navigate`	부울
`navigate_mode`	알려지지 않은
`path_effects`	`AbstractPathEffect`
`picker`	None 또는 bool 또는 float 또는 호출 가능
`position`	[왼쪽, 아래쪽, 너비, 높이] 또는`Bbox`
`prop_cycle`	알려지지 않은
`rasterization_zorder`	부동 또는 없음
`rasterized`	부울
`sketch_params`	(스케일: float, 길이: float, 임의성: float)
`snap`	부울 또는 없음
`title`	str
`transform`	`Transform`
`url`	str
`visible`	부울
`xbound`	알려지지 않은
`xlabel`	str
`xlim`	(아래: 플로트, 위: 플로트)
`xmargin`	-0.5보다 큰 float
`xscale`	알려지지 않은
`xticklabels`	알려지지 않은
`xticks`	알려지지 않은
`ybound`	알려지지 않은
`ylabel`	str
`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)