matplotlib.axes

Herencia

La clase de ejes

clase matplotlib.axes. Ejes ( fig , rect , * , facecolor = Ninguno , frameon = True , sharex = Ninguno , sharey = Ninguno , label = '' , xscale = Ninguno , yscale = Ninguno , box_aspect = Ninguno , ** kwargs )

Bases:_AxesBase

Axescontiene la mayoría de los elementos de la figura: , Axis, Tick, Line2D, Text, Polygonetc., y establece el sistema de coordenadas.

La Axesinstancia admite devoluciones de llamada a través de un atributo de devoluciones de llamada que es una CallbackRegistryinstancia. Los eventos a los que puede conectarse son 'xlim_changed' y 'ylim_changed' y la devolución de llamada se llamará con func( ax ) donde ax es la Axesinstancia.

Atributos :

límite de datosBbox

El cuadro delimitador que encierra todos los datos que se muestran en los ejes.

verLimBbox

Los límites de vista en coordenadas de datos.

Construye un eje en una figura.

Parámetros :

higoFigure

The Axes está construido en la fig .Figure

tupla recta (izquierda, abajo, ancho, alto).

The Axes está construido en el rectángulo rect . rect está en Figurecoordenadas.

sharex, sharey Axes, opcional

El x o y axisse comparte con el eje x o y en la entrada Axes.

frameon bool, por defecto: Verdadero

Si el marco de ejes es visible.

flotante box_aspect , opcional

Establezca un aspecto fijo para el cuadro Ejes, es decir, la relación entre la altura y el ancho. Ver set_box_aspectpara más detalles.

**kwargs

Otros argumentos de palabras clave opcionales:

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
facecoloro 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] oBbox
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

Devoluciones :

Axes

El nuevo Axesobjeto.

Subparcelas

SubplotBase	Clase base para subtramas, que son Axesinstancias con métodos adicionales para facilitar la generación y manipulación de un conjunto Axesdentro de una figura.
subplot_class_factory

Trazado

Básico

Axes.plot	Trace y contra x como líneas y/o marcadores.
Axes.errorbar	Trace y contra x como líneas y/o marcadores con barras de error adjuntas.
Axes.scatter	Un diagrama de dispersión de y vs.
Axes.plot_date	[ Desalentado ] Parcela forzando el eje para tratar los flotadores como fechas.
Axes.step	Haz un diagrama de pasos.
Axes.loglog	Haga una gráfica con escala logarítmica tanto en el eje x como en el eje y.
Axes.semilogx	Haz una gráfica con escala logarítmica en el eje x.
Axes.semilogy	Haz una gráfica con escala logarítmica en el eje y.
Axes.fill_between	Rellene el área entre dos curvas horizontales.
Axes.fill_betweenx	Rellene el área entre dos curvas verticales.
Axes.bar	Haz un gráfico de barras.
Axes.barh	Haz un gráfico de barras horizontales.
Axes.bar_label	Etiqueta un gráfico de barras.
Axes.stem	Crea un diagrama de tallo.
Axes.eventplot	Trace líneas paralelas idénticas en las posiciones dadas.
Axes.pie	Trace un gráfico circular.
Axes.stackplot	Dibuja una gráfica de áreas apiladas.
Axes.broken_barh	Trace una secuencia horizontal de rectángulos.
Axes.vlines	Trace líneas verticales en cada x desde ymin hasta ymax .
Axes.hlines	Trace líneas horizontales en cada y desde xmin hasta xmax .
Axes.fill	Trazar polígonos rellenos.

Se extiende

Axes.axhline	Agregue una línea horizontal a través de los ejes.
Axes.axhspan	Agregue un tramo horizontal (rectángulo) a través de los ejes.
Axes.axvline	Agregue una línea vertical a través de los ejes.
Axes.axvspan	Agregue un tramo vertical (rectángulo) a través de los ejes.
Axes.axline	Agregue una línea recta infinitamente larga.

espectral

Axes.acorr	Trace la autocorrelación de x .
Axes.angle_spectrum	Trace el espectro de ángulos.
Axes.cohere	Trace la coherencia entre x e y .
Axes.csd	Trazar la densidad espectral cruzada.
Axes.magnitude_spectrum	Trace el espectro de magnitud.
Axes.phase_spectrum	Trazar el espectro de fase.
Axes.psd	Trazar la densidad espectral de potencia.
Axes.specgram	Trazar un espectrograma.
Axes.xcorr	Trace la correlación cruzada entre x e y .

Estadísticas

Axes.boxplot	Dibuja un diagrama de caja y bigotes.
Axes.violinplot	Haz una trama de violín.
Axes.violin	Función de dibujo para diagramas de violín.
Axes.bxp	Función de dibujo para diagramas de caja y bigotes.

agrupado

Axes.hexbin	Haz un gráfico binning hexagonal 2D de los puntos x , y .
Axes.hist	Calcular y trazar un histograma.
Axes.hist2d	Haz un diagrama de histograma 2D.
Axes.stairs	Una función constante paso a paso como una línea con bordes delimitadores o un gráfico relleno.

Contornos

Axes.clabel	Etiquete una gráfica de contorno.
Axes.contour	Trazar líneas de contorno.
Axes.contourf	Trazar contornos rellenos.

Matrices 2D

Axes.imshow	Muestre los datos como una imagen, es decir, en un ráster regular 2D.
Axes.matshow	Trace los valores de una matriz o arreglo 2D como una imagen codificada por colores.
Axes.pcolor	Cree un diagrama de pseudocolor con una cuadrícula rectangular no regular.
Axes.pcolorfast	Cree un diagrama de pseudocolor con una cuadrícula rectangular no regular.
Axes.pcolormesh	Cree un diagrama de pseudocolor con una cuadrícula rectangular no regular.
Axes.spy	Trace el patrón de escasez de una matriz 2D.

Triángulos no estructurados

Axes.tripcolor	Cree un diagrama de pseudocolor de una cuadrícula triangular no estructurada.
Axes.triplot	Dibuja una cuadrícula triangular no estructurada como líneas y/o marcadores.
Axes.tricontour	Dibuja líneas de contorno en una cuadrícula triangular sin estructura.
Axes.tricontourf	Dibuje regiones de contorno en una cuadrícula triangular sin estructura.

Texto y anotaciones

Axes.annotate	Anote el punto xy con texto text .
Axes.text	Agregue texto a los ejes.
Axes.table	Agregar una tabla a un Axes.
Axes.arrow	Agregue una flecha a los ejes.
Axes.inset_axes	Agregue un eje insertado secundario a este eje existente.
Axes.indicate_inset	Agregue un indicador de inserción a los ejes.
Axes.indicate_inset_zoom	Agregue un rectángulo indicador de inserción a los ejes en función de los límites del eje para un inset_ax y dibuje conectores entre inset_ax y el rectángulo.
Axes.secondary_xaxis	Agregue un segundo eje x a este Axes.
Axes.secondary_yaxis	Agregue un segundo eje y a este Axes.

Campos vectoriales

Axes.barbs	Trace un campo 2D de púas.
Axes.quiver	Trace un campo 2D de flechas.
Axes.quiverkey	Agrega una llave a un diagrama de carcaj.
Axes.streamplot	Dibujar líneas de corriente de un flujo vectorial.

Borrando

Axes.cla	Borrar los ejes.
Axes.clear	Borrar los ejes.

Apariencia

Axes.axis	Método de conveniencia para obtener o establecer algunas propiedades del eje.
Axes.set_axis_off	Apague los ejes x e y.
Axes.set_axis_on	Active los ejes x e y.
Axes.set_frame_on	Establezca si se dibuja el parche de rectángulo de ejes.
Axes.get_frame_on	Obtenga si se dibuja el parche del rectángulo Axes.
Axes.set_axisbelow	Establezca si las marcas de eje y las líneas de cuadrícula están por encima o por debajo de la mayoría de los artistas.
Axes.get_axisbelow	Obtenga si las marcas del eje y las líneas de cuadrícula están por encima o por debajo de la mayoría de los artistas.
Axes.grid	Configure las líneas de la cuadrícula.
Axes.get_facecolor	Consigue el color de la cara de las Hachas.
Axes.set_facecolor	Establezca el color de la cara de los ejes.

Ciclo de propiedad

Axes.set_prop_cycle

Establezca el ciclo de propiedades de los ejes.

Eje / límites

Axes.get_xaxis	[ Desaconsejado ] Devuelve la instancia de XAxis.
Axes.get_yaxis	[ Desaconsejado ] Devuelve la instancia de YAxis.

Límites del eje y dirección

Axes.invert_xaxis	Invertir el eje x.
Axes.xaxis_inverted	Devuelve si el eje x está orientado en la dirección "inversa".
Axes.invert_yaxis	Invertir el eje y.
Axes.yaxis_inverted	Devuelve si el eje y está orientado en la dirección "inversa".
Axes.set_xlim	Establezca los límites de vista del eje x.
Axes.get_xlim	Devuelve los límites de vista del eje x.
Axes.set_ylim	Establezca los límites de vista del eje y.
Axes.get_ylim	Devuelve los límites de vista del eje y.
Axes.update_datalim	Extienda el dataLimBbox para incluir los puntos dados.
Axes.set_xbound	Establezca los límites numéricos inferior y superior del eje x.
Axes.get_xbound	Devuelve los límites inferior y superior del eje x, en orden creciente.
Axes.set_ybound	Establezca los límites numéricos inferior y superior del eje y.
Axes.get_ybound	Devuelve los límites inferior y superior del eje y, en orden creciente.

Etiquetas de eje, título y leyenda

Axes.set_xlabel	Establezca la etiqueta para el eje x.
Axes.get_xlabel	Obtenga la cadena de texto xlabel.
Axes.set_ylabel	Establezca la etiqueta para el eje y.
Axes.get_ylabel	Obtenga la cadena de texto ylabel.
Axes.set_title	Establezca un título para los ejes.
Axes.get_title	Consigue un título de Hachas.
Axes.legend	Coloque una leyenda en los ejes.
Axes.get_legend	Devuelve la Legendinstancia, o Ninguno si no se define ninguna leyenda.
Axes.get_legend_handles_labels	Identificadores de retorno y etiquetas para la leyenda

Escalas de eje

Axes.set_xscale	Establece la escala del eje x.
Axes.get_xscale	Devuelve la escala del eje x (como str).
Axes.set_yscale	Establezca la escala del eje y.
Axes.get_yscale	Devuelve la escala del eje y (como str).

Autoescalado y márgenes

Axes.use_sticky_edges	Cuando se escala automáticamente, si obedecer todos los Artist.sticky_edges.
Axes.margins	Establecer o recuperar márgenes de escalado automático.
Axes.set_xmargin	Establezca el relleno de los límites de datos X antes del ajuste de escala automático.
Axes.set_ymargin	Establezca el relleno de los límites de datos Y antes del escalado automático.
Axes.relim	Vuelva a calcular los límites de datos en función de los artistas actuales.
Axes.autoscale	Escalar automáticamente la vista del eje a los datos (alternar).
Axes.autoscale_view	Escale automáticamente los límites de vista utilizando los límites de datos.
Axes.set_autoscale_on	Establece si el ajuste de escala automático se aplica a cada eje en el siguiente dibujo o llama a Axes.autoscale_view.
Axes.get_autoscale_on	Retorna True si cada eje se escala automáticamente, False en caso contrario.
Axes.set_autoscalex_on	Establezca si el eje x se escala automáticamente al dibujar o por Axes.autoscale_view.
Axes.get_autoscalex_on	Devuelve si el eje x se ajusta automáticamente.
Axes.set_autoscaley_on	Establezca si el eje y se escala automáticamente al dibujar o por Axes.autoscale_view.
Axes.get_autoscaley_on	Devuelve si el eje y se escala automáticamente.

Relación de aspecto

Axes.apply_aspect	Ajuste los ejes para una relación de aspecto de datos específica.
Axes.set_aspect	Establezca la relación de aspecto de la escala de los ejes, es decir, escala y/x.
Axes.get_aspect	Devuelve la relación de aspecto de la escala de los ejes.
Axes.set_box_aspect	Establezca el aspecto del cuadro de ejes, es decir, la relación entre la altura y el ancho.
Axes.get_box_aspect	Devuelve el aspecto del cuadro de ejes, es decir, la relación entre la altura y el ancho.
Axes.set_adjustable	Establezca cómo se ajustan los ejes para lograr la relación de aspecto requerida.
Axes.get_adjustable	Indica si los ejes ajustarán su dimensión física ('box') o sus límites de datos ('datalim') para lograr la relación de aspecto deseada.

Marcas y etiquetas de marcas

Axes.set_xticks	Establezca las ubicaciones de marca del eje x y, opcionalmente, las etiquetas.
Axes.get_xticks	Devuelve las ubicaciones de marca del eje x en coordenadas de datos.
Axes.set_xticklabels	Establezca las etiquetas de xaxis con la lista de etiquetas de cadena.
Axes.get_xticklabels	Obtén las etiquetas de ticks de xaxis.
Axes.get_xmajorticklabels	Devuelve las principales etiquetas de ticks del eje x, como una lista de Text.
Axes.get_xminorticklabels	Devuelve las etiquetas de ticks menores de xaxis, como una lista de Text.
Axes.get_xgridlines	Devuelve las líneas de cuadrícula del eje x como una lista de Line2Ds.
Axes.get_xticklines	Devuelve las líneas de verificación del eje x como una lista de Line2Ds.
Axes.xaxis_date	Configure marcas de eje y etiquetas para tratar los datos a lo largo del eje x como fechas.
Axes.set_yticks	Establezca las ubicaciones de marca del eje y y, opcionalmente, las etiquetas.
Axes.get_yticks	Devuelve las ubicaciones de marca del eje y en coordenadas de datos.
Axes.set_yticklabels	Establezca las etiquetas del eje y con la lista de etiquetas de cadena.
Axes.get_yticklabels	Obtén las etiquetas de ticks del eje y.
Axes.get_ymajorticklabels	Devuelve las principales etiquetas de marca del eje y, como una lista de Text.
Axes.get_yminorticklabels	Devuelve las etiquetas de ticks menores del eje y, como una lista de Text.
Axes.get_ygridlines	Devuelve las líneas de cuadrícula del eje y como una lista de Line2Ds.
Axes.get_yticklines	Devuelve las líneas de marca del eje y como una lista de Line2Ds.
Axes.yaxis_date	Configure marcas de eje y etiquetas para tratar los datos a lo largo del eje y como fechas.
Axes.minorticks_off	Elimina las marcas menores de los ejes.
Axes.minorticks_on	Mostrar marcas menores en los ejes.
Axes.ticklabel_format	Configure el ScalarFormatterutilizado por defecto para Ejes lineales.
Axes.tick_params	Cambie la apariencia de las marcas, las etiquetas de las marcas y las líneas de cuadrícula.
Axes.locator_params	Comportamiento de control de los principales localizadores de garrapatas.

Unidades

Axes.convert_xunits	Convierte x usando el tipo de unidad del eje x.
Axes.convert_yunits	Convierte y usando el tipo de unidad del eje y.
Axes.have_units	Devuelve si las unidades están configuradas en cualquier eje.

Agregando artistas

Axes.add_artist	Agregue un Artista los Ejes; devolver el artista.
Axes.add_child_axes	Agregue an AxesBasea los hijos de los Hachas; devolver al niño Hachas.
Axes.add_collection	Agregue un Collectiona los Ejes; devolver la colección.
Axes.add_container	Agregue Containera los contenedores de los Hachas; devolver el contenedor.
Axes.add_image	Agregue un AxesImagea los Ejes; devolver la imagen.
Axes.add_line	Agregue un Line2Da los Ejes; devolver la línea.
Axes.add_patch	Agregue un Patcha los Ejes; devolver el parche.
Axes.add_table	Agregue un Tablea los Ejes; devolver la mesa.

Hermanamiento y compartir

Axes.twinx	Crea ejes gemelos compartiendo el eje x.
Axes.twiny	Cree ejes gemelos que compartan el eje y.
Axes.sharex	Comparta el eje x con otros .
Axes.sharey	Comparta el eje y con otros .
Axes.get_shared_x_axes	Devuelve una vista inmutable en el agrupador de ejes x compartido.
Axes.get_shared_y_axes	Devuelve una vista inmutable en el agrupador de ejes y compartido.

Posición de los ejes

Axes.get_anchor	Obtenga la ubicación del ancla.
Axes.set_anchor	Defina la ubicación del ancla.
Axes.get_axes_locator	Devuelve el localizador de ejes.
Axes.set_axes_locator	Configure el localizador de ejes.
Axes.reset_position	Restablece la posición activa a la posición original.
Axes.get_position	Devuelve la posición de los ejes dentro de la figura como un Bbox.
Axes.set_position	Establezca la posición de los ejes.

Asíncrono/basado en eventos

Axes.stale	Si el artista está "obsoleto" y debe volver a dibujarse para que la salida coincida con el estado interno del artista.
Axes.pchanged	Llame a todas las devoluciones de llamadas registradas.
Axes.add_callback	Agregue una función de devolución de llamada que se llamará cada vez que Artistcambie una de las propiedades de .
Axes.remove_callback	Eliminar una devolución de llamada en función de su ID de observador.

Interactivo

Axes.can_pan	Devuelve si este Axes admite alguna funcionalidad de botón de panorámica/zoom.
Axes.can_zoom	Devuelve si estos ejes admiten la funcionalidad del botón del cuadro de zoom.
Axes.get_navigate	Obtenga si los ejes responden a los comandos de navegación.
Axes.set_navigate	Establezca si los ejes responden a los comandos de la barra de herramientas de navegación.
Axes.get_navigate_mode	Obtener el estado del botón de la barra de herramientas de navegación: 'PAN', 'ZOOM' o Ninguno.
Axes.set_navigate_mode	Establecer el estado del botón de la barra de herramientas de navegación.
Axes.start_pan	Se llama cuando se ha iniciado una operación de panorámica.
Axes.drag_pan	Se llama cuando el mouse se mueve durante una operación de desplazamiento.
Axes.end_pan	Se llama cuando se completa una operación de panorámica (cuando el botón del mouse está hacia arriba).
Axes.format_coord	Devuelve una cadena de formato formateando las coordenadas x , y .
Axes.format_cursor_data	Devuelve una representación de cadena de datos .
Axes.format_xdata	Retorna x formateada como un valor x.
Axes.format_ydata	Devuelve y formateado como un valor de y.
Axes.mouseover	Devuelve si se consulta a este artista para obtener información de contexto personalizada cuando el cursor del mouse se mueve sobre él.
Axes.in_axes	Devuelve si el evento dado (en las coordenadas de visualización) está en los Ejes.
Axes.contains	Pruebe si el artista contiene el evento del ratón.
Axes.contains_point	Devuelve si el punto (par de coordenadas de píxeles) está dentro del parche de ejes.
Axes.get_cursor_data	Devuelve los datos del cursor para un evento determinado.

Niños

Axes.get_children	Devuelve una lista de los hijos Artistde this Artist.
Axes.get_images	Devuelve una lista de AxesImagecorreos electrónicos contenidos en los ejes.
Axes.get_lines	Devuelve una lista de líneas contenidas por los ejes.
Axes.findobj	Encuentra objetos de artista.

Dibujo

Axes.draw	Dibuja al Artista (y sus hijos) usando el renderizador dado.
Axes.draw_artist	Vuelva a dibujar eficientemente a un solo artista.
Axes.redraw_in_frame	Vuelva a dibujar eficientemente los datos de los ejes, pero no las marcas de los ejes, las etiquetas, etc.
Axes.get_renderer_cache	[ Obsoleto ]
Axes.get_rasterization_zorder	Devuelve el valor de zorder por debajo del cual se rasterizarán los artistas.
Axes.set_rasterization_zorder	Establezca el umbral de zorder para la rasterización de la salida de gráficos vectoriales.
Axes.get_window_extent	Devuelve el cuadro delimitador de ejes en el espacio de visualización; args y kwargs están vacíos.
Axes.get_tightbbox	Devuelve el cuadro delimitador ajustado de los ejes, incluido el eje y sus decoradores (xlabel, título, etc.).

Proyección

Los métodos utilizados por Axiseso deben anularse para los ejes no rectilíneos.

Axes.name
Axes.get_xaxis_transform	Obtenga la transformación utilizada para dibujar etiquetas, marcas y líneas de cuadrícula en el eje x.
Axes.get_yaxis_transform	Obtenga la transformación utilizada para dibujar etiquetas, marcas y líneas de cuadrícula en el eje Y.
Axes.get_data_ratio	Devuelve la relación de aspecto de los datos escalados.
Axes.get_xaxis_text1_transform	Devoluciones :
Axes.get_xaxis_text2_transform	Devoluciones :
Axes.get_yaxis_text1_transform	Devoluciones :
Axes.get_yaxis_text2_transform	Devoluciones :

Otro

Axes.zorder
Axes.get_default_bbox_extra_artists	Devuelve una lista predeterminada de artistas que se utilizan para el cálculo del cuadro delimitador.
Axes.get_transformed_clip_path_and_affine	Devuelve la ruta del clip con la parte no afín de su transformación aplicada y la parte afín restante de su transformación.
Axes.has_data	Devuelve si se ha agregado algún artista a los Ejes.
Axes.set	Establece varias propiedades a la vez.

clase matplotlib.axes.Axes. Lista de artistas ( ejes , prop_name , add_name , valid_types = Ninguno , invalid_types = Ninguno )

Una sublista de hijos de Axes basada en su tipo.

Las sublistas secundarias específicas del tipo se volverán inmutables en Matplotlib 3.7. Entonces, estas listas de artistas probablemente serán reemplazadas por tuplas. Úselo como si esto ya fuera una tupla.

Esta clase existe solo durante el período de transición para advertir sobre la modificación obsoleta de las listas de artistas.

Parámetros :

ejes .ejes.ejes

Los ejes de los que esta sublista sacará a los niños Artistas.

prop_name str

El nombre de propiedad utilizado para acceder a esta sublista desde los Ejes; se utiliza para generar advertencias de desaprobación.

añadir_nombre str

El nombre del método utilizado para agregar Artistas del tipo de esta sublista a los Ejes; se utiliza para generar advertencias de desaprobación.

valid_types lista de tipo, opcional

Una lista de tipos que determinan qué elementos secundarios devolverá esta sublista. Si se especifica, los artistas de la sublista deben ser instancias de cualquiera de estos tipos. Si no se especifica, cualquier tipo de artista es válido (a menos que esté limitado por invalid_types ).

tupla invalid_types , opcional

Una lista de tipos que determina qué elementos secundarios no devolverá esta sublista. Si se especifica, los Artistas en la sublista nunca serán una instancia de estos tipos. De lo contrario, no se excluirá ningún tipo.

insertar ( índice , artículo )

S.insertar(índice, valor) -- insertar valor antes del índice