Documentación de referencia de Matplotlib

Matplotlib es la biblioteca de visualización de datos más utilizada en Python, compatible con la creación de gráficos estáticos, dinámicos e interactivos.

Este documento recopila por completo las funciones y métodos de todas las interfaces públicas de Matplotlib, para facilitar la consulta rápida de funcionalidades y usos correspondientes.


Dos interfaces de programación

Matplotlib ofrece dos formas de uso, adecuadas para diferentes escenarios.

Característica Interfaz Axes (explícita / orientada a objetos) Interfaz pyplot (implícita / funcional)
Forma de uso Primero crear los objetos Figure y Axes, luego llamar a los métodos del objeto Llamar directamente a las funciones del módulo pyplot, operando implícitamente sobre el gráfico actual
Escenario aplicable Gráficos complejos, múltiples subtramas, necesidad de control fino Dibujo rápido, exploración interactiva, gráficos simples
Ejemplo de código fig, ax = plt.subplots(); ax.plot(x, y) plt.plot(x, y); plt.title("título")
Nivel de recomendación Recomendado(Más claro y más controlable) Adecuado para escenarios simples y prototipos rápidos

La interfaz Axes es el método de programación recomendado oficialmente; la lógica del código es más clara y es menos propenso a errores al manejar múltiples subtramas y gráficos complejos. Para facilitar la consulta rápida, a continuación se enumeran tanto las funciones de pyplot como los métodos de Axes correspondientes.

FunciónContenido relacionado
Función plot() de Matplotlibplot()
Función scatter() de Matplotlibscatter()
Función bar() / barh() de Matplotlibbar(), barh(), bar_label(), grouped_bar()
Función hist() de Matplotlibhist()
Función pie() de Matplotlibpie(), pie_label()
Función imshow() de Matplotlibimshow()
Función subplots() de Matplotlibsubplots()
Función figure() de Matplotlibfigure()
Función savefig() de Matplotlibsavefig()
Función errorbar() de Matplotliberrorbar()
Función boxplot() de Matplotlibboxplot()
Función contour() / contourf() de Matplotlibcontour(), contourf(), clabel()
Función fill_between() / fill_betweenx() de Matplotlibfill_between(), fill_betweenx()
Función legend() de Matplotliblegend()
Función text() / annotate() de Matplotlibtext(), annotate()
Funciones de títulos y etiquetas de Matplotlibtitle(), xlabel(), ylabel(), suptitle(), supxlabel(), supylabel()
Función colorbar() de Matplotlibcolorbar()
Funciones de gestión de Figure y Axes de Matplotlibaxes(), cla(), clf(), close(), delaxes(), fignum_exists(), gca(), gcf(), get_figlabels(), get_fignums(), sca(), subplot(), subplot2grid(), subplot_mosaic(), twinx(), twiny()
Funciones de dibujo avanzado de Matplotlibstep(), stem(), eventplot(), stackplot(), broken_barh(), vlines(), hlines(), fill(), loglog(), semilogx(), semilogy()
Funciones de líneas de intervalo y campos vectoriales de Matplotlibaxhline(), axhspan(), axvline(), axvspan(), axline(), quiver(), quiverkey(), barbs(), streamplot()
Funciones de análisis de espectro de Matplotlibacorr(), xcorr(), psd(), csd(), specgram(), cohere(), angle_spectrum(), magnitude_spectrum(), phase_spectrum()
Funciones de datos bidimensionales y gráficos estadísticos de Matplotlibhist2d(), hexbin(), stairs(), matshow(), pcolor(), pcolormesh(), spy(), figimage(), ecdf(), violinplot()
Funciones de mallas triangulares y coordenadas polares de Matplotlibtriplot(), tripcolor(), tricontour(), tricontourf(), polar(), rgrids(), thetagrids()
Funciones de configuración de ejes de Matplotlibxlim(), ylim(), xscale(), yscale(), xticks(), yticks(), tick_params(), ticklabel_format(), locator_params(), minorticks_on(), minorticks_off(), grid(), axis(), box(), autoscale()
Funciones de diseño y configuración de Matplotlibsubplots_adjust(), tight_layout(), margins(), subplot_tool(), rc(), rc_context(), rcdefaults(), clim(), get_cmap(), set_cmap(), gci(), sci(), imread(), imsave(), draw(), ion(), ioff(), pause(), switch_backend(), show(), isinteractive(), install_repl_displayhook(), uninstall_repl_displayhook(), draw_if_interactive()
Funciones de utilidades e interacción de Matplotlibconnect(), disconnect(), ginput(), waitforbuttonpress(), findobj(), get(), setp(), getp(), get_current_fig_manager(), new_figure_manager(), set_loglevel(), xkcd()
Funciones de texto y anotaciones a nivel de Fig de Matplotlibfigtext(), figlegend(), table(), arrow()

Módulo pyplot - Lista completa de funciones

pyplot es la interfaz de nivel superior de Matplotlib y ofrece una experiencia de dibujo similar a MATLAB. A continuación se enumeran todas las funciones según la clasificación oficial.

1. Gestión de Figure y Axes

Funciones para crear y gestionar Figure (lienzo) y Axes (sistema de coordenadas / subtrama).

FunciónDescripción de la función
figure()Crear una nueva Figure o activar una Figure existente
subplots()RecomendadoCrear una Figure y un conjunto de subtramas Axes
subplot()Agregar una subtrama individual a la Figure actual (según índice de fila y columna)
subplot2grid()Crear una subtrama en la posición especificada en una disposición de cuadrícula
subplot_mosaic()Crear disposiciones complejas no uniformes mediante cadenas de etiquetas
axes()Agregar un Axes a la Figure actual
gca()Obtener el objeto Axes actual
gcf()Obtener el objeto Figure actual
sca()Establecer el Axes actual
cla()Limpiar el Axes actual
clf()Limpiar la Figure actual
close()Cerrar la ventana de Figure
delaxes()Eliminar el Axes especificado de la Figure
fignum_exists()Verificar si existe una Figure con el número especificado
get_figlabels()Devuelve la lista de etiquetas de todos los Figure.
get_fignums()Devuelve la lista de números de todos los Figure.
twinx()Crear un eje y gemelo que comparte el eje x.
twiny()Crear un eje x gemelo que comparte el eje y.

2. Dibujo básico

Funciones para dibujar los tipos de gráficos más utilizados.

FunciónDescripción
plot()Dibujar un gráfico de líneas (el más utilizado)
scatter()Dibujar un gráfico de dispersión; admite mapeo de tamaño/color/transparencia
bar()Dibujar un gráfico de barras verticales
barh()Dibujar un gráfico de barras horizontales
bar_label()Añadir etiquetas numéricas a las barras de un gráfico de barras
grouped_bar()Dibujar un gráfico de barras agrupadas
pie()Dibujar un gráfico circular
pie_label()Añadir etiquetas a un gráfico circular
stem()Dibujar un diagrama de tallos (gráfico de palos)
eventplot()Dibujar un gráfico de eventos (líneas horizontales que marcan la posición de eventos)
step()Dibujar un gráfico de pasos
fill()Dibujar un polígono relleno
fill_between()Rellenar el área entre dos curvas horizontales
fill_betweenx()Rellenar el área entre dos curvas verticales
stackplot()Dibujar un gráfico de áreas apiladas
broken_barh()Dibujar un gráfico de barras horizontales discontinuas (estilo Gantt)
vlines()Dibujar una línea de referencia vertical
hlines()Dibujar una línea de referencia horizontal
errorbar()Dibujar un gráfico de líneas con barras de error
loglog()Dibujar un gráfico de líneas en coordenadas doble logarítmicas
semilogx()Dibujar un gráfico de líneas con el eje x en escala logarítmica
semilogy()Dibujar un gráfico de líneas con el eje y en escala logarítmica
polar()Dibujar en coordenadas polares

3. Líneas de intervalo (Spans)

Dibujar líneas de referencia horizontales y verticales y áreas sombreadas.

FunciónDescripción
axhline()Añadir una línea horizontal a lo ancho de los Axes
axhspan()Añadir una banda horizontal sombreada a lo ancho de los Axes
axvline()Añadir una línea vertical a lo alto de los Axes
axvspan()Añadir una banda vertical sombreada a lo alto de los Axes
axline()Añadir una línea recta infinita que pasa por dos puntos

4. Análisis de espectro

Funciones para el procesamiento de señales y la visualización espectral.

FunciónDescripción
acorr()Dibujar un gráfico de autocorrelación
xcorr()Dibujar un gráfico de correlación cruzada
angle_spectrum()Dibujar el espectro de ángulo
magnitude_spectrum()Dibujar el espectro de magnitudes
phase_spectrum()Dibujar el espectro de fase
psd()Dibujar la densidad espectral de potencia
csd()Dibujar la densidad espectral cruzada
cohere()Dibujar la coherencia
specgram()Dibujar un espectrograma (gráfico tiempo-frecuencia)

5. Gráficos estadísticos

Dibuja gráficos relacionados con distribuciones estadísticas.

FunciónDescripción
boxplot()Dibujar un diagrama de caja
violinplot()Dibujar un diagrama de violín
ecdf()Dibujar la función de distribución acumulada empírica (ECDF)

6. Agrupación en intervalos e histogramas

FunciónDescripción
hist()Dibujar un histograma 1D
hist2d()Dibujar un histograma 2D
hexbin()Dibujar un gráfico de agrupación hexagonal
stairs()Dibujar un histograma de pasos (nueva versión, sustituye al modo step de hist)

7. Curvas de nivel

FunciónDescripción
contour()Dibujar curvas de nivel
contourf()Dibujar curvas de nivel rellenas
clabel()Añadir etiquetas a las curvas de nivel

8. Arreglos bidimensionales e imágenes

Funciones para visualizar datos 2D, matrices e imágenes.

FunciónDescripción
imshow()Mostrar una imagen o un array 2D (mapa de calor)
matshow()Mostrar una matriz como una imagen en una nueva Figure
pcolor()Dibujar un gráfico de malla de pseudocolor (crea una PolyCollection)
pcolormesh()Dibujar un gráfico de malla de pseudocolor (crea QuadMesh, con mejor rendimiento)
spy()Dibujar el patrón de elementos no nulos de una matriz dispersa
figimage()Colocar una imagen a nivel de Figure (no de Axes)

9. Mallas triangulares no estructuradas

FunciónDescripción
triplot()Dibujar una malla triangular no estructurada
tripcolor()Dibujar un gráfico de pseudocolor sobre una malla triangular
tricontour()Dibujar curvas de nivel sobre una malla triangular
tricontourf()Dibujar curvas de nivel rellenas sobre una malla triangular

10. Texto y anotaciones

FunciónDescripción
text()Añadir texto en las coordenadas especificadas de Axes
figtext()Añadir texto en una posición especificada de Figure
annotate()Añadir una anotación con flecha
arrow()Añadir una flecha
legend()Añadir una leyenda en Axes
figlegend()Añadir una leyenda a nivel de Figure
table()Añadir una tabla en Axes

11. Campos vectoriales

FunciónDescripción
quiver()Dibujar un campo vectorial (diagrama de flechas)
quiverkey()Añadir una clave de leyenda al campo vectorial
barbs()Dibujar un gráfico de barbas (indica velocidad y dirección del viento en meteorología)
streamplot()Dibujar un diagrama de líneas de corriente

12. Configuración de ejes

Funciones para establecer el rango, las marcas, las etiquetas y la escala de los ejes.

FunciónDescripción
title()Establecer el título de Axes
suptitle()Establecer el título global de Figure
xlabel()Establecer la etiqueta del eje x
ylabel()Establecer la etiqueta del eje y
xlim()Obtener o configurar el rango del eje x
ylim()Obtener o configurar el rango del eje y
xscale()Establecer la escala del eje x (linear/log/symlog/logit...)
yscale()Establecer la escala del eje y (linear/log/symlog/logit...)
xticks()Obtener o configurar las posiciones y etiquetas de los ticks del eje x
yticks()Obtener o configurar las posiciones y etiquetas de los ticks del eje y
tick_params()Ajustar la apariencia de los ticks (orientación, color, tamaño, rotación de etiquetas, etc.)
ticklabel_format()Establecer el formato de las etiquetas de los ticks (notación científica, etc.)
locator_params()Controlar los parámetros del localizador de ticks
minorticks_on()Mostrar los ticks menores
minorticks_off()Ocultar los ticks menores
rgrids()Obtener o configurar las líneas de cuadrícula radiales de un gráfico polar
thetagrids()Obtener o configurar las líneas de cuadrícula angulares de un gráfico polar
grid()Activar o desactivar la cuadrícula
axis()Función de conveniencia para obtener o configurar ciertos atributos de los ejes
box()Activar o desactivar los bordes de los Axes
autoscale()Autoescalar los ejes para ajustarse a los datos

13. Diseño

Funciones para controlar la disposición y el espaciado de los subplots.

FunciónDescripción
subplots_adjust()Ajustar manualmente el espaciado de los subplots (left/right/top/bottom/wspace/hspace)
tight_layout()Ajustar automáticamente los parámetros de los subplots para una distribución compacta
margins()Establecer u obtener los márgenes de datos de los ejes
subplot_tool()Abrir la herramienta interactiva de ajuste de subplots

14. Mapa de colores

Funciones relacionadas con colormaps y barras de color.

FunciónDescripción
colorbar()Añadir una barra de color
clim()Establecer el rango de datos del colormap
get_cmap()Obtener el objeto colormap del nombre especificado
set_cmap()Configurar el colormap por defecto
gci()Obtener el objeto de imagen actualmente mapeable en color
sci()Establecer el objeto de imagen actualmente mapeable en color
imread()Leer una imagen de archivo a un array
imsave()Guardar un array como archivo de imagen
colormapsObjeto registro de colormaps
color_sequencesObjeto registro de secuencias de colores

15. Configuración

Funciones para administrar los parámetros de configuración globales de Matplotlib.

FunciónDescripción
rc()Establecer los parámetros rc (se pueden configurar en lote)
rc_context()Administrador de contexto para establecer temporalmente los parámetros rc
rcdefaults()Restablecer todos los parámetros rc a los valores por defecto

16. Salida e interacción

Funciones para controlar la visualización, el guardado y el modo interactivo de los gráficos.

FunciónDescripción
show()Mostrar todas las Figures abiertas
savefig()Guardar la Figure actual en un archivo
draw()Forzar la renderización de la Figure actual
draw_if_interactive()Renderizar la Figure si se encuentra en modo interactivo
pause()Pausar la cantidad de segundos especificada (procesando eventos mientras tanto)
ion()Activar el modo interactivo
ioff()Desactivar el modo interactivo
isinteractive()Devolver si se está actualmente en modo interactivo
install_repl_displayhook()Instalar el hook de visualización de REPL (hace que las Figures se muestren automáticamente)
uninstall_repl_displayhook()Desinstalar el hook de visualización de REPL
switch_backend()Cambiar el backend

17. Otras funciones de utilidad

FunciónDescripción
connect()Vincular una función callback de eventos
disconnect()Desvincular una función callback de eventos
ginput()Obtener puntos de coordenadas mediante clics del mouse
waitforbuttonpress()Esperar una pulsación del mouse o del teclado y devolver el tipo de evento
findobj()Buscar objetos Artist que coincidan con las condiciones especificadas
get()Obtener el valor de una propiedad del objeto Artist
getp()Obtener las propiedades del objeto Artist (alias de get)
setp()Establecer propiedades del objeto Artist
get_current_fig_manager()Obtener el administrador de ventanas de la Figure actual
new_figure_manager()Crear un nuevo administrador de Figure para la Figure especificada
set_loglevel()Establecer el nivel de registro (logging) de Matplotlib
xkcd()Cambiar al estilo xkcd (cómic dibujado a mano)

Objeto Axes - Lista completa de métodos

Axes (objeto Axes) representa un subplot dentro de una Figure, que contiene datos, ticks, etiquetas, títulos, etc. A continuación se enumeran todos los métodos según la clasificación oficial.

1. Métodos de dibujo básico

MétodoDescripción
Axes.plot()Gráfico de líneas
Axes.scatter()Diagrama de dispersión
Axes.bar()Gráfico de barras verticales
Axes.barh()Gráfico de barras horizontales
Axes.bar_label()Añadir etiquetas de valor a las barras
Axes.grouped_bar()Gráfico de barras agrupadas
Axes.pie()Gráfico circular (de pastel)
Axes.pie_label()Etiquetas del gráfico circular
Axes.stem()Gráfico de tallos
Axes.eventplot()Gráfico de eventos
Axes.step()Gráfico escalonado
Axes.fill()Polígono relleno
Axes.fill_between()Región de relleno horizontal
Axes.fill_betweenx()Región de relleno vertical
Axes.stackplot()Gráfico de áreas apiladas
Axes.broken_barh()Gráfico de barras horizontales discontinuas
Axes.vlines()Línea de referencia vertical
Axes.hlines()Línea de referencia horizontal
Axes.errorbar()Gráfico de líneas con barras de error
Axes.loglog()Coordenadas log-log
Axes.semilogx()Coordenadas logarítmicas en el eje x
Axes.semilogy()Coordenadas logarítmicas en el eje y

2. Métodos de líneas de intervalo

MétodoDescripción
Axes.axhline()Línea de referencia horizontal
Axes.axvline()Línea de referencia vertical
Axes.axhspan()Banda horizontal de color
Axes.axvspan()Banda vertical de color
Axes.axline()Línea recta infinita que pasa por dos puntos

3. Métodos de análisis de espectro

MétodoDescripción
Axes.acorr()Gráfico de autocorrelación
Axes.xcorr()Gráfico de correlación cruzada
Axes.angle_spectrum()Espectro de ángulo
Axes.magnitude_spectrum()Espectro de amplitud
Axes.phase_spectrum()Espectro de fase
Axes.psd()Densidad espectral de potencia
Axes.csd()Densidad espectral cruzada
Axes.cohere()Coherencia
Axes.specgram()Espectrograma (gráfico tiempo-frecuencia)

4. Métodos estadísticos

MétodoDescripción
Axes.boxplot()Diagrama de caja
Axes.bxp()Dibujar diagrama de caja a partir de estadísticas precalculadas
Axes.violinplot()Gráfico de violín
Axes.violin()Dibujar gráfico de violín a partir de estadísticas precalculadas
Axes.ecdf()Función de distribución acumulativa empírica

5. Métodos de agrupación en intervalos e histogramas

MétodoDescripción
Axes.hist()Histograma
Axes.hist2d()Histograma bidimensional
Axes.hexbin()Gráfico de agrupación hexagonal (hexbin)
Axes.stairs()Histograma escalonado

6. Métodos de curvas de nivel

MétodoDescripción
Axes.contour()Curvas de nivel (contorno)
Axes.contourf()Curvas de nivel rellenas
Axes.clabel()Etiquetas de curvas de nivel

7. Métodos de arreglos bidimensionales

MétodoDescripción
Axes.imshow()Mostrar imagen / mapa de calor
Axes.matshow()Imagen de matriz
Axes.pcolor()Malla de falso color (PolyCollection)
Axes.pcolorfast()Falso color rápido (dibujado con imshow)
Axes.pcolormesh()Malla de falso color (QuadMesh, recomendado)
Axes.spy()Patrón de matriz dispersa

8. Métodos de mallas triangulares no estructuradas

MétodoDescripción
Axes.triplot()Líneas de malla triangular
Axes.tripcolor()Falso color en malla triangular
Axes.tricontour()Curvas de nivel en malla triangular
Axes.tricontourf()Curvas de nivel rellenas en malla triangular

9. Métodos de texto y anotaciones

MétodoDescripción
Axes.text()Añadir texto
Axes.annotate()Añadir anotación con flecha
Axes.table()Añadir tabla
Axes.arrow()Añadir flecha
Axes.inset_axes()Crear subplot incrustado dentro del Axes
Axes.indicate_inset()Marcar la región del subplot incrustado en el Axes padre
Axes.indicate_inset_zoom()Marcar la región ampliada del subplot incrustado
Axes.secondary_xaxis()Añadir eje x secundario (mostrar los mismos datos en otra posición)
Axes.secondary_yaxis()Añadir eje y secundario

10. Métodos de campos vectoriales

MétodoDescripción
Axes.quiver()Campo vectorial (gráfico de flechas)
Axes.quiverkey()Clave de leyenda del campo vectorial
Axes.barbs()Gráfico de barbas (wind barbs)
Axes.streamplot()Gráfico de líneas de flujo

11. Métodos de limpieza

MétodoDescripción
Axes.cla()Limpiar todo el contenido del Axes
Axes.clear()Limpiar el Axes (igual que cla())

12. Métodos de apariencia

MétodoDescripción
Axes.axis()Establecer la visibilidad o los límites de los ejes
Axes.set_axis_off()Ocultar los ejes
Axes.set_axis_on()Mostrar los ejes
Axes.set_frame_on()Mostrar el borde del Axes
Axes.get_frame_on()Obtener si el borde es visible
Axes.set_axisbelow()Establecer si la cuadrícula/los ticks están debajo de los datos
Axes.get_axisbelow()Obtener el nivel de la cuadrícula/ticks
Axes.grid()Establecer líneas de cuadrícula
Axes.get_facecolor()Obtener el color de fondo del Axes
Axes.set_facecolor()Establecer el color de fondo del Axes

13. Ciclo de propiedades

MétodoDescripción
Axes.set_prop_cycle()Establecer el ciclo de propiedades (color, tipo de línea, etc.)

14. Control de ejes y marcas

Acceso a los ejes:

MétodoDescripción
Axes.xaxis / Axes.yaxisObtener el objeto Axis del eje x/y (propiedad)
Axes.get_xaxis() / get_yaxis()Obtener el objeto Axis del eje x/y

Rango y dirección de los ejes:

MétodoDescripción
Axes.set_xlim() / get_xlim()Establecer/Obtener el rango del eje x
Axes.set_ylim() / get_ylim()Establecer/Obtener el rango del eje y
Axes.set_xbound() / get_xbound()Establecer/Obtener los límites inferior y superior del eje x
Axes.set_ybound() / get_ybound()Establecer/Obtener los límites inferior y superior del eje y
Axes.invert_xaxis()Invertir la dirección del eje x
Axes.invert_yaxis()Invertir la dirección del eje y
Axes.xaxis_inverted() / yaxis_inverted()Consultar si el eje está invertido
Axes.set_xinverted() / get_xinverted()Establecer/Obtener si el eje x está invertido
Axes.set_yinverted() / get_yinverted()Establecer/Obtener si el eje y está invertido
Axes.update_datalim()Extender el rango de datos con nuevos puntos de datos

Etiquetas de ejes y leyenda:

MétodoDescripción
Axes.set_xlabel() / get_xlabel()Establecer/Obtener la etiqueta del eje x
Axes.set_ylabel() / get_ylabel()Establecer/Obtener la etiqueta del eje y
Axes.label_outer()Conservar solo las etiquetas de los ticks de los subplots más externos
Axes.set_title() / get_title()Establecer/Obtener el título del Axes
Axes.legend()Añadir leyenda
Axes.get_legend()Obtener el objeto de leyenda actual
Axes.get_legend_handles_labels()Obtener los handles y etiquetas de la leyenda

Escala de los ejes:

MétodoDescripción
Axes.set_xscale() / get_xscale()Establecer/Obtener la escala del eje x
Axes.set_yscale() / get_yscale()Establecer/Obtener la escala del eje y

Autoescalado y márgenes:

MétodoDescripción
Axes.autoscale()Autoescalar la vista para ajustarse a los datos
Axes.autoscale_view()Autoescalar la vista únicamente (sin cambiar los márgenes)
Axes.margins()Establecer u obtener los márgenes de datos
Axes.relim()Recalcular el rango de datos según el Artist actual
Axes.use_sticky_edges()Usar bordes adhesivos (sticky edges)
Axes.set_xmargin() / get_xmargin()Establecer/Obtener el margen del eje x
Axes.set_ymargin() / get_ymargin()Establecer/Obtener el margen del eje y
Axes.set_autoscale_on() / get_autoscale_on()Establecer/Obtener si la autoescalada está activa
Axes.set_autoscalex_on() / get_autoscalex_on()Establecer/Obtener si la autoescalada del eje x está activa
Axes.set_autoscaley_on() / get_autoscaley_on()Establecer/Obtener si la autoescalada del eje y está activa

Relación de aspecto:

MétodoDescripción
Axes.set_aspect() / get_aspect()Establecer/Obtener la relación de aspecto de los ejes ('equal'/'auto'/numérico)
Axes.set_box_aspect() / get_box_aspect()Establecer/Obtener la relación de aspecto de la caja del Axes
Axes.apply_aspect()Aplicar la configuración actual de relación de aspecto
Axes.set_adjustable() / get_adjustable()Establecer/Obtener el modo de ajuste ('box'/'datalim')

Ticks y etiquetas de ticks:

MétodoDescripción
Axes.set_xticks() / get_xticks()Establecer/Obtener las posiciones de los ticks del eje x
Axes.set_yticks() / get_yticks()Establecer/Obtener las posiciones de los ticks del eje y
Axes.set_xticklabels() / get_xticklabels()Establecer/Obtener las etiquetas de los ticks del eje x
Axes.set_yticklabels() / get_yticklabels()Establecer/Obtener las etiquetas de los ticks del eje y
Axes.get_xmajorticklabels()Obtener las etiquetas de los ticks principales del eje x
Axes.get_xminorticklabels()Obtener las etiquetas de los ticks secundarios del eje x
Axes.get_ymajorticklabels()Obtener las etiquetas de los ticks principales del eje y
Axes.get_yminorticklabels()Obtener las etiquetas de los ticks secundarios del eje y
Axes.get_xgridlines()Obtener las líneas de cuadrícula del eje x
Axes.get_ygridlines()Obtener las líneas de cuadrícula del eje y
Axes.get_xticklines()Obtener las líneas de ticks del eje x
Axes.get_yticklines()Obtener las líneas de ticks del eje y
Axes.xaxis_date()Establecer los ticks del eje x en formato de fecha
Axes.yaxis_date()Establecer los ticks del eje y en formato de fecha
Axes.minorticks_on()Mostrar ticks secundarios
Axes.minorticks_off()Ocultar ticks secundarios
Axes.ticklabel_format()Configurar el formato de las etiquetas de los ticks
Axes.tick_params()Ajustar los parámetros de apariencia de los ticks
Axes.locator_params()Controlar los parámetros del localizador de ticks

15. Unidades

MétodoDescripción de la función
Axes.convert_xunits()Convertir valores de x usando un convertidor de unidades
Axes.convert_yunits()Convertir valores de y usando un convertidor de unidades
Axes.have_units()Verificar si hay un convertidor de unidades registrado

16. Agregar Artist

MétodoDescripción de la función
Axes.add_artist()Añadir cualquier objeto Artist
Axes.add_child_axes()Añadir un Axes hijo
Axes.add_collection()Añadir un objeto Collection
Axes.add_container()Añadir un objeto Container
Axes.add_image()Añadir un objeto AxesImage
Axes.add_line()Añadir un objeto Line2D
Axes.add_patch()Añadir un objeto Patch
Axes.add_table()Añadir un objeto Table

17. Ejes dobles y ejes compartidos

MétodoDescripción de la función
Axes.twinx()Crear un eje y dual que comparte el eje x
Axes.twiny()Crear un eje x dual que comparte el eje y
Axes.sharex()Compartir el eje x con otros Axes
Axes.sharey()Compartir el eje y con otros Axes
Axes.get_shared_x_axes()Obtener el objeto Grouper del eje x compartido
Axes.get_shared_y_axes()Obtener el objeto Grouper del eje y compartido

18. Posición de Axes

MétodoDescripción de la función
Axes.get_position() / set_position()Obtener/establecer la posición y el tamaño de Axes en la Figure
Axes.get_anchor() / set_anchor()Obtener/establecer el ancla (posición fija) de Axes
Axes.get_axes_locator() / set_axes_locator()Obtener/establecer la función de devolución de llamada del localizador de Axes
Axes.get_subplotspec() / set_subplotspec()Obtener/establecer el objeto SubplotSpec
Axes.reset_position()Restablecer la posición de Axes a su valor original

19. Asíncrono/Eventos

MétodoDescripción de la función
Axes.staleMarcar si el Artist necesita redibujarse (propiedad)
Axes.pchanged()Marcar un evento de cambio de propiedad
Axes.add_callback()Añadir una devolución de llamada para el cambio de propiedad
Axes.remove_callback()Eliminar una devolución de llamada para el cambio de propiedad

20. Interacción

MétodoDescripción de la función
Axes.can_pan() / can_zoom()Devolver si se puede desplazar/escalar (pan/zoom)
Axes.set_navigate() / get_navigate()Establecer/obtener si la barra de herramientas de navegación está activa
Axes.set_navigate_mode() / get_navigate_mode()Establecer/obtener el modo de navegación
Axes.start_pan() / drag_pan() / end_pan()Inicio/arrastre/fin de la operación de desplazamiento (pan)
Axes.format_coord()Formatear la cadena de coordenadas mostrada en la barra de herramientas
Axes.format_cursor_data()Formatear el valor de datos en la posición del cursor
Axes.format_xdata() / format_ydata()Formatear los valores de datos de x/y
Axes.mouseover()Determinar si el mouse está sobre el Axes
Axes.in_axes()Determinar si un punto está dentro del Axes
Axes.contains() / contains_point()Determinar si el Artist contiene un punto
Axes.get_cursor_data()Obtener los datos en la posición del cursor
Axes.get_forward_navigation_events() / set_forward_navigation_events()Obtener/establecer el reenvío de eventos de navegación

21. Consulta de subelementos

MétodoDescripción de la función
Axes.get_children()Obtener todos los Artists hijos
Axes.get_images()Obtener todos los objetos de imagen
Axes.get_lines()Obtener todos los objetos de líneas (Line2D)
Axes.findobj()Buscar Artists hijos que coincidan con la condición

22. Dibujo

MétodoDescripción de la función
Axes.draw()Renderizar el Axes
Axes.draw_artist()Dibujar un solo Artist (método de bajo nivel)
Axes.redraw_in_frame()Redibujar dentro del marco
Axes.get_window_extent()Obtener los límites de Axes en la ventana de visualización
Axes.get_tightbbox()Obtener el cuadro delimitador compacto de Axes
Axes.get_rasterization_zorder() / set_rasterization_zorder()Obtener/establecer el umbral de zorder para rasterización

23. Proyección (debe sobrescribirse en subclases)

MétodoDescripción de la función
Axes.nameNombre de la proyección (por ejemplo, 'rectilinear', 'polar')
Axes.get_xaxis_transform() / get_yaxis_transform()Obtener la transformación de los ejes x/y
Axes.get_data_ratio()Obtener la relación de aspecto de los datos
Axes.get_xaxis_text1_transform()Transformación de la etiqueta inferior del eje x
Axes.get_xaxis_text2_transform()Transformación de la etiqueta superior del eje x
Axes.get_yaxis_text1_transform()Transformación de la etiqueta izquierda del eje y
Axes.get_yaxis_text2_transform()Transformación de la etiqueta derecha del eje y

24. Otros métodos

MétodoDescripción de la función
Axes.set()Establecer propiedades en lote
Axes.zorderObtener/establecer el zorder (propiedad)
Axes.get_figure()Obtener el objeto Figure al que pertenece
Axes.figureObjeto Figure al que pertenece (propiedad)
Axes.remove()Eliminarse a sí mismo de la Figure
Axes.has_data()Verificar si tiene datos
Axes.get_default_bbox_extra_artists()Obtener los Artists adicionales a incluir en el cálculo del cuadro delimitador
Axes.get_transformed_clip_path_and_affine()Obtener la ruta de recorte transformada
Axes.viewLimRango de vista (propiedad)
Axes.dataLimRango de datos (propiedad)
Axes.spinesDiccionario de líneas de borde (propiedad)

Objeto Figure - Lista completa de métodos

La Figure es el contenedor de nivel superior de todo el gráfico, que gestiona todos los Axes, Artists y el diseño.

1. Agregar Axes y SubFigure

MétodoDescripción de la función
Figure.subplots()RecomendadoCrear una cuadrícula de subtramas de Axes
Figure.add_subplot()Añadir una sola subtrama por posición de fila y columna
Figure.add_axes()Añadir un Axes en una posición y tamaño específicos
Figure.subplot_mosaic()Crear disposiciones complejas de subtramas usando el diseño de etiquetas
Figure.add_gridspec()Añadir un objeto de diseño GridSpec
Figure.subfigures()Crear una SubFigure anidada
Figure.add_subfigure()Añadir una sola SubFigure
Figure.axesLista de Axes (propiedad)
Figure.get_axes()Obtener todos los Axes
Figure.delaxes()Eliminar el Axes especificado

2. Guardar

MétodoDescripción de la función
Figure.savefig()Guardar la Figure en un archivo

3. Anotaciones a nivel de Figure

MétodoDescripción de la función
Figure.suptitle() / get_suptitle()Establecer/obtener el título general de la Figure
Figure.supxlabel() / get_supxlabel()Establecer/obtener la etiqueta x a nivel de Figure
Figure.supylabel() / get_supylabel()Establecer/obtener la etiqueta y a nivel de Figure
Figure.colorbar()Añadir una barra de color
Figure.legend()Añadir una leyenda global
Figure.text()Añadir texto a nivel de Figure
Figure.align_labels()Alinear las etiquetas de los ejes de todas las subtramas
Figure.align_xlabels()Alinear las etiquetas del eje x de todas las subtramas
Figure.align_ylabels()Alinear las etiquetas del eje y de todas las subtramas
Figure.align_titles()Alinear los títulos de todas las subtramas
Figure.autofmt_xdate()Rotar automáticamente las etiquetas de ticks de fecha

4. Geometría de Figure

MétodoDescripción de la función
Figure.set_size_inches() / get_size_inches()Establecer/obtener el tamaño de la Figure (en pulgadas)
Figure.set_figheight() / get_figheight()Establecer/obtener la altura de la Figure
Figure.set_figwidth() / get_figwidth()Establecer/obtener el ancho de la Figure
Figure.dpiResolución DPI (propiedad)
Figure.set_dpi() / get_dpi()Establecer/obtener el DPI

5. Disposición de subtramas

MétodoDescripción de la función
Figure.subplots_adjust()Ajustar manualmente el espaciado entre subtramas
Figure.set_layout_engine()Establecer el motor de diseño ('constrained'/'compressed'/'none')
Figure.get_layout_engine()Obtener el motor de diseño actual
Figure.tight_layout()Diseño compacto automático (ya no recomendado)
Figure.set_tight_layout() / get_tight_layout()Establecer/obtener tight_layout (ya no recomendado)
Figure.set_constrained_layout() / get_constrained_layout()Establecer/obtener constrained_layout (ya no recomendado)
Figure.set_constrained_layout_pads() / get_constrained_layout_pads()Establecer/obtener los márgenes de constrained_layout (ya no recomendado)

6. Interacción

MétodoDescripción de la función
Figure.ginput()Obtener un punto de coordenadas mediante un clic del mouse
Figure.waitforbuttonpress()Esperar una pulsación del mouse o del teclado
Figure.pick()Activar el evento pick
Figure.add_axobserver()Añadir un observador de Axes

7. Modificación de apariencia

MétodoDescripción de la función
Figure.set_frameon() / get_frameon()Establecer/obtener si el fondo de la Figure es visible
Figure.set_linewidth() / get_linewidth()Establecer/obtener el grosor del borde de la Figure
Figure.set_facecolor() / get_facecolor()Establecer/obtener el color de fondo de la Figure
Figure.set_edgecolor() / get_edgecolor()Establecer/obtener el color del borde de la Figure

8. Agregar y obtener Artist

MétodoDescripción de la función
Figure.add_artist()Añadir cualquier Artist
Figure.figimage()Colocar una imagen a nivel de Figure
Figure.get_children()Obtener todos los Artists hijos

9. Gestión de estado

MétodoDescripción de la función
Figure.clear()Limpiar la Figure
Figure.gca()Obtener el Axes actual
Figure.sca()Establecer el Axes actual
Figure.show()Mostrar la Figure
Figure.draw()Renderizar la Figure
Figure.draw_artist()Dibujar un solo Artist
Figure.draw_without_rendering()Calcular el diseño sin renderizar (para obtener información de tamaño)
Figure.set_canvas()Establecer el lienzo (canvas)
Figure.get_tightbbox()Obtener el cuadro delimitador compacto de la Figure
Figure.get_window_extent()Obtener los límites de Figure en la ventana de visualización

10. Funciones auxiliares

FunciónDescripción
figaspect()Calcular el tamaño de Figure según la relación de aspecto especificada

Objeto SubFigure - Lista de métodos

SubFigure es un sub-Figure lógico anidado dentro de un Figure padre y tiene métodos similares a los de Figure.

Agregar Axes

MétodoDescripción
SubFigure.subplots()Crear una cuadrícula de subgráficos
SubFigure.add_subplot()Añadir un solo subgráfico
SubFigure.add_axes()Añadir Axes en una posición especificada
SubFigure.subplot_mosaic()Subgráficos con disposición de etiquetas
SubFigure.add_gridspec()Añadir GridSpec
SubFigure.subfigures()Crear un SubFigure anidado más profundo
SubFigure.add_subfigure()Añadir un solo SubFigure
SubFigure.delaxes()Eliminar Axes

Anotaciones

MétodoDescripción
SubFigure.suptitle() / get_suptitle()Título general de SubFigure
SubFigure.supxlabel() / get_supxlabel()Etiqueta x de SubFigure
SubFigure.supylabel() / get_supylabel()Etiqueta y de SubFigure
SubFigure.colorbar()Barra de color
SubFigure.legend()Leyenda
SubFigure.text()Texto
SubFigure.align_labels()Alinear etiquetas
SubFigure.align_xlabels() / align_ylabels()Alinear etiquetas x/y
SubFigure.align_titles()Alinear títulos

Artist y apariencia

MétodoDescripción
SubFigure.add_artist()Añadir Artist
SubFigure.get_children()Obtener sub-Artist
SubFigure.set_frameon() / get_frameon()Establecer/obtener borde
SubFigure.set_linewidth() / get_linewidth()Establecer/obtener grosor de línea
SubFigure.set_facecolor() / get_facecolor()Establecer/obtener color de fondo
SubFigure.set_edgecolor() / get_edgecolor()Establecer/obtener color de borde
SubFigure.set_dpi() / get_dpi()Establecer/obtener DPI

Referencia rápida de configuración de estilos

Hojas de estilo integradas

Medianteplt.style.use('name')cambiar de estilo.

Nombre del estiloDescripción del estilo
defaultEstilo predeterminado, claro y neutro
ggplotSimula el estilo ggplot2 de R, fondo gris con cuadrícula blanca
seaborn-v0_8Estilo moderno similar a la biblioteca seaborn
seaborn-v0_8-brightseaborn tono brillante
seaborn-v0_8-colorblindseaborn paleta apta para daltónicos
seaborn-v0_8-darkseaborn estilo oscuro
seaborn-v0_8-dark-paletteseaborn paleta de tonos oscuros
seaborn-v0_8-darkgridseaborn oscuro con cuadrícula
seaborn-v0_8-deepseaborn tonos oscuros
seaborn-v0_8-mutedseaborn tonos suaves
seaborn-v0_8-notebookseaborn estilo notebook
seaborn-v0_8-paperseaborn estilo papel
seaborn-v0_8-pastelseaborn tonos rosados
seaborn-v0_8-posterseaborn estilo póster
seaborn-v0_8-talkseaborn estilo presentación
seaborn-v0_8-ticksseaborn estilo de marcas
seaborn-v0_8-whiteseaborn fondo blanco
seaborn-v0_8-whitegridseaborn blanco con cuadrícula
fivethirtyeightImita el estilo de periodismo de datos FiveThirtyEight
dark_backgroundFondo oscuro, adecuado para presentaciones y uso nocturno
bmhEstilo Bayesian Methods for Hackers
grayscaleEstilo en escala de grises, adecuado para impresión en blanco y negro
classicEstilo clásico Matplotlib v1.x
fastEstilo simplificado, renderizado más rápido
Solarize_Light2Tema claro Solarized
tableau-colorblind10Paleta apta para daltónicos de Tableau

Configuración común de rcParams

ParámetroDescripciónValor de ejemplo
figure.figsizeTamaño predeterminado de la figura (en pulgadas)[8, 6]
figure.dpiResolución predeterminada100
figure.facecolorColor de fondo de Figure'white'
figure.edgecolorColor de borde de Figure'white'
font.sizeTamaño de fuente global12
font.familyFamilia tipográfica'sans-serif'
font.sans-serifLista de fuentes sans-serif['DejaVu Sans', ...]
axes.titlesizeTamaño de fuente del título'large'
axes.labelsizeTamaño de fuente de las etiquetas de los ejes'medium'
axes.gridMostrar cuadrícula por defectoFalse
axes.facecolorColor de fondo de Axes'white'
axes.spines.topMostrar borde superiorTrue
axes.spines.rightMostrar borde derechoTrue
lines.linewidthGrosor de línea predeterminado1.5
lines.markersizeTamaño de marcador predeterminado6
lines.linestyleTipo de línea predeterminado'-'
legend.locPosición predeterminada de la leyenda'best'
legend.fontsizeTamaño de fuente de la leyenda'medium'
xtick.labelsizeTamaño de las etiquetas de los ticks del eje x'medium'
ytick.labelsizeTamaño de las etiquetas de los ticks del eje y'medium'
savefig.dpiResolución predeterminada al guardar imágenes'figure'
savefig.bboxModo de límites al guardarNone
image.cmapColormap predeterminado'viridis'
image.interpolationMétodo de interpolación de imágenes'antialiased'

Referencia rápida de colormap (mapa de colores)

CategoríaNombre del colormapCasos de uso
Perceptualmente uniforme (Secuencial)viridis, plasma, inferno, magma, cividisDatos continuos, apto para daltónicos, primera opción recomendada
Secuencial (degradado de un solo color)Greys, Purples, Blues, Greens, Oranges, Reds, YlOrBr, YlOrRd, OrRd, PuRd, RdPu, BuPu, GnBu, PuBu, YlGnBu, PuBuGn, BuGn, YlGnDatos continuos de menor a mayor, tono único
DivergentePiYG, PRGn, BrBG, PuOr, RdGy, RdBu, RdYlBu, RdYlGn, Spectral, coolwarm, bwr, seismicDatos bidireccionales con punto de referencia central
Cíclicotwilight, twilight_shifted, hsvDatos periódicos (como ángulos, tiempo)
CualitativoPastel1, Pastel2, Paired, Accent, Dark2, Set1, Set2, Set3, tab10, tab20, tab20b, tab20cDatos categóricos discretos
Misceláneosflag, prism, ocean, gist_earth, terrain, gist_stern, gnuplot, gnuplot2, CMRmap, cubehelix, brg, gist_rainbow, rainbow, jet, turbo, nipy_spectral, gist_ncarUsos especiales o efectos visuales

'viridis'Es el colormap predeterminado desde Matplotlib 2.0, tiene una excelente uniformidad perceptiva y es apto para daltónicos, siendo la primera opción en la mayoría de los casos. Evite usar'jet'y'rainbow', pues tienen problemas de distorsión perceptiva.


Ejemplos comunes

Ejemplo 1: Gráfico de líneas y diagrama de dispersión básicos

Usar la interfaz explícita de Axes para crear una gráfica con múltiples curvas y anotaciones.

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

# Generar datos: 100 puntos equiespaciados entre 0 y 10
x = np.linspace(0, 10, 100)
y1 = np.sin(x)   # Función seno
y2 = np.cos(x)   # Función coseno

# Crear Figure y Axes (interfaz explícita, recomendada)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

# Dibujar dos líneas, establecer color, tipo de línea y etiquetas
ax.plot(x, y1, label='sin(x)', color='blue', linewidth=2)
ax.plot(x, y2, label='cos(x)', color='red', linestyle='--', linewidth=2)

# Añadir un punto de dispersión destacado en la posición del pico
peak_idx_sin = np.argmax(y1)
peak_idx_cos = np.argmax(y2)
ax.scatter(x[peak_idx_sin], y1[peak_idx_sin],
           color='blue', s=100, zorder=5)
ax.scatter(x[peak_idx_cos], y2[peak_idx_cos],
           color='red', s=100, zorder=5)

# Decoración: título, etiquetas de ejes, leyenda, cuadrícula
ax.set_title('Sine and Cosine Functions', fontsize=14)
ax.set_xlabel('x (radians)')
ax.set_ylabel('Amplitude')
ax.legend(loc='upper right')
ax.grid(True, alpha=0.3)

plt.show()
print("ejemplo: plot displayed successfully")

Ejemplo 2: Disposición de múltiples subtramas (2x2)

Muestra cómo crear diferentes tipos de subgráficos en un mismo Figure.

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 2 * np.pi, 100)

# Crear subgráficos 2x2 (interfaz orientada a objetos)
fig, axes = plt.subplots(2, 2, figsize=(10, 8), layout='constrained')
fig.suptitle('Multi-panel EJEMPLO Demo', fontsize=16)

# Subgráfico (0,0): gráfico de líneas
axes[0, 0].plot(x, np.sin(x), color='tab:blue', linewidth=2)
axes[0, 0].set_title('Line Plot')
axes[0, 0].set_ylabel('sin(x)')

# Subgráfico (0,1): gráfico de dispersión
np.random.seed(42)
colors = np.random.rand(50)
sizes = np.random.rand(50) * 200
axes[0, 1].scatter(np.random.rand(50), np.random.rand(50),
                   c=colors, s=sizes, alpha=0.6, cmap='viridis')
axes[0, 1].set_title('Scatter Plot')

# Subgráfico (1,0): gráfico de barras (con etiquetas de valor)
categories = ['A', 'B', 'C', 'D', 'E']
values = [23, 45, 56, 78, 32]
bars = axes[1, 0].bar(categories, values,
                       color='tab:green', edgecolor='white')
axes[1, 0].bar_label(bars)  # Mostrar valores sobre las barras
axes[1, 0].set_title('Bar Chart')

# Subgráfico (1,1): histograma
data = np.random.randn(1000)
axes[1, 1].hist(data, bins=30, color='tab:orange',
                edgecolor='white', alpha=0.8)
axes[1, 1].axvline(x=0, color='red', linestyle='--', linewidth=2)
axes[1, 1].set_title('Histogram')

plt.show()

Ejemplo 3: Comparación entre mapa de calor y curvas de nivel

Muestra el uso de imshow y contourf en el mismo Figure para visualizar datos bidimensionales.

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

# Crear datos de cuadrícula bidimensional
x = np.linspace(-3, 3, 100)
y = np.linspace(-3, 3, 100)
X, Y = np.meshgrid(x, y)
Z = np.sin(X) * np.cos(Y)  # Valores de la función bidimensional

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
                                layout='constrained')

# Gráfico izquierdo: mapa de calor (imshow)
im = ax1.imshow(Z, extent=[-3, 3, -3, 3], origin='lower',
                cmap='viridis', aspect='auto')
ax1.set_title('Heatmap (imshow)', fontsize=14)
ax1.set_xlabel('X')
ax1.set_ylabel('Y')
fig.colorbar(im, ax=ax1, label='Amplitude', shrink=0.8)

# Gráfico derecho: curvas de nivel rellenas (contourf)
contour = ax2.contourf(X, Y, Z, levels=15, cmap='RdYlBu')
# Superponer bordes de curvas de nivel
ax2.contour(X, Y, Z, levels=15, colors='black', linewidths=0.5)
ax2.set_title('Filled Contour (contourf)', fontsize=14)
ax2.set_xlabel('X')
ax2.set_ylabel('Y')
fig.colorbar(contour, ax=ax2, label='Amplitude', shrink=0.8)

plt.show()

Ejemplo 4: Cambio de estilo y guardado de imágenes

Usar hojas de estilo y rcParams para personalizar la apariencia y guardar imágenes de alta calidad.

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

# Usar estilo ggplot y ajustar finamente algunos parámetros
plt.style.use('ggplot')
plt.rcParams['figure.figsize'] = [8, 6]
plt.rcParams['font.size'] = 12

x = np.linspace(0, 10, 50)
y1 = np.exp(-x/3) * np.sin(2 * x)  # Onda seno amortiguada
y2 = np.exp(-x/3) * np.cos(2 * x)  # Onda coseno amortiguada

fig, ax = plt.subplots()
ax.plot(x, y1, 'o-', label='Damped sin', markersize=6)
ax.plot(x, y2, 's--', label='Damped cos', markersize=6)

# Anotar el primer pico
peak_idx = np.argmax(y1)
ax.annotate(f'Peak: {y1[peak_idx]:.2f}',
            xy=(x[peak_idx], y1[peak_idx]),
            xytext=(x[peak_idx] + 1.5, y1[peak_idx] + 0.15),
            arrowprops=dict(arrowstyle='->', color='gray'),
            fontsize=10)

ax.set_title('Damped Oscillation', fontsize=16)
ax.set_xlabel('Time (s)')
ax.set_ylabel('Amplitude')
ax.legend()
ax.grid(True)

# Guardar como PNG de alta calidad a 300 DPI
fig.savefig('ejemplo_damped_oscillation.png',
            dpi=300, bbox_inches='tight')
print("ejemplo: figure saved successfully")

plt.show()

Ejemplo 5: Disposición compleja con mosaic

Usar subplot_mosaic para crear arreglos de subgráficos no uniformes.

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

# La cadena mosaic define la disposición:
# 'A' abarca toda la fila superior, 'B' y 'C' están abajo a la izquierda y en el medio izquierdo, 'D' ocupa verticalmente la parte inferior derecha
layout = """
A A A
B C D
"""


fig, axes = plt.subplot_mosaic(layout, figsize=(10, 6),
                                layout='constrained')
fig.suptitle('Complex Mosaic Layout (EJEMPLO)', fontsize=16)

# Panel A: gráfico de líneas (abarca la parte superior)
x = np.linspace(0, 10, 100)
axes['A'].plot(x, np.sin(x), label='sin(x)')
axes['A'].plot(x, np.cos(x), label='cos(x)')
axes['A'].set_title('Panel A: Line Plot')
axes['A'].legend()

# Panel B: gráfico circular
sizes = [30, 25, 20, 15, 10]
labels = ['Python', 'Java', 'C++', 'Rust', 'Go']
axes['B'].pie(sizes, labels=labels, autopct='%1.1f%%',
              startangle=90)
axes['B'].set_title('Panel B: Pie Chart')

# Panel C: gráfico de barras
axes['C'].bar(['X', 'Y', 'Z'], [10, 25, 15],
              color=['#ff6b6b', '#4ecdc4', '#45b7d1'])
axes['C'].set_title('Panel C: Bar Chart')

# Panel D: mapa de calor
matrix = np.random.rand(5, 5)
im = axes['D'].imshow(matrix, cmap='Blues', aspect='auto')
axes['D'].set_title('Panel D: Heatmap')
fig.colorbar(im, ax=axes['D'])

plt.show()

Ejemplo 6: Doble eje y y subtrama incrustada

Muestra el uso de secondary_axis, twinx e inset_axes.

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')

x = np.linspace(0, 10, 100)

# Gráfico principal: dibujar dos curvas con diferentes magnitudes
ax.plot(x, np.sin(x), 'b-', label='sin(x) [amplitude]')
ax.set_xlabel('x (radians)')
ax.set_ylabel('sin(x)', color='blue')
ax.tick_params(axis='y', labelcolor='blue')

# Crear doble eje y (compartiendo el eje x)
ax2 = ax.twinx()
ax2.plot(x, np.exp(x/5), 'r--', label='exp(x/5) [growth]')
ax2.set_ylabel('exp(x/5)', color='red')
ax2.tick_params(axis='y', labelcolor='red')

# Añadir un subgráfico incrustado en ax (para ampliar una región local)
axins = ax.inset_axes([0.15, 0.5, 0.3, 0.35])
axins.plot(x, np.sin(x), 'b-')
axins.set_xlim(3, 5)
axins.set_ylim(-1.2, 1.2)
axins.set_title('Zoomed Region')
axins.grid(True, alpha=0.3)

# Marcar la región incrustada en el gráfico principal
ax.indicate_inset_zoom(axins, edgecolor='gray')

ax.set_title('Dual Y-Axes with Inset Zoom', fontsize=14)
plt.show()

Preguntas frecuentes

El gráfico no se muestra

Verificar si se ha llamado aplt.show()。

En backends no interactivos (como Agg) se debe llamar explícitamente ashow()。

En Jupyter Notebook, usar%matplotlib inlineEl comando mágico garantiza que los gráficos se muestren incrustados.

Demasiadas marcas o desorden en el orden

Una causa común es pasar una lista de cadenas como datos (en lugar de valores numéricos o de fecha y hora).

Matplotlib trata una lista de cadenas como una variable categórica: un tick por cada valor único, ordenados según su aparición.

Solución: convertir las cadenas a valores numéricos, por ejemplonp.asarray(data, dtype='float')onp.asarray(data, dtype='datetime64[s]')。

El chino se muestra como recuadros

La fuente predeterminada de Matplotlib (DejaVu Sans) no incluye glifos chinos; debe especificar una fuente compatible con chino.

Configuraciónplt.rcParams['font.sans-serif'] = ['SimHei', 'Arial Unicode MS', ...]y asegúrese de que el sistema tenga instalada la fuente correspondiente.

Etiquetas superpuestas o truncadas

Se recomienda usar al crear la Figurelayout='constrained'olayout='compressed'parámetro, que gestiona automáticamente los problemas de solapamiento de etiquetas, títulos y leyendas.

También se puede usarfig.tight_layout()ofig.subplots_adjust()para ajustar manualmente.

Diferencia entre pcolor y pcolormesh

pcolor()Crea un PolyCollection, cuyo renderizado es más lento pero más preciso.

pcolormesh()Crea un QuadMesh, con renderizado más rápido; es la opción recomendada en la mayoría de los escenarios.

Para cuadrículas muy grandes,pcolorfast()use imshow para dibujar; es el método más rápido, pero el de menor precisión.


Recursos relacionados

  • Sitio web oficial de Matplotlib: matplotlib.org
  • Galería oficial (Gallery): matplotlib.org/stable/gallery/index.html
  • Referencia completa de la API: matplotlib.org/stable/api/index.html
  • Guía de instalación: matplotlib.org/stable/install/index.html
  • Guía de contribución: matplotlib.org/stable/devel/index.html
Otras extensiones