matplotlib.pyplot.subparcela #

matplotlib.pyplot. subtrama ( * argumentos , ** kwargs ) [fuente] #

Agregue ejes a la figura actual o recupere ejes existentes.

Este es un contenedor Figure.add_subplotque proporciona un comportamiento adicional cuando se trabaja con la API implícita (consulte la sección de notas).

Firmas de llamada:

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

Parámetros :

*args int, (int, int, index ), o SubplotSpec, por defecto: (1, 1, 1)

La posición de la trama secundaria descrita por uno de

Tres enteros ( nrows , ncols , index ). La subparcela tomará la posición de índice en una cuadrícula con nrows filas y ncols columnas. El índice comienza en 1 en la esquina superior izquierda y aumenta hacia la derecha. El índice también puede ser una tupla de dos que especifica los índices ( primero , último ) (basado en 1 e incluido el último ) de la subparcela, por ejemplo, crea una subparcela que abarca los 2/3 superiores de la figura.fig.add_subplot(3, 1, (1, 2))
Un entero de 3 dígitos. Los dígitos se interpretan como si se dieran por separado como tres números enteros de un solo dígito, es decir, fig.add_subplot(235)es lo mismo que . Tenga en cuenta que esto solo se puede usar si no hay más de 9 subparcelas.fig.add_subplot(2, 3, 5)
un SubplotSpec_

proyección {Ninguno, 'aitoff', 'martillo', 'lambert', 'mollweide', 'polar', 'rectilíneo', str}, opcional

El tipo de proyección de la subtrama ( Axes). str es el nombre de una proyección personalizada, consulte projections. El valor predeterminado Ninguno da como resultado una proyección 'rectilínea'.

bool polar , por defecto: Falso

Si es verdadero, equivalente a proyección = 'polar'.

sharex, sharey Axes, opcional

Comparta x o y axiscon sharex y/o sharey. El eje tendrá los mismos límites, marcas y escala que el eje de los ejes compartidos.

cadena de etiquetas

Una etiqueta para los ejes devueltos.

Devoluciones :

axes.SubplotBase, u otra subclase deAxes: Los ejes de la subtrama. La clase base de los ejes devueltos depende de la proyección utilizada. Lo es Axessi se usa proyección rectilínea y projections.polar.PolarAxessi se usa proyección polar. Los ejes devueltos son entonces una subclase de subtrama de la clase base.

Otros parámetros :

**kwargs

Este método también toma los argumentos de palabra clave para la clase base de ejes devuelta; excepto por el argumento de la figura . Los argumentos de palabras clave para la clase base rectilínea Axesse pueden encontrar en la siguiente tabla, pero también puede haber otros argumentos de palabras clave si se usa otra proyección.

Propiedad	Descripción
`adjustable`	{'caja', 'límite de datos'}
`agg_filter`	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
`alpha`	escalar o ninguno
`anchor`	(flotante, flotante) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'igual'} o flotante
`autoscale_on`	bool
`autoscalex_on`	desconocido
`autoscaley_on`	desconocido
`axes_locator`	Invocable[[Ejes, Renderer], Bbox]
`axisbelow`	bool o 'línea'
`box_aspect`	flotante o Ninguno
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Parchear o (Ruta, Transformar) o Ninguno
`facecolor`o FC	color
`figure`	`Figure`
`frame_on`	bool
`gid`	calle
`in_layout`	bool
`label`	objeto
`mouseover`	bool
`navigate`	bool
`navigate_mode`	desconocido
`path_effects`	`AbstractPathEffect`
`picker`	Ninguno o bool o flotante o invocable
`position`	[izquierda, abajo, ancho, alto] o`Bbox`
`prop_cycle`	desconocido
`rasterization_zorder`	flotante o Ninguno
`rasterized`	bool
`sketch_params`	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
`snap`	booleano o ninguno
`title`	calle
`transform`	`Transform`
`url`	calle
`visible`	bool
`xbound`	desconocido
`xlabel`	calle
`xlim`	(abajo: flotador, arriba: flotador)
`xmargin`	flotante mayor que -0.5
`xscale`	desconocido
`xticklabels`	desconocido
`xticks`	desconocido
`ybound`	desconocido
`ylabel`	calle
`ylim`	(abajo: flotador, arriba: flotador)
`ymargin`	flotante mayor que -0.5
`yscale`	desconocido
`yticklabels`	desconocido
`yticks`	desconocido
`zorder`	flotar

Ver también

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

notas

La creación de un nuevo eje eliminará cualquier eje preexistente que se superponga con él más allá de compartir un límite:

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)

Si no desea este comportamiento, utilice el Figure.add_subplotmétodo o la pyplot.axesfunción en su lugar.

Si no se pasan kwargs y existe un Axe en la ubicación especificada por args , se devolverá ese Axe en lugar de crear un nuevo Axe.

Si se pasan kwargs y existe un Axes en la ubicación especificada por args , el tipo de proyección es el mismo y los kwargs coinciden con los Axes existentes, entonces se devuelven los Axes existentes. De lo contrario, se crea un nuevo eje con los parámetros especificados. Guardamos una referencia a los kwargs que usamos para esta comparación. Si alguno de los valores en kwargs es mutable, no detectaremos el caso en el que están mutados. En estos casos, sugerimos usar Figure.add_subplotla API Axes explícita en lugar de la API pyplot implícita.

Ejemplos

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)