matplotlib.pyplot.subplot #

matplotlib.pyplot. subtrama ( * args , ** kwargs ) [fonte] #

Adicione um eixo à figura atual ou recupere um eixo existente.

Este é um wrapper Figure.add_subplotque fornece comportamento adicional ao trabalhar com a API implícita (consulte a seção de notas).

Assinaturas de chamada:

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

Parâmetros :

*args int, (int, int, index ), ou SubplotSpec, padrão: (1, 1, 1)

A posição da subtrama descrita por um dos

Três inteiros ( nrows , ncols , index ). A subtrama assumirá a posição do índice em uma grade com nrows linhas e ncols colunas. índice começa em 1 no canto superior esquerdo e aumenta para a direita. index também pode ser uma tupla dupla especificando os ( primeiro , último ) índices (baseados em 1 e incluindo o último ) da subtrama, por exemplo, cria uma subtrama que abrange os 2/3 superiores da figura.fig.add_subplot(3, 1, (1, 2))
Um número inteiro de 3 dígitos. Os dígitos são interpretados como se fossem dados separadamente como três inteiros de um dígito, ou seja, fig.add_subplot(235)é o mesmo que . Observe que isso só pode ser usado se não houver mais de 9 subparcelas.fig.add_subplot(2, 3, 5)
A. SubplotSpec_

projeção {Nenhum, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'retilíneo', str}, opcional

O tipo de projeção da subtrama ( Axes). str é o nome de uma projeção personalizada, consulte projections. O padrão Nenhum resulta em uma projeção 'retilínea'.

bool polar , padrão: Falso

Se True, equivalente a projeção='polar'.

sharex, sharey Axes, opcional

Compartilhe x ou y axiscom sharex e/ou sharey. O eixo terá os mesmos limites, marcações e escala que o eixo dos eixos compartilhados.

rótulo str

Um rótulo para os eixos retornados.

Devoluções :

axes.SubplotBase, ou outra subclasse deAxes: Os eixos da subtrama. A classe base dos eixos retornados depende da projeção utilizada. É Axesse a projeção retilínea for usada e projections.polar.PolarAxesse a projeção polar for usada. Os eixos retornados são então uma subclasse de subplot da classe base.

Outros Parâmetros :

** kwargs

Esse método também usa os argumentos de palavra-chave para a classe base dos eixos retornados; exceto para o argumento da figura . Os argumentos de palavra-chave para a classe base retilínea Axespodem ser encontrados na tabela a seguir, mas também pode haver outros argumentos de palavra-chave se outra projeção for usada.

Propriedade	Descrição
`adjustable`	{'caixa', 'dados'}
`agg_filter`	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
`alpha`	escalar ou nenhum
`anchor`	(float, float) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'igual'} ou flutuante
`autoscale_on`	bool
`autoscalex_on`	desconhecido
`autoscaley_on`	desconhecido
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool ou 'linha'
`box_aspect`	flutuante ou nenhum
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch ou (Caminho, Transformação) ou Nenhum
`facecolor`ou fc	cor
`figure`	`Figure`
`frame_on`	bool
`gid`	str
`in_layout`	bool
`label`	objeto
`mouseover`	bool
`navigate`	bool
`navigate_mode`	desconhecido
`path_effects`	`AbstractPathEffect`
`picker`	None ou bool ou float ou callable
`position`	[esquerda, inferior, largura, altura] ou`Bbox`
`prop_cycle`	desconhecido
`rasterization_zorder`	flutuante ou nenhum
`rasterized`	bool
`sketch_params`	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
`snap`	bool ou nenhum
`title`	str
`transform`	`Transform`
`url`	str
`visible`	bool
`xbound`	desconhecido
`xlabel`	str
`xlim`	(inferior: flutuar, superior: flutuar)
`xmargin`	flutuação maior que -0,5
`xscale`	desconhecido
`xticklabels`	desconhecido
`xticks`	desconhecido
`ybound`	desconhecido
`ylabel`	str
`ylim`	(inferior: flutuar, superior: flutuar)
`ymargin`	flutuação maior que -0,5
`yscale`	desconhecido
`yticklabels`	desconhecido
`yticks`	desconhecido
`zorder`	flutuador

Veja também

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

Notas

A criação de um novo eixo excluirá quaisquer eixos preexistentes que se sobreponham a ele além de compartilhar um limite:

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)

Se você não deseja esse comportamento, use o Figure.add_subplotmétodo ou a pyplot.axesfunção.

Se nenhum kwarg for passado e houver um Axes no local especificado por args , esse Axes será retornado em vez de um novo Axes sendo criado.

Se os kwargs forem passados e houver um Axes no local especificado por args , o tipo de projeção for o mesmo e os kwargs corresponderem aos Axes existentes, então os Axes existentes serão retornados. Caso contrário, um novo Axes é criado com os parâmetros especificados. Guardamos uma referência aos kwargs que usamos para esta comparação. Se algum dos valores em kwargs for mutável, não detectaremos o caso em que eles são mutantes. Nesses casos, sugerimos usar Figure.add_subplote a API Axes explícita em vez da API pyplot implícita.

Exemplos

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)