<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
>Het gebruik van de commandoregel en voorbeelden</title>
<para
>Kst kan typisch worden gebruikt voor het maken van XY-plots van gegevensbestanden vanaf de commandoregel. Kst kan ascii-gegevens lezen en binaire bestanden die compatibel zijn met (de kst-functie) "readdata" (lezen van gegevens). </para>

<sect1 id="command-linesynopsis">
<title
>Overzicht commandoregel</title>
<para
>De opties zijn: <cmdsynopsis
><command
>kst</command
> <arg
>Qt-options</arg
> <arg
>KDE-options</arg
> <arg
>options</arg
> <arg rep="repeat"
><replaceable
>bestand</replaceable
></arg
> </cmdsynopsis>
</para>

<variablelist>

<varlistentry>
<term
><option
>[bestand...]</option
></term>
<listitem>
<para
>Een kst-bestand, of een of meer gegevensbestanden. Ondersteunde bestandstypen zijn ASCII-kolommen, BOOMERANG frame-bestanden, of BLAST dirfile-bestanden.In een .kst-bestand zijn alle opties opgenomen die door andere opties kunnen worden gewijzigd. De volgende opties kunnen worden gebruikt om de opties ingesteld in het .kst-bestand te wijzigen: <option
>-F datafile</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. De rest kan niet worden gewijzigd. Wijzigingen gelden voor alle vectoren in de plot. </para>
<para
>ASCII-gegevens afkomstig van stdin (het toetsenbord) kunnen worden geplot door "stdin" op te nemen in de lijst <option
>[bestand...]</option
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-y Y</option
></term>
<listitem>
<para
>De bron voor de Y-asgegevens. In ASCII-bestanden is dit de kolom. In binaire bestanden is dit de veldnaam. Om meerdere krommen tegelijk te plotten kan dit meerdere keren worden opgegeven. Hierbij worden hetzelfde bronbestand, intervallen voor bemonstering (sample ranges) en gegevens voor de X-as aangenomen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e E</option
></term>
<listitem>
<para
>Foutbalken voor de Y-asgegevens. In een ASCII-bestand: zie de kolom die de gegevens bevat. In binaire bestanden gebruikt u de veldnaam. Bij meerdere <option
>-y Y</option
>-opties kan dit ook meerdere keren worden gebruikt. Individueel ingevoerde Y-waarden worden in verband gebracht met meervoudige foutbalkgegevens. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-x X</option
></term>
<listitem>
<para
>De bron voor de X-asgegevens. In ASCII-bestanden is dit de kolom. In "readdata"- bestanden is dit de veldnaam. Als deze optie niet opgegeven is wordt het rijnummer in het bestand gebruikt. Deze optie kan maar een keer worden opgegeven. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-p P</option
></term>
<listitem>
<para
>De bron voor Fourierspectra. In ASCII-bestanden is dit de kolom. In binaire bestanden is dit de veldnaam. Om Fourierspectra voor meerdere krommen tegelijk te plotten kan deze meerdere keren worden opgegeven. Voor alle Fourierspectra waarom vanaf de commandoregel wordt gevraagd worden hetzelfde bronbestand, intervallen voor bemonstering (sample ranges) en FFT-lengtes gebruikt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-l P</option
></term>
<listitem>
<para
>De lengte van de FFT (Fast Fourier Transform, snel algoritme voor Foutiertransformatie) die wordt gebruikt voor de benadering van het Fourierspectrum is 2^p. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-h H</option
></term>
<listitem>
<para
>De bron voor histogrammen. In ASCII-bestanden is dit de kolom. In binaire bestanden is dit de veldnaam. Vanaf de commandoregel kunnen meerdere histogrammen tegelijk worden gedefinieerd. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-m NC</option
></term>
<listitem>
<para
>Wordt gebruikt als er meerdere krommen zijn gedefinieerd. In plaats van ze alle in dezelfde plot te tekenen wordt elke plot apart getekend. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f F0</option
></term>
<listitem>
<para
>Het nummer van de frame vanaf welke het lezen wordt gestart (voor "readdata"bestanden) of rij (voor ASCII-bestanden). </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem>
<para
>Het aantal frames (voor "readdata"bestanden) of rijen (voor ASCII-bestanden) die moeten worden gelezen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s NS</option
></term>
<listitem>
<para
>Het aantal frames of rijen die bij het lezen steeds moeten worden overgeslagen. Dit is nuttig bij het lezen van erg grote gegevensbestanden om de verwerking te versnellen en om geheugen te besparen in het geval dat de gegevens slechts langzaam veranderen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a</option
></term>
<listitem>
<para
>Gebruikt met de optie <option
> -s NS</option
>: in plaats van elke NS frames over te slaan worden die gemiddeld. Hiermee verkrijgt men een combinatie van een erg eenvoudig hoogdoorlaat filter (high pass filtering) en een geheugenbesparing. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-F Datafile</option
></term>
<listitem>
<para
>In plaats van uit het gegevensbestand worden alle vectoren gelezen uit het .kst-bestand. Kan alleen in samenwerking met een .kst-bestand worden gebruikt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--print psfile</option
></term>
<listitem>
<para
>In plaats van de plot op het scherm te tonen wordt de afbeelding geëxporteerd naar een postscript-bestand en het programma verlaten. *BUG opmerking: hoewel er op het scherm geen vensters zijn geopend is toegang tot de X-server toch vereist.* </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--png pngfile</option
></term>
<listitem>
<para
>In plaats van de plot op het scherm te tonen wordt de afbeelding geëxporteerd naar een .pngbestand met de afmetingen 640x480 en het programma verlaten. *BUG opmerking: hoewel er op het scherm geen vensters zijn geopend is toegang tot de X-server toch vereist.* </para>
</listitem>
</varlistentry>


</variablelist>

</sect1>

<sect1 id="command-lineexamples">
<title
>Voorbeelden van de commandoregel</title>

<para
>U ziet hier enkele voorbeelden van een typisch gebruik. </para>


<para
>Om kolom 1 te plotten van een bestand (tmp.dat) met ASCII-gegevens: <informalexample
> <screen
><userinput
><command
>kst -y 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>Om de kolommen 2, 3 en 4 te plotten tegen kolom 1 van een ASCII-bestand, in 1 plot: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>Om de kolommen 2, 3 en 4 te plotten tegen kolom 1 van een ASCII-bestand, in 3 plots, gerangschikt in 1 kolom: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>Om 500 rijen van kolom 2 te plotten van een ASCII-bestand vanaf rij 100 <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 100 -n 500 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>Om de eerste 100.000 rijen van kolom 2 te plotten van een ASCII-bestand, waarbij steeds elke 100 rijen worden gemiddeld: <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

</sect1>


</appendix>