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ón | Contenido relacionado |
|---|---|
| Función plot() de Matplotlib | plot() |
| Función scatter() de Matplotlib | scatter() |
| Función bar() / barh() de Matplotlib | bar(), barh(), bar_label(), grouped_bar() |
| Función hist() de Matplotlib | hist() |
| Función pie() de Matplotlib | pie(), pie_label() |
| Función imshow() de Matplotlib | imshow() |
| Función subplots() de Matplotlib | subplots() |
| Función figure() de Matplotlib | figure() |
| Función savefig() de Matplotlib | savefig() |
| Función errorbar() de Matplotlib | errorbar() |
| Función boxplot() de Matplotlib | boxplot() |
| Función contour() / contourf() de Matplotlib | contour(), contourf(), clabel() |
| Función fill_between() / fill_betweenx() de Matplotlib | fill_between(), fill_betweenx() |
| Función legend() de Matplotlib | legend() |
| Función text() / annotate() de Matplotlib | text(), annotate() |
| Funciones de títulos y etiquetas de Matplotlib | title(), xlabel(), ylabel(), suptitle(), supxlabel(), supylabel() |
| Función colorbar() de Matplotlib | colorbar() |
| Funciones de gestión de Figure y Axes de Matplotlib | axes(), cla(), clf(), close(), delaxes(), fignum_exists(), gca(), gcf(), get_figlabels(), get_fignums(), sca(), subplot(), subplot2grid(), subplot_mosaic(), twinx(), twiny() |
| Funciones de dibujo avanzado de Matplotlib | step(), stem(), eventplot(), stackplot(), broken_barh(), vlines(), hlines(), fill(), loglog(), semilogx(), semilogy() |
| Funciones de líneas de intervalo y campos vectoriales de Matplotlib | axhline(), axhspan(), axvline(), axvspan(), axline(), quiver(), quiverkey(), barbs(), streamplot() |
| Funciones de análisis de espectro de Matplotlib | acorr(), xcorr(), psd(), csd(), specgram(), cohere(), angle_spectrum(), magnitude_spectrum(), phase_spectrum() |
| Funciones de datos bidimensionales y gráficos estadísticos de Matplotlib | hist2d(), hexbin(), stairs(), matshow(), pcolor(), pcolormesh(), spy(), figimage(), ecdf(), violinplot() |
| Funciones de mallas triangulares y coordenadas polares de Matplotlib | triplot(), tripcolor(), tricontour(), tricontourf(), polar(), rgrids(), thetagrids() |
| Funciones de configuración de ejes de Matplotlib | xlim(), 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 Matplotlib | subplots_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 Matplotlib | connect(), 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 Matplotlib | figtext(), 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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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ón | Descripció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 |
| colormaps | Objeto registro de colormaps |
| color_sequences | Objeto registro de secuencias de colores |
15. Configuración
Funciones para administrar los parámetros de configuración globales de Matplotlib.
| Función | Descripció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ón | Descripció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ón | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripción |
|---|---|
| Axes.cla() | Limpiar todo el contenido del Axes |
| Axes.clear() | Limpiar el Axes (igual que cla()) |
12. Métodos de apariencia
| Método | Descripció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étodo | Descripció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étodo | Descripción |
|---|---|
| Axes.xaxis / Axes.yaxis | Obtener 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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripción de la función |
|---|---|
| Axes.stale | Marcar 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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripción de la función |
|---|---|
| Axes.name | Nombre 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étodo | Descripción de la función |
|---|---|
| Axes.set() | Establecer propiedades en lote |
| Axes.zorder | Obtener/establecer el zorder (propiedad) |
| Axes.get_figure() | Obtener el objeto Figure al que pertenece |
| Axes.figure | Objeto 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.viewLim | Rango de vista (propiedad) |
| Axes.dataLim | Rango de datos (propiedad) |
| Axes.spines | Diccionario 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étodo | Descripció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.axes | Lista de Axes (propiedad) |
| Figure.get_axes() | Obtener todos los Axes |
| Figure.delaxes() | Eliminar el Axes especificado |
2. Guardar
| Método | Descripción de la función |
|---|---|
| Figure.savefig() | Guardar la Figure en un archivo |
3. Anotaciones a nivel de Figure
| Método | Descripció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étodo | Descripció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.dpi | Resolución DPI (propiedad) |
| Figure.set_dpi() / get_dpi() | Establecer/obtener el DPI |
5. Disposición de subtramas
| Método | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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ón | Descripció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étodo | Descripció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étodo | Descripció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étodo | Descripció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 estilo | Descripción del estilo |
|---|---|
| default | Estilo predeterminado, claro y neutro |
| ggplot | Simula el estilo ggplot2 de R, fondo gris con cuadrícula blanca |
| seaborn-v0_8 | Estilo moderno similar a la biblioteca seaborn |
| seaborn-v0_8-bright | seaborn tono brillante |
| seaborn-v0_8-colorblind | seaborn paleta apta para daltónicos |
| seaborn-v0_8-dark | seaborn estilo oscuro |
| seaborn-v0_8-dark-palette | seaborn paleta de tonos oscuros |
| seaborn-v0_8-darkgrid | seaborn oscuro con cuadrícula |
| seaborn-v0_8-deep | seaborn tonos oscuros |
| seaborn-v0_8-muted | seaborn tonos suaves |
| seaborn-v0_8-notebook | seaborn estilo notebook |
| seaborn-v0_8-paper | seaborn estilo papel |
| seaborn-v0_8-pastel | seaborn tonos rosados |
| seaborn-v0_8-poster | seaborn estilo póster |
| seaborn-v0_8-talk | seaborn estilo presentación |
| seaborn-v0_8-ticks | seaborn estilo de marcas |
| seaborn-v0_8-white | seaborn fondo blanco |
| seaborn-v0_8-whitegrid | seaborn blanco con cuadrícula |
| fivethirtyeight | Imita el estilo de periodismo de datos FiveThirtyEight |
| dark_background | Fondo oscuro, adecuado para presentaciones y uso nocturno |
| bmh | Estilo Bayesian Methods for Hackers |
| grayscale | Estilo en escala de grises, adecuado para impresión en blanco y negro |
| classic | Estilo clásico Matplotlib v1.x |
| fast | Estilo simplificado, renderizado más rápido |
| Solarize_Light2 | Tema claro Solarized |
| tableau-colorblind10 | Paleta apta para daltónicos de Tableau |
Configuración común de rcParams
| Parámetro | Descripción | Valor de ejemplo |
|---|---|---|
| figure.figsize | Tamaño predeterminado de la figura (en pulgadas) | [8, 6] |
| figure.dpi | Resolución predeterminada | 100 |
| figure.facecolor | Color de fondo de Figure | 'white' |
| figure.edgecolor | Color de borde de Figure | 'white' |
| font.size | Tamaño de fuente global | 12 |
| font.family | Familia tipográfica | 'sans-serif' |
| font.sans-serif | Lista de fuentes sans-serif | ['DejaVu Sans', ...] |
| axes.titlesize | Tamaño de fuente del título | 'large' |
| axes.labelsize | Tamaño de fuente de las etiquetas de los ejes | 'medium' |
| axes.grid | Mostrar cuadrícula por defecto | False |
| axes.facecolor | Color de fondo de Axes | 'white' |
| axes.spines.top | Mostrar borde superior | True |
| axes.spines.right | Mostrar borde derecho | True |
| lines.linewidth | Grosor de línea predeterminado | 1.5 |
| lines.markersize | Tamaño de marcador predeterminado | 6 |
| lines.linestyle | Tipo de línea predeterminado | '-' |
| legend.loc | Posición predeterminada de la leyenda | 'best' |
| legend.fontsize | Tamaño de fuente de la leyenda | 'medium' |
| xtick.labelsize | Tamaño de las etiquetas de los ticks del eje x | 'medium' |
| ytick.labelsize | Tamaño de las etiquetas de los ticks del eje y | 'medium' |
| savefig.dpi | Resolución predeterminada al guardar imágenes | 'figure' |
| savefig.bbox | Modo de límites al guardar | None |
| image.cmap | Colormap predeterminado | 'viridis' |
| image.interpolation | Método de interpolación de imágenes | 'antialiased' |
Referencia rápida de colormap (mapa de colores)
| Categoría | Nombre del colormap | Casos de uso |
|---|---|---|
| Perceptualmente uniforme (Secuencial) | viridis, plasma, inferno, magma, cividis | Datos 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, YlGn | Datos continuos de menor a mayor, tono único |
| Divergente | PiYG, PRGn, BrBG, PuOr, RdGy, RdBu, RdYlBu, RdYlGn, Spectral, coolwarm, bwr, seismic | Datos bidireccionales con punto de referencia central |
| Cíclico | twilight, twilight_shifted, hsv | Datos periódicos (como ángulos, tiempo) |
| Cualitativo | Pastel1, Pastel2, Paired, Accent, Dark2, Set1, Set2, Set3, tab10, tab20, tab20b, tab20c | Datos categóricos discretos |
| Misceláneos | flag, prism, ocean, gist_earth, terrain, gist_stern, gnuplot, gnuplot2, CMRmap, cubehelix, brg, gist_rainbow, rainbow, jet, turbo, nipy_spectral, gist_ncar | Usos 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 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 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 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 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 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 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