`matplotlib.patheffects`#

Definisce le classi per gli effetti del percorso. Gli effetti del percorso sono supportati in Text, Line2De Patch.

Guarda anche

Guida agli effetti del percorso

classe matplotlib.patheffects. AbstractPathEffect ( offset = (0.0, 0.0) ) [fonte] #

Basi:object

Una classe base per effetti di percorso.

Le sottoclassi dovrebbero sovrascrivere il draw_pathmetodo per aggiungere la funzionalità dell'effetto.

Parametri :

offset (float, float), default: (0, 0): L'offset (x, y) da applicare al percorso, misurato in punti.

draw_path ( renderer , gc , tpath , affine , rgbFace = None ) [fonte] #: Derived dovrebbe eseguire l'override di questo metodo. Gli argomenti sono gli stessi di matplotlib.backend_bases.RendererBase.draw_path() tranne che il primo argomento è un renderer.

classe matplotlib.patheffects. Normale ( offset = (0.0, 0.0) ) [sorgente] #

Basi:AbstractPathEffect

L'"identità" PathEffect.

L'unico scopo di Normal PathEffect è quello di disegnare l'artista originale senza alcun effetto di percorso speciale.

Parametri :

offset (float, float), default: (0, 0): L'offset (x, y) da applicare al percorso, misurato in punti.

classe matplotlib.patheffects. PathEffectRenderer ( path_effects , renderer ) [fonte] #

Basi:RendererBase

Implementa un renderer che contiene un altro renderer.

Questo proxy quindi intercetta le chiamate draw, chiamando il AbstractPathEffectmetodo draw appropriato.

Nota

Non tutti i metodi sono stati sovrascritti in questa sottoclasse RendererBase. Potrebbe essere necessario aggiungere ulteriori metodi per estendere ulteriormente le funzionalità di PathEffects.

Parametri :

path_effects iterabile diAbstractPathEffect: Gli effetti del percorso rappresentati da questo renderer.
sottoclasse del renderermatplotlib.backend_bases.RendererBase

copy_with_path_effect ( path_effects ) [fonte] #

draw_markers ( gc , marker_path , marker_trans , path , * args , ** kwargs ) [fonte] #

Disegna un marcatore su ciascuno dei vertici del percorso (esclusi i punti di controllo).

L'implementazione di base (fallback) effettua più chiamate a draw_path. I backend potrebbero voler sovrascrivere questo metodo per disegnare il marcatore solo una volta e riutilizzarlo più volte.

Parametri :

gcGraphicsContextBase: Il contesto grafico.
marker_transmatplotlib.transforms.Transform: Una trasformazione affine applicata al marcatore.
transmatplotlib.transforms.Transform: Una trasformazione affine applicata al percorso.

draw_path ( gc , tpath , affine , rgbFace = None ) [fonte] #: Disegna Pathun'istanza usando la trasformata affine data.

draw_path_collection ( gc , master_transform , percorsi , * args , ** kwargs ) [fonte] #

Disegna una raccolta di percorsi .

Ogni percorso viene prima trasformato dalla voce corrispondente in all_transforms (un elenco di (3, 3) matrici) e quindi da master_transform . Vengono quindi tradotti dalla voce corrispondente in offsets , che è stata prima trasformata da offset_trans .

facecolors , edgecolors , linewidths , linestyles e antialiased sono elenchi che impostano le proprietà corrispondenti.

offset_position non è attualmente utilizzato, ma l'argomento viene mantenuto per compatibilità con le versioni precedenti.

L'implementazione di base (fallback) effettua più chiamate a draw_path. I backend potrebbero voler eseguire l'override di questo per eseguire il rendering di ogni set di dati di percorso solo una volta e quindi fare riferimento a quel percorso più volte con i diversi offset, colori, stili ecc. I metodi del generatore _iter_collection_raw_pathse _iter_collectionsono forniti per aiutare con (e standardizzare) l'implementazione attraverso i backend. Si consiglia vivamente di utilizzare tali generatori, in modo che le modifiche al comportamento di draw_path_collectionpossano essere apportate a livello globale.

classe matplotlib.patheffects. PathPatchEffect ( offset = (0, 0) , ** kwargs ) [fonte] #

Basi:AbstractPathEffect

Disegna PathPatchun'istanza il cui percorso proviene dall'artista PathEffect originale.

Parametri :

offset (float, float), default: (0, 0): L'offset (x, y) da applicare al percorso, in punti.
**kwargs: Tutti gli argomenti delle parole chiave vengono passati al PathPatchcostruttore. Le proprietà che non possono essere sovrascritte sono "path", "clip_box" "transform" e "clip_path".

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Derived dovrebbe eseguire l'override di questo metodo. Gli argomenti sono gli stessi di matplotlib.backend_bases.RendererBase.draw_path() tranne che il primo argomento è un renderer.

classe matplotlib.patheffects. SimpleLineShadow ( offset = (2, -2) , shadow_color = 'k' , alpha = 0.3 , rho = 0.3 , ** kwargs ) [fonte] #

Basi:AbstractPathEffect

Una semplice ombra tramite una linea.

Parametri :

offset (float, float), default: (2, -2): L'offset (x, y) da applicare al percorso, in punti.
shadow_color colore, predefinito: 'nero': Il colore dell'ombra. Un valore di Noneprende il colore dell'artista originale con un fattore di scala di rho .
alfa float, predefinito: 0.3: La trasparenza alfa della macchia d'ombra creata.
rho float, predefinito: 0.3: Un fattore di scala da applicare al colore rgbFace se shadow_color è None.
**kwargs: Le parole chiave extra vengono memorizzate e passate a AbstractPathEffect._update_gc().

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Sostituisce lo standard draw_path per aggiungere l'offset dell'ombra e le modifiche di colore necessarie per l'ombra.

classe matplotlib.patheffects. SimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs ) [fonte] #

Basi:AbstractPathEffect

Una semplice ombra tramite una patch piena.

Parametri :

offset (float, float), default: (2, -2): L'offset (x, y) dell'ombra in punti.
shadow_rgbColore faccia: Il colore dell'ombra.
alfa float, predefinito: 0.3: La trasparenza alfa della macchia d'ombra creata.
rho float, predefinito: 0.3: Un fattore di scala da applicare al colore rgbFace se shadow_rgbFace non è specificato.
**kwargs: Le parole chiave extra vengono memorizzate e passate a AbstractPathEffect._update_gc().

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Sostituisce lo standard draw_path per aggiungere l'offset dell'ombra e le modifiche di colore necessarie per l'ombra.

classe matplotlib.patheffects. Stroke ( offset = (0, 0) , ** kwargs ) [fonte] #

Basi:AbstractPathEffect

Un PathEffect basato sulla linea che ridisegna un tratto.

Il percorso verrà tracciato con il suo gc aggiornato con gli argomenti della parola chiave specificati, ovvero, gli argomenti della parola chiave dovrebbero essere valori di parametro gc validi.

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Disegna il percorso con gc aggiornato.

classe matplotlib.patheffects. TickedStroke ( offset = (0, 0) , spaziatura = 10.0 , angolo = 45.0 , lunghezza = 1.4142135623730951 , ** kwargs ) [fonte] #

Basi:AbstractPathEffect

Un PathEffect basato sulla linea che disegna un tracciato con uno stile spuntato.

Questo stile di linea viene spesso utilizzato per rappresentare i vincoli nell'ottimizzazione. I tick possono essere utilizzati per indicare che un lato della linea non è valido o per rappresentare un confine chiuso di un dominio (ad esempio un muro o il bordo di un tubo).

È possibile controllare la spaziatura, la lunghezza e l'angolo delle zecche.

Questo stile di linea viene talvolta definito linea tratteggiata.

Vedere anche l' esempio dimostrativo del contorno .

Vedere anche i contorni nell'esempio di ottimizzazione .

Parametri :

offset (float, float), default: (0, 0): L'offset (x, y) da applicare al percorso, in punti.
spaziatura float, default: 10.0: La spaziatura tra i tick in punti.
angolo mobile, predefinito: 45.0: L'angolo tra il percorso e il segno di spunta in gradi. L'angolo viene misurato come se fossi una formica che cammina lungo la curva, con zero gradi che puntano direttamente davanti a te, 90 a sinistra, -90 a destra e 180 dietro di te.
float di lunghezza , predefinito: 1.414: La lunghezza del tick rispetto alla spaziatura. Lunghezza consigliata = 1.414 (sqrt(2)) quando angolo=45, lunghezza=1.0 quando angolo=90 e lunghezza=2.0 quando angolo=60.
**kwargs: Le parole chiave extra vengono memorizzate e passate a AbstractPathEffect._update_gc().

Esempi

Vedere TickedStroke patheffect .

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Disegna il percorso con gc aggiornato.

classe matplotlib.patheffects. withSimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs ) [fonte] #

Basi:SimplePatchShadow

Una scorciatoia PathEffect per applicare SimplePatchShadowe quindi disegnare l'Artista originale.

Con questa classe puoi usare

artist.set_path_effects([path_effects.withSimplePatchShadow()])

come scorciatoia per

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])

Parametri :

offset (float, float), default: (2, -2): L'offset (x, y) dell'ombra in punti.
shadow_rgbColore faccia: Il colore dell'ombra.
alfa float, predefinito: 0.3: La trasparenza alfa della macchia d'ombra creata.
rho float, predefinito: 0.3: Un fattore di scala da applicare al colore rgbFace se shadow_rgbFace non è specificato.
**kwargs: Le parole chiave extra vengono memorizzate e passate a AbstractPathEffect._update_gc().

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Sostituisce lo standard draw_path per aggiungere l'offset dell'ombra e le modifiche di colore necessarie per l'ombra.

classe matplotlib.patheffects. withStroke ( offset = (0, 0) , ** kwargs ) [fonte] #

Basi:Stroke

Una scorciatoia PathEffect per applicare Strokee quindi disegnare l'Artista originale.

Con questa classe puoi usare

artist.set_path_effects([path_effects.withStroke()])

come scorciatoia per

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

Il percorso verrà tracciato con il suo gc aggiornato con gli argomenti della parola chiave specificati, ovvero, gli argomenti della parola chiave dovrebbero essere valori di parametro gc validi.

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Disegna il percorso con gc aggiornato.

classe matplotlib.patheffects. withTickedStroke ( offset = (0, 0) , spaziatura = 10.0 , angolo = 45.0 , lunghezza = 1.4142135623730951 , ** kwargs ) [fonte] #

Basi:TickedStroke

Una scorciatoia PathEffect per applicare TickedStrokee quindi disegnare l'Artista originale.

Con questa classe puoi usare

artist.set_path_effects([path_effects.withTickedStroke()])

come scorciatoia per

artist.set_path_effects([path_effects.TickedStroke(),
                         path_effects.Normal()])

Parametri :

offset (float, float), default: (0, 0): L'offset (x, y) da applicare al percorso, in punti.
spaziatura float, default: 10.0: La spaziatura tra i tick in punti.
angolo mobile, predefinito: 45.0: L'angolo tra il percorso e il segno di spunta in gradi. L'angolo viene misurato come se fossi una formica che cammina lungo la curva, con zero gradi che puntano direttamente davanti a te, 90 a sinistra, -90 a destra e 180 dietro di te.
float di lunghezza , predefinito: 1.414: La lunghezza del tick rispetto alla spaziatura. Lunghezza consigliata = 1.414 (sqrt(2)) quando angolo=45, lunghezza=1.0 quando angolo=90 e lunghezza=2.0 quando angolo=60.
**kwargs: Le parole chiave extra vengono memorizzate e passate a AbstractPathEffect._update_gc().

Esempi

Vedere TickedStroke patheffect .

draw_path ( renderer , gc , tpath , affine , rgbFace ) [fonte] #: Disegna il percorso con gc aggiornato.

matplotlib.patheffects#

`matplotlib.patheffects`#