Gestión de backend

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

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

Parámetros:
backendstr

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

  • backends interactivos: GTK3Agg, GTK3Cairo, MacOSX, nbAgg, Qt4Agg, Qt4Cairo, Qt5Agg, Qt5Cairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo
  • backends no interactivos: agg, cairo, pdf, pgf, ps, svg, template

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

forcebool, default: True

Si es Verdadero (el valor predeterminado), genere un ImportError si 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 falso, ignore el error.

Ver también

Backends
matplotlib.get_backend
matplotlib.get_backend()[source]

Devuelve el nombre del backend actual.

Ver también

matplotlib.use
matplotlib.interactive(b)[source]

Establezca si volver a dibujar después de cada comando de trazado (p. Ej. pyplot.xlabel).

matplotlib.is_interactive()[source]

Devuelve si volver a dibujar después de cada comando de trazado.

Estilo y valores predeterminados

matplotlib.rcParams

Una instancia de RcParams para manejar los valores predeterminados de Matplotlib.

class matplotlib.RcParams(*args, **kwargs)[source]

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:

  • backend
  • backend_fallback
  • barra de herramientas
  • interactivo
  • zona horaria
  • webagg.port
  • webagg.address
  • webagg.open_in_browser
  • webagg.port_retries
  • lines.linewidth
  • lines.linestyle
  • lineas color
  • lines.marker
  • lines.markerfacecolor
  • lines.markeredgecolor
  • lines.markeredgewidth
  • lines.markersize
  • lines.antialiased
  • lines.dash_joinstyle
  • lines.solid_joinstyle
  • lines.dash_capstyle
  • lines.solid_capstyle
  • lines.dashed_pattern
  • lines.dashdot_pattern
  • lines.dotted_pattern
  • lines.scale_dashes
  • marcadores.fillstyle
  • pcolor.shading
  • pcolormesh.snap
  • patch.linewidth
  • patch.edgecolor
  • patch.force_edgecolor
  • patch.facecolor
  • patch.antialiased
  • hatch.color
  • hatch.linewidth
  • hist.bins
  • boxplot.notch
  • boxplot.vertical
  • boxplot bigotes
  • boxplot.bootstrap
  • boxplot.patchartist
  • boxplot.show significa
  • boxplot.showcaps
  • boxplot.showbox
  • boxplot.showfliers
  • boxplot.meanline
  • boxplot.flierprops.color
  • boxplot.flierprops.marker
  • boxplot.flierprops.markerfacecolor
  • boxplot.flierprops.markeredgecolor
  • boxplot.flierprops.markeredgewidth
  • boxplot.flierprops.markersize
  • boxplot.flierprops.linestyle
  • boxplot.flierprops.linewidth
  • boxplot.boxprops.color
  • boxplot.boxprops.linewidth
  • boxplot.boxprops.linestyle
  • boxplot.whiskerprops.color
  • boxplot.whiskerprops.linewidth
  • boxplot.whiskerprops.linestyle
  • boxplot.capprops.color
  • boxplot.capprops.linewidth
  • boxplot.capprops.linestyle
  • boxplot.medianprops.color
  • boxplot.medianprops.linewidth
  • boxplot.medianprops.linestyle
  • boxplot.meanprops.color
  • boxplot.meanprops.marker
  • boxplot.meanprops.markerfacecolor
  • boxplot.meanprops.markeredgecolor
  • boxplot.meanprops.markersize
  • boxplot.meanprops.linestyle
  • boxplot.meanprops.linewidth
  • Familia tipográfica
  • Estilo de fuente
  • font.variant
  • font.stretch
  • font.weight
  • tamaño de fuente
  • font.serif
  • font.sans-serif
  • font.cursive
  • font.fantasy
  • font.monospace
  • color de texto
  • text.usetex
  • text.latex.preamble
  • text.latex.preview
  • insinuación de texto
  • text.hinting_factor
  • text.kerning_factor
  • text.antialiased
  • mathtext.cal
  • mathtext.rm
  • mathtext.tt
  • mathtext.it
  • mathtext.bf
  • mathtext.sf
  • mathtext.fontset
  • mathtext.default
  • mathtext.fallback_to_cm
  • mathtext.fallback
  • imagen.aspecto
  • imagen.interpolación
  • image.cmap
  • image.lut
  • image.origin
  • image.resample
  • image.composite_image
  • contour.negative_linestyle
  • contour.corner_mask
  • contour.linewidth
  • errorbar.capsize
  • xaxis.labellocation
  • yaxis.labellocation
  • axes.axisbelow
  • axes.facecolor
  • axes.edgecolor
  • axes.linewidth
  • axes.spines.left
  • axes.spines.right
  • axes.spines.bottom
  • axes.spines.top
  • axes.titlesize
  • axes.titlelocation
  • axes.titleweight
  • axes.titlecolor
  • axes.titley
  • axes.titlepad
  • axes.grid
  • axes.grid. que
  • axes.grid.axis
  • axes.labelsize
  • axes.labelpad
  • axes.labelweight
  • axes.labelcolor
  • axes.formatter.limits
  • axes.formatter.use_locale
  • axes.formatter.use_mathtext
  • axes.formatter.min_exponent
  • axes.formatter.useoffset
  • axes.formatter.offset_threshold
  • axes.unicode_minus
  • axes.prop_cycle
  • axes.autolimit_mode
  • axes.xmargin
  • axes.ymargin
  • axes.zmargin
  • polaraxes.grid
  • axes3d.grid
  • scatter.marker
  • scatter.edgecolors
  • date.epoch
  • date.autoformatter.year
  • date.autoformatter.month
  • date.autoformatter.day
  • date.autoformatter.hour
  • date.autoformatter.minute
  • date.autoformatter.second
  • date.autoformatter.microsecond
  • date.converter
  • date.interval_multiples
  • legend.fancybox
  • legend.loc
  • legend.numpoints
  • legend.scatterpoints
  • legend.fontsize
  • legend.title_fontsize
  • legend.markerscale
  • leyenda.sombra
  • Legend.frameon
  • legend.framealpha
  • Legend.borderpad
  • legend.labelspacing
  • legend.handlength
  • Legend.handleheight
  • legend.handletextpad
  • legend.borderaxespad
  • leyenda.columnspacing
  • legend.facecolor
  • legend.edgecolor
  • xtick.top
  • xtick.bottom
  • xtick.labeltop
  • xtick.labelbottom
  • xtick.major.size
  • xtick.minor.size
  • xtick.major.width
  • xtick.minor.width
  • xtick.major.pad
  • xtick.minor.pad
  • xtick.color
  • xtick.labelcolor
  • xtick.minor.visible
  • xtick.minor.top
  • xtick.minor.bottom
  • xtick.major.top
  • xtick.major.bottom
  • xtick.labelsize
  • xtick.direction
  • xtick.alignment
  • ytick.left
  • ytick.right
  • ytick.labelleft
  • ytick.labelright
  • ytick.major.size
  • ytick.minor.size
  • ytick.major.width
  • ytick.minor.width
  • ytick.major.pad
  • ytick.minor.pad
  • ytick.color
  • ytick.labelcolor
  • ytick.minor.visible
  • ytick.minor.left
  • ytick.minor.right
  • ytick.major.left
  • ytick.major.right
  • ytick.labelsize
  • ytick.direction
  • ytick.alignment
  • grid.color
  • grid.linestyle
  • grid.linewidth
  • grid.alpha
  • figure.titlesize
  • figure.titleweight
  • figure.figsize
  • figure.dpi
  • figure.facecolor
  • figure.edgecolor
  • figura.marco
  • figure.autolayout
  • figure.max_open_warning
  • figure.raise_window
  • figure.subplot.left
  • figure.subplot.right
  • figure.subplot.bottom
  • figure.subplot.top
  • figure.subplot.wspace
  • figure.subplot.hspace
  • figure.constrained_layout.use
  • figure.constrained_layout.hspace
  • figure.constrained_layout.wspace
  • figure.constrained_layout.h_pad
  • figure.constrained_layout.w_pad
  • savefig.dpi
  • savefig.facecolor
  • savefig.edgecolor
  • savefig.orientation
  • savefig.jpeg_quality
  • savefig.format
  • savefig.bbox
  • savefig.pad_inches
  • savefig.directory
  • savefig.transparent
  • tk.window_focus
  • ps.papersize
  • ps.useafm
  • ps.usedistiller
  • ps.distiller.res
  • ps.fonttype
  • pdf.compresión
  • pdf.inheritcolor
  • pdf.use14corefonts
  • pdf.fonttype
  • pgf.texsystem
  • pgf.rcfonts
  • pgf. preámbulo
  • svg.image_inline
  • svg.fonttype
  • svg.hashsalt
  • docstring.hardcopy
  • path.simplify
  • path.simplify_threshold
  • path.snap
  • path.sketch
  • path.effects
  • agg.path.chunksize
  • keymap.fullscreen
  • keymap.home
  • keymap.back
  • keymap.forward
  • keymap.pan
  • keymap.zoom
  • keymap.save
  • keymap.quit
  • keymap.quit_all
  • keymap.grid
  • keymap.grid_minor
  • keymap.yscale
  • keymap.xscale
  • keymap.all_axes
  • keymap.help
  • keymap.copy
  • animation.html
  • animation.embed_limit
  • animation.writer
  • animation.codec
  • animation.bitrate
  • animation.frame_format
  • animation.html_args
  • animation.ffmpeg_path
  • animation.ffmpeg_args
  • animation.avconv_path
  • animation.avconv_args
  • animation.convert_path
  • animation.convert_args
  • _internal.classic_mode

Ver también

El archivo matplotlibrc
find_all(self, pattern)[source]

Devuelve el subconjunto de este diccionario RcParams cuyas claves coinciden, usando re.search(), lo dado pattern.

Nota

Los cambios en el diccionario devuelto son no propagado al diccionario principal RcParams.

matplotlib.rc_context(rc=None, fname=None)[source]

Devuelve un administrador de contexto para cambiar temporalmente rcParams.

Parámetros:
rcdict

Los rcParams para establecer temporalmente.

fnamestr or path-like

Un archivo con la configuración rc de Matplotlib. Si ambos fname y rc se dan, configuraciones de rc prevalecerán.

Ver también

El archivo matplotlibrc

Ejemplos de

Pasando 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)

Carga de la configuración de un archivo:

with mpl.rc_context(fname='print.rc'):
    plt.plot(x, y)# uses 'print.rc'
matplotlib.rc(group, **kwargs)[source]

Establecer la corriente rcParams. grupo es la agrupación para el rc, por ejemplo, para lines.linewidth el grupo es lines, por axes.facecolor, el grupo es axes, etcétera. El grupo también puede ser una lista o tupla de nombres de grupos, por ejemplo, (xtick, ytick). kwargs es un atributo de diccionario de pares de nombre / valor, por ejemplo:

rc('lines', linewidth=2, color='r')

establece la corriente rcParams y es equivalente para:

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

Los siguientes alias están disponibles para ahorrar escritura a los usuarios interactivos:

Alias Propiedad
‘lw’ ‘ancho de línea’
‘ls’ ‘estilo de línea’
‘C’ ‘color’
‘fc’ ‘color de la cara’
‘CE’ ‘edgecolor’
‘maullar’ ‘markeredgewidth’
‘Automóvil club británico’ ‘suavizado’

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. Usar matplotlib.style.use('default') o rcdefaults() para restaurar el valor predeterminado rcParams después de los cambios.

Notas

Funcionalidad similar está disponible usando la interfaz de dictado normal, es decir rcParams.update("lines.linewidth": 2, ...) (pero rcParams.update no admite abreviaturas ni agrupaciones).

matplotlib.rcdefaults()[source]

Restaurar el rcParams del estilo predeterminado interno de Matplotlib.

Estilo en la lista negra rcParams (definido en matplotlib.style.core.STYLE_BLACKLIST) no se actualizan.

Ver también

matplotlib.rc_file_defaults
Restaurar el rcParams desde el archivo rc cargado originalmente por Matplotlib.
matplotlib.style.use
Utilice un archivo de estilo específico. Llama style.use('default') para restaurar el estilo predeterminado.
matplotlib.rc_file_defaults()[source]

Restaurar el rcParams desde el archivo rc original cargado por Matplotlib.

Estilo en la lista negra rcParams (definido en matplotlib.style.core.STYLE_BLACKLIST) no se actualizan.

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

Actualizar rcParams desde el archivo.

Estilo en la lista negra rcParams (definido en matplotlib.style.core.STYLE_BLACKLIST) no se actualizan.

Parámetros:
fnamestr or path-like

Un archivo con la configuración rc de Matplotlib.

use_default_templatebool

Si es True, 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=False)[source]

Construye un RcParams instancia del archivo rc de Matplotlib predeterminado.

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

Construye un RcParams desde el archivo fname.

Parámetros:
fnamestr or path-like

Un archivo con la configuración rc de Matplotlib.

fail_on_errorbool

Si es True, genera un error cuando el analizador no puede convertir un parámetro.

use_default_templatebool

Si es True, 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()[source]

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

El directorio se elige de la siguiente manera:

  1. Si se proporciona la variable de entorno MPLCONFIGDIR, elija esa.
  2. En Linux, siga la especificación XDG y busque primero en $XDG_CONFIG_HOME, si está definido, o $HOME/.config. En otras plataformas, elija $HOME/.matplotlib.
  3. Si el directorio elegido existe y se puede escribir, utilícelo como directorio de configuración.
  4. De lo contrario, cree un directorio temporal y utilícelo como directorio de configuración.
matplotlib.matplotlib_fname()[source]

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

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

  • $PWD/matplotlibrc
  • $MATPLOTLIBRC si no es un directorio
  • $MATPLOTLIBRC/matplotlibrc
  • $MPLCONFIGDIR/matplotlibrc
  • En Linux,
    • $XDG_CONFIG_HOME/matplotlib/matplotlibrc (si $XDG_CONFIG_HOME se define)
    • o $HOME/.config/matplotlib/matplotlibrc (si $XDG_CONFIG_HOME no está definido)
  • En otras plataformas, – $HOME/.matplotlib/matplotlibrc si $HOME se define
  • Por último, mira en $MATPLOTLIBDATA/matplotlibrc, que debería existir siempre.
matplotlib.get_data_path()[source]

Devuelve la ruta a los datos de Matplotlib.

Inicio sesión

matplotlib.set_loglevel(level)[source]

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

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

Parámetros:
level"notset", "debug", "info", "warning", "error", "critical"

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.

Diverso

matplotlib.get_cachedir()[source]

Devuelve la ruta de la cadena del directorio de caché.

El procedimiento usado para encontrar el directorio es el mismo que para _get_config_dir, excepto que usa $XDG_CACHE_HOME/$HOME/.cache en lugar de.