<appendix id="command-lineoptions">

<appendixinfo>
<author
><firstname
>Barth</firstname
> <surname
>Netterfield</surname
> <affiliation
> <address
><email
>kst@omega.astro.utoronto.ca</email
></address>
</affiliation>
</author>
</appendixinfo>

<title
>Kasutamine käsurealt ja näited</title>
<para
>Kst kõige tüüpilisem kasutamisviis käsurealt on andmefailide X-Y jooniste valmistamine. Kst suudab lugeda ASCII andmeid või ka sobivate binaarfailide andmeid. </para>

<sect1 id="command-linesynopsis">
<title
>Käsurea kokkuvõte</title>
<para
>Võtmed on järgmised: <cmdsynopsis
><command
>kst</command
> <arg
>Qt võtmed</arg
> <arg
>KDE võtmed</arg
> <arg
>võtmed</arg
> <arg rep="repeat"
><replaceable
>fail</replaceable
></arg
> </cmdsynopsis>
</para>

<variablelist>

<varlistentry>
<term
><option
>[fail...]</option
></term>
<listitem>
<para
>.kst-fail või üks või enam andmefaili. Toetatud on ASCII veergude, BOOMERANG kaadrifailide ning BLAST dirfile failivormingud. .kst-failid salvestavad kõik võtmed, mida saab määrata muude lippudega. .kst-failis määratud võtmete tühistamiseks saab kasutada järgmisi lippe: <option
>-F andmefail</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. Teisi tühistada ei saa, Kui antakse tühistav lipp, rakendatakse seda joonise kõigile vektoritele. </para>
<para
>Standardsisendist võetavaid ASCII andmeid saab joonistada, kui anda "stdin" loendis <option
>[fail...]</option
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-y Y</option
></term>
<listitem>
<para
>Y-telje andmete allikas. ASCII failide korral on see veerg, binaarfailide puhul välja nimi. Mitme kõvera joonistamiseks saab seda anda mitu korda. Eeldatakse, et lähtefail, valimi vahemikud ja X-telje andmed ei muutu. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e E</option
></term>
<listitem>
<para
>Y-telje andmete veatulbad. ASCII failide korral viitab see andmeid sisaldavale veerule, binaarfailide puhul välja nimele. Kui anda mitu võtit <option
>-y Y</option
>, saab seda ka mitu korda kasutada. Konkreetsed Y-kirjed seostatakse antud järjekorras E-kirjetega. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-x X</option
></term>
<listitem>
<para
>X-telje andmete allikas. ASCII failide korral on see veerg, binaarfailide puhul välja nimi. Kui seda võtit ei anta, kasutatakse failis leiduvat rea numbrit. Seda võtit saab anda ainult üks kord. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-p P</option
></term>
<listitem>
<para
>Jõuspektri allikas. ASCII failide korral on see veerg, binaarfailide puhul välja nimi. Mitme kõvera jõuspektri joonistamiseks võib seda anda mitu korda. Kõigi käsurealt algatatud jõuspektrite korral kasutatakse sama lähtefaili, valimi vahemikke ja FFT pikkusi. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-l P</option
></term>
<listitem>
<para
>Jõuspektris kasutatava FFT pikkus, ligikaudu 2^P. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-h H</option
></term>
<listitem>
<para
>Histogrammi allikas. ASCII failide korral on see veerg, binaarfailide puhul välja nimi. Käsurealt võib algatada ka mitu histogrammi korraga. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-m NC</option
></term>
<listitem>
<para
>Kasutatakse mitme kõvera määramisel. Kõigi kõverate ühel joonisel esitamise asemel joonistatakse iga joonis eraldi. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f F0</option
></term>
<listitem>
<para
>Esimese loetava kaadri (binaarfailid) või rea (ASCII failid) number. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem>
<para
>Loetavate kaadrite (binaarfailid) või ridade (ASCII failid) arv. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s NS</option
></term>
<listitem>
<para
>Igal lugemisel vahele jäetavate kaadrite või ridade arv. See on mõttekas väga suurte andmefailide korral kiiruse suurendamiseks või mälu säästmiseks eriti juhul, kui andmete erinevused on pisikesed. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a</option
></term>
<listitem>
<para
>Kasutatakse koos võtmega <option
>-s NS</option
>: kaadrite vahelejätmise asemel võetakse nende keskmine. See pakub hästi elementaarset andmete filtreerimist ning hoiab kokku mälu. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-F Datafile</option
></term>
<listitem>
<para
>Tühistab .kst-failis antud faili, millest loetakse kõigi vektorite andmed. Saab kasutada ainult koos .kst-failiga. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--print psfile</option
></term>
<listitem>
<para
>Joonise näitamise asemel eksporditakse see PostScript-faili ja väljutakse. Märkus: isegi kui ekraanil ei ole ühtki akent avatud, on siiski vajalik X-serveri töötamine. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--png pngfile</option
></term>
<listitem>
<para
>Joonise näitamise asemel eksporditakse see PNG-faili mõõtmetes 640x480 ja väljutakse. Märkus: isegi kui ekraanil ei ole ühtki akent avatud, on siiski vajalik X-serveri töötamine. </para>
</listitem>
</varlistentry>


</variablelist>

</sect1>

<sect1 id="command-lineexamples">
<title
>Käsurea näited</title>

<para
>Toome siin mõningad tüüpilised kasutamisjuhud. </para>


<para
>ASCII andmetega faili tmp.dat 1. veeru joonistamine: <informalexample
> <screen
><userinput
><command
>kst -y 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>ASCII faili 2., 3. ja 4. veeru joonistamine 1. veeru baasil ühel joonisel: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>ASCII faili 2., 3. ja 4. veeru joonistamine 1. veeru baasil kolme joonisena ühes veerus: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>ASCII faili 2. veeru 500 rea joonistamine alates reast 100: <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 100 -n 500 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>ASCII faili 2. veeru esimese 100 000 rea joonistamine, võttes iga saja rea keskmise: <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

</sect1>


</appendix>