<chapter id="tutorial">

<chapterinfo>
<authorgroup>
<author
><firstname
>Barth</firstname
> <othername
></othername
> <surname
>Netterfield</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
<author
><firstname
>Rick</firstname
> <othername
></othername
> <surname
>Chern</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
</authorgroup>



<copyright>
<year
>2004</year>
<holder
>Briti Columbia ülikool</holder>
</copyright>



</chapterinfo>
<title
>&kst; algtutvustus</title>



<sect1 id="Welcome">
<title
>Tere tulemast!</title>
<para
>Tere tulemast! Sind tervitab &kst;. Veel mõni minut ja sa oled teel meie suurepärase andmete joonistamise ja töötlemise rakenduse maailma. Kõigepealt mõned asjad, mida &kst; võimaldab sul teha: </para>

<itemizedlist>
<listitem>
<para
>Joonistada kiiresti kas või mitu graafikut korraga isegi käsurealt. </para>
</listitem>
<listitem>
<para
>Analüüsida andmeid arvukate abivahenditega, sealhulgas histogrammid, jõuspektrid ja isetehtud võrrandid. </para>
</listitem>
<listitem>
<para
>Jooniste huvipakkuvate piirkondade sujuv suurendamine ja vähendamine kas hiirega või klaviatuuri abil. </para>
</listitem>
<listitem>
<para
>Reaalaja andmete jälgimine tänu &kst; reaalajas jooniste loomise võimele. </para>
</listitem>
</itemizedlist>
<para
>Käesolev algtutvustus käsitleb &kst; paigaldamise, käivitamise ja kasutamise põhialuseid. See põhineb Barth Netterfieldi kirjutatud &kst; sissejuhatusele. Kõiki siin kirjeldatud võimalusi on põhjalikumalt käsitletud ülejäänud käsiraamatus.</para>

</sect1>

<sect1 id="commandline">
<title
>&kst; käivitamine käsurealt</title>
<para
>&kst; kõige tüüpilisem kasutamisviis on andmejooniste kiire loomine käsurealt. See jooniste loomise viis võimaldab peaaegu unustada, et &kst; pakub ka graafilist kasutajaliidest, lubades ometi saada vajalikke tulemusi välkkiirelt. </para>

<para
>See sissejuhatus kasutab näidisandmefaile, mis paigaldatakse koos &kst;'ga kataloogi <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/apps/kst/tutorial</filename
>, kus <filename class="directory"
>$<envar
>KDEDIR</envar
></filename
> on &kde; paigalduse asukoht sinu süsteemis (selle saad leida kasutades käsku <command
>kde-config --prefix</command
>).</para>

<note
><para
>Kui sinu käsutuses olev &kst; on väiksema versiooninumbriga kui 1.1.10, leiad andmefailid aadressilt <ulink url="http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz"
>http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz</ulink
>. Tõmba see enda arvutisse, paki lahti ning liigu saadud kataloogi: <screen
><userinput
><command
>tar -zxvf kst_tutorialdata.tgz</command>
<command
>cd kst_tutorialdata</command
></userinput
></screen>

</para>
</note>

<para
>Kõigi &kst; võimalike käsureavõtmetega tutvumiseks anna käsk: <screen
><userinput
><command
>kst --help</command
></userinput
></screen>
</para>
<para
>Süntaksikirjeldus ja käskude nimekiri peaks välja nägema umbes nii: <screen
>Kasutusviis: kst [Qt-võtmed] [KDE-võtmed] [võtmed] [Failid]

Kst: andmete visuaalse esitamise rakendus.

Üldised võtmed:
  --help                    abiinfo võtmete kohta
  --help-qt                 Qt spetsiifilised võtmed
  --help-kde                KDE spetsiifilised võtmed
  --help-all                kõik võtmed
  --author                  info autori(te) kohta
  -v, --version             versiooniinfo
  --license                 litsentsiinfo
  --                        võtmete lõpp

Võtmed:
  -F &lt;andmefail&gt;            Määrab andmefaili, kasutatakse Kst faili vaikeväärtuste tühistamiseks [|]
  -y &lt;Y&gt;                    Väli Y-teljele (võib anda mitu korda)
  --ye &lt;võrrand&gt;            Võrrand Y-teljele (võib anda mitu korda)
  -e &lt;E&gt;                    Väli Y vigadele (võib anda mitu korda)
  -x &lt;X&gt;                    Väli või vahemik X-teljele [INDEX]
  --xe &lt;X&gt;                  X vektor võrrandile x0:x1:n [INDEX]
  -p &lt;Y&gt;                    Väli jõuspektrile (võib anda mitu korda)
  -h &lt;Y&gt;                    Väli histogrammile (võib anda mitu korda)
  -r &lt;f&gt;                    Jõuspektri valimi samm [60.0]
  --ru &lt;U&gt;                  PSD valimi sammu ühikud [Hz]
  --yu &lt;U&gt;                  Y vektorite ühikud [V]
  -l &lt;P&gt;                    FFT pikkus on 2^P [10]
  -f &lt;F0&gt;                   Esimene loetav kaader [-2]
  -n &lt;NS&gt;                   Loetavate kaadrite arv [-2]
  -s &lt;NS&gt;                   Igal lugemisel vahele jäetavate kaadrite arv [-1]
  -a                        Liikuva keskmise filtri rakendamine enne kaadrite vahelejätmist
  -m &lt;NC&gt;                   Eraldi joonised &lt;NC&gt; veergudesse korraldatult
  -d                        Kõverate asemel punktide näitamine
  -g                        Luuakse legendikast
  --print &lt;fail&gt;            Salvestab faili ja lõpetab [&lt;puudub&gt;]
  --png &lt;fail&gt;              Salvestab png-faili ja lõpetab [&lt;puudub&gt;]

Argumendid:
  Failid                    Andmefailid (kui on antud -y) või *.kst fail
</screen>
</para>

<para
>&kst; spetsiifilised võtmed on kirjas osas <literal
>Võtmed:</literal
>. Kui võimalik, näidatakse vaikeväärtusi nurksulgudes pärast võtme kirjeldust &mdash; neid väärtusi kasutatakse ka täpsustamata võtmete korral. </para>

<para
>Vaatame esmalt demopaketis leiduvat ASCII faili <filename
>gyrodata.dat</filename
>. ASCII failid on üks paljudest failitüüpidest, mida &kst; lugeda oskab. ASCII failides on andmed korraldatud veergudesse, kus iga veerg vastab väljale ning veerunumbrid (1 on kõige vasakpoolsem veerg) väljanimedele. Antud ASCII failis on 3 veergu ja sestap on väljanimed 1, 2 ja 3. Esimese veeru joonise loomiseks anna lihtsalt korraldus: <screen
><userinput
><command
>kst -y 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>Joonistatakse kõik esimese veeru andmed: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro1.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
<para
>Pane tähele, et joonise X-teljele välja ei määratud, mistõttu &kst; kasutas oodatult vaikimisi indeksivektorit. Indeksivektor on &kst; eriline vektor, mis sisaldab täisarve 0 kuni N-1, kus N on andmeväärtuse arv vastavas Y-telje vektoris. Sulge &kst; käsuga <guimenuitem
>Välju</guimenuitem
>, mille leiad menüüst <guimenu
>Fail</guimenu
>, või kiirklahviga <keycombo action="simul"
><keycap
>Ctrl</keycap
><keycap
>Q</keycap
></keycombo
>. </para>

<para
><filename
>gyrodata.dat</filename
> sisaldab 20 000 kaadrit, mistõttu võib juhtuda, et sulle pakuvad huvi ainult teatud andmed. Vaid 10 000 kaadri joonistamiseks alates kaadrist 7000 anna korraldus: <screen
><userinput
><command
>kst -y 1 -f 7000 -n 10000 gyrodata.dat</command
></userinput
></screen>

</para>

<para
>&kst; üks tugevamaid külgi on joonistada reaalaja andmeid. Oletame, et faili <filename
>gyrodata.dat</filename
> lõppu lisatakse pidevalt uusi andmeid. Sellisel juhul võib olla mõttekas lasta joonistada ainult uuemaid andmeid. Vaid faili <filename
>gyrodata.dat</filename
> viimase 10 000 kaadri joonistamiseks anna korraldus: <screen
><userinput
><command
>kst -y 1 -n 10000 gyrodata.dat</command
></userinput
></screen>
</para>
<para
>Kui faili <filename
>gyrodata.dat</filename
> uuendatakse, muutub ka joonis, kujutades alati vaid 10 000 viimast kaadrit. </para>

<para
>&kst; ei pea andmeid otse sisendfailist lugema, vaid võib andmeallikana kasutada ka standardsisendist hangitavaid ASCII andmeid. Standardsisendi (stdin) määramiseks sisendiks lisa lihtsalt <filename
>stdin</filename
> ühe failinimena. Nii avaneb tegelikult päris palju võimalusi, näiteks saab &kst;-d kasutada ühe osana arvukas protsessidejadas: <screen
><userinput
><command
>cat gyrodata.dat | awk '{print $1 + 2}' | kst -y 1 stdin</command
></userinput
></screen>
</para>
<para
>Toodud käsk kasutab programmi <command
>awk</command
> 2 liitmiseks faili <filename
>gyrodata.dat</filename
> esimesele veerule, enne kui saata tulemus &kst;-le. </para>

<para
>Pane tähele, et võtme <option
>y</option
> kirjelduse kohaselt on lubatud seda ka mitu korda kasutada. See võimaldab kiiresti joonistada enam kui ühe kõvera või isegi joonise. Faili <filename
>gyrodata.dat</filename
> kõigi kolme välja joonistamiseks eraldi joonistel anna korraldus: <screen
><userinput
><command
>kst -y 1 -y 2 -y 3 -m 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>Võti <option
>m</option
> määrab, et ühe joonise asemel tuleb kasutada eraldi jooniseid, nagu näha allpool: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro-multiple.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="datawizard-tour">
<title
>Andmenõustaja kiirülevaade</title>
<para
>Kuigi &kst; kasutamine käsurealt on kiire ja mugav, võib tekkida olukordi, kus andmete import on hõlpsam graafilise kasutajaliidesega &mdash; näiteks kui oled juba &kst; avanud muude andmetega. Aga sulle võib ka lihtsalt meeldida graafiline kasutajaliides... Igatahes on mõlema võimalusega kursisolek kindel tee &kst; võimalikult tõhusaks kasutamiseks. </para>

<para
>Andmenõustaja võimaldab kiiresti ja hõlpsalt andmefailide põhjal luua vektoreid, kõveraid ja jooniseid. Nõustaja käivitamiseks vali käsk <guimenuitem
>Andmenõustaja...</guimenuitem
> menüüst <guimenu
>Andmed</guimenu
> või klõpsa tööriistaribal nupule <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-datawizard.png" format="PNG"/></imageobject
></inlinemediaobject
>. Seejärel palutakse sul valida andmeallikas. Otsi üles meie käsureanäidetes pruugitud fail <filename
>gyrodata.dat</filename
> ning klõpsa nupule <guibutton
>Järgmine</guibutton
>. Ilmub selline aken: </para>

<screenshot>
<screeninfo
>Andmenõustaja teine aken</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Andmenõustaja teine aken</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Faili <filename
>gyrodata.dat</filename
> väljad on ära toodud vasakul. Väljaloendit saab filtreerida loendi kohal olevasse tekstikasti vajalikku stringi sisestades (lubatud on ka metamärgid, näiteks <literal
>*</literal
>). Märgi väljad <guilabel
>1</guilabel
>, <guilabel
>2</guilabel
> ja <guilabel
>3</guilabel
>. </para>

<para
>Sektsioonis <guilabel
>Andmevahemik</guilabel
> saab määrata andmete vahemiku, mida sisendfaili valitud vektoritest loetakse. Me oletame siinkohal, et sa juba tead, mida tähendab <quote
>kaader</quote
>. Väga lühidalt öeldes on kaader lihtsalt andmevalimite kogum ning iga andmefail koosnebki kaadritest. Täpsemalt tutvustab seda aga <xref linkend="supportingadditionalfileformatsdatasourceconceptsframes"/>. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Algus</guilabel
>, <guilabel
>Arvestamine lõpust</guilabel
>, <guilabel
>Vahemik</guilabel
> ja <guilabel
>Lugemine lõpuni</guilabel
> </term>
<listitem>
<para
>Nende nelja võimalusega saab määrata andmevahemiku alumise ja ülemise raja. Näiteks ainult faili viimase 10 000 kaadri lugemiseks vali <guilabel
>Arvestamine lõpust</guilabel
> ning anna <guilabel
>Vahemiku</guilabel
> väärtuseks <userinput
>10000</userinput
>. Kui faili <filename
>gyrodata.dat</filename
> uuendatakse reaalajas, loetakse ka faili lõppu lisatavaid uusi andmeid. </para>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Loetakse 1 valim N kaadri kohta</guilabel
> ja <guilabel
>Eelnevalt rakendatakse liikuva keskmise filtrit</guilabel
> </term>
<listitem>
<para
>Lisaks vahemiku ülemisele ja alumisele rajale saab määrata ka seda, mitu valimit antud vahemikust loetakse. Kui <guilabel
>Loetakse 1 valim N kaadri kohta</guilabel
> (kus N on sisestatud väärtus) on märkimata, loetakse antud vahemikus kõik valimid. Kui aga valida <guilabel
>Loetakse 1 valim N kaadri kohta</guilabel
>, saab osa andmefaili kaadreid vahele jätta. Praegu jäta <guilabel
>Loetakse 1 valim N kaadri kohta</guilabel
> valimata. </para>
</listitem>
</varlistentry>
</variablelist>

<para
>Jõuspektri ja X-telje seadistusi saab määrata osas <guilabel
>Joonise tüübid</guilabel
>. </para>

<variablelist>

<varlistentry>
<term
><guilabel
>XY</guilabel
>, <guilabel
>Jõuspekter</guilabel
> ja <guilabel
>XY ja jõuspekter</guilabel
> </term>
<listitem>
<para
>Vali <guilabel
>XY ja jõuspekter</guilabel
> nii andmeid kui selle jõuspektrit sisaldavate jooniste loomiseks. Jõuspektri valikute kohta rohkema info saamiseks vaata <xref linkend="power-spectra"/>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>X-telje vektor</guilabel>
</term>
<listitem>
<para
>Seda vektorit kasutatakse joonistel sõltumatu vektorina. Võid valida välja oma andmefailist või indeksivektori. Et <filename
>gyrodata.dat</filename
> ei sisalda X-telje vektorit, vali INDEX. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Sektsiooni <guilabel
>Joonise tüübid</guilabel
> alamsektsiooni <guilabel
>FFT valikud</guilabel
> saab kasutada ainult sel juhul, kui jõuspekter lastakse joonistada. Siinses algtutvustuses ei hakka me jõuspektri üksikasjadega tegelema, nii et jäta siin kehtima vaikimisi määratud valikud. </para>

<para
>Kui oled kõik vajaliku määranud, klõpsa järgmisesse aknasse liikumiseks nupule <guibutton
>Järgmine</guibutton
>. </para>

<screenshot>
<screeninfo
>Andmenõustaja kolmas aken</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard3.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Andmenõustaja kolmas aken</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Siin saab muuta joonise üldisi omadusi. Enamik neist peaks olema mõistetavad ka ilma seletuseta. Vali <guilabel
>1 uus joonis kõvera kohta</guilabel
> sektsioonis <guilabel
>Kõvera paigutus</guilabel
> ning <guilabel
>Uues aknas</guilabel
> sektsioonis <guilabel
>Joonise paigutus</guilabel
>. Nii asetatakse kõik kuus joonist (kolm kõverat ja kolm jõuspektrit) ühte aknasse. </para>


<para
>Kui oled kõik valikud langetanud, klõpsa nupule <guibutton
>Lõpeta</guibutton
> ning joonised tekitataksegi: </para>
<screenshot>
<screeninfo
>Loodud joonised</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-datawizard-done.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Loodud joonised</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Me kulutasime nende jooniste loomisele päris hulga vaeva, nii et nüüd tasuks &kst; seanss (millest tuleb juttu järgmises osas) ka Vali selleks käsk <guimenuitem
>Salvesta kui...</guimenuitem
>, mille leiad menüüst <guimenu
>Fail</guimenu
> ja salvesta seanss nimega <filename
>minukstseanss.kst</filename
>: </para>

<screenshot>
<screeninfo
>KST seansi salvestamine</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-filesave.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>KST seansi salvestamine</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>&kst; seansi salvestamine salvestab kõik joonised, andmeobjektid (nendega teeme tutvust hiljem) ja paigutused, mis salvestamise ajal eksisteerivad. </para>
<para
>Kui fail on salvestatud, võid &kst; sulgeda. </para>
</sect1>

<sect1 id="mousezooming">
<title
>Jooniste kasutamise põhialused</title>
<para
>Nüüd, kus oled veidi tutvunud jooniste loomisega &kst;-s, vaatame põgusalt &kst; graafilise kasutajaliidese pakutavaid jooniste käsitlemise võimalusi. Käivita &kst; käsurealt eelnevalt salvestatud failiga <filename
>minukstseanss.kst</filename
>: </para>
<screen
><userinput
><command
>kst minukstseanss.kst</command
></userinput
></screen>
<para
>&kst; avab nüüd kõik varem loodud joonised. Võtame ette joonise, mille Y-telje pealdiseks on <literal
>PSD [V/Hz^{1/2}]</literal
>. Joonise täpsemaks uurimiseks tee sellele hiire parema nupuga klõps ja vali ilmuvast hüpikmenüüst käsk <guimenuitem
>Maksimeeri</guimenuitem
>, nagu näitab järgmine joonis: </para>
<screenshot>
<screeninfo
>Joonise maksimeerimine</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-zoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Joonise maksimeerimine</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Joonis on nüüd aknas maksimeeritud. Kindlasti märkad, et suuremate x väärtuste korral on joonis praktiliselt sirge, nii et tegelikult tasuks üldse vaadata ainult seda joonise osa, kus tõesti on midagi vaadata. Selleks veendu, et sisse oleks lülitatud XY hiiresuurendus (vali <guimenuitem
>XY hiiresuurendus</guimenuitem
> menüüst <guimenu
>Joonised</guimenu
> või klõpsa tööriistaribal nupule <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xymousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
>). Seejärel lohista hiirega ristkülik koordinaadist (4, 0,025) kuni koordinaadini (0,0), nagu näha pildil. Pane tähele, et hiirekursori koordinaate näeb &kst; akna alumises paremas nurgas (kui neid seal näha ei ole, kontrolli, et võimalus <guimenuitem
>Olekuriba näitamine</guimenuitem
> menüüs <guimenu
>Seadistused</guimenu
> oleks sisse lülitatud). </para>

<para
>Joonise teljed muutuvad ning <quote
>suurenevad</quote
> valitud joonise alal. Küllap märkad, et jõuspektri vasakus servas on tipp, mis väljub Y-telje uuest ülemisest rajast. Oletame, et soovid näha tipu ülaosa. Klõpsa joonisel hiire parema nupuga ja vali kirje <guimenu
>Keri</guimenu
> alammenüüst <guimenuitem
>Üles</guimenuitem
>. Joonis peaks nüüd ülespoole kerima. Tegelikult on muidugi veel lihtsam kasutada vastava menüükirjega seotud kiirklahvi, mis on olemas kõigil suurendus- ja kerimisvõimalustel. Antud juhul on kiirklahv <keysym
>Nool üles</keysym
> ning hõlpsaim viis joonist ülespoole kerida ongi hoida all klahvi <keysym
>Nool üles</keysym
>. Maksimaalse suurenduse saab mis tahes hetkel sisse lülitada joonisele hiire parema nupuga klõpsates ja kirje <guisubmenu
>Suurenda</guisubmenu
> alammenüüst <guimenuitem
>Suurenda maksimumini</guimenuitem
> valides (sama teeb klahvi <keycap
>M</keycap
> vajutamine, mis on seotud toiminguga <guimenuitem
>Suurenda maksimumini</guimenuitem
>). </para>

<para
>Jõuspektri joonise esialgse suuruse saab taastada hiire parema nupuga joonisele klõpsates ja kirje <guimenuitem
>Maksimeeri</guimenuitem
> eest märget eemaldades. </para>

<para
>Nüüd vaatame jooniseid, mille Y-telgede pealdisteks on <literal
>Column 2</literal
> ja <literal
>Column 3</literal
>. Need on vastavalt 1998. aasta BOOMERANGi lennu pikikalde- ja külgkaldegüroskoop. Kuna need joonised on omavahel seotud, on mõttekas neid üheskoos suurendada ja kerida. Klõpsa mõlemal joonisel ülal paremal nurgas asuvale ruudukesele. Need muutuvad tumedaks, mis annab märku, et kaks joonist on nüüd omavahel seotud: </para>

<screenshot>
<screeninfo
>Seotud suurendus</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tiedzoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Seotud suurendus</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Enne suurendama asumist tuleks kustutada kõik joonised peale nende kahe, mida me kasutada sovime. Vali <guimenuitem
>Paigutusrežiim</guimenuitem
> menüüst <guimenu
>Joonised</guimenu
> või klõpsa tööriistaribal nupule <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-layoutmode.png" format="PNG"/></imageobject
></inlinemediaobject
>. Klõpsa kõigil muudel joonistel ja vali <guimenuitem
>Kustuta</guimenuitem
>. Nüüd klõpsa aknas hiire parema nupuga ja vali <guimenuitem
>Puhasta paigutus</guimenuitem
>. Meie kaks joonist peaks seejärel hõlmama aknas maksimaalse ruumi. Kui oled sellega valmis, mine tagasi XY hiiresuurenduse režiimi. </para>

<para
>Nüüd proovi suurendada ülemise joonis mis tahes osa. Märkad, et alumine joonis äkitselt tühjeneb. Põhjuseks on see, et alumise joonise teljed muutusid vastavalt ülemise joonise telgedele, alumise joonise nähtavaks jäänud osas aga pole midagi, mida me võiks kuidagi jälgida. Vii hiirekursor ükspuha kumba joonise kohale ja vajuta klahvi <keycap
>M</keycap
>, millega taastatakse mõlema joonise maksimaalne suurendus. Nüüd vajuta alla klahv <keycap
> Ctrl</keycap
> (see võrdub <guimenu
>X hiiresuurendus</guimenu
> valimisega menüüst <guimenu
>Joonised</guimenu
> või klõpsuga tööriistariba nupule <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xmousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
>). Hiirekursori muutumine näitab erinevaid režiime. Klahvi <keycap
>Ctrl</keycap
> all hoides lohista hiirega ülemisel joonisel ristkülik. Pane tähele, et ristküliku kõrgus on piiratud, nii et suurendada saab ainult X-telge. Nüüd näitavad mõlemad joonised suurendamisel andmeid, sest kumbkil ei muudeta Y-telge. </para>
<tip>
<para
>Jooniseid saab kiiresti siduda või seose kaotada käsuga <guimenuitem
>Seotud suurendus</guimenuitem
>, mille leiab menüüst <guimenu
>Joonised</guimenu
> või klõpsuga tööriistariba nupule <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-tiedzoom.png" format="PNG"/></imageobject
></inlinemediaobject
>. </para>
</tip>
<para
>Kui oled suurendamiskatsetused lõpetanud, võid &kst; sulgeda. Seekord pole vaja jooniseid salvestada (kui sa seda just kogu hingest taas ei soovi teha...). </para>

</sect1>



<sect1 id="overviewdataobjects">
<title
>Lühiülevaade andmeobjektidest</title>
<para
>&kst; ei tähenda mõistagi lihtsalt ja ainult andmete joonistamise ja vaatamise võimalust. Andmenõustajas võis juba näha, et &kst; suudab luua ka näiteks jõuspektreid. Tegelikult võib &kst; luua muidki andmeobjekte: histogrammid, võrrandid, pluginad. Kõigil loodud andmeobjektidel aitab silma peal hoida andmehaldur. </para>

<para
>Käivita &kst; demopaketti kuuluva failiga <filename
>demo.kst</filename
>: </para>
<screen
><userinput
><command
>kst demo.kst</command
></userinput
></screen>
<screenshot>
<screeninfo
>Kst failiga demo.kst</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-demo.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Kst failiga demo.kst</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>See &kst; seanss sisaldab vektoreid ja muid failis <filename
>gyrodata.dat</filename
> leiduvate andmete põhjal loodud andmeobjekte. Ülemine joonis sisaldab asimuudiandmeid, keskmine pikikaldeandmeid ja alumine pikikaldeandmete jõuspektrit. Vaatame nüüd jooniseid lähemalt. Seo kaks ülemist joonist omavahel eelmises osas näidatud viisil. Nüüd hoia X hiiresuurenduse režiimi minekuks all klahvi <keycap
>Ctrl</keycap
>. Seejärel suurenda ülemisel joonisel mingi väike osa (näiteks 50000 kuni 53000), mis paneb mõlemad seotud joonised suurenema. Märkad, et sinine pikikaldekõver on punase asimuudikõveraga negatiivses korrelatsioonis. Põhjuseks on see, et pikikaldegüroskoop oli asimuuditelje suhtes veidi pööratud (-0,69 kraadi). Õige pikikalle <literal
>p'</literal
> on: <informalequation
> <mediaobject
> <imageobject
> <imagedata fileref="Equation-kst-correctedpitch.png" format="PNG"/> </imageobject
> </mediaobject
> </informalequation
>, kus <literal
>p</literal
> on esialgne kalle, <inlinemediaobject
><imageobject
><imagedata fileref="Symbol-kst-theta.png" format="PNG"/></imageobject
></inlinemediaobject
> pikikaldegüroskoobi kõrvalekalle asimuuditelje suhtes ja <literal
>a</literal
> on asimuut. <literal
>p'</literal
> on must kõver keskmisel joonisel. <literal
>p'</literal
> jõuspekter on must kõver alumisel joonisel. </para>

<para
>Vaatame nüüd, kuidas need kolm joonist luuakse. Andmehalduri avamiseks vali käsk <guimenuitem
>Andmehaldur...</guimenuitem
> menüüst <guimenu
>Andmed</guimenu
> või klõpsa tööriistaribal nupule <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-datamanager.png" format="PNG"/></imageobject
></inlinemediaobject
>: </para>
<screenshot>
<screeninfo
>Andmehaldur</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datamanager.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Andmehaldur</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Andmehaldur sisaldab kõigi &kst; aktiivse seansi andmeobjektide nimekirja. Siin saab neid ka muuta või luua uusi andmeobjekte. Nagu näed, on kirjas kolm kõverat (igaüks loodud vektoripaari põhjal), üks võrrand, kaks jõuspektrit ja neli andmevektorit. Klõpsa hiire parema nupuga C2-GY_PITCH peal ja vali kirje <guisubmenu
>Eemalda jooniselt</guisubmenu
> alammenüüst <guimenuitem
>W1-P1</guimenuitem
>. Sellega eemaldatakse kõver jooniselt P1 aknas W1. Eemalda samasuguse operatsiooniga ka C-PSD2-V3-GY_PITCH jooniselt P3 aknas W1. Nüüd peaks joonistel olema näha ainult korrigeeritud kõverad: </para>

<screenshot>
<screeninfo
>Ainult korrigeeritud kõverad</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-democorrected.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ainult korrigeeritud kõverad</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Nägemaks, kuidas luuakse korrigeeritud pikikaldegüroskoop, vali C4-cleaned_pitch ja klõpsa nupule <guibutton
>Muuda</guibutton
>. Avaneb võrrandi muutmise dialoog: </para>
<screenshot>
<screeninfo
>Võrrandi muutmine</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-editequation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Võrrandi muutmine</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Pane tähele, et tekstikasti <guilabel
>Võrrand</guilabel
> on sisestatud <literal
>p'</literal
> arvutamiseks kasutatav võrrand (<literal
>cos(-0,69)</literal
> jaoks kasutatakse lähendust 1). Eksperimenteeri dialoogis kõigi seadistustega. Kui oled valmis, klõpsa nupule <guibutton
>OK</guibutton
> (tehtud muudatuste salvestamiseks) või <guibutton
>Loobu</guibutton
>. </para>

<para
>Pane tähele, et kõigi andmeobjektide korral on veerus <guilabel
># kasutusel</guilabel
> mingi number. See osutab, mitu korda kasutavad andmeobjekti teised andmeobjektid või joonised. Kuna me ühe kõvera ja jõuspektri eemaldasime, peaks vähemalt kahel andmeobjektil olema selles veerus kirjas 0. Kõigi kasutamata andmeobjektide lõplikuks eemaldamiseks klõpsa nupule <guibutton
>Puhasta</guibutton
>. </para>

<para
>Andmehalduri sulgemiseks klõpsa nupule <guibutton
>Sulge</guibutton
>. Kui soovid, võid ka &kst; sulgeda. </para>
</sect1>

<sect1 id="pluginsandevents">
<title
>Pluginatest ja sündmustest</title>
<para
>Me lõpetame oma lühiretke &kst; maailma kahe spetsiifilise andmetüübi tutvustamisega &mdash; pluginad ja sündmuse monitorid. </para>

<para
>Plugin on väga paindlik andmeobjekt, mille käitumine sõltub täielikult konkreetsest valitud pluginafailist. Pluginafail võib olla kaasas juba &kst; endaga, kuid see võib pärineda ka väljastpoolt projekti. Põhjalikud juhised, kuidas ise pluginafaile luua, annab <xref linkend="creatingplugins"/>. Pluginad lubavad &kst;-l sooritada andmetega palju lisaoperatsioone, sest pluginafaili ainus nõue on see, et nad kasutaksid sisendina vektoreid ja skalaare ning väljastaksid samuti vektoreid ja skalaare. </para>

<para
>Näitena üritame luua väheste andmepunktidega lineaarjaotuse. Käivita &kst; demopaketti kuuluva faili <filename
>maxima.dat</filename
> esimese välja joonisega: </para>

<screen
><userinput
><command
>kst -y 1 -d maxima.dat</command
></userinput
></screen>

<para
>Võti <option
>d</option
> määrab, et joonistatakse ainult punkte, mitte aga jooni. Nüüd näebki andmepunktide joonist: </para>
<screenshot>
<screeninfo
>Andmepunktide joonis</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-maxima-datapoints.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Andmepunktide joonis</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Nüüd ava andmehaldur. Klõpsa uue pluginaobjekti loomiseks sektsioonis <guilabel
>Uus</guilabel
> nupule <guibutton
>Plugin...</guibutton
> Vali <guilabel
>Plugina valik</guilabel
> all <guimenuitem
>Lineaarjaotus</guimenuitem
>. See plugin vajab kaht sisendvektorit &mdash; üks jaotatavate andmepunktide X- ja teine Y-väärtuste tarbeks. Vali <guilabel
>Sisendvektor - X massiiv</guilabel
> all <guimenuitem
>INDEX</guimenuitem
> ja <guilabel
>Sisendvektor - Y massiiv</guilabel
> all <guimenuitem
>1</guimenuitem
>. Seejärel klõpsa nupule <guibutton
>OK</guibutton
>. Märkad, et uus pluginaobjekt on tekitanud alamvektorid, kuhu oma väljund salvestada. Väljundvektorite põhjal uue kõvera loomiseks klõpsa nupule <guibutton
>Kõver...</guibutton
> Vali <guilabel
>X-telje vektor</guilabel
> all <guimenuitem
>V1-INDEX</guimenuitem
> ja <guilabel
>Y-telje vektor</guilabel
> all <guimenuitem
>P1-kstfit_linear_unweighted-Y Fitted</guimenuitem
>. Me soovime seada kõvera olemasoleval joonisel andmepunktide peale, seega tuleb sektsioonis <guilabel
>Kõvera paigutus</guilabel
> valida <guilabel
>Olemasoleval joonisel</guilabel
> ja välja lülitada <guilabel
>Uuel joonisel</guilabel
>. Seejärel klõpsa kõvera loomiseks nupule <guibutton
>OK</guibutton
>. Sulge andmehaldur ja võidki näha lineaarjaotust: </para>

<screenshot>
<screeninfo
>Lineaarjaotus</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-fittedline.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Lineaarjaotus</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Samalaadse protseduuriga saab luua ja joonistada mis tahes tüüpi pluginaobjekti väljundit. Jaotuspluginate loomisel saab aga ka kasutada kiiremat teed. Klõpsa hiire parema nupuga joonisel ja näed ilmuvas hüpikmenüüs alammenüüga kirjet <guisubmenu
>Jaotus...</guisubmenu
> Alammenüüst kõverat valides avaneb jaotusfunktsiooni dialoog, kus X- ja Y-vektor on juba kindlaks määratud. Jaotusplugina valimise järel loobki klõps nupule <guibutton
>OK</guibutton
> pluginaobjekti, plugina väljundi põhjal kõvera ja asetab selle olemasolevale joonisele. </para>

<para
>Vaatame nüüd sündmusi. Sündmuseobjektid jälgivad tavaliselt teisi vektoreid või skalaare ning võtavad midagi ette, kui mingi neid vektoreid või skalaare puudutav tingimus osutub täidetuks. Uue sündmuse loomiseks klõpsa andmehalduri sektsioonis <guilabel
>Uus</guilabel
> nupule <guibutton
>Sündmuse monitor...</guibutton
>: </para>
<screenshot>
<screeninfo
>Sündmuse monitor</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Sündmuse monitor</phrase>
</textobject>
</mediaobject>
</screenshot>

<!-- FIXME: This seems to be incorrect: the equation given doesn't work -->
<para
>Oletame, et pikikalde güroandmeid uuendatakse reaalajas ja et me soovime saada teada, kui korrigeeritud pikikalle väljub vahemikust <literal
>[-0.60, -0.40]</literal
>. Sellisest sündmusest teadasaamiseks sisesta kasti <guilabel
>Avaldis</guilabel
> järgmine tekst: </para>

<para>
<literal
>[C4-cleaned_pitch-sv]&gt;(-0.40) | [C4-cleaned_pitch-sv]&lt;(-0.60)</literal>
</para>

<para
>Arvesta, et avaldis peab olema antud tõeväärtusavaldisena. Toodud avaldist hinnatakse tõeseks juhul, kui üks tingimustest on täidetud. Vali nii <guilabel
>Logitakse kui</guilabel
> kui ka <guilabel
>Märguanne</guilabel
> ning sisesta oma e-posti aadress väljale <guilabel
>Märguanne</guilabel
>. Klõpsuga nupule <guibutton
>OK</guibutton
> ongi sündmus loodud. </para>

<para
>Nüüd vali menüüst <guimenu
>Abi</guimenu
> <guimenuitem
>Kst silumine...</guimenuitem
> Klõpsa silumislogi vaatamiseks kaardile <guilabel
>Logi</guilabel
>. Kui sündmus on korrektselt loodud, peaksid nägema hoiatusi, mis tähistavad X-väärtusi, mille puhul sündmus teoks sai. Kontrolli, kas väärtused vastavad enam-vähem sellele, mida saab näha ka joonisel: </para>

<screenshot>
<screeninfo
>Silumislogi</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-debuglog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Silumislogi</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Kui pikikalde andmeid uuendatakse reaalajas, käivitub sündmuse monitor uute andmete saabumisel vajaduse korral alati. </para>

<para
>Kui oled omadega valmis, võid &kst; sulgeda. </para>
</sect1>


<sect1 id="conclusion">
<title
>Kokkuvõte</title>

<para
>Me oleme &kst; algtutvustusega lõpule jõudnud. Loodetavasti omandasid piisavalt teadmisi, et &kst;-d produktiivselt kasutama hakata. Arvesta, et käesolev algtutvustus ei hõlma kaugeltki kõiki &kst; võimalusi &mdash; uurimiseks ja katsetamiseks jagub ruumi veel kõvasti. Ülejäänud osa sellest käsiraamatust annab põhjaliku ülevaate kogu rakendusest alates akende kasutamise põhialustest kuni oma käega pluginate valmistamiseni. Me soovitame sulle kasutada &kst; kõiki võimalusi &mdash; on päris tõenäoline, et sa avastad, et rakendus mitte ainult ei vasta sinu vajadustele, vaid lausa ületab neid tunduvalt. </para>
</sect1>


</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-omittag:nil
sgml-shorttag:nil
sgml-namecase-general:nil
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:true
sgml-parent-document:("index.docbook" "book" "chapter")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

