<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 of Z-afbeeldingen van gegevensbestanden vanaf de commandoregel. Kst kan ASCII-gegevens lezen, binaire bestanden die compatibel zijn met (de kst-functies) "readdata" en "dirfile", en optioneel (hiervoor zijn externe bibliotheken nodig) FITS-afbeeldingen, PIOLib-bestanden, vetCDF-bestanden en HEALPix FITS-bestanden. </para>

<refentry id="command-linesynopsis">

<refmeta>
<refentrytitle
>&kst; Samenvatting opdrachtregels</refentrytitle>
</refmeta>

<refnamediv>
<refname
>kst</refname>
<refpurpose
>Een programma voor het plotten en het bekijken van gegevens</refpurpose>
</refnamediv>


<refsynopsisdiv>
<para
>De opties zijn:</para>
<cmdsynopsis
><command
>kst</command
> <arg
>Qt-opties</arg
> <arg
>KDE-opties</arg
> <arg
>opties</arg
> <arg rep="repeat"
><replaceable
>bestand</replaceable
></arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id="cmdline-options">
<title
>Opties</title>

<variablelist>
<!-- TODO: Add <replaceable
>s here -->
<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 en andere optioneel ondersteunde bestandstypen. 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
>-z Z</option
></term>
<listitem>
<para
>De bron van de gegevens voor de Z-matrix (die als een afbeelding wordt weergegeven). In ASCII-bestanden is dit de kolom met de z-gegevens. Bij andere optionele bestandstypen (HEALPix, FITS-afbeelding enz.) is dit de naam van het gewenste gegevensveld, zoals te zien in de matrix-dialoog. In sommige matrix-compatibele gegevensbronnen kan ook een alias worden gebruikt die het nummer is van het gewenste veld in de matrix. Om meer dan een matrix te plotten kan dit meerdere keren 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>

</refsect1>

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

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

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

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


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

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

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

<informalexample>
<para
>(Met gebruik van een optionele HEALPix gegevensbron) Om de eerste 3 afbeeldingen te plotten in een HEALPix FITS-bestand in een 2x2 schema: <screen
><userinput
><command
>kst -z 1 -z 2 -z 3 -m 2 healpix_example_sm.fits</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>(Met gebruik van een optionele HEALPix gegevensbron) Om een afbeelding met een bepaalde naam te plotten in een HEALPix FITS-gegevensbestand: <screen
><userinput
><command
>kst -z "1 - TEMPERATURE (Kelvin)" healpix_example_sm.fits</command
></userinput
></screen>
</para>
</informalexample>

</refsect1>

</refentry>

</appendix>


<!-- 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" "appendix")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
