2.1 Huvudfönstret . . . 7
2.1.1 Flytta grafen inne i fönstret . . . 8
2.1.2 Zoomning . . . 8
2.1.3 Hantering av graffiler . . . 10
2.1.3.1 Filer ändrade på disk . . . 10
2.1.3.2 Filer och fönster . . . 10
2.1.3.3 Sessionshantering . . . 11
2.2 Utskrift av grafer . . . 11
2.3 Anpassa KGraphViewer . . . 14
2.4 Diverse funktioner . . . 16
3 Kommandoreferens 18 3.1 Menyerna i KGraphViewer . . . 18
3.1.1 Menyn Arkiv . . . 18
3.1.2 Menyn Visa . . . 18
3.1.3 Menyerna Inställningar och Hjälp . . . 19
3.2 Verktygsraderna i KGraphViewer . . . 19
3.2.1 Huvudverktygsraden . . . 19
3.2.2 Vyverktygsraden . . . 20
3.2.3 Hjälpverktygsraden . . . 20
4 Tack till och licens 21 4.1 Program . . . 21
4.1.1 Huvudsakliga upphovsmän . . . 21
4.1.2 Bidragsgivare (kommer att kompletteras) . . . 21
4.2 Användarguide . . . 21
4.2.1 Bidragsgivare . . . 21
4.3 Övriga erkännanden . . . 21
4.4 Licenser . . . 22
KDE-gemenskapen. Programmen iGraphviz ä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.
Kapitel 1
Inledning
KGraphViewer är ett grafvisningsverktyg avGraphvizDOT-grafer. Programmen iGraphvizä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ånGraphviz,
• 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 Graphviz- verktyget 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 1.36.
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 verktygs- raden 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:
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.
2.1.1 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.
2.1.2 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.
En graf med maximal inzoomningsnivå
Zoomning är begränsat till en faktor 10 i båda riktningar. Nedan kan du se den maximala zoom- faktorn för en graf.
En graf med maximal utzoomningsnivå
2.1.3 Hantering av graffiler
2.1.3.1 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 kom- ma 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 Avsnitt2.3.
2.1.3.2 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 in- ställningsdialogrutan.
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 ut- skriftsalternativen.
Dialogrutan för sidinställning
Du kan ställa in utskriftsalternativ för att exakt passa in grafen på en sida, som nedan:
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.
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
2.3 Anpassa KGraphViewer
Sidan Utseende gör det möjligt att ändra den vanliga bakgrundsfärgen som används i KGrap- hViewer 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 tolkaGraphvizDOT-filer.
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
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 diverseGraphvizlayoutalgoritmer eller välja en egen. Alter- nativen, som de beskrivs påGraphvizhemsida, ä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 im- plementerar den heuristiska metoden enligt Fruchterman-Reingold, inklusive en fler- dimensionell rutnätslösning som hanterar stora grafer och oriktade grafer med an-
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 positione- ringsmeny ä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
Kapitel 3
Kommandoreferens
3.1 Menyerna i KGraphViewer
3.1.1 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.
3.1.2 Menyn Visa
Visa → Zooma in (Ctrl++)
Visar en delmeny med diverse layoutalgoritmer frånGraphvizför aktuell graf.
Visa → Aktivera översiktsvy (Ctrl+B)
Om markerad, visas översiktsvyn om nödvändigt. Annars är den dold, och dess positione- ringsmeny ä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
3.1.3 Menyerna Inställningar och Hjälp
KGraphViewer har de vanliga menyalternativen i KDE, Inställningar och Hjälp. För mer infor- mation läs avsnitten omMenyn InställningarochMenyn Hjälpi KDE:s grunder.
3.2 Verktygsraderna i KGraphViewer
3.2.1 Huvudverktygsraden
Visar dialogrutan Öppna fil.
Visar listan med senaste öppnade filer
Visar dialogrutan Förhandsgranskning av utskrift.
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 %.
3.2.3 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).
Kapitel 4
Tack till och licens
4.1 Program
4.1.1 Huvudsakliga upphovsmän
Program copyright 2005-2006 Gaël de Chalendarkleag@free.fr
4.1.2 Bidragsgivare (kommer att kompletteras)
• Reimar DöffingerReimar.Doeffinger@stud.uni-karlsruhe.de
4.2 Användarguide
Dokumentation copyright 2006 Gaël de Chalendarkleag@free.fr
4.2.1 Bidragsgivare
• Federico Zenithfederico.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.
4.4 Licenser
Översättning Stefan Asserhällstefan.asserhall@bredband.net
Den här dokumentationen licensieras under villkoren iGNU Free Documentation License.
Det här programmet licensieras under villkoren iGNU General Public License.
