Riferimento API n.

Quando si utilizza la libreria, in genere creerai oggetti Figure e Axes e chiamerai i loro metodi per aggiungere contenuto e modificare l'aspetto.

  • matplotlib.figure: creazione di assi, contenuto a livello di figura

  • matplotlib.axes: la maggior parte dei metodi di plottaggio, etichette degli assi, accesso allo stile degli assi, ecc.

Esempio: Creiamo una Figura fige Assi ax. Quindi chiamiamo metodi su di essi per tracciare i dati, aggiungere etichette degli assi e un titolo di figura.

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 4, 0.05)
y = np.sin(x*np.pi)

fig, ax = plt.subplots(figsize=(3,2), constrained_layout=True)
ax.plot(x, y)
ax.set_xlabel('t [s]')
ax.set_ylabel('S [V]')
ax.set_title('Sine wave')
fig.set_facecolor('lightsteelblue')

( Codice sorgente , png )

../_images/index-11.png

Modelli di utilizzo #

Di seguito descriviamo diversi approcci comuni alla stampa con Matplotlib. Vedere Matplotlib Application Interfaces (API) per una spiegazione dei compromessi tra le API utente supportate.

L'API esplicita #

Fondamentalmente, Matplotlib è una libreria orientata agli oggetti. Ti consigliamo di lavorare direttamente con gli oggetti se hai bisogno di maggiore controllo e personalizzazione delle tue trame.

In molti casi creerai uno Figuree uno o più Axesusando pyplot.subplotse da quel momento in poi lavorerai solo su questi oggetti. Tuttavia, è anche possibile creare Figuremessaggi di posta elettronica in modo esplicito (ad esempio quando li si include nelle applicazioni GUI).

Ulteriori letture:

L'API implicita #

matplotlib.pyplotè una raccolta di funzioni che fanno funzionare Matplotlib come MATLAB. Ogni funzione pyplot apporta alcune modifiche a una figura: ad esempio, crea una figura, crea un'area di disegno in una figura, traccia alcune linee in un'area di disegno, decora il disegno con etichette, ecc.

pyplotè principalmente destinato a trame interattive e semplici casi di generazione di trame programmatiche.

Ulteriori letture:

L'API pylab (sconsigliata) #

Avvertimento

Poiché l'importazione pesante nello spazio dei nomi globale può comportare un comportamento imprevisto, l'uso di pylab è fortemente sconsigliato. Usa matplotlib.pyplot invece.

pylabè un modulo che include matplotlib.pyplot, numpy, numpy.fft, numpy.linalg, numpy.randome alcune funzioni aggiuntive, tutte all'interno di un singolo spazio dei nomi. Il suo scopo originale era imitare un modo di lavorare simile a MATLAB importando tutte le funzioni nello spazio dei nomi globale. Questo è considerato di cattivo stile al giorno d'oggi.

Moduli #

Elenco alfabetico dei moduli: