`matplotlib.layout_engine`#

Classi per il layout degli elementi in un file Figure.

Le figure hanno una layout_engineproprietà che contiene una sottoclasse di LayoutEnginedefinito qui (o None per nessun layout). Viene chiamato il momento figure.get_layout_engine().execute()dell'estrazione, il cui obiettivo è solitamente quello di riorganizzare gli assi sulla figura per produrre un layout piacevole. Questo è come un drawrichiamo, tuttavia durante la stampa disabilitiamo il motore di layout per il disegno finale ed è utile conoscere il motore di layout durante la creazione della figura, in particolare per gestire le barre dei colori.

Matplotlib fornisce due motori di layout TightLayoutEnginee ConstrainedLayoutEngine. Terze parti possono creare il proprio motore di layout sottoclasse LayoutEngine.

classe matplotlib.layout_engine. ConstrainedLayoutEngine ( * , h_pad = None , w_pad = None , hspace = None , wspace = None , rect = (0, 0, 1, 1) , compress = False , ** kwargs ) [fonte] #

Implementa la constrained_layoutgestione della geometria. Vedere Guida al layout vincolato per i dettagli.

Inizializza constrained_layoutle impostazioni.

Parametri :

h_pad, w_pad float: Imbottitura attorno agli elementi degli assi in unità normalizzate per la figura. Il valore predefinito è rcParams["figure.constrained_layout.h_pad"](predefinito: 0.04167) e rcParams["figure.constrained_layout.w_pad"](predefinito: 0.04167).
hspace, wspace float: Frazione della figura da dedicare allo spazio tra gli assi. Questi sono distribuiti uniformemente tra gli spazi tra gli assi. Un valore di 0,2 per un layout a tre colonne avrebbe uno spazio di 0,1 della larghezza della figura tra ogni colonna. Se h/wspace < h/w_pad, allora vengono usati i pad. Il valore predefinito è rcParams["figure.constrained_layout.hspace"](predefinito: 0.02) e rcParams["figure.constrained_layout.wspace"](predefinito: 0.02).
tupla retta di 4 float: Rettangolo nelle coordinate della figura per eseguire il layout vincolato in (sinistra, in basso, larghezza, altezza), ciascuna da 0-1.
comprimere bool: Se spostare gli assi in modo da rimuovere lo spazio bianco tra di essi. Questo è utile per semplici griglie di Assi ad aspetto fisso (es. una griglia di immagini). Vedere Griglie di assi a proporzioni fisse: layout "compresso" .

proprietà aggiusta_compatibile #: Restituisce un valore booleano se il motore di layout è compatibile con subplots_adjust.

proprietà colorbar_gridspec #: Restituisce un valore booleano se il motore di layout crea barre colore utilizzando una specifica griglia.

esegui ( fig ) [fonte] #

Eseguire constrained_layout e spostare e ridimensionare gli assi di conseguenza.

Parametri :

fig Figuresu cui eseguire il layout.

get ( ) [fonte] #: Copia di ritorno dei parametri per il motore di layout.

set ( * , h_pad = Nessuno , w_pad = Nessuno , hspace = Nessuno , wspace = Nessuno , rect = Nessuno ) [fonte] #

Imposta i pad per constrained_layout.

Parametri :

h_pad, w_pad float: Imbottitura attorno agli elementi degli assi in unità normalizzate per la figura. Il valore predefinito è rcParams["figure.constrained_layout.h_pad"](predefinito: 0.04167) e rcParams["figure.constrained_layout.w_pad"](predefinito: 0.04167).
hspace, wspace float: Frazione della figura da dedicare allo spazio tra gli assi. Questi sono distribuiti uniformemente tra gli spazi tra gli assi. Un valore di 0,2 per un layout a tre colonne avrebbe uno spazio di 0,1 della larghezza della figura tra ogni colonna. Se h/wspace < h/w_pad, allora vengono usati i pad. Il valore predefinito è rcParams["figure.constrained_layout.hspace"](predefinito: 0.02) e rcParams["figure.constrained_layout.wspace"](predefinito: 0.02).
tupla retta di 4 float: Rettangolo nelle coordinate della figura per eseguire il layout vincolato in (sinistra, in basso, larghezza, altezza), ciascuna da 0-1.

classe matplotlib.layout_engine. LayoutEngine ( ** kwargs ) [fonte] #

Classe base per motori di layout Matplotlib.

Un motore di layout può essere passato a una figura all'istanza o in qualsiasi momento con set_layout_engine. Una volta collegata a una figura, la funzione del motore di layout executeviene chiamata al momento dell'estrazione da draw, fornendo uno speciale aggancio per l'estrazione.

Nota

Tuttavia, tieni presente che i motori di layout influenzano la creazione delle barre dei colori, quindi set_layout_enginedovrebbero essere chiamati prima che vengano create le barre dei colori.

Attualmente, ci sono due proprietà delle LayoutEngineclassi che vengono consultate durante la manipolazione della figura:

engine.colorbar_gridspecdice Figure.colorbarse fare il
assi utilizzando il metodo gridspec (vedi colorbar.make_axes_gridspec) o meno (vedi colorbar.make_axes);
engine.adjust_compatiblesmette Figure.subplots_adjustdi essere
eseguire se non è compatibile con il motore di layout.

Per implementare un'abitudine LayoutEngine:

sovrascrivere _adjust_compatiblee_colorbar_gridspec
eseguire l' override LayoutEngine.setper aggiornare self._params
eseguire l' override LayoutEngine.executecon l'implementazione

proprietà aggiusta_compatibile #: Restituisce un valore booleano se il motore di layout è compatibile con subplots_adjust.

proprietà colorbar_gridspec #: Restituisce un valore booleano se il motore di layout crea barre colore utilizzando una specifica griglia.

esegui ( fig ) [fonte] #: Eseguire lo schema sulla figura data dalla fig .

get ( ) [fonte] #: Copia di ritorno dei parametri per il motore di layout.

set ( ** kwargs ) [fonte] #

classe matplotlib.layout_engine. PlaceHolderLayoutEngine ( adjust_compatibili , colorbar_gridspec , ** kwargs ) [fonte] #

Questo motore di layout non regola affatto il layout della figura.

Lo scopo di questo LayoutEngineè quello di fungere da segnaposto quando l'utente rimuove un motore di layout per garantire che un incompatibile LayoutEnginenon possa essere impostato in seguito.

Parametri :

adjust_compatibile, colorbar_gridspec bool: Consenti a PlaceHolderLayoutEngine di rispecchiare il comportamento di qualsiasi motore di layout che sta sostituendo.

proprietà aggiusta_compatibile #: Restituisce un valore booleano se il motore di layout è compatibile con subplots_adjust.

proprietà colorbar_gridspec #: Restituisce un valore booleano se il motore di layout crea barre colore utilizzando una specifica griglia.

esegui ( fig ) [fonte] #: Eseguire lo schema sulla figura data dalla fig .

get ( ) [fonte] #: Copia di ritorno dei parametri per il motore di layout.

set ( ** kwargs ) [fonte] #

classe matplotlib.layout_engine. TightLayoutEngine ( * , pad = 1.08 , h_pad = None , w_pad = None , rect = (0, 0, 1, 1) , ** kwargs ) [fonte] #

Implementa la tight_layoutgestione della geometria. Vedere la guida al layout stretto per i dettagli.

Inizializza il motore tight_layout.

Parametri :

tampone galleggiante, 1.08: Imbottitura tra il bordo della figura e i bordi delle sottotrame, come frazione della dimensione del carattere.
h_pad, w_pad float: Imbottitura (altezza/larghezza) tra bordi di sottotrame adiacenti. L'impostazione predefinita è pad .
tupla rect (sinistra, in basso, a destra, in alto), default: (0, 0, 1, 1).: rettangolo nelle coordinate della figura normalizzata in cui si adatteranno le sottotrame (incluse le etichette).

proprietà aggiusta_compatibile #: Restituisce un valore booleano se il motore di layout è compatibile con subplots_adjust.

proprietà colorbar_gridspec #: Restituisce un valore booleano se il motore di layout crea barre colore utilizzando una specifica griglia.

esegui ( fig ) [fonte] #

Eseguire tight_layout.

Questo decide i parametri della sottotrama dato il riempimento che consentirà alle etichette degli assi di non essere coperte da altre etichette e assi.

Parametri :

fig Figuresu cui eseguire il layout.
Vedi anche: `.figure.Figure.tight_layout` e `.pyplot.tight_layout`.

get ( ) [fonte] #: Copia di ritorno dei parametri per il motore di layout.

set ( * , pad = Nessuno , w_pad = Nessuno , h_pad = Nessuno , rect = Nessuno ) [fonte] #

matplotlib.layout_engine#

`matplotlib.layout_engine`#