Handbok KGraphViewer. Gaël de Chalendar Federico Zenith Översättare: Stefan Asserhäll

Transkript

1 Gaël de Chalendar Federico Zenith Översättare: Stefan Asserhäll

2 2

3 Innehåll 1 Inledning 5 2 Använda KGraphViewer Huvudfönstret Flytta grafen inne i fönstret Zoomning Hantering av graffiler Filer ändrade på disk Filer och fönster Sessionshantering Utskrift av grafer Anpassa KGraphViewer Diverse funktioner Kommandoreferens Menyerna i KGraphViewer Menyn Arkiv Menyn Visa Menyerna Inställningar och Hjälp Verktygsraderna i KGraphViewer Huvudverktygsraden Vyverktygsraden Hjälpverktygsraden Tack till och licens Program Huvudsakliga upphovsmän Bidragsgivare (kommer att kompletteras) Användarguide Bidragsgivare Övriga erkännanden Licenser

4 Sammanfattning KGraphViewer är ett grafvisningsverktyg av Graphviz DOT-grafer. Det är utvecklat inom KDE-gemenskapen. Programmen i Graphviz är fri programvara för layout av grafer. Grafer används vanligtvis i vetenskapliga sammanhang och i synnerhet inom datavetenskap. KGraphViewer visar graferna i ett modernt användarvänligt grafiskt gränssnitt.

5 Kapitel 1 Inledning KGraphViewer är ett grafvisningsverktyg av Graphviz DOT-grafer. Programmen i Graphviz är fri programvara för layout av grafer. KGraphViewer visar graferna i ett modernt användarvänligt grafiskt gränssnitt. Det har följande funktioner: Zoomning, Samtidig laddning av flera grafer under flikar, Lagring av en lista med senaste öppnade filer, En översiktsvy av grafen, Panorering av grafen genom att dra musen, Utskrift med fullständig funktion, Perfekt uppritning av alla exempelgrafer från Graphviz, 5

6 Färger på noder och bågar samt alla nodformer stöds, Automatiskt val av DOT för riktade grafer och NEATO för oriktade, Manuell eller automatisk inläsning med bekräftelse av användaren för (externt) ändrade filer (anpassningsbart), Öppnar nya instanser som nya flikar i den tidigare (anpassningsbart), Hjälpsystem, Översättning av programmet. Planerade funktioner är: Framtida användning av Qanava-biblioteket för att stödja intern representation av grafer, Spara sessionsdata om grafer (layout som programmet använde, zoomfaktor, etc.) Integrering i Kate och Konqueror (så att en ändring i Kates visning av grafen skulle göra en ny layout och inläsning av filen i KGraphViewer), Meny för att öppna filen i Kate eller öppna ett Kate-delprogram inne i KGraphViewers fönster, Laddning av stora och mycket stora grafer (för närvarande finns prestandaproblem omkring 1000 noder, och en fix för att ignorera noder över en angiven gräns), Stöd för fler och fler egenskaper och värden från DOT efter hand, Layout i bakgrunden (tråd för att inte blockera gränssnittet, med förloppsrad), NOT Observera att programmet innehåller kod från GPL-verktyget KCacheGrind av Josef Weidendorfer, med hans tillstånd. NOT Observera också att utskriftssystemet kommer från Calligrasdatabasprogram Kexi. Annan programvara som krävs: KGraphViewer är ett program som använder Graphvizverktyget DOT för layout av grafer. Dess beroenden är: Qt - och KF5-biblioteken version 5.x, Graphviz-verktygen som externa program (testat med version 2.8), Boost-biblioteket version

7 Kapitel 2 Använda KGraphViewer 2.1 Huvudfönstret Huvudfönstret visar laddade grafer, var och en under sin flik. Om du startar KGraphViewer utan väljare är huvudfönstret tomt som visas på skärmbilden nedan. I detta fall innehåller verktygsraden bara ikonerna Öppna fil och (den tomma) Senast öppnade filer. Klicka på den första för att visa den vanliga dialogrutan Öppna fil. Det ursprungliga huvudfönstret när KGraphViewer startas för första gången Efter att ha valt en eller flera DOT-filer, ser huvudfönstret ut som nästa skärmbild nedan: 7

8 Huvudfönstret i KGraphViewer med flera öppna filer Som du kan se visas en översiktsvy i ett hörn om grafen är större än tillgänglig yta. Du kan välja om den bästa platsen för översikten ska beräknas automatiskt åt dig, eller om du ska placera den där du vill ha den själv, med den sammanhangsberoende menyn Flytta grafen inne i fönstret För att flytta en graf kan du: Klicka och dra den, Använda rullningslisterna, Trycka på piltangenterna, Klicka någonstans i översiktsvyn, Använda mushjulet (uppåt och neråt utan väljartangent, vänster och höger med Alt-tangenten nertryckt), eller klicka och dra inne i översiktsvyn Zoomning För att zooma kan du antingen använda verktygsradens knappar och eller hålla nere Skift-tangenten medan du rör mushjulet. Vid inzoomning blir den röda rektangeln i panoreringsvyn, som avbildar området som visas, mindre och mindre. Om den skulle bli mindre än 10 bildpunkter längs den kortaste sidan, ersätts den dock av en enkel röd rektangel för att förbli synlig. Du ser det på skärmbilden nedan. 8

9 En graf med maximal inzoomningsnivå Zoomning är begränsat till en faktor 10 i båda riktningar. Nedan kan du se den maximala zoomfaktorn för en graf. En graf med maximal utzoomningsnivå 9

10 2.1.3 Hantering av graffiler Filer ändrade på disk Om en fil som för närvarande är laddad i KGraphViewer ändras av ett annat program, visas följande dialogruta: Dialogruta för inläsning av en fil ändrad på disk Du kan välja att läsa in grafen eller ignorera ändringen. Du kan också få KGraphViewer att komma ihåg ditt val och att göra samma sak följande gång. Om du senare vill ändra ditt val, välj menyalternativet Inställningar Anpassa KGraphViewer. Se Avsnitt Filer och fönster När en graffil öppnas utanför en instans av KGraphViewer som kör, t.ex. i en filhanterare eller på kommandoraden, har du möjlighet att visa ett nytt KGraphViewer-fönster eller lägga till grafen under en ny flik i det befintliga fönstret. Det görs med dialogrutan nedan. Dialogrutan för att öppna ett nytt fönster Liksom med det tidigare alternativet kan du spara förvalt alternativ och senare ändra det i inställningsdialogrutan. 10

11 Sessionshantering Vid start kan du välja att öppna graferna som var öppna föregående gång eller inte. Kom ihåg ditt val och ändra det senare, om du vill. Dialogruta för inläsning av grafer från tidigare session vid start 2.2 Utskrift av grafer Prova med knapparna Förhandsgranskning av utskrift eller Sidinställning för att utforska utskriftsalternativen. Dialogrutan för sidinställning Du kan ställa in utskriftsalternativ för att exakt passa in grafen på en sida, som nedan: 11

12 Inställning av förhandsgranskning för att få plats på en sida Du kan också välja hur grafen ska delas upp på flera sidor. Antal horisontella och vertikala sidor kan väljas oberoende. Sidinställning gjord för att få plats på flera sidor och fylla dem Till sist, när flera sidor används, kan du välja att låta delen av grafen på varje sida att fylla sin sida som ovan, och inte behålla proportionen, eller att behålla den. I det senare fallet fylls inte sidorna. Du kan ändra sidstorlek och marginaler: 12

13 Dialogrutan för sidstorlek och marginaler Du kan också ändra teckensnitt, sidhuvud och sidfot: Sidinställning gjord för att få plats på flera sidor utan sidhuvud och med ett annat teckensnitt 13

14 2.3 Anpassa KGraphViewer Sidan Utseende gör det möjligt att ändra den vanliga bakgrundsfärgen som används i KGraphViewer om en graf inte har sin egen bakgrundsfärg. Sida för att ändra en grafs utseende Sidan Tolkning gör det möjligt att välja ett externt kommando eller det interna biblioteket för att tolka Graphviz DOT-filer. Sida i inställningsdialogrutan för att ladda om filer ändrade på disk 14

15 Sidan Uppdatering låter dig ändra beteende hos KGraphViewer när en fil ändras på disk. Du kan välja en standardreaktion (automatisk inläsning eller inte) eller att bli tillfrågad varje gång. Sida i inställningsdialogrutan för att ladda om filer ändrade på disk Sidan Öppna låter dig ändra beteende hos KGraphViewer när en graffil öppnas utanför den nuvarande sessionen. Du kan välja en standardreaktion (öppna i befintligt fönster eller i ett nytt) eller att bli tillfrågad varje gång. Sida i inställningsdialogrutan för att öppna nya filer i befintligt fönster 15

16 Sidan Sessionshantering låter dig ändra beteende hos KGraphViewer när det startar. Du kan välja en standardreaktion (öppna filer från föregående session eller inte) eller att bli tillfrågad varje gång. Sida i inställningsdialogrutan för att öppna tidigare öppnade filer igen 2.4 Diverse funktioner Sammanhangsberoende menyn (som oftast erhålls genom att högerklicka i grafvyn) erbjuder några andra möjligheter: Layout Det här låter dig välja mellan diverse Graphviz layoutalgoritmer eller välja en egen. Alternativen, som de beskrivs på Graphviz hemsida, är följande: DOT Algoritmen DOT. Standardalternativ för riktade grafer. Den ritar hierarkiska bilder med lager av riktade grafer. Layoutalgoritmen riktar bågar åt samma håll (uppifrån och neråt, eller från vänster till höger) och försöker därefter undvika korsande bågar och reducera bågarnas längd. NEATO Algoritmen NEATO, standardalternativ för oriktade grafer. Gör en layout enligt fjädermodellen. Den använder Kamada-Kawai algoritmen, vilken är ekvivalent med statistisk flerdimensionell skalning. TWOPI Algoritmen TWOPI, för riktade och oriktade grafer. Radiell layout enligt Graham Wills 97. FDP Algoritmen FDP. För oriktade grafer. Gör en layout enligt fjädermodellen. Den implementerar den heuristiska metoden enligt Fruchterman-Reingold, inklusive en flerdimensionell rutnätslösning som hanterar stora grafer och oriktade grafer med anhopningar. 16

17 CIRCO Algoritmen CIRCO. Den skapar en cirkulär layout, enligt Six och Tollis 99, Kauffman och Wiese 02. Lämplig för vissa diagram med flera cykliska strukturer. Ange layoutkommando Öppnar en dialogruta som låter dig ange ett layoutkommando som körs i ett skal. Kommandot ska förvänta sig en parameter, som är grafens filnamn, och skriva ut layouten på standardutmatningen med språket xdot. På så sätt kan du till exempel ange särskilda väljare för ett av de tidigare kommandona eller använda ett filter som ändrar grafen innan den körs igenom DOT. Återställ layoutkommando till normalvärden Bestäm återigen grafens typ (riktad eller inte) och använd standardalgoritmen på den, för närvarande DOT respektive NEATO. Exportera graf Som bild... Möjliggör export av hela grafen till alla bildformat som stöds. Aktivera översiktsvy Om markerad, visas översiktsvyn om nödvändigt. Annars är den dold, och dess positioneringsmeny är inaktiverad. Översiktsvy Anpassa var översiktsvyn ska placeras i grafvyn. Möjliga val är: Uppe till vänster Placerar översiktsvyn i övre vänstra hörnet, Uppe till höger Placerar översiktsvyn i övre högra hörnet, Nere till vänster Placerar översiktsvyn i nedre vänstra hörnet, Nere till höger Placerar översiktsvyn i nedre högra hörnet, Automatisk Välj automatiskt bästa position för att dölja så litet som möjligt av grafen 17

18 Kapitel 3 Kommandoreferens 3.1 Menyerna i KGraphViewer Menyn Arkiv Arkiv Ny (Ctrl+N) Öppnar ett nytt KGraphViewer-fönster. Arkiv Öppna (Ctrl+O) Visar dialogrutan Öppna fil. Arkiv Öppna senaste Visar listan med de tio senast öppnade graffilerna. Arkiv Exportera graf Som bild... Möjliggör export av hela grafen till alla bildformat som stöds. Arkiv Skriv ut... (Ctrl+P) Skriver ut nuvarande graf med utskriftsparametrarna som för närvarande är inställda. Arkiv Förhandsgranska utskrift... (Ctrl+Skift+P) Öppnar fönstret för förhandsgranskning av utskrift för nuvarande graf. Arkiv Sidinställning Öppnar dialogrutan för sidinställning av utskrift för nuvarande graf. Arkiv Avsluta (Ctrl+Q) Avslutar KGraphViewer Menyn Visa Visa Zooma in (Ctrl++) Zooma in i nuvarande graf med 10 %. 18

19 Visa Zooma ut (Ctrl+-) Zooma ut i nuvarande graf med 10 %. Visa Visa igen Laddar om nuvarande graf. Visa Välj layoutalgoritm Visar en delmeny med diverse layoutalgoritmer från Graphviz för aktuell graf. Visa Aktivera översiktsvy (Ctrl+B) Om markerad, visas översiktsvyn om nödvändigt. Annars är den dold, och dess positioneringsmeny är inaktiverad. Visa Översiktsvy Anpassa var översiktsvyn ska placeras i grafvyn. Möjliga val är: Uppe till vänster Placerar översiktsvyn i övre vänstra hörnet, Uppe till höger Placerar översiktsvyn i övre högra hörnet, Nere till vänster Placerar översiktsvyn i nedre vänstra hörnet, Nere till höger Placerar översiktsvyn i nedre högra hörnet, Automatisk Välj automatiskt bästa position för att dölja så litet som möjligt av grafen Menyerna Inställningar och Hjälp KGraphViewer har de vanliga menyalternativen i KDE, Inställningar och Hjälp. För mer information läs avsnitten om Menyn Inställningar och Menyn Hjälp i KDE:s grunder. 3.2 Verktygsraderna i KGraphViewer Huvudverktygsraden Visar dialogrutan Öppna fil. Visar listan med senaste öppnade filer Visar dialogrutan Förhandsgranskning av utskrift. 19

20 3.2.2 Vyverktygsraden Redigerar layoutkommandot eller visar listan med förinställda layoutalgoritmer. Zooma in i nuvarande graf med 10 %. Zooma ut i nuvarande graf med 10 % Hjälpverktygsraden Visar muspekaren Vad är det här. Klicka med den på ett grafiskt element för att få hjälp med att använda det (om någon sådan hjälp finns tillgänglig). 20

21 Kapitel 4 Tack till och licens 4.1 Program Huvudsakliga upphovsmän Program copyright Gaël de Chalendar kleag@free.fr Bidragsgivare (kommer att kompletteras) Reimar Döffinger Reimar.Doeffinger@stud.uni-karlsruhe.de 4.2 Användarguide Dokumentation copyright 2006 Gaël de Chalendar kleag@free.fr Bidragsgivare Federico Zenith federico.zenith@member.fsf.org 4.3 Övriga erkännanden Kod från följande fri programvara har återanvänts i detta program: KCacheGrind Ursprunglig grafmodell och visningsklasser, Kexi Utskriftsinställning och förhandsgranskningsklasser. 21

22 4.4 Licenser Översättning Stefan Asserhäll Den här dokumentationen licensieras under villkoren i GNU Free Documentation License. Det här programmet licensieras under villkoren i GNU General Public License. 22