Manuale di KGraphViewer - docs.kde.org · I programmiGraphvizsono software libero per tracciare...

Manuale di KGraphViewer

Gaël de ChalendarFederico Zenith

Traduzione in italiano: Federico Zenith


2

Indice

1 Introduzione 5

2 Uso di KGraphViewer 7

2.1 La finestra principale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.1.1 Spostare il grafo nella finestra . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.1.2 Ingrandimento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.1.3 Gestione dei file di grafi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.1.3.1 File modificati sul disco . . . . . . . . . . . . . . . . . . . . . . . . . 92.1.3.2 File e finestre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.1.3.3 Gestione delle sessioni . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.2 Stampa dei grafi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.3 Configurare KGraphViewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.4 Funzioni varie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3 Guida ai comandi 183.1 I menu di KGraphViewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3.1.1 Il menu File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.1.2 Il menu Visualizza . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.1.3 I menu Impostazioni e Aiuto . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.2 Le barre degli strumenti di KGraphViewer . . . . . . . . . . . . . . . . . . . . . . . 19

3.2.1 La barra degli strumenti principale . . . . . . . . . . . . . . . . . . . . . . . . 19

3.2.2 La barra degli strumenti Visualizza . . . . . . . . . . . . . . . . . . . . . . . 20

3.2.3 La barra Aiuto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4 Riconoscimenti e licenza 214.1 Programma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.1.1 Autori principali . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.1.2 Hanno contribuito (da completare) . . . . . . . . . . . . . . . . . . . . . . . . 21

4.2 Manuale dell’utente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.2.1 Hanno contribuito . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.3 Altri riconoscimenti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.4 Licenze . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Sommario

KGraphViewer è un visore di grafi DOT di Graphviz. È sviluppato nella comunità KDE.I programmi Graphviz sono software libero per tracciare grafi. I grafi sono spesso usati nellacomunità scientifica e particolarmente nell’informatica.

KGraphViewer mostra i grafi in un’interfaccia utente moderna e intuitiva.

https://www.graphviz.org



Capitolo 1

Introduzione

KGraphViewer è un visore di grafi DOT di Graphviz. I programmi Graphviz sono software liberoper tracciare grafi. KGraphViewer visualizza i grafi in un’interfaccia moderna e facile da usare.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;

• Sono supportati i colori dei nodi e dei bordi e tutte le forme dei nodi;

5





• 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 (esternamen-te) (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 diingrandimento, eccetera);

• Integrazione in Kate e Konqueror (in modo che un cambiamento nella vista di Kate del grafosia 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 acirca 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 diavanzamento).

NOTANota che questo programma contiene codice dello strumento KCacheGrind di Josef Weidendorfer,sotto licenza GPL, con la sua autorizzazione.

NOTANota anche che il sistema di stampa è stato ottenuto dall’applicazione per banche dati Kexi di Calligra.

Altro software richiesto: KGraphViewer è un programma che usa lo strumento DOT di Graphvizper la struttura dei grafi. Le sue dipendenze sono:

• Le librerie Qt™ e KF5 versione 5.x;

• Gli strumenti Graphviz come programmi esterni (testato con la versione 2.8);

• La libreria Boost versione 1.36.

6



https://www.boost.org


Capitolo 2

Uso di KGraphViewer

2.1 La finestra principale

La finestra principale visualizza i grafi caricati, ciascuno nella propria scheda. Inizialmente, seavvii KGraphViewer senza argomenti, la finestra principale sarà vuota come nella schermatasotto. In questo caso, la barra degli strumenti conterrà solo gli elementi Apri file e File aperti direcente. 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 schermatasotto:

7


La finestra principale di KGraphViewer con diversi file aperti

Come puoi vedere, se il grafo è più grande dell’area disponibile, in un angolo viene visualizzatauna vista a volo d’aquila. Puoi scegliere con il menu contestuale se la posizione ottimale di questapanoramica debba essere calcolata automaticamente oppure metterla dove vuoi.

2.1.1 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 iltasto Alt premuto);

• o fare clic e trascinare nella vista a volo d’aquila.

2.1.2 Ingrandimento

Per ingrandire, puoi usare i pulsanti e della barra degli strumenti per ingrandiree rimpicciolire, o tenere premuto tasto Shift mentre usi la rotellina del mouse. Quando ingrandi-sci, il rettangolo rosso nella vista a volo d’aquila che indica la zona visualizzata diventa semprepiù piccolo. Se dovesse diventare più piccolo di 10 pixel sul lato più corto, sarà sostituito da unrettangolo pieno di colore rosso per rimanere visibile. Puoi vederlo nella schermata sotto.

8


Un grafo al massimo livello di ingrandimento

L’ingrandimento è limitato in entrambe le direzioni da un fattore di 10. Puoi vedere sotto ilmassimo fattore di rimpicciolimento su un grafo.

Un grafo al massimo livello di rimpicciolimento

2.1.3 Gestione dei file di grafi

2.1.3.1 File modificati sul disco

Se un file attualmente caricato in KGraphViewer viene modificato da un altro programma, apparela finestra seguente:

9


Finestra per ricaricare un file modificato su disco

Puoi scegliere di ricaricare il grafo o ignorare le modifiche. Puoi anche far memorizzare a KGra-phViewer la tua scelta per poterla rifare la prossima volta. Se in seguito vorrai modificare questascelta, scegli l’elemento del menu Impostazioni → Configura KGraphViewer. Vedi Sezione 2.3.

2.1.3.2 File e finestre

Quando apri un file di grafi da fuori da un’istanza di KGraphViewer in esecuzione, per esempioda un navigatore di file o dalla riga di comando, hai la scelta di aprire una nuova finestra diKGraphViewer o aprire il grafo in una nuova scheda nella finestra esistente. Ciò viene fatto conla 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ù avantinella finestra di configurazione.

2.1.3.3 Gestione delle sessioni

All’avvio, puoi scegliere di riaprire i grafi che erano stati aperti la volta prima. Di nuovo, puoifar memorizzare la tua scelta e cambiarla in seguito.

10


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 distampa.

Finestra di configurazione di pagina

Puoi configurare le opzioni di stampa per far stare il grafico esattamente su una pagina, comesotto:

11


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 everticali 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:

12


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 caratterediverso

13


2.3 Configurare KGraphViewer

La pagina Aspetto permette di cambiare il colore di sfondo predefinito usato in KGraphViewerse un grafo non definisce un proprio colore di sfondo.

Pagina per cambiare l’aspetto di un grafo.

La pagina Elaborazione permette di selezionare un comando esterno o la libreria interna perl’analisi di file DOT di Graphviz.

Pagina per ricaricare i file modificati sul disco nella finestra di configurazione

14



La pagina Ricarica permette di cambiare il comportamento di KGraphViewer quando un fileviene cambiato sul disco da un’altra applicazione. Puoi scegliere un’azione predefinita (ricaricareautomaticamente 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 digrafi viene aperto dal di fuori della sessione attuale. Puoi scegliere un’azione predefinita (aprirenella 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


La pagina Gestione delle sessioni permette di cambiare il comportamento di KGraphViewerall’avvio. Puoi scegliere un’azione predefinita (riaprire o meno i file della sessione precedente), odi 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 deigrafi) offre altre possibilità:

SchemaQuesto 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:

DOTAlgoritmo DOT, predefinito per i grafi orientati. Produce disegni ‘gerarchici’ o strati-ficati 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 ridurnela lunghezza.

NEATOAlgoritmo NEATO, predefinito per i grafi non orientati. Produce strutture ‘a molla’.Usa l’algoritmo Kamada-Kawai, che è equivalente al riscalamento multidimensionalestatistico.

TWOPIAlgoritmo TWOPI, per grafi orientati e non. Struttura radiale, secondo Graham Willis1997.

FDPAlgoritmo FDP, per grafi non orientati. Produce strutture ‘a molla’. Implementa l’eu-ristica di Fruchterman-Reingold incluso un risolutore multigriglia che gestisce grandigrafi e grafi non orientati a gruppi.

16




CIRCOAlgoritmo CIRCO. Produce una struttura circolare, secondo Six e Tollis 1999,Kauffman e Wiese 2002. Adatto a certi diagrammi di strutture multiple cicliche.

Specifica comando di strutturaApre una finestra che ti permette di specificare un comando di struttura eseguito dallashell. 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 dareopzioni specifiche a uno dei comandi precedenti o applicare un filtro che modifica ilgrafo prima di farlo passare attraverso DOT.

Reimposta i comandi di struttura ai valori predefinitiDetermina 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 in un formato di immagine supportato.

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 possibilisono:

In alto a sinistraPosiziona la vista a volo d’aquila nell’angolo in alto a sinistra;

In alto a destraPosiziona la vista a volo d’aquila nell’angolo in alto a destra;

In basso a sinistraPosiziona la vista a volo d’aquila nell’angolo in basso a sinistra;

In basso a destraPosiziona la vista a volo d’aquila nell’angolo in basso a destra;

AutomaticoSceglie automaticamente la posizione migliore per nascondere il meno possibile delgrafo.

17


Capitolo 3

Guida ai comandi

3.1 I menu di KGraphViewer

3.1.1 Il menu File

File → Nuovo (Ctrl+N)Apre una nuova finestra di KGraphViewer.

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 in un formato di immagine supportato.

File → Stampa... (Ctrl+P)

Stampa il grafo attuale usando i parametri di stampa attuali.

File → Anteprima di stampa... (Ctrl+Shift+P)

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.

3.1.2 Il menu Visualizza

Visualizza → Ingrandisci (Ctrl++)

Ingrandisci il grafo attuale del 10%.

Visualizza → Rimpicciolisci (Ctrl+-)

Rimpicciolisci il grafo attuale del 10%.

18


Visualizza → RicaricaRicarica il grafo attuale.

Visualizza → Seleziona algoritmo di struttura

Apre un sotto-menu con vari algoritmi di struttura di Graphviz per il grafo attuale.

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 sinistraPosiziona la vista a volo d’aquila nell’angolo in alto a sinistra;

In alto a destraPosiziona la vista a volo d’aquila nell’angolo in alto a destra;

In basso a sinistraPosiziona la vista a volo d’aquila nell’angolo in basso a sinistra;

In basso a destraPosiziona la vista a volo d’aquila nell’angolo in basso a destra;

AutomaticoSceglie automaticamente la posizione migliore per nascondere il meno possibile delgrafo.

3.1.3 I menu Impostazioni e Aiuto

KGraphViewer ha le normali voci del menu di KDE Impostazioni e Aiuto; per maggiori in-formazioni leggi la sezione sul menu Impostazioni e sul menu Aiuto dei fondamentali diKDE.

3.2 Le barre degli strumenti di KGraphViewer

3.2.1 La barra degli strumenti principale

Visualizza la finestra Apri file.

Visualizza l’elenco di file aperti di recente.

Visualizza la finestra Anteprima di stampa.

19


help:/fundamentals/ui.html#menus-settings

help:/fundamentals/ui.html#menus-help


3.2.2 La barra degli strumenti Visualizza

Modifica il comando di struttura o visualizza l’elenco di algoritmi di struttura predefiniti.

Ingrandisci il grafo attuale del 10%.

Rimpicciolisci il grafo attuale del 10%.

3.2.3 La barra Aiuto

Visualizza il puntatore del mouse Che cos’è?. Facci clic su un elemento dell’interfaccia peravere aiuto sul suo uso (se ce n’è uno disponibile).

20


Capitolo 4

Riconoscimenti e licenza

4.1 Programma

4.1.1 Autori principali

Copyright del programma 2005-2006 di Gaël de Chalendar [email protected]

4.1.2 Hanno contribuito (da completare)

• Reimar Döffinger [email protected]

4.2 Manuale dell’utente

Copyright della documentazione 2006 di Gaël de Chalendar [email protected]

4.2.1 Hanno contribuito

• Federico Zenith [email protected]

4.3 Altri riconoscimenti

Questo programma contiene codice riutilizzato dai seguenti progetti di software libero:

KCacheGrindModello iniziale dei grafi e classi di visualizzazione;

KexiConfigurazione della stampa e classi di anteprima.

21

mailto:[email protected]




https://kcachegrind.github.io/html/Home.html

http://www.kexi-project.org/


4.4 Licenze

Traduzione di Federico Zenith [email protected]

Questa documentazione è concessa in licenza sotto i termini della GNU Free DocumentationLicense.Questo programma è concesso in licenza sotto i termini della GNU General Public License.

22


fdl-license.html

fdl-license.html

gpl-translated.html

Manuale di KGraphViewer - docs.kde.org · I programmiGraphvizsono software libero per tracciare...

Documents

Transcript of Manuale di KGraphViewer - docs.kde.org · I programmiGraphvizsono software libero per tracciare...