`matplotlib`#

Una libreria di plottaggio orientata agli oggetti.

Un'interfaccia procedurale è fornita dal modulo companion pyplot, che può essere importato direttamente, ad esempio:

import matplotlib.pyplot as plt

o usando ipython:

ipython

al tuo terminale, seguito da:

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

al prompt della shell ipython.

Per la maggior parte, l'uso diretto della libreria esplicita orientata agli oggetti è incoraggiato durante la programmazione; l'interfaccia pyplot implicita è principalmente per lavorare in modo interattivo. Le eccezioni a questo suggerimento sono le funzioni pyplot pyplot.figure, pyplot.subplot, pyplot.subplotse pyplot.savefig, che possono semplificare notevolmente lo scripting. Vedere Matplotlib Application Interfaces (API) per una spiegazione dei compromessi tra le interfacce implicite ed esplicite.

I moduli includono:

matplotlib.axes
La Axesclasse. La maggior parte delle funzioni pyplot sono wrapper per Axesmetodi. Il modulo assi è il più alto livello di accesso OO alla libreria.

matplotlib.figure
La Figureclasse.

matplotlib.artist
La Artistclasse base per tutte le classi che disegnano cose.

matplotlib.lines
La Line2Dclasse per disegnare linee e marcatori.

matplotlib.patches
Classi per disegnare poligoni.

matplotlib.text
Le classi Texte .Annotation

matplotlib.image
Le classi AxesImagee .FigureImage

matplotlib.collections
Classi per il disegno efficiente di gruppi di linee o poligoni.

matplotlib.colors
Specifiche dei colori e creazione di mappe dei colori.

matplotlib.cm
Colormaps e la ScalarMappableclasse mixin per fornire funzionalità di mappatura dei colori ad altre classi.

matplotlib.ticker
Calcolo delle posizioni dei segni di graduazione e formattazione delle etichette di graduazione.

matplotlib.backends
Un sottopacchetto con moduli per varie librerie GUI e formati di output.

Lo spazio dei nomi matplotlib di base include:

rcParams
Impostazioni di configurazione predefinite; i loro valori predefiniti possono essere sovrascritti utilizzando un matplotlibrcfile.

use
Impostazione del backend Matplotlib. Questo dovrebbe essere chiamato prima che venga creata qualsiasi figura, perché non è possibile passare da un backend GUI diverso dopo l'altro.

Matplotlib è stato inizialmente scritto da John D. Hunter (1968-2012) ed è ora sviluppato e gestito da una miriade di altri.

Occasionalmente la documentazione interna (python docstrings) farà riferimento a MATLAB®, un marchio registrato di The MathWorks, Inc.

Gestione back-end #

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

Seleziona il backend utilizzato per il rendering e l'integrazione della GUI.

Parametri :

back-end str

Il backend a cui passare. Questo può essere uno dei nomi di backend standard, che non fanno distinzione tra maiuscole e minuscole:

backend interattivi: GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo, MacOSX, nbAgg, QtAgg, QtCairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo, Qt5Agg, Qt5Cairo
backend non interattivi: agg, cairo, pdf, pgf, ps, svg, template

o una stringa della forma: module://my.module.name.

Il passaggio a un backend interattivo non è possibile se è già stato avviato un ciclo di eventi non correlato (ad esempio, il passaggio a GTK3Agg se è già stata aperta una finestra TkAgg). Il passaggio a un backend non interattivo è sempre possibile.

forza bool, predefinito: vero

Se True (impostazione predefinita), solleva un ImportErrorse il back-end non può essere configurato (o perché non riesce a importare o perché è già in esecuzione un framework interattivo GUI incompatibile); se Falso, ignora silenziosamente l'errore.

Guarda anche

Backend
matplotlib.get_backend

matplotlib. get_backend ( ) [fonte] #

Restituisce il nome del backend corrente.

Guarda anche

matplotlib.use

matplotlib. interattivo ( b ) [fonte] #: Imposta se ridisegnare dopo ogni comando di plottaggio (es pyplot.xlabel. ).

matplotlib. è_interattivo ( ) [fonte] #: Restituisce se ridisegnare dopo ogni comando di plottaggio.

Nota

Questa funzione è destinata esclusivamente all'uso nei backend. Gli utenti finali dovrebbero utilizzare pyplot.isinteractiveinvece.

Valori predefiniti e stile #

matplotlib. rcParams [fonte] #: Un'istanza di RcParamsper la gestione dei valori Matplotlib predefiniti.

classe matplotlib. RcParams ( * args , ** kwargs ) [fonte] #

Un oggetto dizionario che include la convalida.

Le funzioni di convalida sono definite e associate ai parametri rc in matplotlib.rcsetup.

L'elenco di rcParams è:

_internal.classic_mode
agg.path.chunksize
animazione.bitrate
animation.codec
animation.convert_args
animation.convert_path
animation.embed_limit
animation.ffmpeg_args
animation.ffmpeg_path
animation.frame_format
animation.html
animation.writer
axis.autolimit_mode
assi.assesotto
axis.edgecolor
assi.facecolor
assi.formatter.limiti
axis.formatter.min_exponent
axis.formatter.offset_threshold
axis.formatter.use_locale
axis.formatter.use_mathtext
axis.formatter.useoffset
assi.griglia
assi.griglia.asse
assi.griglia.che
axis.labelcolor
assi.labelpad
axis.labelsize
axis.labelweight
assi.larghezzalinea
assi.prop_ciclo
assi.spine.bottom
assi.spine.sinistra
assi.spine.destra
assi.spine.top
assi.titlecolor
axis.titlelocation
assi.titlepad
assi.titlesize
assi.titleweight
assi.titolo
assi.unicode_minus
assi.xmargine
assi.ymargin
assi.zmargin
assi3d.griglia
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.marker
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
boxplot.notch
boxplot.patchartist
boxplot.showbox
boxplot.showcaps
boxplot.showfliers
boxplot.showmeans
boxplot.vertical
boxplot.whiskerprops.color
boxplot.whiskerprops.linestyle
boxplot.whiskerprops.linewidth
boxplot.baffi
algoritmo.di.contorno
contour.corner_mask
contour.linewidth
contour.negative_linestyle
data.autoformattatore.giorno
data.formattatore automatico.ora
data.formattatore automatico.microsecondo
data.formattatore automatico.minuto
data.formattatore automatico.mese
data.formattatore automatico.secondo
data.formattatore.anno
data.converter
data.epoca
data.intervallo_multipli
docstring.hardcopy
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
figure.edgecolor
figure.facecolor
figure.figsize
figure.frameon
figura.labelsize
figure.labelweight
figure.max_open_warning
figure.raise_window
figura.sottotrama.fondo
figura.sottotrama.hspace
figura.sottotrama.a sinistra
figura.sottotrama.destra
figura.sottotrama.in alto
figura.sottotrama.wspace
figura.titolodimensione
figura.titolopeso
font.cursive
famiglia di font
font.fantasy
font.monospace
font.sans serif
font.serif
dimensione del font
font.stretch
stile carattere
font.variant
font.weight
griglia.alfa
griglia.colore
grid.linestyle
grid.linewidth
tratteggio.colore
hatch.linewidth
hist.bins
aspetto.immagine
immagine.cmap
image.composite_image
immagine.interpolazione
immagine.lut
immagine.origine
image.resample
interattivo
keymap.back
keymap.copy
keymap.forward
keymap.schermo intero
keymap.grid
keymap.grid_minor
keymap.help
keymap.home
keymap.pan
keymap.quit
keymap.quit_all
keymap.save
keymap.xscale
keymap.yscale
keymap.zoom
legend.borderaxespad
legend.borderpad
legenda.colonnaspaziatura
legend.edgecolor
legend.facecolor
legend.fancybox
legend.fontsize
legend.framealpha
legend.frameon
legend.handleheight
legenda.handlelength
legend.handletextpad
legend.labelcolor
legend.labelspacing
legenda.loc
legend.markerscale
legend.numpoints
legend.scatterpoints
leggenda.ombra
legend.title_fontsize
lines.antialiased
linee.colore
lines.dash_capstyle
lines.dash_joinstyle
lines.dashdot_pattern
lines.dashed_pattern
lines.doted_pattern
linee.linestyle
linee.larghezzalinea
lines.marker
lines.markeredgecolor
lines.markeredgewidth
lines.markerfacecolor
lines.markersize
lines.scale_dashes
lines.solid_capstyle
lines.solid_joinstyle
markers.fillstyle
mathtext.bf
mathtext.cal
mathtext.predefinito
mathtext.fallback
mathtext.fontset
mathtext.it
mathtext.rm
mathtext.sf
mathtext.tt
patch.antialiased
patch.edgecolor
patch.facecolor
patch.force_edgecolor
patch.linewidth
percorso.effetti
percorso.semplifica
path.simplify_threshold
percorso.schizzo
percorso.snap
pcolor.shading
pcolormesh.snap
pdf.compressione
pdf.fonttype
pdf.inheritcolor
pdf.use14corefonts
pgf.preambolo
pgf.rcfonts
pgf.texsystem
polaraxes.grid
ps.distiller.res
ps.fonttype
ps.papersize
ps.useafm
ps.useddistiller
savefig.bbox
savefig.directory
savefig.dpi
savefig.edgecolor
savefig.facecolor
savefig.format
savefig.orientamento
savefig.pad_inches
savefig.transparent
scatter.edgecolors
scatter.marker
svg.fonttype
svg.hashsalt
svg.image_inline
text.antialiased
colore del testo
text.hinting
text.hinting_factor
text.kerning_factor
testo.latex.preambolo
text.parse_math
testo.usetex
fuso orario
tk.window_focus
barra degli strumenti
webagg.indirizzo
webagg.open_in_browser
webagg.port
webagg.port_retries
xaxis.etichettalocation
xtick.alignment
xtick.bottom
xtick.color
xtick.direction
xtick.labelbottom
xtick.labelcolor
xtick.labelsize
xtick.labeltop
xtick.major.bottom
xtick.major.pad
xtick.maggiore.dimensione
xtick.major.top
xtick.major.width
xtick.minor.bottom
xtick.minor.pad
xtick.minor.size
xtick.minor.top
xtick.minor.visibile
xtick.minor.width
xtick.top
yaxis.etichettalocation
ytick.alignment
ytick.color
ytick.direzione
ytick.labelcolor
ytick.labelleft
ytick.labelright
ytick.labelsize
ytick.left
ytick.major.left
ytick.major.pad
ytick.major.right
ytick.dimensione.maggiore
ytick.larghezza.maggiore
ytick.minore.sinistra
ytick.minor.pad
ytick.minore.destra
ytick.dimensione.minore
ytick.minore.visibile
ytick.minore.larghezza
ytick.giusto

Guarda anche

Il file matplotlibrc

trova_tutto ( modello ) [fonte] #: Restituisce il sottoinsieme di questo dizionario RcParams le cui chiavi corrispondono, utilizzando re.search(), al dato pattern.

Nota

Le modifiche al dizionario restituito non vengono propagate al dizionario padre RcParams.

copia ( ) [fonte] #: Copia questa istanza di RcParams.

matplotlib. rc_context ( rc = Nessuno , fname = Nessuno ) [fonte] #

Restituisce un gestore di contesto per modificare temporaneamente rcParams.

rcParams["backend"]non verrà reimpostato dal gestore di contesto .

Parametri :

rc dict: Gli rcParams da impostare temporaneamente.
fname str o simile a un percorso: Un file con le impostazioni di Matplotlib rc. Se vengono forniti sia fname che rc , le impostazioni di rc hanno la precedenza.

Guarda anche

Il file matplotlibrc

Esempi

Passaggio di valori espliciti tramite un dict:

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

Caricamento delle impostazioni da un file:

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

matplotlib. rc ( gruppo , ** kwargs ) [fonte] #

Imposta la corrente rcParams. gruppo è il raggruppamento per rc, ad esempio, per lines.linewidthil gruppo è lines, per axes.facecolor, il gruppo è axese così via. Il gruppo può anche essere un elenco o una tupla di nomi di gruppi, ad esempio ( xtick , ytick ). kwargs è una coppia nome/valore dell'attributo del dizionario, ad esempio:

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

imposta la corrente rcParamsed è equivalente a:

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

I seguenti alias sono disponibili per salvare la digitazione per gli utenti interattivi:

Alias	Proprietà
'lu'	'larghezza della linea'
'io'	'stile di linea'
'c'	'colore'
'fc'	'colore del viso'
'ec'	'bordo colore'
'miagolare'	'markeredgewidth'
'aa'	'antialiasing'

Quindi potresti abbreviare la chiamata sopra come:

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

Nota che puoi usare la funzione del dizionario kwargs di Python per memorizzare i dizionari dei parametri predefiniti. ad esempio, puoi personalizzare il carattere rc come segue:

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

Ciò consente di passare facilmente da una configurazione all'altra. Utilizzare matplotlib.style.use('default')o rcdefaults()per ripristinare l'impostazione predefinita rcParamsdopo le modifiche.

Appunti

Una funzionalità simile è disponibile utilizzando la normale interfaccia dict, cioè (ma non supporta abbreviazioni o raggruppamenti).rcParams.update({"lines.linewidth": 2, ...})rcParams.update

matplotlib. rcdefaults ( ) [fonte] #

Ripristina rcParamsdallo stile predefinito interno di Matplotlib.

Gli stili inseriti nella blacklist rcParams(definiti in matplotlib.style.core.STYLE_BLACKLIST) non vengono aggiornati.

Guarda anche

matplotlib.rc_file_defaults: Ripristina rcParamsdal file rc originariamente caricato da Matplotlib.
matplotlib.style.use: Usa un file di stile specifico. Chiama style.use('default')per ripristinare lo stile predefinito.

matplotlib. rc_file_defaults ( ) [fonte] #

Ripristina rcParamsdal file rc originale caricato da Matplotlib.

Gli stili inseriti nella blacklist rcParams(definiti in matplotlib.style.core.STYLE_BLACKLIST) non vengono aggiornati.

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

Aggiorna rcParamsda file.

Gli stili inseriti nella blacklist rcParams(definiti in matplotlib.style.core.STYLE_BLACKLIST) non vengono aggiornati.

Parametri :

fname str o simile a un percorso: Un file con le impostazioni di Matplotlib rc.
use_default_template bool: Se True, inizializza con i parametri predefiniti prima dell'aggiornamento con quelli nel file specificato. Se False, la configurazione corrente persiste e vengono aggiornati solo i parametri specificati nel file.

matplotlib. rc_params ( fail_on_error = False ) [fonte] #: Costruisci RcParamsun'istanza dal file Matplotlib rc predefinito.

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

Costruisci un RcParamsfile da fname .

Parametri :

fname str o simile a un percorso: Un file con le impostazioni di Matplotlib rc.
fail_on_error bool: Se True, genera un errore quando il parser non riesce a convertire un parametro.
use_default_template bool: Se True, inizializza con i parametri predefiniti prima dell'aggiornamento con quelli nel file specificato. Se False, la classe di configurazione contiene solo i parametri specificati nel file. (Utile per aggiornare i dict.)

matplotlib. get_configdir ( ) [fonte] #

Restituisce il percorso della stringa della directory di configurazione.

La directory viene scelta come segue:

Se viene fornita la variabile di ambiente MPLCONFIGDIR, sceglila.
Su Linux, segui la specifica XDG e cerca prima in $XDG_CONFIG_HOME, se definito, o $HOME/.config. Su altre piattaforme, scegli $HOME/.matplotlib.
Se la directory scelta esiste ed è scrivibile, utilizzala come directory di configurazione.
Altrimenti, crea una directory temporanea e usala come directory di configurazione.

matplotlib. matplotlib_fname ( ) [fonte] #

Ottieni la posizione del file di configurazione.

La posizione del file è determinata nel seguente ordine

$PWD/matplotlibrc
$MATPLOTLIBRCse non è una directory
$MATPLOTLIBRC/matplotlibrc
$MPLCONFIGDIR/matplotlibrc
Su Linux,
- $XDG_CONFIG_HOME/matplotlib/matplotlibrc(se $XDG_CONFIG_HOME è definito)
- o $HOME/.config/matplotlib/matplotlibrc(se $XDG_CONFIG_HOME non è definito)
Su altre piattaforme, - $HOME/.matplotlib/matplotlibrcse $HOMEè definito
Infine, cerca in $MATPLOTLIBDATA/matplotlibrc, che dovrebbe sempre esistere.

matplotlib. get_data_path ( ) [fonte] #: Restituisce il percorso ai dati Matplotlib.

Registrazione n.

matplotlib. set_loglevel ( livello ) [fonte] #

Imposta il root logger di Matplotlib e il livello del gestore del root logger, creando il gestore se non esiste ancora.

In genere, si dovrebbe chiamare set_loglevel("info")o set_loglevel("debug")per ottenere ulteriori informazioni di debug.

Parametri :

livello {"notset", "debug", "info", "warning", "error", "critical"}: Il livello di log del gestore.

Appunti

La prima volta che questa funzione viene chiamata, un gestore aggiuntivo viene collegato al gestore root di Matplotlib; questo gestore viene riutilizzato ogni volta e questa funzione manipola semplicemente il livello del logger e del gestore.

Mappe dei colori e sequenze di colori #

matplotlib. mappe dei colori [fonte] #

Contenitore per mappe di colori note a Matplotlib per nome.

Sperimentale

Mentre prevediamo che l'API sia definitiva, la contrassegniamo formalmente come sperimentale per 3.5 perché vogliamo mantenere l'opzione per adattare ancora l'API per 3.6 in caso di necessità.

L'istanza del registro universale è matplotlib.colormaps. Non dovrebbe essere necessario che gli utenti istanzino ColormapRegistryse stessi.

L'accesso in lettura utilizza un'interfaccia simile a un dict che mappa i nomi in Colormaps:

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

I messaggi restituiti Colormapsono copie, in modo che la loro modifica non cambi la definizione globale della mappa dei colori.

Ulteriori colormap possono essere aggiunte tramite ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

matplotlib. color_sequences [fonte] #

Contenitore per sequenze di colori note a Matplotlib per nome.

L'istanza del registro universale è matplotlib.color_sequences. Non dovrebbe essere necessario che gli utenti istanzino ColorSequenceRegistry se stessi.

L'accesso in lettura utilizza un'interfaccia simile a un dict che associa i nomi agli elenchi di colori:

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

Gli elenchi restituiti sono copie, in modo che la loro modifica non modifichi la definizione globale della sequenza di colori.

Ulteriori sequenze di colori possono essere aggiunte tramite ColorSequenceRegistry.register:

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

Varie #

classe matplotlib. MatplotlibDeprecationWarning [fonte] #: Una classe per l'emissione di avvisi di deprecazione per gli utenti di Matplotlib.

matplotlib. get_cachedir ( ) [fonte] #

Restituisce il percorso della stringa della directory della cache.

La procedura utilizzata per trovare la directory è la stessa di _get_config_dir, ad eccezione dell'utilizzo di $XDG_CACHE_HOME/ $HOME/.cacheinvece.

matplotlib#

Gestione back-end #

Valori predefiniti e stile #

Registrazione n.

Mappe dei colori e sequenze di colori #

Varie #

`matplotlib`#