matplotlib.backend_tools

Le classi base astratte definiscono le primitive per Tools. Questi strumenti sono utilizzati damatplotlib.backend_managers.ToolManager

ToolBase

Semplice strumento senza stato

ToolToggleBase

Strumento che ha due stati, solo uno strumento Toggle può essere attivo in un dato momento per lo stesso matplotlib.backend_managers.ToolManager

classe matplotlib.backend_tools. AxisScaleBase ( * args , ** kwargs )

Basi:ToolToggleBase

Strumento Base per alternare tra lineare e logaritmico.

disabilita ( evento = Nessuno )

Disabilita lo strumento di commutazione.

triggerchiama questo metodo quando toggledè True.

Questo può accadere in diverse circostanze.

• Fare clic sul pulsante dello strumento della barra degli strumenti.

• Chiama a matplotlib.backend_managers.ToolManager.trigger_tool.

• Viene attivato un altro ToolToggleBasestrumento derivato (dallo stesso ToolManager).

abilita ( evento = Nessuno )

Abilita lo strumento di commutazione.

triggerchiama questo metodo quando toggledè False.

trigger ( mittente , evento , dati = Nessuno )

Chiamate enableo disablein base al toggledvalore.

classe matplotlib.backend_tools. ConfigureSubplotsBase ( toolmanager , nome )

Basi:ToolBase

Strumento base per la configurazione delle sottotrame.

description = 'Configura sottotrame'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

image = 'sottotrame'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

classe matplotlib.backend_tools. Cursori ( valore )

Basi:IntEnum

Tipi di cursore indipendenti dal backend.

MANO = 2

SPOSTA = 4

PUNTATORE = 1

RESIZE_HORIZONTAL = 6

RESIZE_VERTICAL = 7

SELECT_REGION = 3

ATTENDERE = 5

classe matplotlib.backend_tools. RubberbandBase ( toolmanager , nome )

Basi:ToolBase

Disegna e rimuovi un elastico.

draw_rubberband ( * dati )

Disegna l'elastico.

Questo metodo deve essere implementato per back-end.

remove_rubberband ( )

Rimuovi l'elastico.

Questo metodo dovrebbe essere implementato per back-end.

trigger ( mittente , evento , dati = Nessuno )

Chiama draw_rubberbando remove_rubberbandin base ai dati.

classe matplotlib.backend_tools. SaveFigureBase ( toolmanager , nome )

Basi:ToolBase

Strumento di base per salvare la figura.

proprietà default_keymap

description = 'Salva la figura'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

immagine = 'salvataggio file'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

classe matplotlib.backend_tools. SetCursorBase ( * args , ** kwargs )

Basi:ToolBase

Passa al cursore corrente mentre inaxes.

Questo strumento tiene traccia di tutti gli ToolToggleBasestrumenti derivati ​​e chiama set_cursorquando uno strumento viene attivato.

set_cursor ( cursore )

[ Deprecato ] Imposta il cursore.

Appunti

Deprecato dalla versione 3.5: utilizzare FigureCanvasBase.set_cursorinvece.

set_figure ( figura )

classe matplotlib.backend_tools. ToolBack ( toolmanager , nome )

Basi:ViewsPositionsBase

Torna indietro nella pila dei limiti di visualizzazione.

proprietà default_keymap

description = 'Torna alla vista precedente '

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

immagine = 'indietro'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

classe matplotlib.backend_tools. ToolBase ( toolmanager , nome )

Basi:object

Classe di utensili di base.

Uno strumento di base, implementa solo triggeril metodo o nessun metodo. Lo strumento è istanziato da matplotlib.backend_managers.ToolManager.

tela di proprietà

La tela della figura interessata da questo strumento, o Nessuno.

default_keymap = Nessuno

Keymap da associare a questo strumento.

list[str]: elenco di tasti che attivano questo strumento quando viene emesso un evento di pressione di un tasto su self.figure.canvas. Si noti che questo attributo viene cercato nell'istanza e può quindi essere una proprietà (viene utilizzato ad esempio dagli strumenti integrati per caricare rcParams al momento dell'istanziazione).

descrizione = Nessuno

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

distruggere ( )

[ Deprecato ] Distruggi lo strumento.

Questo metodo è chiamato da ToolManager.remove_tool.

Appunti

Deprecato dalla versione 3.6: usa invece tool_removed_event.

cifra della proprietà

La Figura interessata da questo strumento, o Nessuno.

immagine = Nessuno

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

nome proprietà

L'id dello strumento (str, deve essere univoco tra gli strumenti di un tool manager).

set_figure ( figura )

gestore degli strumenti di proprietà

Il ToolManagerche controlla questo strumento.

trigger ( mittente , evento , dati = Nessuno )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

classe matplotlib.backend_tools. ToolCopyToClipboardBase ( toolmanager , nome )

Basi:ToolBase

Strumento per copiare la figura negli appunti.

proprietà default_keymap

description = 'Copia la figura della tela negli appunti'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

trigger ( * args , ** kwargs )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

classe matplotlib.backend_tools. ToolCursorPosition ( * args , ** kwargs )

Basi:ToolBase

Invia messaggio con la posizione corrente del puntatore.

Questo strumento viene eseguito in background riportando la posizione del cursore.

invia_messaggio ( evento )

Chiama matplotlib.backend_managers.ToolManager.message_event.

set_figure ( figura )

classe matplotlib.backend_tools. ToolForward ( toolmanager , nome )

Basi:ViewsPositionsBase

Andare avanti nello stack di visualizzazione lim.

proprietà default_keymap

description = 'Inoltra alla visualizzazione successiva '

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

immagine = 'avanti'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

classe matplotlib.backend_tools. ToolFullScreen ( toolmanager , nome )

Basi:ToolBase

Strumento per attivare o disattivare lo schermo intero.

proprietà default_keymap

description = 'Attiva o disattiva la modalità a schermo intero'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

trigger ( mittente , evento , dati = Nessuno )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

classe matplotlib.backend_tools. ToolGrid ( toolmanager , nome )

Basi:ToolBase

Strumento per alternare le principali griglie della figura.

proprietà default_keymap

description = 'Attiva/disattiva griglie principali

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

trigger ( mittente , evento , dati = Nessuno )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

classe matplotlib.backend_tools. ToolHelpBase ( toolmanager , nome )

Basi:ToolBase

proprietà default_keymap

description = 'Stampa elenco strumenti , scorciatoie e descrizione'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

static format_shortcut ( key_sequence )

Converti una stringa di scorciatoia dalla notazione usata in rc config alla notazione standard per la visualizzazione delle scorciatoie, ad esempio 'ctrl+a' -> 'Ctrl+A'.

immagine = 'aiuto'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

classe matplotlib.backend_tools. ToolHome ( toolmanager , nome )

Basi:ViewsPositionsBase

Ripristina i limiti di visualizzazione originali.

proprietà default_keymap

description = 'Ripristina vista originale '

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

immagine = 'casa'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

classe matplotlib.backend_tools. ToolMinorGrid ( toolmanager , nome )

Basi:ToolBase

Strumento per alternare le griglie maggiore e minore della figura.

proprietà default_keymap

description = 'Alterna griglie principali e secondarie

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

trigger ( mittente , evento , dati = Nessuno )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

classe matplotlib.backend_tools. ToolPan ( * args )

Basi:ZoomPanBase

Panoramica degli assi con il mouse sinistro, zoom con il destro.

cursore = 4

Cursore da utilizzare quando lo strumento è attivo.

proprietà default_keymap

description = 'Sposta gli assi con il mouse sinistro , ingrandisci con il destro'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

immagine = 'sposta'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

radio_group = 'predefinito'

Attributo al gruppo "radio" come strumenti (che si escludono a vicenda).

strche identifica il gruppo oppure Nessuno se non appartenente ad un gruppo.

classe matplotlib.backend_tools. ToolQuit ( toolmanager , nome )

Basi:ToolBase

Strumento per chiamare il metodo di distruzione del gestore di figure.

proprietà default_keymap

description = 'Esci dalla figura'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

trigger ( mittente , evento , dati = Nessuno )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

classe matplotlib.backend_tools. ToolQuitAll ( toolmanager , nome )

Basi:ToolBase

Strumento per chiamare il metodo di distruzione del gestore di figure.

proprietà default_keymap

description = 'Esci da tutte le figure'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

trigger ( mittente , evento , dati = Nessuno )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

matplotlib.backend_tools. ToolSetCursor

alias diSetCursorBase

classe matplotlib.backend_tools. ToolToggleBase ( * args , ** kwargs )

Basi:ToolBase

Strumento commutabile.

Ogni volta che viene attivato, passa tra abilitazione e disabilitazione.

Parametri :

``*argomenti``

Argomento di lunghezza variabile che deve essere utilizzato dallo strumento.

``**kwargs``

toggledse presente e True, imposta lo stato iniziale degli argomenti della parola chiave Tool Arbitrary che devono essere consumati dallo Tool

cursore = Nessuno

Cursore da utilizzare quando lo strumento è attivo.

default_toggled = Falso

Predefinito dello stato attivato.

disabilita ( evento = Nessuno )

Disabilita lo strumento di commutazione.

triggerchiama questo metodo quando toggledè True.

Questo può accadere in diverse circostanze.

• Fare clic sul pulsante dello strumento della barra degli strumenti.

• Chiama a matplotlib.backend_managers.ToolManager.trigger_tool.

• Viene attivato un altro ToolToggleBasestrumento derivato (dallo stesso ToolManager).

abilita ( evento = Nessuno )

Abilita lo strumento di commutazione.

triggerchiama questo metodo quando toggledè False.

gruppo_radio = Nessuno

Attributo al gruppo "radio" come strumenti (che si escludono a vicenda).

strche identifica il gruppo oppure Nessuno se non appartenente ad un gruppo.

set_figure ( figura )

proprietà attivata

Stato dello strumento attivato.

trigger ( mittente , evento , dati = Nessuno )

Chiamate enableo disablein base al toggledvalore.

classe matplotlib.backend_tools. ToolViewsPositions ( * args , ** kwargs )

Basi:ToolBase

Strumento ausiliario per gestire i cambiamenti nelle viste e nelle posizioni.

Viene eseguito in background e dovrebbe essere utilizzato da tutti gli strumenti che devono accedere alla cronologia delle visualizzazioni e delle posizioni della figura, ad es.

• ToolZoom

• ToolPan

• ToolHome

• ToolBack

• ToolForward

add_figure ( figura )

Aggiungi la figura corrente alla pila di viste e posizioni.

indietro ( )

Indietro di un passo nella pila di visualizzazioni e posizioni.

chiaro ( figura )

Reimposta la pila degli assi.

avanti ( )

Avanti di un passo nella pila di visualizzazioni e posizioni.

casa ( )

Richiama la prima vista e posizione dalla pila.

push_current ( figura = None )

Spingi i limiti di visualizzazione correnti e posizionali sui rispettivi stack.

update_home_views ( figura = None )

Assicurarsi che self.home_viewsabbia una voce per tutti gli assi presenti nella figura.

update_view ( )

Aggiorna i limiti di visualizzazione e la posizione per ciascun asse dalla posizione corrente dello stack. Se nella figura sono presenti assi che non si trovano nella posizione corrente dello stack, utilizzare i limiti della vista iniziale per quegli assi e non aggiornare alcuna posizione.

classe matplotlib.backend_tools. ToolXScale ( * args , ** kwargs )

Basi:AxisScaleBase

Strumento per passare dalla scala lineare a quella logaritmica sull'asse X.

proprietà default_keymap

description = 'Attiva/disattiva la scala dell'asse X

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

set_scale ( ax , scale )

classe matplotlib.backend_tools. ToolYScale ( * args , ** kwargs )

Basi:AxisScaleBase

Strumento per passare dalla scala lineare a quella logaritmica sull'asse Y.

proprietà default_keymap

description = 'Attiva/disattiva la scala dell'asse Y

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

set_scale ( ax , scale )

classe matplotlib.backend_tools. ToolZoom ( * args )

Basi:ZoomPanBase

Uno strumento per lo zoom utilizzando un selettore rettangolo.

cursore = 3

Cursore da utilizzare quando lo strumento è attivo.

proprietà default_keymap

description = 'Zoom al rettangolo'

Descrizione dello strumento.

str: Tooltip utilizzato se lo strumento è incluso in una barra degli strumenti.

immagine = 'zoom_to_retto'

Nome file dell'immagine.

str: nome file dell'immagine da utilizzare in una barra degli strumenti. Se Nessuno, il nome viene utilizzato come etichetta nel pulsante della barra degli strumenti.

radio_group = 'predefinito'

Attributo al gruppo "radio" come strumenti (che si escludono a vicenda).

strche identifica il gruppo oppure Nessuno se non appartenente ad un gruppo.

classe matplotlib.backend_tools. ViewsPositionsBase ( toolmanager , nome )

Basi:ToolBase

Classe base per ToolHome, ToolBacke ToolForward.

trigger ( mittente , evento , dati = Nessuno )

Chiamato quando questo strumento viene utilizzato.

Questo metodo è chiamato da ToolManager.trigger_tool.

Parametri :

eventoEvent

L'evento canvas che ha causato la chiamata di questo strumento.

oggetto mittente

Oggetto che ha richiesto l'attivazione dello strumento.

oggetto dati

Dati aggiuntivi.

classe matplotlib.backend_tools. ZoomPanBase ( * args )

Basi:ToolToggleBase

Classe base per ToolZoome ToolPan.

disabilita ( evento = Nessuno )

Rilascia la tela e disconnetti gli eventi di stampa/rilascio.

abilita ( evento = Nessuno )

Collega gli eventi di stampa/rilascio e blocca la tela.

scroll_zoom ( evento )

trigger ( mittente , evento , dati = Nessuno )

Chiamate enableo disablein base al toggledvalore.

matplotlib.backend_tools. add_tools_to_container ( container , tools = [['navigation', ['home', 'back', 'forward']], ['zoompan', ['pan', 'zoom', 'subplots']], ['io ', ['salva', 'aiuta']]] )

Aggiungi più strumenti al contenitore.

Parametri :

contenitore Contenitore

backend_bases.ToolContainerBaseoggetto che otterrà gli strumenti aggiunti.

elenco degli strumenti , facoltativo

Elenca nel modulo in cui verranno visualizzati gli strumenti nel gruppo1. Vedere per i dettagli.[[group1, [tool1, tool2 ...]], [group2, [...]]][tool1, tool2, ...]backend_bases.ToolContainerBase.add_tool

matplotlib.backend_tools. add_tools_to_manager ( toolmanager , tools={'back': <class 'matplotlib.backend_tools.ToolBack'> , 'copy': <class 'matplotlib.backend_tools.ToolCopyToClipboardBase'> , 'cursor': <class 'matplotlib.backend_tools.SetCursorBase' > , 'forward': <class 'matplotlib.backend_tools.ToolForward'> , 'fullscreen': <class 'matplotlib.backend_tools.ToolFullScreen'> , 'grid': <class 'matplotlib.backend_tools.ToolGrid' 'matplotlib.backend_tools.ToolMinorGrid'> , 'help': <class 'matplotlib.backend_tools.ToolHelpBase'> , 'home': <class 'matplotlib.backend_tools.ToolHome'> , 'pan': <class 'matplotlib.backend_tools. ToolPan'> , 'position': <class 'matplotlib.backend_tools.ToolCursorPosition'> , 'quit': <class 'matplotlib.backend_tools.ToolQuit'> , 'quit_all': <class 'matplotlib.backend_tools.ToolQuitAll'> , ' elastico': <class 'matplotlib.backend_tools.RubberbandBase'> , 'salva': <class 'matplotlib.backend_tools.SaveFigureBase'> , 'subplots': <class 'matplotlib.backend_tools.ConfigureSubplotsBase'> , 'viewpos': <class 'matplotlib.backend_tools.ToolViewsPositions'> , 'xscale': <class 'matplotlib. backend_tools.ToolXScale'> , 'yscale': <class 'matplotlib.backend_tools.ToolYScale'> , 'zoom': <class 'matplotlib.backend_tools.ToolZoom'>} )

Aggiungi più strumenti a un file ToolManager.

Parametri :

toolmanagerbackend_managers.ToolManager

Manager a cui vengono aggiunti gli strumenti.

strumenti {str: class_like}, facoltativo

Gli strumenti da aggiungere in un dict {name: tool}, vedi backend_managers.ToolManager.add_toolper maggiori informazioni.

matplotlib.backend_tools. cursori

alias diCursors