# &kgraphviewer;i käsiraamat

Gaël
de Chalendar

    kleag@free.fr

Federico
Zenith

    zenith@chemeng.ntnu.no

Marek
Laane

    bald@starman.ee

Tõlge eesti keelde
2006
Gaël de Chalendar
&FDLNotice;
2006-10-22
1.0.3

&kgraphviewer; on &kde; &graphviz; &dot; graafide näitaja. &graphviz; programmid on graafide vabatarkvaralised esitusmootorid. Graafe kasutatakse laialdaselt teaduses, eriti arvutiteaduses. Seniajani on aga puudunud korralik kaasaegne &GUI; nende näitamiseks. Programmid, mis &graphviz;iga kaasnevad, on minu arvates iganenud ja üsna nappide võimalustega &X11; või &tcltk; rakendused.

&kgraphviewer; püüab sellised tööriistad asendada moodsa, kasutajasõbraliku &GUI;-ga, mis pakub kõiki võimalusi, mida ühel &kde; rakendusel on pakkuda.

KDE
kgraphviewer
graphviz
dot
neato
näitaja

## Sissejuhatus

&kgraphviewer; on &kde; &graphviz; &dot; graafide näitaja. &graphviz; programmid on graafide vabatarkvaralised esitusmootorid. &kgraphviewer; näitab graafe moodsa, kasutajasõbraliku &GUI; vahendusel, mis pakub kõiki võimalusi, mida ühel &kde; rakendusel on pakkuda. Rakenduse omadused on järgmised: &kgraphviewer;i pilt &kgraphviewer;i peaaken ühe &graphviz; näidisgraafiga

- Suurendamine

- Mitme graafi laadimine ühel ajal erinevatel kaartidel

- Viimati kasutatud failide meelespidamine

- Graafide ülevaaterežiim

- Graafi liigutamine hiirega

- Täielik trükkimise toetus

- Kõigi &graphviz; näidisgraafide täiuslik esitamine

- Sõlme- ja servavärvide ja kõigi sõlmekujude toetus

- Automaatne &dot; valimine orienteeritud ja &neato; valimine orienteerimata skeemide jaoks

- Muudetud failide käsitsi või automaatne taaslaadimine kasutaja kinnitust küsides (see on seadistatav)

- Rakenduse uute protsesside avamine olemasoleva protsessi raames uutel kaartidel (see on seadistatav)

- Abisüsteem

- Internatsionaliseerimine

Planeeritavad omadused:

- Port &kde; 4

- &qanava; teegi kasutamine graafide sisemise esituse toetamiseks

- Graafide seansi andmete salvestamine (kasutatud esitusprogramm, suurendustegur &etc;)

- Lõimimine &kate; ja &konqueror;iga (et näiteks muudatus &kate; graafivaates muudaks esitust ja laadiks faili uuesti ka &kgraphviewer;is)

- Menüükäsk faili avamiseks &kate;s või Kate komponendiga &kgraphviewer;i aknas

- Suurte ja hiigelsuurte graafide laadimine (praegu tekivad jõudlusprobleemid umbes 1000 sõlme puhul, mistõttu rakendus eirab üle määratud limiidi olevaid sõlmi)

- Üha põhjalikum &dot; atribuutide ja väärtuste toetus

- Esitamine taustal (eraldi lõim, mis ei blokeeri liidest ennast, edenemisriba).

Pane tähele, et programm sisaldab GPL-i all oleva tööriista &kcachegrind; koodi, mida on lubanud selle autor Josef Weidendorfer.

Pane tähele ka seda, et trükkimissüsteem on üle võetud &koffice;'i andmebaasirakendusest &kexi;.

Muu vajalik tarkvara: &kgraphviewer; on &kde; rakendus, mis kasutab graafide esitamiseks &graphviz; tööriista &dot;. Sõltuvused on järgmised:

- &qt; teek 3.x (joonistamisvea vältimiseks oleks vajalik 3.3.6 või uuem)

- &kde; teegid (pakett kdelibs); programm on arendatud ja testitud versiooniga 3.5.2

- &graphviz; tööriistad väliste programmidena (testitud versiooniga 2.8)

- &boost; &spirit; teek (testitud versiooniga 0.32)

## &kgraphviewer;i kasutamine

### Peaaken

Peaaken näitab igal kaardil laaditud graafi. Kui käivitada &kgraphviewer; ilma argumentideta, on aken esialgu tühi, nagu näha allpool oleval pildil. Sel juhul sisaldab tööriistariba ainult ikoone Ava fail ja (tühja) Viimati kasutatud failid. Esimesel klõpsates avatakse tavapärane faili avamise dialoog.

&kgraphviewer;i peaaken rakenduse esmakordsel avamisel
&kgraphviewer;i peaaken rakenduse esmakordsel avamisel

&kgraphviewer;i peaaken rakenduse esmakordsel avamisel

Pärast ühe või ka mitme &dot; faili valimist näeb peaaken välja nii:

&kgraphviewer;i peaaken mitme avatud failiga
&kgraphviewer;i peaaken mitme avatud failiga

&kgraphviewer;i peaaken mitme avatud failiga

Nagu näha, ilmub juhul, kui graaf on saadaolevast ruumist suurem, ühte nurka ülevaade. Kontekstimenüüst saab valida, kas selle parim asukoht määratakse automaatselt või asetatakse see mõnda sinu valitud asukohta.

#### Graafi liigutamine aknas

Graafi saab liigutada mitmel viisil:

- Klõpsates ja lohistades

- Kerimisribadega

- Nooleklahvidega

- Klõpsates ülevaates

- Hiirerattaga (üles ja alla ilma muuteklahvita, vasakule ja paremale klahviga &Alt;)

- Klõpsates ja lohistades ülevaates

#### Suurendamine

Suurendamiseks ja vähendamiseks võib kasutada tööriistariba nuppe ja või hoida hiirerattaga kerimisel all klahvi &Shift;. Suurendamise ajal muutub punane ristkülik ülevaates, mis näitab näidatavat ala, aina väiksemaks. Kui selle lühim külg on väiksem kui 10 pikslit, asendatakse ristkülik täidetud punase ristkülikuga, nagu näitab allpool toodud pilt.

Graaf maksimaalse suurendusega
Graaf maksimaalse suurendusega

Graaf maksimaalse suurendusega

Nii suurendamine kui ka vähendamine võib olla maksimaalselt kümnekordne. Maksimaalset vähendust näeb alloleval pildil.

Graaf maksimaalse vähendusega
Graaf maksimaalse vähendusega

Graaf maksimaalse vähendusega

#### Graafifailide käitlemine

##### Kettal muudetud failid

Kui mõni muu programm muudab &kgraphviewer;is avatud faili, näidatakse järgmist hoiatusdialoogi:

Kettal muudetud faili taaslaadimise dialoog
Kettal muudetud faili taaslaadimise dialoog

Kettal muudetud faili taaslaadimise dialoog

Dialoogis võib lasta graafi uuesti laadida või muudatusi eirata. Samuti võib lasta &kgraphviewer;il langetatud valiku meelde jätta, et samasuguse juhtumi korral langetataks uuesti samasugune valik. Kui soovid hiljem oma valikut muuta, vali Seadistused&kgraphviewer;i seadistamine. Täpsemalt kõnelb sellest .

##### Failid ja aknad

Graafifaili avamisel väljaspool töötavat &kgraphviewer;i protsessi, &eg; failisirvijas või käsureal, on võimalik lasta avada uus &kgraphviewer;i aken või avada uus kaart olemasolevas aknas. Seda saab teha allpool näidatud dialoogiga.

Uue akna avamise dialoog
Uue akna avamise dialoog

Uue akna avamise dialoog

Nagu eelmise dialoogi puhul, saab ka siin langetatud valiku vaikimisi valikuks muuta ning seda soovi korral hiljem seadistustedialoogis muuta.

##### Seansside käitlemine

Käivitamisel on võimalik avada uuesti graafid, mida vaatasid eelmisel korral. Ka siin on võimalik langetatud valik salvestada ja seda hiljem muuta.

Dialoog eelmise seansi graafi laadimiseks käivitamisel
Dialoog eelmise seansi graafi laadimiseks käivitamisel

Dialoog eelmise seansi graafi laadimiseks käivitamisel

### Graafi trükkimine

Trükkimisvõimalustega saab tutvuda dialoogide Trükkimise eelvaatlus ja Lehekülje seadistamine vahendusel.

Lehekülje seadistamise dialoog
Lehekülje seadistamise dialoog

Lehekülje seadistamise dialoog

Trükkimisvalikutega saab lasta graafi sobitada täpselt ühele lehele, nagu näitab allpool toodud pilt:

Lehekülje eelvaatlus ühele lehele trükitava graafiga
Lehekülje eelvaatlus ühele lehele trükitava graafiga

Lehekülje eelvaatlus ühele lehele trükitava graafiga

Samuti saab valida, kuidas graaf mitmele lehele jagada. Püstsuunas ja rõhtsuunas trükitavate lehekülgede arvu saab määrata teineteisest sõltumatult.

Lehekülje eelvaatlus mitmele lehele trükitava graafiga
Lehekülje eelvaatlus mitmele lehele trükitava graafiga

Lehekülje eelvaatlus mitmele lehele trükitava graafiga

Mitme lehekülje korral saab valida ka seda, kas graafi osa sobitatakse igale lehele (nagu ülal), määrates kindlaks, kas proportsioonidest peetakse kinni või mitte. Esimesel juhul ei üritata lehte võimalikult täielikult ära kasutada.

Võimalik on muuta lehtede suurust ja veeriseid:

Lehe suuruse ja veeriste dialoog
Lehe suuruse ja veeriste dialoog

Lehe suuruse ja veeriste dialoog

Samuti saab muuta fonti, päiseid ja jaluseid:

Lehekülje eelvaatlus mitmele lehele trükitava graafiga ilma päiseta ja teistsuguse fondiga
Lehekülje eelvaatlus mitmele lehele trükitava graafiga ilma päiseta ja teistsuguse fondiga

Lehekülje eelvaatlus mitmele lehele trükitava graafiga ilma päiseta ja teistsuguse fondiga

### &kgraphviewer;i seadistamine

Kaardil Taaslaadimine saab muuta &kgraphviewer;i käitumist juhul, kui faili on kettal muutnud mõni teine rakendus. Valida võib kas vaikimisi toimingu (automaatne taaslaadimine või muudatuste eiramine) või lasta iga kord küsida.

Seadistustedialoogi kaart kettal muudetud failide taaslaadimise seadistamiseks
Seadistustedialoogi kaart kettal muudetud failide taaslaadimise seadistamiseks

Seadistustedialoogi kaart kettal muudetud failide taaslaadimise seadistamiseks

Kaardil Avamine saab muuta &kgraphviewer;i käitumist juhul, kui graafifail avatakse väljaspool aktiivset seanssi. Valida võib kas vaikimisi toimingu (avamine olemasolevas või uues aknas) või lasta iga kord küsida.

Seadistustedialoogi kaart uute failide avamiseks olemasolevas aknas
Seadistustedialoogi kaart uute failide avamiseks olemasolevas aknas

Seadistustedialoogi kaart uute failide avamiseks olemasolevas aknas

Kaardil Seansihaldus saab muuta &kgraphviewer;i käitumist käivitumisel. Valida võib kas vaikimisi toimingu (eelmise seansi failide taasavamine või avamata jätmine) või lasta iga kord küsida.

Seadistustedialoogi kaart eelmise seansi failide taasavamiseks
Seadistustedialoogi kaart eelmise seansi failide taasavamiseks

Seadistustedialoogi kaart eelmise seansi failide taasavamiseks

### Muud funktsioonid

Kontekstimenüü, mille saab avada &HPNga; graafivaates klõpsates, on veel mõned valikud:

Esitus

  Siin saab valida erinevate &graphviz; esitusalgoritmide vahel või luua enda oma. Kirjed, nagu neid kirjeldab &graphviz; kodulehekülg, on järgmised:

  &dot;

    Orienteeritud graafide puhul vaikimisi kasutatav &dot; algoritm. See loob orienteeritud graafi hierarhilise ehk kihilise kujutise. Esitusalgoritm seab servad samas suunas (ülalt alla või vasakult paremale) ning püüab sealjuures vältida servade kattumist ning vähendada servade pikkust.

  &neato;

    Oreienteerimata graafie puhul vaikimisi kasutatav &neato; algoritm. See loob vedrumudeli. See kasutab Kamada-Kawai algoritmi, mis on samane statistilise mitmemõõtmelise skaleerimisega.

  &twopi;

    &twopi; algoritm nii orienteeritud kui ka orienteerimata graafidele. Radiaalne esitus, autor: Graham Wills, 1997.

  &fdp;

    &fdp; algoritm orienteerimata graafidele. See loob vedrumudeli. See kasutab Fruchtermani-Reingoldi heuristikat, kaasa arvatud multivõrklahendaja, mis suudab käitleda suuremaid graafe ja orienteerimata graafide kobaraid.

  &circo;

    &circo; algoritm. See loob ringikujulise esitus. Autorid: Six ja Tollis 1999, Kauffman ja Wiese 2002. Sobib paljude tsükliliste struktuuride skeemidele.

  Määra esituskäsk

    Aavb dialoogi, kus saab määrata shellis käivitatava esituskäsu. Käsk vajab üht parameetrit, nimelt graafifaili nime, ja kirjutab selle esituse standardväljundisse xdot-keeles. Sel moel võib anda mõnele varasemale käsule lisavõtmeid või rakendada graafi muutmiseks mingied filtreid, enne kui sellel &dot; käivitada.

  Lähtesta esituskäsk

    Määrab kindlaks graafi tüübi (orienteeritud või orienteerimata) ja rakendab sellele vaikimisi algoritmi (praegu vastavalt &dot; ja &neato;).

Graafiku eksport

  Pildina...

    Võimaldab eksportida terve graafi &png;-pildina.

Ülevaate lubamine

  Märkimise korral näidatakse ülevaade, kui selle järele on vajadus. Kui see on märkimata, on ülevaade peidetud ning selle paigutamise menüü kasutamatu.

Ülevaade

  Võimaldab määrata, kus peab asuma graafivaates ülevaade. Valikud on järgmised:

  Ülal vasakul

    Ülevaade paikneb ülemises vasakpoolses nurgas

  Ülal paremal

    Ülevaade paikneb ülemises parempoolses nurgas

  All vasakul

    Ülevaade paikneb alumises vasakpoolses nurgas

  All paremal

    Ülevaade paikneb alumises parempoolses nurgas

  Automaatne

    Ülevaatele valitakse automaatselt parim positsioon, kus ta varjab graafi minimaalselt.

## Käskude seletused

### &kgraphviewer;i menüüd

#### Menüü Fail

&Ctrl;O Fail Ava

  Avab faili avamise dialoogi.

Fail Ava viimati kasutatud

  Näitab kümne viimati avatud graafifaili nimekirja.

Fail Graafi eksport Pildina...

  Võimaldab eksportida terve graafi &png;-pildina.

&Ctrl;P Fail Trüki...

  Trükib aktiivse graafi kehtivate trükkimisseadistustega.

Fail Trükkimise eelvaatlus...

  Avab aktiivse graafi trükkimise eelvaatluse akna.

Fail Lehekülje paigutus

  Avab aktiivse graafi lehekülje paigutuse dialoogi.

&Ctrl;Q Fail Välju

  Väljub &kgraphviewer;ist.

#### Menüü Vaade

Vaade Laadi uuesti

  Laadib aktiivse graafi uuesti.

&Ctrl;+Vaade Suurenda

  Suurendab aktiivset graafi 10% võrra.

&Ctrl;-Vaade Vähenda

  Vähendab aktiivset graafi 10% võrra.

&Ctrl;B Vaade Ülevaate lubamine

  Märkimise korral näidatakse ülevaade, kui selle järele on vajadus. Kui see on märkimata, on ülevaade peidetud ning selle paigutamise menüü kasutamatu.

Vaade Ülevaade

  Võimaldab määrata, kus peab graafivaates asuma ülevaade. Valikud on järgmised:

  Ülal vasakul

    Ülevaade paikneb ülemises vasakpoolses nurgas

  Ülal paremal

    Ülevaade paikneb ülemises parempoolses nurgas

  All vasakul

    Ülevaade paikneb alumises vasakpoolses nurgas

  All paremal

    Ülevaade paikneb alumises parempoolses nurgas

  Automaatne

    Ülevaatele valitakse automaatselt parim positsioon, kus ta varjab graafi minimaalselt.

#### Menüü Abi

&help.menu.documentation;

### &kgraphviewer;i tööriistaribad

#### Peamine tööriistariba

  Avab faili avamise dialoog.

  Näitab viimati avatud failide nimekirja.

  Trükib graafi kehtivate seadistustega.

  Avab trükkimise eelvaatluse dialoog.

  Avab lehekülje paigutuse dialoogi.

#### Vaateriba

  Laadib aktiivse graafi uuesti.

  Muudab esituskäsku või näitab olemasolevate esitusalgoritmide nimekirja.

  Suurendab aktiivset graafi 10% võrra.

  Vähendab aktiivset graafi 10% võrra.

#### Abiriba

  Lülitab sisse Mis see on? hiirekursori. Sellega &GUI;-s klõpsates näidatakse vastava elemendi abiinfot (kui see on olemas).

## Autorid ja litsents

### Rakendus

#### Põhiautorid

Rakenduse autoriõigus 2005-2006: Gaël de Chalendar kleag@free.fr

#### Kaasautorid (pole täielik)

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

### Kasutaja käsiraamat

Dokumentatsiooni autoriõigus 2006: Gaël de Chalendar kleag@free.fr

#### Kaasautorid

- Federico Zenith zenith@chemeng.ntnu.no

### Muu tunnustus

Käesolev rakendus sisaldab järgmiste vaba tarkvara projektide koodi:

&kcachegrind;

  Esialgne graafimudel ja vaateklassid

&kexi;

  Trükkimise seadistamine ja eelvaatlus.

### Litsentsid

Tõlge eesti keelde: Marek Laane bald@starman.ee

&underFDL; &underGPL;

## Paigaldamine

### &kgraphviewer;i hankimine

&kgraphviewer; kuulub &kde; paketti extragear. Selle Subversioni hoidla leiab aadressil websvn.kde.org.

&kgraphviewer;i sõltumatuid väljalaskeid leiab &kgraphviewer;i koduleheküljelt.

Muudatuste nimekirja leiab siit ja failist `ChangeLog` tarkvarapaketis.

### Sõltuvused

&kgraphviewer; on &kde; rakendus, mis kasutab graafide esitamiseks &graphviz; tööriistu. Paigaldatud peavad olema järgmised programmid:

- &qt; teegid 3.x (joonistamisvea vältimiseks 3.3.6 või uuem)

- &kde; teegid (arendatud ja testitud versiooniga 3.5.x)

- &graphviz; tööriistad (testitud versioonidega kuni 2.8)

- &boost; &spirit; teek (testitud versiooniga 0.32)

### Kompileerimine ja paigaldamine

&install.compile.documentation;

### Seadistamine

&kgraphviewer; ei vaja erilisi seadistusi. Mõningate valikute kohta vaata menüüd Seadistused.

&documentation.index;