matplotlib.pyplot.subplots
-
matplotlib.pyplot.subplots(nrows=1, ncols=1, sharex=False, sharey=False, squeeze=True, subplot_kw=None, gridspec_kw=None, **fig_kw)[source] -
Создать фигуру и набор подграфиков.
Эта утилитарная оболочка делает удобным создание общих макетов подграфиков, включая объект фигуры, в одном вызове.
Параметры: -
nrows, ncols : int, optional, default: 1 -
Количество строк/столбцов сетки подграфиков.
-
sharex, sharey : bool or {'none', 'all', 'row', 'col'}, default: False -
Управляет совместным использованием свойств между осями x (
sharex) или y (sharey) :- True или 'all': ось x или y будет совмещена для всех подграфиков.
- False или 'none': каждая ось x или y подграфика будет независимой.
- 'row': каждая строка подграфиков будет совмещать ось x или y.
- 'col': каждый столбец подграфиков будет совмещать ось x или y.
Когда подграфики имеют общую ось x по столбцу, метки делений x отображаются только для нижнего подграфика. Аналогично, когда подграфики имеют общую ось y по строке, метки делений y отображаются только для подграфика первого столбца. Чтобы в дальнейшем включить метки делений для других подграфиков, используйте
tick_params. -
squeeze : bool, optional, default: True -
-
Если True, из возвращаемого массива объектов
Axesлишние измерения удаляются:- если создан только один подграфик (nrows=ncols=1), возвращаемый одиночный объект Axes возвращается как скаляр.
- для Nx1 или 1xM подграфиков возвращаемый объект — одномерный массив numpy объектов Axes.
- для NxM подграфиков с N>1 и M>1 возвращаемый объект — двумерный массив.
- Если False, никакое сжатие не выполняется: возвращаемый объект Axes всегда является двумерным массивом, содержащим экземпляры Axes, даже если он оказывается 1x1.
-
-
num : integer or string, optional, default: None -
Ключевое слово
pyplot.figure, устанавливающее номер или метку фигуры. -
subplot_kw : dict, optional -
Словарь с ключевыми словами, передаваемыми вызову
add_subplot, используемому для создания каждого подграфика. -
gridspec_kw : dict, optional -
Словарь с ключевыми словами, передаваемыми конструктору
GridSpec, используемому для создания сетки, на которой размещаются подграфики. - **fig_kw :
-
Все дополнительные ключевые слова передаются вызову
pyplot.figure.
Возвращает: -
fig : Figure -
ax : axes.Axes object or array of Axes objects. -
ax может быть одиночным объектом
Axesили массивом объектов Axes, если было создано более одного подграфика. Размеры результирующего массива могут быть контролируемы ключевым словом squeeze, см. выше.
См. также
pyplot.figure,pyplot.subplot,pyplot.axes,Figure.subplots,Figure.add_subplotПримеры
#First create some toy data: x = np.linspace(0, 2*np.pi, 400) y = np.sin(x**2) #Creates just a figure and only one subplot fig, ax = plt.subplots() ax.plot(x, y) ax.set_title('Simple plot') #Creates two subplots and unpacks the output array immediately f, (ax1, ax2) = plt.subplots(1, 2, sharey=True) ax1.plot(x, y) ax1.set_title('Sharing Y axis') ax2.scatter(x, y) #Creates four polar axes, and accesses them through the returned array fig, axes = plt.subplots(2, 2, subplot_kw=dict(polar=True)) axes[0, 0].plot(x, y) axes[1, 1].scatter(x, y) #Share a X axis with each column of subplots plt.subplots(2, 2, sharex='col') #Share a Y axis with each row of subplots plt.subplots(2, 2, sharey='row') #Share both X and Y axes with all subplots plt.subplots(2, 2, sharex='all', sharey='all') #Note that this is the same as plt.subplots(2, 2, sharex=True, sharey=True) #Creates figure number 10 with a single subplot #and clears it if it already exists. fig, ax=plt.subplots(num=10, clear=True) -
Примеры использования matplotlib.pyplot.subplots
END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER 
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.pyplot.subplots.html
