`matplotlib`#

Una biblioteca de trazado orientada a objetos.

El módulo complementario de pyplot proporciona una interfaz de procedimiento, que se puede importar directamente, por ejemplo:

import matplotlib.pyplot as plt

o usando ipython:

ipython

en su terminal, seguido de:

In [1]: %matplotlib
In [2]: import matplotlib.pyplot as plt

en el indicador de shell de ipython.

En su mayor parte, se recomienda el uso directo de la biblioteca explícita orientada a objetos al programar; la interfaz implícita de pyplot es principalmente para trabajar de forma interactiva. Las excepciones a esta sugerencia son las funciones pyplot pyplot.figure, pyplot.subplot, pyplot.subplotsy pyplot.savefig, que pueden simplificar enormemente la creación de scripts. Consulte Interfaces de aplicación (API) de Matplotlib para obtener una explicación de las compensaciones entre las interfaces implícitas y explícitas.

Los módulos incluyen:

matplotlib.axes
la Axesclase La mayoría de las funciones de pyplot son contenedores para Axesmétodos. El módulo de ejes es el nivel más alto de acceso OO a la biblioteca.

matplotlib.figure
la Figureclase

matplotlib.artist
La Artistclase base para todas las clases que dibujan cosas.

matplotlib.lines
La Line2Dclase para dibujar líneas y marcadores.

matplotlib.patches
Clases para dibujar polígonos.

matplotlib.text
Las Texty Annotationclases.

matplotlib.image
Las AxesImagey FigureImageclases.

matplotlib.collections
Clases para el dibujo eficiente de grupos de líneas o polígonos.

matplotlib.colors
Especificaciones de color y elaboración de mapas de color.

matplotlib.cm
Colormaps y la ScalarMappableclase mixin para proporcionar funcionalidad de mapeo de color a otras clases.

matplotlib.ticker
Cálculo de ubicaciones de marcas de verificación y formato de etiquetas de verificación.

matplotlib.backends
Un subpaquete con módulos para varias bibliotecas GUI y formatos de salida.

El espacio de nombres matplotlib base incluye:

rcParams
Ajustes de configuración predeterminados; sus valores predeterminados pueden anularse mediante un matplotlibrcarchivo.

use
Configuración del backend de Matplotlib. Esto debe llamarse antes de crear cualquier figura, porque no es posible cambiar entre diferentes backends de GUI después de eso.

Matplotlib fue escrito inicialmente por John D. Hunter (1968-2012) y ahora es desarrollado y mantenido por muchos otros.

Ocasionalmente, la documentación interna (docstrings de Python) hará referencia a MATLAB®, una marca comercial registrada de The MathWorks, Inc.

Gestión de back -end #

matplotlib. use ( backend , * , force = True ) [fuente] #

Seleccione el backend utilizado para la representación y la integración de la GUI.

Parámetros :

cadena de fondo

El backend al que cambiar. Este puede ser uno de los nombres de back-end estándar, que no distinguen entre mayúsculas y minúsculas:

backends interactivos: GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo, MacOSX, nbAgg, QtAgg, QtCairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo, Qt5Agg, Qt5Cairo
backends no interactivos: agg, cairo, pdf, pgf, ps, svg, plantilla

o una cadena de la forma: module://my.module.name.

No es posible cambiar a un backend interactivo si ya se ha iniciado un bucle de eventos no relacionado (p. ej., cambiar a GTK3Agg si ya se ha abierto una ventana de TkAgg). Siempre es posible cambiar a un backend no interactivo.

forzar bool, por defecto: Verdadero

Si es Verdadero (el valor predeterminado), genera un ImportErrorsi el backend no se puede configurar (ya sea porque no se puede importar o porque ya se está ejecutando un marco interactivo de GUI incompatible); si es False, ignora silenciosamente la falla.

Ver también

backends
matplotlib.get_backend

matplotlib. get_backend ( ) [fuente] #

Devuelve el nombre del backend actual.

Ver también

matplotlib.use

matplotlib. interactivo ( b ) [fuente] #: Establezca si desea volver a dibujar después de cada comando de trazado (p. ej pyplot.xlabel., ).

matplotlib. es_interactivo ( ) [fuente] #: Devuelve si se vuelve a dibujar después de cada comando de trazado.

Nota

Esta función solo está diseñada para usarse en backends. Los usuarios finales deben usar en su pyplot.isinteractivelugar.

Valores predeterminados y estilo #

matplotlib. rcParams [fuente] #: Una instancia de RcParamspara manejar los valores predeterminados de Matplotlib.

clase matplotlib. RcParams ( * argumentos , ** kwargs ) [fuente] #

Un objeto de diccionario que incluye validación.

Las funciones de validación se definen y asocian con parámetros rc en matplotlib.rcsetup.

La lista de rcParams es:

_internal.classic_mode
agg.path.chunksize
animación.tasa de bits
animación.códec
animación.convert_args
animación.convert_path
animación.embed_limit
animación.ffmpeg_args
animación.ffmpeg_ruta
animación.frame_format
animación.html
animación.guionista
ejes.autolimit_mode
ejes.eje debajo
ejes.edgecolor
ejes.facecolor
ejes.formateador.límites
ejes.formateador.min_exponent
ejes.formateador.offset_threshold
ejes.formateador.use_locale
ejes.formateador.use_mathtext
ejes.formateador.useoffset
ejes.grid
ejes.grid.axis
ejes.cuadrícula.que
ejes.labelcolor
ejes.labelpad
ejes.tamaño de la etiqueta
ejes.peso de la etiqueta
ejes.ancho de línea
ejes.prop_cycle
ejes.espinas.fondo
ejes.espinas.izquierda
ejes.espinas.derecha
hachas.espinas.arriba
ejes.titlecolor
ejes.titleubicación
ejes.titlepad
ejes.titlesize
ejes.titleweight
ejes.titley
ejes.unicode_minus
ejes.xmargin
ejes.ymargen
ejes.zmargin
ejes3d.grid
back-end
backend_fallback
boxplot.bootstrap
boxplot.boxprops.color
boxplot.boxprops.linestyle
boxplot.boxprops.linewidth
boxplot.capprops.color
boxplot.capprops.linestyle
boxplot.capprops.linewidth
boxplot.flierprops.color
boxplot.flierprops.linestyle
boxplot.flierprops.linewidth
boxplot.flierprops.marcador
boxplot.flierprops.markeredgecolor
boxplot.flierprops.markeredgewidth
boxplot.flierprops.markerfacecolor
boxplot.flierprops.markersize
boxplot.meanline
boxplot.meanprops.color
boxplot.meanprops.linestyle
boxplot.meanprops.linewidth
boxplot.meanprops.marker
boxplot.meanprops.markeredgecolor
boxplot.meanprops.markerfacecolor
boxplot.meanprops.markersize
boxplot.medianprops.color
boxplot.medianprops.linestyle
boxplot.medianprops.linewidth
diagrama de caja.muesca
boxplot.patchartist
boxplot.showbox
boxplot.showcaps
boxplot.showfliers
boxplot.showmeans
boxplot.vertical
boxplot.whiskerprops.color
boxplot.whiskerprops.linestyle
boxplot.whiskerprops.linewidth
boxplot.bigotes
algoritmo de contorno
contorno.corner_mask
contorno.ancho de línea
contorno.negative_linestyle
date.autoformatter.day
fecha.autoformateador.hora
fecha.formateador automático.microsegundo
fecha.formateador automático.minuto
fecha.autoformateador.mes
fecha.autoformateador.segundo
fecha.autoformateador.año
convertidor.de.fecha
fecha.época
fecha.intervalo_múltiplos
docstring.copia impresa
errorbar.capsize
figure.autolayout
figure.constrained_layout.h_pad
figure.constrained_layout.hspace
figure.constrained_layout.use
figure.constrained_layout.w_pad
figure.constrained_layout.wspace
figura.dpi
figura.bordecolor
figura.facecolor
figura.figsize
figura.frameon
figure.labelsize
figura.peso de la etiqueta
figura.max_open_warning
figure.raise_window
figura.subtrama.abajo
figura.subparcela.hspace
figura.subparcela.izquierda
figura.subtrama.derecha
figura.subparcela.superior
figura.subtrama.wspace
figure.titlesize
figure.titleweight
fuente.cursiva
Familia tipográfica
fuente.fantasía
fuente.monoespacio
fuente.sans-serif
fuente.serif
tamaño de fuente
fuente.estirar
Estilo de fuente
fuente.variante
fuente.peso
grilla.alfa
grid.color
grid.linestyle
grid.linewith
escotilla.color
escotilla.ancho de línea
hist.bins
imagen.aspecto
imagen.cmap
imagen.imagen_compuesta
imagen.interpolación
imagen.lut
imagen.origen
imagen.resample
interactivo
mapa de teclas.atrás
mapa de teclas.copiar
mapa de teclas.adelante
mapa de teclas.pantalla completa
mapa de teclas.grid
mapa de teclas.grid_menor
mapa de teclas.ayuda
mapa de teclas.inicio
mapa de teclas.pan
mapa de teclas.salir
mapa de teclas.quit_all
mapa de teclas.guardar
mapa de teclas.xscale
mapa de teclas.yscale
mapa de teclas.zoom
legend.borderaxespad
leyenda.borderpad
leyenda.espaciado de columnas
leyenda.bordecolor
leyenda.facecolor
leyenda.fancybox
leyenda.tamaño de fuente
leyenda.framealpha
leyenda.frameon
leyenda.handleheight
leyenda.handlelength
leyenda.handletextpad
leyenda.labelcolor
leyenda.labelspacing
leyenda.loc
leyenda.markerscale
leyenda.numpoints
leyenda.puntos de dispersión
leyenda.sombra
leyenda.title_fontsize
lineas.antialiased
lineas.color
lineas.dash_capstyle
líneas.dash_joinstyle
lineas.dashdot_pattern
líneas.patrón_discontinuo
líneas.patrón_de_puntos
lineas.linestyle
líneas.ancho de línea
lineas.marcador
lineas.markeredgecolor
lineas.markeredgewidth
lineas.markerfacecolor
líneas.tamañomarcador
lineas.escala_guiones
lineas.solid_capstyle
lineas.solid_joinstyle
marcadores.fillstyle
textomatematico.bf
textomatematico.cal
textomatemático.predeterminado
textomatemático.fallback
textomatematico.fontset
textomatematico.it
textomatematico.rm
textomatematico.sf
textomatematico.tt
patch.antialiased
parche.bordecolor
parche.facecolor
parche.force_edgecolor
parche.ancho de línea
path.effects
camino.simplificar
ruta.simplificar_umbral
ruta.boceto
ruta.snap
pcolor.shading
pcolormesh.snap
pdf.compresión
pdf.tipo de fuente
pdf. heredar color
pdf.use14corefonts
pgf.preámbulo
pgf.rcfonts
pgf.texsystem
polaraxes.grid
ps.distiller.res
ps.fonttype
ps.papersize
ps.useafm
ps.usedistiller
guardarfig.bbox
savefig.directorio
guardarfig.dpi
savefig.edgecolor
savefig.facecolor
savefig.formato
savefig.orientación
savefig.pad_pulgadas
savefig.transparente
scatter.edgecolors
marcador.de.dispersión
svg.tipo de fuente
svg.hashsalt
svg.imagen_en línea
texto.antialiased
color de texto
text.hinting
text.hinting_factor
texto.kerning_factor
texto.latex.preámbulo
texto.parse_math
texto.usetex
zona horaria
tk.window_focus
barra de herramientas
dirección.webagg
webagg.open_in_browser
webagg.puerto
webagg.port_retries
xaxis.labelubicación
xtick.alineación
xtick.bottom
xtick.color
xtick.direction
xtick.labelbottom
xtick.labelcolor
xtick.labelsize
xtick.labeltop
xtick.major.bottom
xtick.major.pad
xtick.mayor.tamaño
xtick.major.top
xtick.principal.ancho
xtick.minor.bottom
xtick.menor.pad
xtick.tamaño menor
xtick.minor.top
xtick.menor.visible
xtick.menor.ancho
xtick.top
yaxis.labelubicación
ytick.alineación
ytick.color
ytick.direction
ytick.labelcolor
ytick.labelleft
ytick.labelright
ytick.labelsize
ytick.izquierda
ytick.principal.izquierda
ytick.major.pad
ytick.major.right
ytick.mayor.tamaño
ytick.principal.ancho
ytick.menor.left
ytick.menor.pad
ytick.menor.right
ytick.menor.size
ytick.menor.visible
ytick.menor.ancho
ytick.derecho

Ver también

El archivo matplotlibrc

find_all ( patrón ) [fuente] #: Devuelve el subconjunto de este diccionario RcParams cuyas claves coinciden, usando re.search(), el dado pattern.

Nota

Los cambios en el diccionario devuelto no se propagan al diccionario principal RcParams.

copiar ( ) [fuente] #: Copie esta instancia de RcParams.

matplotlib. rc_context ( rc = Ninguno , fname = Ninguno ) [fuente] #

Devuelve un administrador de contexto para cambiar temporalmente rcParams.

El rcParams["backend"]administrador de contexto no los restablecerá.

Parámetros :

dictado rc: Los rcParams para establecer temporalmente.
fname str o similar a una ruta: Un archivo con la configuración rc de Matplotlib. Si se proporcionan tanto fname como rc , la configuración de rc tiene prioridad.

Ver también

El archivo matplotlibrc

Ejemplos

Pasar valores explícitos a través de un dictado:

with mpl.rc_context({'interactive': False}):
    fig, ax = plt.subplots()
    ax.plot(range(3), range(3))
    fig.savefig('example.png')
    plt.close(fig)

Cargar configuraciones desde un archivo:

with mpl.rc_context(fname='print.rc'):
    plt.plot(x, y)  # uses 'print.rc'

matplotlib. rc ( grupo , ** kwargs ) [fuente] #

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('lines', linewidth=2, color='r')

establece la corriente rcParamsy es equivalente a:

rcParams['lines.linewidth'] = 2
rcParams['lines.color'] = 'r'

Los siguientes alias están disponibles para guardar la escritura para usuarios interactivos:

Alias	Propiedad
'lw'	'ancho de línea'
'ls'	'estilo de línea'
'C'	'color'
'fc'	'color de cara'
'CE'	'color del borde'
'maullar'	'ancho del borde del marcador'
'Automóvil club británico'	'antialiasing'

Por lo tanto, podría abreviar la llamada anterior como:

rc('lines', lw=2, c='r')

Tenga en cuenta que puede usar la función de diccionario kwargs de python para almacenar diccionarios de parámetros predeterminados. por ejemplo, puede personalizar la fuente rc de la siguiente manera:

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}
rc('font', **font)  # pass in the font dict as kwargs

Esto le permite cambiar fácilmente entre varias configuraciones. Use matplotlib.style.use('default')o rcdefaults()para restaurar el valor predeterminado rcParamsdespués de los cambios.

notas

Una funcionalidad similar está disponible mediante el uso de la interfaz de dictado normal, es decir (pero no admite abreviaturas ni agrupaciones).rcParams.update({"lines.linewidth": 2, ...})rcParams.update

matplotlib. rcdefaults ( ) [fuente] #

Restaure el rcParamsestilo predeterminado interno de Matplotlib.

Los estilos incluidos en la lista negra rcParams(definidos en matplotlib.style.core.STYLE_BLACKLIST) no se actualizan.

Ver también

matplotlib.rc_file_defaults: Restaure rcParamsdesde el archivo rc cargado originalmente por Matplotlib.
matplotlib.style.use: Utilice un archivo de estilo específico. Llame style.use('default')para restaurar el estilo predeterminado.

matplotlib. rc_file_defaults ( ) [fuente] #

Restaure el rcParamsarchivo rc original cargado por Matplotlib.

Los estilos incluidos en la lista negra rcParams(definidos en matplotlib.style.core.STYLE_BLACKLIST) no se actualizan.

matplotlib. rc_file ( fname , * , use_default_template = True ) [fuente] #

Actualizar rcParamsdesde archivo.

Los estilos incluidos en la lista negra rcParams(definidos en matplotlib.style.core.STYLE_BLACKLIST) no se actualizan.

Parámetros :

fname str o similar a una ruta: Un archivo con la configuración rc de Matplotlib.
use_default_template booleano: Si es Verdadero, inicialice con los parámetros predeterminados antes de actualizar con los del archivo dado. Si es False, la configuración actual persiste y solo se actualizan los parámetros especificados en el archivo.

matplotlib. rc_params ( fail_on_error = Falso ) [fuente] #: Construya una RcParamsinstancia a partir del archivo rc predeterminado de Matplotlib.

matplotlib. rc_params_from_file ( fname , fail_on_error = False , use_default_template = True ) [fuente] #

Construya a RcParamspartir del archivo fname .

Parámetros :

fname str o similar a una ruta: Un archivo con la configuración rc de Matplotlib.
error_en_error bool: Si es True, genera un error cuando el analizador no puede convertir un parámetro.
use_default_template booleano: Si es Verdadero, inicialice con los parámetros predeterminados antes de actualizar con los del archivo dado. Si es False, la clase de configuración solo contiene los parámetros especificados en el archivo. (Útil para actualizar dictados).

matplotlib. get_configdir ( ) [fuente] #

Devuelve la ruta de la cadena del directorio de configuración.

El directorio se elige de la siguiente manera:

Si se proporciona la variable de entorno MPLCONFIGDIR, selecciónela.
En Linux, siga la especificación XDG y busque primero en $XDG_CONFIG_HOME, si está definido, o $HOME/.config. En otras plataformas, elige $HOME/.matplotlib.
Si el directorio elegido existe y se puede escribir, utilícelo como directorio de configuración.
De lo contrario, cree un directorio temporal y utilícelo como directorio de configuración.

matplotlib. matplotlib_fname ( ) [fuente] #

Obtenga la ubicación del archivo de configuración.

La ubicación del archivo se determina en el siguiente orden

$PWD/matplotlibrc
$MATPLOTLIBRCsi no es un directorio
$MATPLOTLIBRC/matplotlibrc
$MPLCONFIGDIR/matplotlibrc
en linux,
- $XDG_CONFIG_HOME/matplotlib/matplotlibrc(si $XDG_CONFIG_HOME está definido)
- o $HOME/.config/matplotlib/matplotlibrc(si $XDG_CONFIG_HOME no está definido)
En otras plataformas, - $HOME/.matplotlib/matplotlibrcsi $HOMEestá definido
Por último, busca en $MATPLOTLIBDATA/matplotlibrc, que siempre debería existir.

matplotlib. get_data_path ( ) [fuente] #: Devuelve la ruta a los datos de Matplotlib.

Registro #

matplotlib. set_loglevel ( nivel ) [fuente] #

Establezca el registrador raíz de Matplotlib y el nivel del controlador del registrador raíz, creando el controlador si aún no existe.

Por lo general, uno debe llamar set_loglevel("info")o set_loglevel("debug")para obtener información adicional de depuración.

Parámetros :

nivel {"notset", "debug", "info", "advertencia", "error", "crítico"}: El nivel de registro del controlador.

notas

La primera vez que se llama a esta función, se adjunta un controlador adicional al controlador raíz de Matplotlib; este controlador se reutiliza cada vez y esta función simplemente manipula el registrador y el nivel del controlador.

Mapas de colores y secuencias de colores #

matplotlib. mapas de color [fuente] #

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)

matplotlib. color_secuencias [fuente] #

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'])

Varios #

clase matplotlib. MatplotlibDeprecationWarning [fuente] #: Una clase para emitir advertencias de obsolescencia para los usuarios de Matplotlib.

matplotlib. get_cachedir ( ) [fuente] #

Devuelve la ruta de cadena del directorio de caché.

El procedimiento usado para encontrar el directorio es el mismo que para _get_config_dir, excepto que se usa $XDG_CACHE_HOME/ $HOME/.cacheen su lugar.

matplotlib#

Gestión de back -end #

Valores predeterminados y estilo #

Registro #

Mapas de colores y secuencias de colores #

Varios #

`matplotlib`#