<chapter id="workingwithdata">
<title
>Andmete töötlemine</title>

<sect1 id="fileformats">
<title
>Toetatud failivormingud</title>
<para
>Praegu toetab Kst andmeallikatena ASCII tekstifaile, BOOMERANG-i raamifaile ja BLAST dirfile-faile. Tulevikus on võimalik ka muude failivormingute toetamine. </para>

<sect2 id="creatingascii">
<title
>ASCII sisendfailide loomine</title>
<para
>Lihtsaim sisendfaili vorming on ASCII tekstifail. Need on enamasti hästi loetavad ka inimesele, mitte ainult arvutile, ning neid saab soovi korral ka käsitsi luua. Toome siin näite tüüpilisest ASCII sisendfailist. </para>

<informalexample>
<screen
>112.5 3776 428
187.5 5380 429
262.5 5245 345
337.5 2942 184
412.5 1861 119
487.5 2424 138
567.5 2520 162
637.5 1868 144
712.5 1736 211
787.5 1736 211
862.5 2172 292
937.5 1174 377
1000.5 499 623
</screen>
</informalexample>
<para
>Faili iga veerg kujutab endast &kst; seisukohalt vaadates vektorit. Veerge eristavad tühikud, ridu reavahetused. </para>

</sect2>
</sect1>

<sect1 id="datawizard">
<title
>Andmenõustaja</title>
<para
>Andmenõustaja võimaldab kiiresti ja hõlpsalt andmefailide põhjal luua ja &kst;-sse importida vektoreid, kõveraid ja jooniseid. Nõustaja käivitamiseks vali käsk <guimenuitem
>Andmenõustaja...</guimenuitem
> menüüst <guimenu
>Andmed</guimenu
>. Seejärel palutakse sul valida andmeallikas. Otsi üles sobilik andmefail või sisesta selle asukoht käsitsi 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
>Vali väljad, mida soovid &kst;-sse importida. Väljaloendit saab filtreerida loendi kohal olevasse tekstikasti vajalikku stringi sisestades (lubatud on ka metamärgid). Järgnev loetelu selgitab muid aknas olevaid võimalusi ja valikuid. </para>

<variablelist>


<varlistentry>
<term>
<guilabel
>Algusraam</guilabel>
</term>
<listitem>
<para
>Esimene raam (rida andmefailis), millest hakatakse andmeid lugema. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Arvestamine lõpust</guilabel>
</term>
<listitem>
<para
>Selle valimisel loetakse raamid, mille arv on määratud võimalusega <guilabel
>Raamide arv</guilabel
>, alates andmefaili lõpust. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Raamide arv</guilabel>
</term>
<listitem>
<para
>Loetavate raamide koguarv. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Loetakse lõpuni</guilabel>
</term>
<listitem>
<para
>Selle valimisel loetakse raamist, mis on määratud võimalusega <guilabel
>Alustav raam</guilabel
>, kuni faili lõpuni. Kui valida nii <guilabel
>Arvestamine lõpust</guilabel
> kui ka <guilabel
>Loetakse lõpuni</guilabel
>, loetakse andmed faili algusest selle lõpuni. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Raamid jäetakse vahele</guilabel>
</term>
<listitem>
<para
>Lugemisel vahelejäetavate raamide arv. Kui anda siin näiteks 1, siis jäetakse andmete lugemisel failist vahele iga teine raam. </para>
</listitem>
</varlistentry>


<varlistentry>
<term>
<guilabel
>Eelnevalt rakendatakse liikuva keskmise filtrit</guilabel>
</term>
<listitem>
<para
>Enne muid tegevusi kasutatakse liikuva keskmise filtrit. </para>
</listitem>
</varlistentry>
</variablelist>


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

<variablelist>

<varlistentry>
<term
><guilabel
>XY</guilabel
>, <guilabel
>Jõuspekter</guilabel
> ja <guilabel
>XY ja jõuspekter</guilabel
> </term>
<listitem>
<para
>Võimalus valida, kas joonistama peaks olema ainult jõuspektri (PSD), ainult andmed või mõlemad. Kui valida jõuspekter, saab kasutada ka mõningaid täiendavaid seadistusvõimalusi. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>X-telje vektor</guilabel>
</term>
<listitem>
<para
>Seda vektorit kasutatakse joonistel iseseisva vektorina. Võid valida välja oma andmefailist või indeksivektori. Indeksivektor on vektor, mis sisaldab elemente 0 kuni N-1, kus N on ridade arv andmefailis. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Ülejäänud seadistusi saab määrata ainult siis, kui valida jõuspektri joonistamine. </para>

<variablelist>

<varlistentry>
<term>
<guibutton
>FFT pikkus</guibutton>
</term>
<listitem>
<para
>Kiire Fourier' teisenduse (FFT) pikkus. Selle määramisel kasutatakse eksponenti <literal
>x</literal
> valemis <literal
>2^x</literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Andmete ühikud</guibutton>
</term>
<listitem>
<para
>Vektorites andmete puhul kasutatavad ühikud. </para>
</listitem>
</varlistentry>


<varlistentry>
<term>
<guibutton
>Sammu ühikud</guibutton>
</term>
<listitem>
<para
>Sammu määramiseks kasutatavad ühikud. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Valimi samm</guibutton>
</term>
<listitem>
<para
>Valimi samm, mis kasutab võimalusega <guilabel
>Sammu ühikud</guilabel
> määratud ühikuid. </para>
</listitem>
</varlistentry>



<varlistentry>
<term>
<guilabel
>Apodeeritakse</guilabel>
</term>
<listitem>
<para
>Selle valimisel apodeeritakse jõuspektri otsad. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Keskmine eemaldatakse</guilabel>
</term>
<listitem>
<para
>Selle valimisel eemaldatakse valitud andmete keskmine (s.t. andmeid tõlgendatakse nii, et keskmine võrdub nulliga). </para>
</listitem>
</varlistentry>
</variablelist>
<para
>Kui oled kõik vajaliku määranud, klõpsa järgmisesse aknasse liikumiseks nupule <guibutton
>Järgmine</guibutton
>. Vali kõik filtrid, mida soovid andmetele rakendada, ja klõpsa viimasesse aknasse jõudmiseks 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. Anname siin kõigest siiski lühikese ülevaate. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Kõvera stiil</guilabel>
</term>
<listitem>
<para
>Võimalus valida, kas joonistatakse ainult andmepunktid, ainult andmepunkte siduvad jooned või mõlemad. </para>
</listitem>
</varlistentry>



<varlistentry>
<term>
<guilabel
>Kõvera paigutus</guilabel>
</term>
<listitem>
<para
>Võimalus valida joonised, kuhu uued kõverad seada. <guilabel
>Keritakse läbi</guilabel
> loob määratud arvu uusi jooniseid ja kerib läbi iga joonise, asetades iga kord uue kõvera joonisele. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Pealdise tekitamine</guilabel>
</term>
<listitem>
<para
>Võimalus valida joonistele seatavad pealdised ja legendid. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Joonise paigutus</guilabel>
</term>
<listitem>
<para
>Võimalus valida aken/aknad, kuhu uued joonised seada. Uusi aknaid saab joonistele luua, kui valida <guilabel
>uues aknas</guilabel
>. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Kui oled kõik valikud langetanud, klõpsa nupule <guibutton
>Lõpeta</guibutton
> ning joonised tekitataksegi. </para>

</sect1>

<sect1 id="datamanager">
<title
>Andmehaldur</title>
<para
>Andmehaldur on keskne vahend, kus saab kõiki &kst;-s kasutatavaid andmeobjekte lisada, kustutada ja muuta. Halduri saab avada käsuga <guimenuitem
>Andmehaldur</guimenuitem
> menüüst <guimenu
>Andmed</guimenu
>. </para>
<sect2 id="creatingdata">
<title
>Uute andmeobjektide loomine</title>
<para
>Uue andmeobjekti loomiseks andmehalduris klõpsa nupul <guilabel
>Uus:</guilabel
>. Ilmub uus aken, kus saab andmeobjekti seadistada.</para>

<tip
><para
>Uusi kõveraid saab luua ka vektoril hiire parema nupuga klõpsates ja ilmuvast menüüst käsku <guimenuitem
>Loo kõver...</guimenuitem
> valides.</para
></tip>

<para
>Uue andmeobjekti loomisel tuleb selle tuvastamiseks määrata sellele unikaalne nimi. Kasutada võib ka vaikenime (kui see on ikka unikaalne). </para>
<para
>Kõigi vähegi joonistamiskõlbulike andmeobjektide seadistustes on kaks ühist sektsiooni &mdash; kõvera välimus ja kõvera paigutus. Neid kirjeldatakse allpool. Andmespetsiifilisi seadistusi tutvustab lähemalt <link linkend="datatypes"
>andmetüüpidest</link
> rääkiv osa. </para>
<note>
<para
>Siin ja edaspidi tähendab <quote
>kõver</quote
> üldjuhul andmeobjekti joonistamisel joonisel nähtavaid jooni ja punkte &mdash; enamasti ei tähenda see mitte andmeobjekti enda <quote
>kõverat</quote
>. </para>
</note>
<sect3 id="curveappearance">
<title
>Kõvera välimus</title>
<para
>Kõvera välimuse sektsioonis saab muuta andmeobjektile joonistamisel antavat välimust. </para>

<variablelist>

<varlistentry>
<term>
<inlinemediaobject
><imageobject
><imagedata fileref="Widget-kst-colourchooser.png" format="PNG"/></imageobject
></inlinemediaobject>
</term>
<listitem>
<para
>Selle nupule klõpsates avatakse värvivalija dialoog, kus saab muuta nii kõvera joonte kui punktide värvi. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Näidatakse punkte</guilabel>
</term>
<listitem>
<para
>Selle märkimisel näidatakse kõvera joonistamisel andmepunkte. Paremal asuv hüpikkast võimaldab valida punktide kuju. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Näidatakse jooni</guilabel>
</term>
<listitem>
<para
>Selle märkimisel näidatakse kõvera joonistamisel andmepunkte siduvaid jooni. Valida saab nii joone paksuse kui ka stiili. </para>
</listitem>
</varlistentry>

</variablelist>


</sect3>

<sect3 id="curveplacement">
<title
>Kõvera paigutus</title>
<para
>Kõvera paigutuse sektsioonis saab määrata uute kõverate asukoha. </para>

<variablelist>

<varlistentry>
<term>
<guilabel
>Joonise aken</guilabel>
</term>
<listitem>
<para
>Määrab akna, kuhu kõver seatakse. Klõpsuga nupule <guibutton
>Uus...</guibutton
> saab luua uue akna. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Asukoht olemasoleval joonisel</guilabel>
</term>
<listitem>
<para
>Selle märkimisel asetatakse kõver olemasolevale joonisele. Sobiva joonise saab valida paremal asuvas hüpikkastis. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Asukoht uuel joonisel</guilabel>
</term>
<listitem>
<para
>Selle märkimisel asetatakse kõver uuele joonisele. Valida saab uue joonise veergude arvu. Pane tähele, et kõvera võib asetada nii uuele kui ka olemasolevale joonisele. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Kui oled määranud uue andmeobjekti kõik vajalikud seadistused, klõpsa selle loomiseks nupule <guibutton
>Rakenda uuele</guibutton
>. </para>

</sect3>

</sect2>

<sect2 id="editinganddeletingdata">
<title
>Olemasolevate andmeobjektide muutmine ja kustutamine</title>
<para
>Olemasoleva andmeobjekti muutmiseks vali see andmehalduris ja klõpsa nupule <guibutton
>Muuda</guibutton
>. Ilmub valitud objekti seadistustedialoog. See on samasugune nagu uue objekti loomisel, nii et vaata selle kirjeldust lähemalt <link linkend="creatingdata"
>uute andmeobjektide loomise</link
> osast. </para>
<para
>Andmeobjekti kustutamiseks vali see andmehalduris ja klõpsa nupule <guibutton
>Kustuta</guibutton
>. Pane tähele, et veerus <guilabel
># kasutusel</guilabel
> peab seisma 0, muidu ei saa objekti kustutada. Veerg <guilabel
># kasutusel</guilabel
> teatab, mitu korda on antud andmeobjekt ja selle järglased (kui neid on) leidnud kasutamist teiste andmeobjektide poolt või joonistel. Allpool on tooduid mõningad piirangud, mida tuleks andmeobjektide kustutamisel meeles pidada ja arvestada. </para>

<itemizedlist>
<listitem>
<para
>Kõik joonistatavad objektid (kõverad, võrrandid, histogrammid ja jõuspektrid) tuleb enne kustutamist joonistelt eemaldada. Objekti saab jooniselt eemaldada, kui klõpsata andmehalduris selle nimel hiire parema nupuga ja valida alammenüüst <guisubmenu
>Eemalda jooniselt</guisubmenu
> vajalik joonis. </para>
</listitem>

<listitem>
<para
>Kõik mingit andmevektorit kasutavad kõverad peavad olema kustutatud, enne kui saab kustutada andmevektorit ennast. </para>
</listitem>

<listitem>
<para
>Ükski eellasest andmeobjekti järglane ei tohi olla kasutusel, muidu ei saa eellasobjekti kustutada. </para>
</listitem>
</itemizedlist>

<para
>Pärast kõverate arvukamat kustutamist ja eemaldamist joonistelt võid leida andmehalduris hulga kasutamata andmeobjekte. Nende kiireks eemaldamiseks klõpsa nupule <guibutton
>Puhasta</guibutton
>. </para>



</sect2>

</sect1>

<sect1 id="datatypes">
<title
>Andmetüübid</title>

<para
>&kst; kasutab seitset peamist andmeobjekti tüüpi. Andmeobjektid võivad sisaldada muid andmeobjekte, mida näidatakse andmehalduris puuvaatena. Järgnev diagramm näitab erinevate andmetüüpide suhteid. </para>

<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Diagram-kst-datatypes.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>&kst; andmetüübid</phrase>
</textobject>
</inlinemediaobject>
</para>

<para
>Nagu diagrammilt näha, on kõver, võrrand, histogramm ja jõuspekter ainsad andmetüübid, mida saab joonistada. Kõverad luuakse vektorite põhjal, võrrandid, jõuspektrid ja pluginad aga sisaldavad alamvektoreid. </para>

<para
>Nüüd toome ära kõigi andmetüüpide kirjeldused, andes ka ülevaate seadistustest ja valikutest, mida saab kasutada vastavat andmetüüpi luues või muutes. Peaaegu kõigile andmetüüpidele ühised seadistused on välja jäetud &mdash; nende kirjeldust vaata <link linkend="creatingdata"
>uute andmeobjektide loomisest</link
> kõnelevast osast. </para>

<sect2 id="vectors">
<title
>Vektorid</title>
<para
>Vektorid on &kst; ilmselt kõige enam kasutust leidvad andmeobjektid. Nagu nende nimigi eeldab, kujutavad vektorid endast lihtsalt järjekorda seatud numbriloendit. Enamasti sisaldavad nad andmepunktide X- või Y-koordinaate. </para>
<para
>Näidataval pildil on näha vektorite loomise/muutmise dialoog. Selle seletuse leiab altpoolt. </para>

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

<sect3 id="datavectorparameters">
<title
>Andmevektorite parameetrid</title>
<para
>Andmevektori lähtefaili ja muud parameetrid saab määrata järgnevaid võimalusi pruukides. </para>
<variablelist>
<varlistentry>
<term>
<guilabel
>Väli või veerg</guilabel>
</term>
<listitem>
<para
>Väli või veerg, mille põhjal vektor luuakse. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Algusraam</guilabel>
</term>
<listitem>
<para
>Esimene raam (rida andmefailis), millest hakatakse andmeid lugema. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Arvestamine lõpust</guilabel>
</term>
<listitem>
<para
>Selle valimisel loetakse raamid, mille arv on määratud võimalusega <guilabel
>Raamide arv</guilabel
>, alates andmefaili lõpust. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Raamide arv</guilabel>
</term>
<listitem>
<para
>Loetavate raamide koguarv. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Loetakse lõpuni</guilabel>
</term>
<listitem>
<para
>Selle valimisel loetakse raamist, mis on määratud võimalusega <guilabel
>Alustav raam</guilabel
>, kuni faili lõpuni. Kui valida nii <guilabel
>Arvestamine lõpust</guilabel
> kui ka <guilabel
>Loetakse lõpuni</guilabel
>, loetakse andmed faili algusest selle lõpuni. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Raamid jäetakse vahele</guilabel>
</term>
<listitem>
<para
>Lugemisel vahelejäetavate raamide arv. Kui anda siin näiteks 1, siis jäetakse andmete lugemisel failist vahele iga teine raam. </para>
</listitem>
</varlistentry>


<varlistentry>
<term>
<guilabel
>Eelnevalt rakendatakse liikuva keskmise filtrit</guilabel>
</term>
<listitem>
<para
>Enne muid tegevusi kasutatakse liikuva keskmise filtrit. </para>
</listitem>
</varlistentry>


</variablelist>
</sect3>
</sect2>

<sect2 id="curves">
<title
>Kõverad</title>
<para
>Kõveraid kasutatakse esmajärjekorras vektorite põhjal joonistatavate objektide loomiseks. Kõverad luuakse kahe vektori põhjal - <quote
>X-telje vektor</quote
> ja <quote
>Y-telje vektor</quote
>, mis mõlemad peaksid sisaldama andmepunktide kogumit. Nii võib kõverat pidada andmepunktide ja neid ühendavate joonte kogumiks. </para>
<para
>Näidataval pildil on näha kõverate loomise/muutmise dialoog. Selle seletuse leiab altpoolt. </para>

<screenshot>
<screeninfo
>Kõverate muutmine</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-curvewindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Kõverate muutmine</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="curvecontents">
<title
>Kõvera sisu</title>
<para
>Selles sektsioonis saab määrata kõvera olemuse. </para>
<variablelist>
<varlistentry>
<term>
<guilabel
>X-telje vektor</guilabel>
</term>
<listitem>
<para
>Vektor, mida kasutatakse iseseisva (rõhtsa) telje jaoks. </para>
</listitem>

</varlistentry>

<varlistentry>
<term>
<guilabel
>Y-telje vektor</guilabel>
</term>
<listitem>
<para
>Vektor, mida kasutatakse sõltuva (püstise) telje jaoks. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>X veatulp</guilabel>
</term>
<listitem>
<para
>Vektor, mis sisaldab X-telje vektorile vastavaid veaväärtusi. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Y veatulp</guilabel>
</term>
<listitem>
<para
>Vektor, mis sisaldab Y-telje vektorile vastavaid veaväärtusi. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>

<sect2 id="equations">
<title
>Võrrandid</title>
<para
>Võrrandi andmeobjekt koosneb matemaatilisest avaldisest ja sõltumatust muutujast. Avaldis luuakse skalaare, vektoreid ja operande kasutades ning see esindab tavaliselt sõltuva muutuja väärtusi. Sõltumatu muutuja võib olla olemasolev vektor, kuid selle võib genereerida ka võrrandiobjekti luues või muutes. Kuna võrrand sisaldab endas andmepunktide kogumit, saab seda ka joonistada. </para>
<para
>Näidataval pildil on näha võrrandite loomise/muutmise dialoog. Selle seletuse leiab altpoolt. </para>

<screenshot>
<screeninfo
>Võrrandi muutmine</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-equationwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Võrrandi muutmine</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="equation">
<title
>Võrrand</title>
<para
>Selles osas saab muuta sõltuvat muutujat esindavat matemaatilist avaldist. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Operandid</guilabel>
</term>
<listitem>
<para
>Saadaolevate operandide loend. Loendist mingi operandi valimine lisab selle kohta, kus tekstikastis <guilabel
>Võrrand</guilabel
> asub parajasti kursor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vektorid</guilabel>
</term>
<listitem>
<para
>&kst; aktiivsete vektoriobjektide loend. Loendist mõne vektori valimine lisab selle kohta, kus tekstikastis <guilabel
>Võrrand</guilabel
> asub parajasti kursor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Skalaarid</guilabel>
</term>
<listitem>
<para
>Saadaolevate skalaaväärtuste loend. See koosneb nii käesoleva &kst; seansi skalaarväärtustest kui ka mõningatest kasutadaolevatest konstantidest. Loendist mõne skalaari valimine lisab selle kohta, kus tekstikastis <guilabel
>Võrrand</guilabel
> asub parajasti kursor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Võrrand</guilabel>
</term>
<listitem>
<para
>Sõltumatut muutujat esindav matemaatiline avaldis. Selle võib käsitsi tekstikasti sisestada või valida sobiva ülalolevat hüpikkasti kasutades. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>


<sect3 id="independentvariable">
<title
>Sõltumatu muutuja</title>
<para
>Selles osas saab määrata sõltumatu muutuja väärtuste allika. </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Kasutatakse olemasolevat vektorit</guilabel>
</term>
<listitem>
<para
>Vektor, mida kasutada sõltumatu muutujana. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Interpoleeritakse suurima resolutsiooni vektorini</guilabel>
</term>
<listitem>
<para
>Selle märkimisel interpoleeritakse olemasolev vektor suurima võimaliku resolutsioonini. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Genereeritakse X</guilabel>
</term>
<listitem>
<para
>Selle valimisel genereeritakse sõltumatu muutujana kasutatavad väärtused. Määra väikseim genereeritav väärtus väljal <guilabel
>Alates</guilabel
> ja suurim väljal <guilabel
>kuni</guilabel
>. Määra <guilabel
>valimite arv</guilabel
>u väärtuseks samas vahemikus väärtuste arv, kui soovid genereerida väikseima ja suurima väärtuse vahel (kaasa arvatud). </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="Histograms">
<title
>Histogrammid</title>
<para
>Histogrammi andmeobjekt kujutab endast konkreetse vektori histogrammi. Histogrammiobjektid on joonistatavad. </para>
<para
>Näidataval pildil on näha histogrammide loomise/muutmise dialoog. Selle seletuse leiab altpoolt. </para>

<screenshot>
<screeninfo
>Võrrandi muutmine</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-histogramwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Võrrandi muutmine</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="histogramproperties">
<title
>Histogrammi omadused</title>
<para
>Selles osas saab muuta lähtevektorit ning histogrammi põhiomadusi. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Andmevektor</guilabel>
</term>
<listitem>
<para
>Andmevektor, mille põhjal histogramm luua. Kuigi vektor on vajalik histogrammi loomiseks, koheldakse vektorit histogrammi loomisel mittekasutatavana. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Alates</guilabel
> ja <guilabel
>kuni</guilabel
> </term>
<listitem>
<para
><guilabel
>Alates</guilabel
> sisaldab histogrammi vasakpoolseima kasti vasakut raja. <guilabel
>kuni</guilabel
> sisaldab histogrammi parempoolseima kasti paremat raja. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Kastide arv</guilabel>
</term>
<listitem>
<para
>Histogrammi kastide arv. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Automaatne kast</guibutton>
</term>
<listitem>
<para
>Sellel klõpsates genereeritakse väljade <guilabel
>Alates</guilabel
> ja <guilabel
>kuni</guilabel
> väärtused lähtevektori vastavalt väikseima ja suurima väärtuse põhjal. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>


<sect3 id="yaxisnormalization">
<title
>Y-telje normaliseerimine</title>
<para
>Selles osas saab määrata histogrammi Y-telje normaliseerimise tüübi. </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Arv kastis</guilabel>
</term>
<listitem>
<para
>Selle valimisel esindab Y-telg elementide arvu igas kastis. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Murd kastis</guilabel>
</term>
<listitem>
<para
>Selle valimisel esindab Y-telg elementide murrulist tähtsust (elementide koguarvust) igas kastis. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Protsent kastis</guilabel>
</term>
<listitem>
<para
>Selle valimisel esindab Y-telg elementide protsenti (elementide koguarvust) igas kastis. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Tippkast = 1,0</guilabel>
</term>
<listitem>
<para
>Selle valimisel esindab Y-telg elementide arvu igas kastis jagatud elementide arvuga suurimas kastis (suurima elementide arvuga kastis). </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>


</sect2>

<sect2 id="PowerSpectra">
<title
>Jõuspekter</title>
<para
>Jõuspektri andmeobjekt esindab vektori jõuspektrit. </para>
<para
>Näidataval pildil on näha jõuspektri loomise/muutmise dialoog. Selle seletuse leiab altpoolt. </para>

<screenshot>
<screeninfo
>Jõuspektri aken</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-powerspectrawindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Jõuspektri aken</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="powerspectracurvecontents">
<title
>Kõvera sisu</title>
<para
>Selles osas saab muuta lähtevektorit ning jõuspektri põhiomadusi. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Andmevektor</guilabel>
</term>
<listitem>
<para
>Andmevektor, mille põhjal jõuspekter luua. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Apodeeritakse</guilabel>
</term>
<listitem>
<para
>Selle valimisel apodeeritakse jõuspektri otsad. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Keskmine eemaldatakse</guilabel>
</term>
<listitem>
<para
>Selle valimisel eemaldatakse valitud andmete keskmine (s.t. andmeid tõlgendatakse nii, et keskmine võrdub nulliga). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>FFT pikkus</guibutton>
</term>
<listitem>
<para
>Kiire Fourier' teisenduse (FFT) pikkus. Selle määramisel kasutatakse eksponenti <literal
>x</literal
> valemis <literal
>2^x</literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Sammu ühikud</guibutton>
</term>
<listitem>
<para
>Sammu määramiseks kasutatavad ühikud. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Valimi samm</guibutton>
</term>
<listitem>
<para
>Valimi samm. </para>
</listitem>
</varlistentry>


</variablelist>
</sect3>

</sect2>

<sect2 id="plugins">
<title
>Pluginad</title>
<para
>Plugina andmeobjekt esindab &kst; pluginat. Kõigil pluginatel on ühine vorming ning andmehaldur näitab neid tüübiga <quote
>plugin</quote
>. Rohkem infot pluginate kohta annab osa <link linkend="pluginsandfilters"
>Pluginad ja filtrid</link
>. </para>
</sect2>

<sect2 id="events">
<title
>Sündmused</title>
<para
>Sündmuste andmetüüp esindab &kst; sündmuste monitori. Sündmuste monitor hoiab sisuliselt silma peal ühel või enamal vektoril või skalaaril ning sooritab teatud toimingu, kui mõni vektorile või skalaarile määratud tingimus osutub tõeseks. Sündmuste monitori kasutatakse tavaliselt andmeesitusel reaalajas. Nii võib sündmuste monitor näiteks jälgida, kas mõni temperatuuri esindatest andmevektori elementidest ületab eelnevalt määratud väärtust. </para>
<para
>Näidataval pildil on näha sündmuste loomise/muutmise dialoog. Selle seletuse leiab altpoolt. </para>

<screenshot>
<screeninfo
>Sündmuste monitori aken</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Sündmuste monitori aken</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="eventsexpression">
<title
>Avaldis</title>
<para
>Selles osas saab muuta jälgitavat tingimust ja muid sündmuse omadusi. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Operandid</guilabel>
</term>
<listitem>
<para
>Saadaolevate operandide loend. Loendist mõne operandi valimine lisab selle kohta tekstikastis <guilabel
>Avaldis</guilabel
>, kus asub parajasti kursor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vektorid</guilabel>
</term>
<listitem>
<para
>&kst; aktiivsete vektoriobjektide. Loendist mõne vektori valimine lisab selle kohta tekstikastis <guilabel
>Avaldis</guilabel
>, kus asub parajasti kursor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Skalaarid</guilabel>
</term>
<listitem>
<para
>Saadaolevate skalaaväärtuste loend. See koosneb nii käesoleva &kst; seansi skalaarväärtustest kui ka mõningatest kasutadaolevatest konstantidest. Loendist mõne skalaari valimine lisab selle kohta, kus tekstikastis <guilabel
>Avaldis</guilabel
> asub parajasti kursor. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Avaldis</guilabel>
</term>
<listitem>
<para
>Jälgitav avaldis. Selle võib otse tekstikasti kirjutada või valida ülalolevast hüpikkastist. Kontrolli, et tekstikastis olev avaldis oleks ikka tõeväärtusavaldis (s.t. selle tulemus saaks olla tõene või väär). Tavaliselt tähendab see võrdsuse või ebavõrdsuse defineerimist avaldises. Pane tähele, et tekstikasti sisestatud vektoritel jälgitakse nende üksikelemente. </para>
<para
>Kui avaldis osutub tõeseks, käivitatakse sündmus. Milline toiming ette võetakse, sõltub kahes järgmises osas langetatud valikutest. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Kirjeldus</guilabel>
</term>
<listitem>
<para
>Selles kastis saab anda sündmuse lühikirjelduse. Seda pruugitakse peamiselt hea abivahendina arvukate sündmuste täpseks jälgimiseks. Tekstikasti võib sisestada just sellise teksti, mida heaks pead. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="eventskstdebuglog">
<title
>Kst silumislogi</title>
<para
>Selles osas saab määrata sündmuste käivitamisel &kst; silumislogisse lisatavate kirjete omadusi. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Logitakse kui:</guilabel
></term>
<listitem>
<para
>Selle märkimisel lisatakse sündmuste käivitamisel kirjed &kst; silumislogisse. </para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<varlistentry>
<term
><guilabel
>Märguanne</guilabel
></term>
<listitem>
<para
>Kirje logitakse märguandena. </para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<varlistentry>
<term
><guilabel
>Hoiatus</guilabel
></term>
<listitem>
<para
>Kirje logitakse hoiatusena. </para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<varlistentry>
<term
><guilabel
>Viga</guilabel
></term>
<listitem>
<para
>Kirje logitakse veana. </para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="eventsemailnotification">
<title
>Märguanne e-postiga</title>
<para
>Selles osas saab määrata sündmuste käivitamisel e-postiga saadetavate märguannete omadusi. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Märguanne</guilabel
></term>
<listitem>
<para
>Selle märkimisel saadab &kst; sündmuse käivitamisel märguande e-postiga määratud aadressile. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

</sect1>


<sect1 id="thedatamenu">
<title
>Andmemenüü</title>
<para
>Menüüga <guimenu
>Andmed</guimenu
> saab kasutada enamikku &kst; andmeobjektidega seotud võimalusi. Suurem osa menüükirjetest kordavad mujalolevaid funktsioone, mistõttu siinkohal kirjeldatakse neid ainult lühidalt. </para>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Laadi uuesti</guimenuitem
></term>
<listitem>
<para
>Laeb kõik vektorid lähtefailidest uuesti. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Andmenõustaja...</guimenuitem
></term>
<listitem>
<para
>Avab <link linkend="datawizard"
>andmenõustaja</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Andmehaldur</guimenuitem
></term>
<listitem>
<para
>Avab <link linkend="datamanager"
>andmehalduri</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Redigeeri</guimenuitem
> [andmeobjekt]</term>
<listitem>
<para
>Avab vastava andmeobjekti muutmise dialoogi. Nende kirjeldust vaata osast <link linkend="datatypes"
>Andmetüübid</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Vaata skalaare</guimenuitem
></term>
<listitem>
<para
>Avab dialoogi, kus on näha kõigi käesoleva &kst; seansi skalaaride väärtused. Väärtuste muutumisel uuendatakse dialoogi dünaamiliselt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Vaata vektoreid</guimenuitem
></term>
<listitem>
<para
>Avab dialoogi, kus on näha kõigi aktiivsete vektorite väärtused. Vali vajalik vektor hüpikkastist. Dialoogi uuendatakse väärtuste muutumisel dünaamiliselt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Loo kiiresti uus kõver</guimenuitem
></term>
<listitem>
<para
>Avab dialoogi, millega saab kiiresti andmefailide põhjal uusi kõveraid luua. Dialoog kujutab endast dialoogide <link linkend="curves"
>Kõvera muutmine</link
> ja <link linkend="vectors"
>Vektori muutmine</link
> kombinatsiooni. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Loo kiiresti uus PSD</guimenuitem
></term>
<listitem>
<para
>Avab dialoogi, millega kiiresti luua jõuspekter kas andmefaili või vektori põhjal. Dialoog kujutab endast dialoogide <link linkend="PowerSpectra"
>Jõuspektri muutmine</link
> ja <link linkend="vectors"
>Vektori muutmine</link
> kombinatsiooni. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Muuda andmefaili</guimenuitem
></term>
<listitem>
<para
>Avab dialoogi, millega kiiresti muuta vektoritega seotud andmefaile. Vali muudetavad vektorid ja seejärel määra uus andmefail. Muudatuste salvestamiseks klõpsa nupule <guibutton
>Rakenda</guibutton
>. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>
