Manuale di KGraphViewer. Gaël de Chalendar Federico Zenith Traduzione in italiano: Federico Zenith

Transcript

1 Gaël de Chalendar Federico Zenith Traduzione in italiano: Federico Zenith

2 2

3 Indice 1 Introduzione 6 2 Uso di KGraphViewer La finestra principale Spostare il grafo nella finestra Ingrandimento Gestione dei file di grafi File modificati sul disco File e finestre Gestione delle sessioni Stampa dei grafi Configurare KGraphViewer Funzioni varie Guida ai comandi I menu di KGraphViewer Il menu File Il menu Visualizza Il menu Aiuto Le barre degli strumenti di KGraphViewer La barra degli strumenti principale La barra degli strumenti Visualizza La barra Aiuto Riconoscimenti e licenza Programma Autori principali Hanno contribuito (da completare) Manuale dell utente Hanno contribuito Altri riconoscimenti Licenze

4 A Installazione 23 A.1 Come ottenere KGraphViewer A.2 Dipendenze A.3 Compilazione e installazione A.4 Configurazione

5 Sommario KGraphViewer è un visore di grafi DOT di GraphViz per KDE. I programmi GraphViz sono software libero per tracciare grafi. I grafi sono spesso usati nella comunità scientifica e particolarmente nell informatica. Finora, mancava un interfaccia moderna per visualizzarli. I programmi forniti con GraphViz sono secondo me applicazioni per X11 o Tcl/Tk datate e con poche funzionalità. Il progetto KGraphViewer punta a sostituire questi strumenti con un interfaccia moderna e intuitiva con tutto il potere di un applicazione ben integrata in KDE.

6 Capitolo 1 Introduzione KGraphViewer è un visore di grafi DOT di GraphViz per KDE. I programmi GraphViz sono software libero per tracciare grafi. KGraphViewer visualizza i grafi in un interfaccia moderna e facile da usare, con tutta la potenza di un applicazione ben integrata in KDE. Ha le seguenti funzionalità: Ingrandimento; Caricamento di diversi grafi allo stesso tempo in schede; Salvataggio di un elenco di file recenti; Vista a volo d aquila del grafo; Spostamento del grafo trascinando del mouse; Stampa con tutte le funzionalità; Tracciamento perfetto di tutti i grafi d esempio di GraphViz; 6

7 Sono supportati i colori dei nodi e dei bordi e tutte le forme dei nodi; Scelta automatica di DOT per i grafi orientati e NEATO per i non orientati; Ricaricamento manuale o automatico con conferma dell utente dei file modificati (esternamente) (configurabile); Apertura di nuove istanze del programma come nuove schede in un istanza preesistente (configurabile); Sistema d aiuto; Internazionalizzazione. Le funzionalità in programma sono: Uso della libreria Qanava per supportare la rappresentazione interna dei grafi; Salvataggio dei dati di sessione dei grafi (programma usato per la struttura, fattore di ingrandimento, eccetera); Integrazione in Kate e Konqueror (in modo che un cambiamento nella vista di Kate del grafo sia segnalata e causi un ricaricamento del file in KGraphViewer); Menu per aprire il file in Kate o per aprire un componente Kate nella finestra di KGraphViewer; Caricamento di grafi grandi e molto grandi (al momento, ci sono problemi di prestazioni a circa 1000 nodi, e un trucco per ignorare i nodi oltre un certo limite); Supporto progressivo di sempre più attributi e valori DOT; Struttura sullo sfondo (con threading per evitare blocchi dell interfaccia, e con una barra di avanzamento). NOTA Nota che questo programma contiene codice dello strumento KCacheGrind di Josef Weidendorfer, sotto licenza GPL, con la sua autorizzazione. NOTA Nota anche che il sistema di stampa è stato ottenuto dall applicazione per banche dati Kexi di KOffice. Altro software richiesto: KGraphViewer è un programma di KDE che usa lo strumento DOT di GraphViz per la struttura dei grafi. Le sue dipendenze sono: La libreria Qt e le librerie di KDE (pacchetto kdelibs), versione 4.x; Gli strumenti GraphViz come programmi esterni (testato con la versione 2.8); La libreria Boost versione

8 Capitolo 2 Uso di KGraphViewer 2.1 La finestra principale La finestra principale visualizza i grafi caricati, ciascuno nella propria scheda. Inizialmente, se avvii KGraphViewer senza argomenti, la finestra principale sarà vuota come nella schermata sotto. In questo caso, la barra degli strumenti conterrà solo gli elementi Apri file e File aperti di recente. Fai clic sul primo per aprire la finestra standard Apri file. La finestra principale iniziale quando si apre KGraphViewer per la prima volta Dopo aver selezionato uno o più file DOT, la finestra principale apparirà come nella schermata sotto: 8

9 La finestra principale di KGraphViewer con diversi file aperti Come puoi vedere, se il grafo è più grande dell area disponibile, in un angolo viene visualizzata una vista a volo d aquila. Puoi scegliere con il menu contestuale se la posizione ottimale di questa panoramica debba essere calcolata automaticamente oppure metterla dove vuoi Spostare il grafo nella finestra Per spostare il grafo, puoi: Farci clic e trascinarlo; Usare le barre di scorrimento; Premere i tasti freccia; Fare clic da qualche parte nella vista a volo d aquila; Usare la rotellina del mouse (in alto e in basso senza modificatori, a sinistra e a destra con il tasto Alt premuto); o fare clic e trascinare nella vista a volo d aquila Ingrandimento Per ingrandire, puoi usare i pulsanti e della barra degli strumenti per ingrandire e rimpicciolire, o tenere premuto tasto Shift mentre usi la rotellina del mouse. Quando ingrandisci, il rettangolo rosso nella vista a volo d aquila che indica la zona visualizzata diventa sempre più piccolo. Se dovesse diventare più piccolo di 10 pixel sul lato più corto, sarà sostituito da un rettangolo pieno di colore rosso per rimanere visibile. Puoi vederlo nella schermata sotto. 9

10 Un grafo al massimo livello di ingrandimento L ingrandimento è limitato in entrambe le direzioni da un fattore di 10. Puoi vedere sotto il massimo fattore di rimpicciolimento su un grafo. Un grafo al massimo livello di rimpicciolimento 10

11 2.1.3 Gestione dei file di grafi File modificati sul disco Se un file attualmente caricato in KGraphViewer viene modificato da un altro programma, appare la finestra seguente: Finestra per ricaricare un file modificato su disco Puoi scegliere di ricaricare il grafo o ignorare le modifiche. Puoi anche far memorizzare a KGraphViewer la tua scelta per poterla rifare la prossima volta. Se in seguito vorrai modificare questa scelta, scegli l elemento del menu Impostazioni Configura KGraphViewer. Vedi Sezione File e finestre Quando apri un file di grafi da fuori da un istanza di KGraphViewer in esecuzione, per esempio da un navigatore di file o dalla riga di comando, hai la scelta di aprire una nuova finestra di KGraphViewer o aprire il grafo in una nuova scheda nella finestra esistente. Ciò viene fatto con la finestra che vedi qui sotto: Finestra per aprire una nuova finestra di KGraphViewer Come per l opzione precedente, puoi salvare la tua scelta predefinita e modificarla più avanti nella finestra di configurazione Gestione delle sessioni All avvio, puoi scegliere di riaprire i grafi che erano stati aperti la volta prima. Di nuovo, puoi far memorizzare la tua scelta e cambiarla in seguito. 11

12 Finestra per ricaricare i grafi della sessione precedente all avvio 2.2 Stampa dei grafi Prova i pulsanti Anteprima di stampa o Configurazione di pagina per esplorare le opzioni di stampa. Finestra di configurazione di pagina Puoi configurare le opzioni di stampa per far stare il grafico esattamente su una pagina, come sotto: 12

13 Anteprima della configurazione di pagina per far stare il grafo su una pagina Puoi anche scegliere come dividere il grafo su più pagine. Il numero di pagine orizzontali e verticali può essere scelto indipendentemente. Anteprima della configurazione di pagina per far stare il grafo su più pagine e riempirle Infine, quando usi più pagine, puoi scegliere se far adattare la parte del grafo su ogni pagina, perdendo le proporzioni, o mantenerle. In quest ultimo caso, le pagine non saranno piene. Puoi cambiare le dimensioni delle pagine e dei margini: 13

14 Finestra delle dimensioni e dei margini delle pagine Puoi anche cambiare il carattere, le intestazioni e i piè di pagina: Anteprima di stampa configurata per stare su più pagine senza intestazioni e con un carattere diverso 14

15 2.3 Configurare KGraphViewer La pagina Ricarica permette di cambiare il comportamento di KGraphViewer quando un file viene cambiato sul disco da un altra applicazione. Puoi scegliere un azione predefinita (ricaricare automaticamente o ignorare le modifiche), o di venire interpellato ogni volta. Pagina per ricaricare i file modificati sul disco nella finestra di configurazione La finestra Apertura permette di cambiare il comportamento di KGraphViewer quando un file di grafi viene aperto dal di fuori della sessione attuale. Puoi scegliere un azione predefinita (aprire nella finestra attuale o in una nuova), o di venire interpellato ogni volta. Pagina per aprire i nuovi file in una finestra esistente nella finestra di configurazione 15

16 La pagina Gestione delle sessioni permette di cambiare il comportamento di KGraphViewer all avvio. Puoi scegliere un azione predefinita (riaprire o meno i file della sessione precedente), o di venire interpellato ogni volta. Pagina per riaprire i file della sessione precedente nella finestra di configurazione 2.4 Funzioni varie Il menu contestuale (normalmente ottenuto premendo il tasto destro del mouse nella vista dei grafi) offre altre possibilità: Schema Questo permette di scegliere tra diversi algoritmi di struttura GraphViz o di scegliere il tuo. Le voci, come descritte nella pagina Web di GraphViz, sono le seguenti: DOT Algoritmo DOT, predefinito per i grafi orientati. Produce disegni gerarchici o stratificati dei grafi orientati. L algoritmo di struttura punta le frecce nella stessa direzione (dall alto in basso, o da sinistra a destra) e cerca di evitare di incrociarle e di ridurne la lunghezza. NEATO Algoritmo NEATO, predefinito per i grafi non orientati. Produce strutture a molla. Usa l algoritmo Kamada-Kawai, che è equivalente al riscalamento multidimensionale statistico. TWOPI Algoritmo TWOPI, per grafi orientati e non. Struttura radiale, secondo Graham Willis FDP Algoritmo FDP, per grafi non orientati. Produce strutture a molla. Implementa l euristica di Fruchterman-Reingold incluso un risolutore multigriglia che gestisce grandi grafi e grafi non orientati a gruppi. CIRCO Algoritmo CIRCO. Produce una struttura circolare, secondo Six e Tollis 1999, Kauffman e Wiese Adatto a certi diagrammi di strutture multiple cicliche. 16

17 Specifica comando di struttura Apre una finestra che ti permette di specificare un comando di struttura eseguito dalla shell. Questo comando dovrebbe accettare un parametro, il nome del file di grafi, e scriverne la struttura su stdout nel linguaggio xdot. In questo modo, puoi dare opzioni specifiche a uno dei comandi precedenti o applicare un filtro che modifica il grafo prima di farlo passare attraverso DOT. Reimposta i comandi di struttura ai valori predefiniti Determina il tipo di grafo (orientato o meno) e applicaci l algoritmo predefinito, attualmente DOT e NEATO rispettivamente. Esporta grafo Come immagine... Permette di esportare il grafo completo come immagine png. Attiva vista a volo d aquila Quando segnato, la vista a volo d aquila viene visualizzata quando necessario. Altrimenti, viene nascosta e il suo menu di posizionamento viene disattivato. Vista a volo d aquila Configura dove posizionare la vista a volo d aquila nella vista dei grafi. Le scelte possibili sono: In alto a sinistra Posiziona la vista a volo d aquila nell angolo in alto a sinistra; In alto a destra Posiziona la vista a volo d aquila nell angolo in alto a destra; In basso a sinistra Posiziona la vista a volo d aquila nell angolo in basso a sinistra; In basso a destra Posiziona la vista a volo d aquila nell angolo in basso a destra; Automatico Sceglie automaticamente la posizione migliore per nascondere il meno possibile del grafo. 17

18 Capitolo 3 Guida ai comandi 3.1 I menu di KGraphViewer Il menu File File Apri (Ctrl+O) Visualizza la finestra Apri file. File Apri recenti Visualizza l elenco dei dieci file di grafi aperti più di recente. File Esporta grafo Come immagine... Permette di esportare il grafo completo come immagine png. File Stampa... (Ctrl+P) Stampa il grafo attuale usando i parametri di stampa attuali. File Anteprima di stampa... Apre la finestra di Anteprima di stampa per il grafo attuale. File Configurazione di pagina Apre la finestra Configurazione di pagina per il grafo attuale. File Esci (Ctrl+Q) Esce da KGraphViewer Il menu Visualizza Visualizza Ricarica Ricarica il grafo attuale. Visualizza Ingrandisci (Ctrl++) Ingrandisci il grafo attuale del 10%. Visualizza Rimpicciolisci (Ctrl+-) Rimpicciolisci il grafo attuale del 10%. 18

19 Visualizza Attiva vista a volo d aquila (Ctrl+B) Quando segnato, la vista a volo d aquila viene visualizzata quando necessario. Altrimenti, viene nascosta e il suo menu di posizionamento viene disattivato. Visualizza Vista a volo d aquila Configura dove posizionare la vista a volo d aquila nella vista dei grafi. Le scelte sono: In alto a sinistra Posiziona la vista a volo d aquila nell angolo in alto a sinistra; In alto a destra Posiziona la vista a volo d aquila nell angolo in alto a destra; In basso a sinistra Posiziona la vista a volo d aquila nell angolo in basso a sinistra; In basso a destra Posiziona la vista a volo d aquila nell angolo in basso a destra; Automatico Sceglie automaticamente la posizione migliore per nascondere il meno possibile del grafo Il menu Aiuto KGraphViewer ha i normali elementi del menu di KDE Aiuto; per maggiori informazioni leggi le sezioni sul menu Aiuto dei Fondamentali di KDE. 3.2 Le barre degli strumenti di KGraphViewer La barra degli strumenti principale Visualizza la finestra Apri file. Visualizza l elenco di file aperti di recente. Stampa il grafo usando la configurazione attuale La barra degli strumenti Visualizza Modifica il comando di struttura o visualizza l elenco di algoritmi di struttura predefiniti. 19

20 Ingrandisci il grafo attuale del 10%. Rimpicciolisci il grafo attuale del 10% La barra Aiuto Visualizza il puntatore del mouse Che cos è?. Facci clic su un elemento dell interfaccia per avere aiuto sul suo uso (se ce n è uno disponibile). 20

21 Capitolo 4 Riconoscimenti e licenza 4.1 Programma Autori principali Copyright del programma di Gaël de Chalendar kleag@free.fr Hanno contribuito (da completare) Reimar Döffinger Reimar.Doeffinger@stud.uni-karlsruhe.de 4.2 Manuale dell utente Copyright della documentazione 2006 di Gaël de Chalendar kleag@free.fr Hanno contribuito Federico Zenith federico.zenith@member.fsf.org 4.3 Altri riconoscimenti Questo programma contiene codice riutilizzato dai seguenti progetti di software libero: KCacheGrind Modello iniziale dei grafi e classi di visualizzazione; Kexi Configurazione della stampa e classi di anteprima. 21

22 4.4 Licenze Traduzione di Federico Zenith Questa documentazione è concessa in licenza sotto i termini della GNU Free Documentation License. Questo programma è concesso in licenza sotto i termini della GNU General Public License. 22

23 Appendice A Installazione A.1 Come ottenere KGraphViewer KGraphViewer fa parte del pacchetto extragear di KDE. Il suo deposito di Subversion può essere trovato su websvn.kde.org. I rilasci indipendenti di KGraphViewer possono essere trovati sulla home page di KGraphViewer. Puoi trovare un elenco delle modifiche a questo indirizzo e nel file ChangeLog nella radice dell archivio di distribuzione. A.2 Dipendenze KGraphViewer è un programma per KDE che usa gli strumenti GraphViz per la struttura dei grafi. Richiede che i seguenti programmi siano installati: Le librerie Qt 3.x (3.3.6 e superiore per evitare un errore di disegno); Le librerie di KDE (sviluppato e testato con la versione 3.5.x); Gli strumenti GraphViz (testato con versioni fino alla 2.8); La libreria Boost Spirit (testato con la versione 0.32). A.3 Compilazione e installazione Per avere informazioni dettagliate su come compilare e installare le applicazioni di KDE, vedi Building and Running KDE Software From Source Siccome KDE usa cmake non dovresti avere problemi a compilarle. incontrarne, segnalali alle liste di distribuzione di KDE. Se invece dovessi A.4 Configurazione Non è necessaria una configurazione speciale per usare KGraphViewer. Impostazioni per alcune opzioni. Vedi il menu 23