matplotlib.pyplot.subplots #
- matplotlib.pyplot. subplots ( nrows = 1 , ncols = 1 , * , sharex = False , sharey = False , squeeze = True , width_ratios = Nenhum , height_ratios = Nenhum , subplot_kw = Nenhum , gridspec_kw = Nenhum , ** fig_kw ) [source] #
Crie uma figura e um conjunto de subtramas.
Este wrapper de utilitário torna conveniente criar layouts comuns de subtramas, incluindo o objeto de figura envolvente, em uma única chamada.
- Parâmetros :
- nrows, ncols int, padrão: 1
Número de linhas/colunas da grade da subtrama.
- sharex, sharey bool ou {'none', 'all', 'row', 'col'}, padrão: False
Controla o compartilhamento de propriedades entre os eixos x ( sharex ) ou y ( sharey ):
Verdadeiro ou 'todos': os eixos x ou y serão compartilhados entre todos os subplots.
Falso ou 'nenhum': cada subtrama x ou eixo y será independente.
'linha': cada linha da subtrama compartilhará um eixo x ou y.
'col': cada coluna da subtrama compartilhará um eixo x ou y.
Quando as subtramas têm um eixo x compartilhado ao longo de uma coluna, apenas os rótulos x da subtrama inferior são criados. Da mesma forma, quando os subplots têm um eixo y compartilhado ao longo de uma linha, apenas os rótulos de marcação y do subplot da primeira coluna são criados. Para ativar posteriormente os rótulos de outras subtramas, use
tick_params.Quando as subparcelas têm um eixo compartilhado com unidades, a chamada
set_unitsatualizará cada eixo com as novas unidades.- squeeze bool, padrão: True
Se True, as dimensões extras são espremidas da matriz retornada de
Axes:se apenas uma subtrama for construída (nrows=ncols=1), o único objeto Axes resultante será retornado como um escalar.
para subparcelas Nx1 ou 1xM, o objeto retornado é uma matriz de objeto numpy 1D de objetos Axes.
para NxM, as subparcelas com N>1 e M>1 são retornadas como uma matriz 2D.
Se False, nenhum espremedor é feito: o objeto Axes retornado é sempre um array 2D contendo instâncias de Axes, mesmo que seja 1x1.
- width_ratios semelhante a array de length ncols , opcional
Define as larguras relativas das colunas. Cada coluna obtém uma largura relativa de . Se não for fornecido, todas as colunas terão a mesma largura. Equivalente a .
width_ratios[i] / sum(width_ratios)gridspec_kw={'width_ratios': [...]}- height_ratios semelhante a array de length nrows , opcional
Define as alturas relativas das linhas. Cada linha obtém uma altura relativa de . Se não for fornecido, todas as linhas terão a mesma altura. Conveniência para .
height_ratios[i] / sum(height_ratios)gridspec_kw={'height_ratios': [...]}- subplot_kw dict, opcional
Dito com palavras-chave passadas para a
add_subplotchamada usada para criar cada subtrama.- gridspec_kw dict, opcional
Dict com palavras-chave passadas para o
GridSpecconstrutor usado para criar a grade na qual os subplots são colocados.- **fig_kw
Todos os argumentos de palavra-chave adicionais são passados para a
pyplot.figurechamada.
- Devoluções :
- FIG
Figure - machado
Axesou matriz de eixos ax pode ser um único
Axesobjeto ou uma matriz de objetos Axes se mais de uma subtrama foi criada. As dimensões da matriz resultante podem ser controladas com a palavra-chave squeeze, veja acima.Os idiomas típicos para lidar com o valor de retorno são:
# using the variable ax for single a Axes fig, ax = plt.subplots() # using the variable axs for multiple Axes fig, axs = plt.subplots(2, 2) # using tuple unpacking for multiple Axes fig, (ax1, ax2) = plt.subplots(1, 2) fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2)
Os nomes
axe pluralizadosaxssão preferidosaxesporque para o último não está claro se se refere a uma únicaAxesinstância ou a uma coleção delas.
- FIG
Exemplos
# First create some toy data: x = np.linspace(0, 2*np.pi, 400) y = np.sin(x**2) # Create just a figure and only one subplot fig, ax = plt.subplots() ax.plot(x, y) ax.set_title('Simple plot') # Create two subplots and unpack 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) # Create four polar axes and access them through the returned array fig, axs = plt.subplots(2, 2, subplot_kw=dict(projection="polar")) axs[0, 0].plot(x, y) axs[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) # Create figure number 10 with a single subplot # and clears it if it already exists. fig, ax = plt.subplots(num=10, clear=True)
Exemplos usando matplotlib.pyplot.subplots#
Distribuição discreta como gráfico de barras horizontais
Mapeando as propriedades do marcador para dados multivariados
Criando uma linha do tempo com linhas, datas e texto
Gráfico de contorno de dados espaçados irregularmente
Controlando os limites de exibição usando margens e sticky_edges
Rótulos de figuras: suptitle, supxlabel, supylabel
Combinando duas subtramas usando subtramas e GridSpec
Gráficos de caixa com cores de preenchimento personalizadas
Traçar uma elipse de confiança de um conjunto de dados bidimensional
Incluindo limites superior e inferior em barras de erro
Criando caixas de barras de erro usando PatchCollection
Usando histogramas para traçar uma distribuição cumulativa
Algumas características da função histograma (hist)
Demonstração das diferentes configurações histtype da função histograma
A função histograma (hist) com vários conjuntos de dados
Controlando programaticamente o ajuste da subtrama
Criando um mapa de cores a partir de uma lista de cores
Coleção Line, Poly e RegularPoly com escalonamento automático
Métodos bayesianos para folha de estilos de hackers
Controlando a posição e o tamanho das barras de cores com eixos inseridos
Imagem animada usando uma lista pré-computada de imagens
Construindo histogramas usando retângulos e polycollections
Hillshading personalizado em uma plotagem de superfície 3D
Gráfico de radar (também conhecido como gráfico de aranha ou estrela)
Formatando marcações de data usando ConciseDateFormatter
Colocando marcações de data usando regras de recorrência
Formatador de marca personalizado para séries temporais
Definindo rótulos de escala de uma lista de valores
Mova os rótulos dos marcadores do eixo x para o topo
Selecione índices de uma coleção usando o seletor de polígonos
Ajustando controles deslizantes para valores discretos
