# Handbok &kgraphviewer;

Gaël
de Chalendar

    kleag@free.fr

Federico
Zenith

    federico.zenith@member.fsf.org

Stefan
Asserhäll

    stefan.asserhall@comhem.se

Översättare
2006
Gaël de Chalendar
&FDLNotice;
2006-10-22
1.0.3

&kgraphviewer; är en grafvisning av &graphviz; &dot;-grafer för KDE. Programmen i &graphviz; är fri programvara för layout av grafer. Grafer används vanligtvis i vetenskapliga sammanhang och i synnerhet inom datavetenskap. Ända tills nyligen saknades dock ett modernt grafiskt gränssnitt för att betrakta grafer. De som levereras med &graphviz; är enligt min mening föråldrade &X11;- eller &tcltk;-program med få funktioner.

&kgraphviewer;-projektet har som målsättning att ersätta dessa verktyg med ett modernt användarvänligt grafiskt gränssnitt med alla möjligheter hos ett välintegrerat &kde;-program.

KDE
kgraphviewer
graphviz
dot
neato
visning

## Inledning

&kgraphviewer; är en grafvisning av &graphviz; &dot;-grafer för &kde;. Programmen i &graphviz; är fri programvara för layout av grafer. &kgraphviewer; visar graferna i ett modernt användarvänligt grafiskt gränssnitt med alla möjligheter hos ett välintegrerat &kde;-program. Det har följande funktioner: Här är en skärmbild av &kgraphviewer; Huvudfönstret i &kgraphviewer; som visar ett av exemplen från &graphviz;

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

- Överföring till &kde; 4

- 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 &kate;s 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 &kgraphviewer;s 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),

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

Observera också att utskriftssystemet kommer från &koffice;-databasprogrammet &kexi;.

Annan programvara som krävs: &kgraphviewer; är ett &kde;-program som använder &graphviz;-verktyget &dot; för layout av grafer. Dess beroenden är:

- &qt;-biblioteket 3.x (3.3.6 eller senare för att undvika ett uppritningsfel),

- &kde;-biblioteken (paketet kdelibs), utvecklat och testat med version 3.5.2,

- &graphviz;-verktygen som externa program (testat med version 2.8),

- &boost; &spirit;-biblioteket (testat med version 0.32),

## Använda &kgraphviewer;

### 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
Det ursprungliga huvudfönstret när &kgraphviewer; startas för första gången

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
Huvudfönstret i &kgraphviewer; med flera öppna filer

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 &Shift;-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å
En graf med maximal inzoomningsnivå

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å
En graf med maximal utzoomningsnivå

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
Dialogruta för inläsning av en fil ändrad på disk

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 .

##### 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
Dialogrutan för att öppna ett nytt fönster

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.

##### 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
Dialogruta för inläsning av grafer från tidigare session vid start

Dialogruta för inläsning av grafer från tidigare session vid start

### Utskrift av grafer

Prova med knapparna Förhandsgranskning av utskrift eller Sidinställning för att utforska utskriftsalternativen.

Dialogrutan för sidinställning
Dialogrutan för sidinställning

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
Inställning av förhandsgranskning för att få plats på en sida

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
Sidinställning gjord för att få plats på flera sidor och fylla dem

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
Dialogrutan för 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
Sidinställning gjord för att få plats på flera sidor utan sidhuvud och med ett annat teckensnitt

Sidinställning gjord för att få plats på flera sidor utan sidhuvud och med ett annat teckensnitt

### Anpassa &kgraphviewer;

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
Sida i inställningsdialogrutan för att ladda om filer ändrade på disk

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
Sida i inställningsdialogrutan för att öppna nya filer i befintligt fönster

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
Sida i inställningsdialogrutan för att öppna tidigare öppnade filer igen

Sida i inställningsdialogrutan för att öppna tidigare öppnade filer igen

### 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 diagrammet till en &png;-bild.

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

## Kommandoreferens

### Menyerna i &kgraphviewer;

#### Menyn Arkiv

&Ctrl;O Arkiv Öppna

  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 diagrammet till en &png;-bild.

&Ctrl;P Arkiv Skriv ut...

  Skriver ut nuvarande graf med utskriftsparametrarna som för närvarande är inställda.

Arkiv Förhandsgranska utskrift...

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

&Ctrl;Q Arkiv Avsluta

  Avslutar &kgraphviewer;.

#### Menyn Visa

Visa Visa igen

  Laddar om nuvarande graf.

&Ctrl;+ Visa Zooma in

  Zooma in i nuvarande graf med 10 %.

&Ctrl;- Visa Zooma ut

  Zooma ut i nuvarande graf med 10 %.

&Ctrl;B Visa Aktivera översiktsvy

  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

#### Menyn Hjälp

&help.menu.documentation;

### Verktygsraderna i &kgraphviewer;

#### Huvudverktygsraden

  Visar dialogrutan Öppna fil.

  Visar listan med senaste öppnade filer

  Skriver ut grafen med nuvarande inställning.

  Visar dialogrutan Förhandsgranskning av utskrift.

  Visar dialogrutan Sidinställning.

#### Vyverktygsraden

  Laddar om nuvarande graf.

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

## Tack till och licens

### Program

#### Huvudsakliga upphovsmän

Program copyright 2005-2006 Gaël de Chalendar kleag@free.fr

#### Bidragsgivare (kommer att kompletteras)

- Reimar Döffinger Reimar.Doeffinger@stud.uni-karlsruhe.de

### Användarguide

Dokumentation copyright 2006 Gaël de Chalendar kleag@free.fr

#### Bidragsgivare

- Federico Zenith federico.zenith@member.fsf.org

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

Översättning Stefan Asserhäll stefan.asserhall@comhem.se

&underFDL; &underGPL;

## Installation

### Hur man skaffar &kgraphviewer;

&kgraphviewer; är en del av &kde; paketet extragear. Dess Subversion-arkiv finns på websvn.kde.org.

Oberoende utgåvor av &kgraphviewer; finns på &kgraphviewer;s hemsida

En lista med ändringar finns på följande sida och i filen `ChangeLog` i distributionsarkivets rotkatalog.

### Beroenden

&kgraphviewer; är ett &kde;-program som använder &graphviz;-verktyg för layout av grafer. Det kräver att följande program är installerade:

- &qt;-biblioteket 3.x (3.3.6 eller senare för att undvika ett uppritningsfel),

- &kde;-biblioteken (paketet kdelibs), utvecklat och testat med version 3.5.x,

- &graphviz;-verktygen (testat med versioner fram till 2.8),

- &boost; &spirit;-biblioteket (testat med version 0.32),

### Kompilering och installation

&install.compile.documentation;

### Anpassning

Inga särskilda inställningar är nödvändiga för att använda &kgraphviewer;. Se menyn Inställningar för ett antal olika inställningar.

&documentation.index;