matplotlib.pyplot

matplotlib.pyplotes una interfaz basada en estado para matplotlib. Proporciona una forma de representación gráfica implícita, similar a MATLAB. También abre figuras en su pantalla y actúa como el administrador de GUI de figuras.

pyplot está diseñado principalmente para gráficos interactivos y casos simples de generación de gráficos programáticos:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)

La API explícita orientada a objetos se recomienda para gráficos complejos, aunque pyplot todavía se usa para crear la figura y, a menudo, los ejes de la figura. Consulte pyplot.figure, pyplot.subplotsy pyplot.subplot_mosaicpara crear figuras, y la API de ejes para conocer los métodos de trazado en un eje:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

Consulte Interfaces de aplicación (API) de Matplotlib para obtener una explicación de las compensaciones entre las interfaces implícitas y explícitas.

Comandos de trazado

acorr	Trace la autocorrelación de x .
angle_spectrum	Trace el espectro de ángulos.
annotate	Anote el punto xy con texto text .
arrow	Agregue una flecha a los ejes.
autoscale	Escalar automáticamente la vista del eje a los datos (alternar).
axes	Agregue un eje a la figura actual y conviértalo en el eje actual.
axhline	Agregue una línea horizontal a través de los ejes.
axhspan	Agregue un tramo horizontal (rectángulo) a través de los ejes.
axis	Método de conveniencia para obtener o establecer algunas propiedades del eje.
axline	Agregue una línea recta infinitamente larga.
axvline	Agregue una línea vertical a través de los ejes.
axvspan	Agregue un tramo vertical (rectángulo) a través de los ejes.
bar	Haz un gráfico de barras.
bar_label	Etiqueta un gráfico de barras.
barbs	Trace un campo 2D de púas.
barh	Haz un gráfico de barras horizontales.
box	Active o desactive el cuadro de ejes en los ejes actuales.
boxplot	Dibuja un diagrama de caja y bigotes.
broken_barh	Trace una secuencia horizontal de rectángulos.
cla	Borrar los ejes actuales.
clabel	Etiquete una gráfica de contorno.
clf	Borrar la figura actual.
clim	Establezca los límites de color de la imagen actual.
close	Cierra una ventana de figura.
cohere	Trace la coherencia entre x e y .
colorbar	Añadir una barra de colores a un gráfico.
contour	Trazar líneas de contorno.
contourf	Trazar contornos rellenos.
csd	Trazar la densidad espectral cruzada.
delaxes	Eliminar an Axes(predeterminado a los ejes actuales) de su figura.
draw	Vuelva a dibujar la figura actual.
draw_if_interactive	Vuelva a dibujar la figura actual si está en modo interactivo.
errorbar	Trace y contra x como líneas y/o marcadores con barras de error adjuntas.
eventplot	Trace líneas paralelas idénticas en las posiciones dadas.
figimage	Agregue una imagen no remuestreada a la figura.
figlegend	Coloque una leyenda en la figura.
fignum_exists	Devuelve si existe la figura con el id dado.
figtext	Agregar texto a la figura.
figure	Cree una nueva figura o active una figura existente.
fill	Trazar polígonos rellenos.
fill_between	Rellene el área entre dos curvas horizontales.
fill_betweenx	Rellene el área entre dos curvas verticales.
findobj	Encuentra objetos de artista.
gca	Obtenga los ejes actuales.
gcf	Obtenga la cifra actual.
gci	Obtenga el artista coloreable actual.
get	Devuelve el valor de una Artistpropiedad o imprímelas todas.
get_cmap	Obtenga una instancia de mapa de colores, con valores predeterminados de rc si el nombre es Ninguno.
get_figlabels	Devuelve una lista de etiquetas de figuras existentes.
get_fignums	Devuelve una lista de números de figuras existentes.
getp	Devuelve el valor de una Artistpropiedad o imprímelas todas.
grid	Configure las líneas de la cuadrícula.
hexbin	Haz un gráfico binning hexagonal 2D de los puntos x , y .
hist	Calcular y trazar un histograma.
hist2d	Haz un diagrama de histograma 2D.
hlines	Trace líneas horizontales en cada y desde xmin hasta xmax .
imread	Leer una imagen de un archivo en una matriz.
imsave	Guarde una matriz como un archivo de imagen.
imshow	Muestre los datos como una imagen, es decir, en un ráster regular 2D.
install_repl_displayhook	Conéctese al gancho de visualización del shell actual.
ioff	Deshabilitar el modo interactivo.
ion	Activa el modo interactivo.
isinteractive	Devuelve si los gráficos se actualizan después de cada comando de trazado.
legend	Coloque una leyenda en los ejes.
locator_params	Comportamiento de control de los principales localizadores de garrapatas.
loglog	Haga una gráfica con escala logarítmica tanto en el eje x como en el eje y.
magnitude_spectrum	Trace el espectro de magnitud.
margins	Establecer o recuperar márgenes de escalado automático.
matshow	Muestre una matriz como una matriz en una nueva ventana de figura.
minorticks_off	Elimina las marcas menores de los ejes.
minorticks_on	Mostrar marcas menores en los ejes.
pause	Ejecute el bucle de eventos de la GUI durante segundos de intervalo .
pcolor	Cree un diagrama de pseudocolor con una cuadrícula rectangular no regular.
pcolormesh	Cree un diagrama de pseudocolor con una cuadrícula rectangular no regular.
phase_spectrum	Trazar el espectro de fase.
pie	Trace un gráfico circular.
plot	Trace y contra x como líneas y/o marcadores.
plot_date	[ Desalentado ] Parcela forzando el eje para tratar los flotadores como fechas.
polar	Haz un gráfico polar.
psd	Trazar la densidad espectral de potencia.
quiver	Trace un campo 2D de flechas.
quiverkey	Agrega una llave a un diagrama de carcaj.
rc	Establece la corriente rcParams. grupo es la agrupación para el rc, por ejemplo, para lines.linewidthel grupo es lines, para axes.facecolor, el grupo es axes, y así sucesivamente. El grupo también puede ser una lista o tupla de nombres de grupos, por ejemplo, ( xtick , ytick ). kwargs es un par de nombre/valor de atributo de diccionario, por ejemplo, ::.
rc_context	Devuelve un administrador de contexto para cambiar temporalmente rcParams.
rcdefaults	Restaure el rcParamsestilo predeterminado interno de Matplotlib.
rgrids	Obtenga o establezca las líneas de cuadrícula radiales en el gráfico polar actual.
savefig	Guarda la figura actual.
sca	Establezca los Ejes actuales en ax y la Figura actual en el padre de ax .
scatter	Un diagrama de dispersión de y vs.
sci	Establecer la imagen actual.
semilogx	Haz una gráfica con escala logarítmica en el eje x.
semilogy	Haz una gráfica con escala logarítmica en el eje y.
set_cmap	Establece el mapa de colores predeterminado y lo aplica a la imagen actual, si corresponde.
set_loglevel	Establezca el registrador raíz de Matplotlib y el nivel del controlador del registrador raíz, creando el controlador si aún no existe.
setp	Establezca una o más propiedades en un Artist, o enumere los valores permitidos.
show	Mostrar todas las figuras abiertas.
specgram	Trazar un espectrograma.
spy	Trace el patrón de escasez de una matriz 2D.
stackplot	Dibuja una gráfica de áreas apiladas.
stairs	Una función constante paso a paso como una línea con bordes delimitadores o un gráfico relleno.
stem	Crea un diagrama de tallo.
step	Haz un diagrama de pasos.
streamplot	Dibujar líneas de corriente de un flujo vectorial.
subplot	Agregue ejes a la figura actual o recupere ejes existentes.
subplot2grid	Cree una subparcela en una ubicación específica dentro de una cuadrícula normal.
subplot_mosaic	Cree un diseño de ejes basado en arte ASCII o listas anidadas.
subplot_tool	Inicie una ventana de herramientas de subtrama para una figura.
subplots	Crea una figura y un conjunto de subtramas.
subplots_adjust	Ajuste los parámetros de diseño de la subparcela.
suptitle	Agregue un subtítulo centrado a la figura.
switch_backend	Cierre todas las figuras abiertas y configure el backend de Matplotlib.
table	Agregar una tabla a un Axes.
text	Agregue texto a los ejes.
thetagrids	Obtenga o establezca las líneas de cuadrícula theta en el gráfico polar actual.
tick_params	Cambie la apariencia de las marcas, las etiquetas de las marcas y las líneas de cuadrícula.
ticklabel_format	Configure el ScalarFormatterutilizado por defecto para Ejes lineales.
tight_layout	Ajuste el relleno entre y alrededor de las subparcelas.
title	Establezca un título para los ejes.
tricontour	Dibuja líneas de contorno en una cuadrícula triangular sin estructura.
tricontourf	Dibuje regiones de contorno en una cuadrícula triangular sin estructura.
tripcolor	Cree un diagrama de pseudocolor de una cuadrícula triangular no estructurada.
triplot	Dibuja una cuadrícula triangular no estructurada como líneas y/o marcadores.
twinx	Crea y devuelve un segundo eje que comparte el eje x .
twiny	Cree y devuelva un segundo eje que comparta el eje y .
uninstall_repl_displayhook	Desconéctese del gancho de visualización del caparazón actual.
violinplot	Haz una trama de violín.
vlines	Trace líneas verticales en cada x desde ymin hasta ymax .
xcorr	Trace la correlación cruzada entre x e y .
xkcd	Active el modo de dibujo estilo boceto xkcd .
xlabel	Establezca la etiqueta para el eje x.
xlim	Obtener o establecer los límites x de los ejes actuales.
xscale	Establece la escala del eje x.
xticks	Obtenga o establezca las ubicaciones y etiquetas de marcas actuales del eje x.
ylabel	Establezca la etiqueta para el eje y.
ylim	Obtenga o establezca los límites y de los ejes actuales.
yscale	Establezca la escala del eje y.
yticks	Obtenga o establezca las ubicaciones y etiquetas de marcas actuales del eje y.

Otros comandos

connect	Enlace la función func al evento s .
disconnect	Desconecte la devolución de llamada con id cid .
get_current_fig_manager	Devuelve el gestor de figuras de la figura actual.
ginput	Llamada de bloqueo para interactuar con una figura.
new_figure_manager	Cree una nueva instancia de administrador de figuras.
waitforbuttonpress	Llamada de bloqueo para interactuar con la figura.

Mapas de colores

Los mapas de colores están disponibles a través del registro de mapas de colores matplotlib.colormaps. Para mayor comodidad, este registro está disponible pyploten

matplotlib.pyplot. mapas de color

Contenedor para mapas de colores que Matplotlib conoce por su nombre.

Experimental

Si bien esperamos que la API sea definitiva, la marcamos formalmente como experimental para 3.5 porque queremos mantener la opción de adaptar la API para 3.6 en caso de que surja la necesidad.

La instancia de registro universal es matplotlib.colormaps. No debería haber necesidad de que los usuarios creen una instancia de ColormapRegistrysí mismos.

El acceso de lectura utiliza una interfaz similar a un dictado que asigna nombres a Colormaps:

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

Los s devueltos Colormapson copias, por lo que su modificación no cambia la definición global del mapa de colores.

Se pueden agregar mapas de color adicionales a través de ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

Además, hay funciones de acceso directo para establecer mapas de colores integrados; por ejemplo plt.viridis(), es equivalente a plt.set_cmap('viridis').

matplotlib.pyplot. color_secuencias

Contenedor para secuencias de colores que Matplotlib conoce por su nombre.

La instancia de registro universal es matplotlib.color_sequences. No debería haber necesidad de que los usuarios creen una instancia de ColorSequenceRegistry sí mismos.

El acceso de lectura utiliza una interfaz similar a un dictado que asigna nombres a listas de colores:

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

Las listas devueltas son copias, por lo que su modificación no cambia la definición global de la secuencia de colores.

Se pueden agregar secuencias de color adicionales a través de ColorSequenceRegistry.register:

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])