Handbok KGraphViewer

# Handbok KGraphViewer

Gaël de Chalendar `<kleag@free.fr>`

Federico Zenith `<federico.zenith@member.fsf.org>`

Översättare: Stefan Asserhäll
Revision KGraphViewer 2.4.3 (2020-12-14)

Copyright © 2006 Gaël de Chalendar

Rättsligt Meddelande

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.

Kapitel 1. Inledning
Inledning

# 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,

- 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),

### Notera

Observera att programmet innehåller kod från GPL-verktyget KCacheGrind av Josef Weidendorfer, med hans tillstånd.

### Notera

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 KDE Ramverk-biblioteken version 5.x,

- Graphviz-verktygen som externa program (testat med version 2.8),

- Boost-biblioteket version 1.36.

Kapitel 2. Använda KGraphViewer
Använda KGraphViewer

# Kapitel 2. Använda KGraphViewer

## Huvudfönstret

Huvudfönstret visar inlästa 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... och (den tomma) Öppna senaste. 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.

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

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å

### 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 ”Anpassa KGraphViewer”.

#### 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 föregående alternativet kan du spara valet som förval och senare ändra det i inställningsdialogrutan.

#### 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

Utskrift av grafer
Utskrift av grafer

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

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:

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

Anpassa KGraphViewer
Anpassa KGraphViewer

## 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

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

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

Diverse funktioner
Diverse funktioner

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

  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

Kapitel 3. Kommandoreferens
Kommandoreferens

# Kapitel 3. Kommandoreferens

## 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 %.

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.

Verktygsraderna i KGraphViewer
Verktygsraderna i KGraphViewer

## Verktygsraderna i KGraphViewer

### Huvudverktygsraden

  Visar dialogrutan Öppna fil.

  Visar listan med senaste öppnade filer

  Visar dialogrutan Förhandsgranskning av utskrift.

### 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).

Kapitel 4. Tack till och licens
Tack till och licens

# Kapitel 4. Tack till och licens

## Program

### Huvudsakliga upphovsmän

Program copyright 2005-2006 Gaël de Chalendar `(kleag AT free.fr)`

### Bidragsgivare (kommer att kompletteras)

- Reimar Döffinger `(Reimar.Doeffinger AT stud.uni-karlsruhe.de)`

Användarguide
Användarguide

## Användarguide

Dokumentation copyright 2006 Gaël de Chalendar `(kleag AT free.fr)`

### Bidragsgivare

- Federico Zenith `(federico.zenith AT member.fsf.org)`

Övriga erkännanden
Övriga erkännanden

## Ö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.

Licenser
Licenser

## Licenser

Översättning Stefan Asserhäll `(stefan.asserhall AT bredband.net)`

Den här dokumentationen licensieras under villkoren i GNU Free Documentation License.

Det här programmet licensieras under villkoren i GNU General Public License.