<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
>Brug af kommandolinjen og eksempler</title>
<para
>En typisk brug af Kst er fra kommandolinjen for at oprette X-Y plot for datafiler. Kst kan læse ASCII-data, eller binære filer som er kompatible med readdata. </para>

<sect1 id="command-linesynopsis">
<title
>Kommandolinjesammenfatning</title>
<para
>Flagene er: <cmdsynopsis
><command
>kst</command
> <arg
>Qt-flag</arg
> <arg
>KDE-flag</arg
> <arg
>flag</arg
> <arg rep="repeat"
><replaceable
>fil</replaceable
></arg
> </cmdsynopsis>
</para>

<variablelist>

<varlistentry>
<term
><option
>[fil...]</option
></term>
<listitem>
<para
>En .kst-fil, eller en eller flere datafiler. Formater som understøttes er ASCII-søjler, BOOMERANG rammefiler, eller BLAST dirfile-filer. En .kst-fil gemmer alle valgmuligheder som kan angives med andre flag. Følgende flag kan bruges for at sætte flagene sat i .kst-filen ud af kraft: <option
>-F datafile</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. De øvrige kan ikke sættes ud af kraft. Hvis en flag der sætter andre ud af kraft angives, gælder det alle vektorer i plottet. </para>
<para
>ASCII-data fra stdin kan plottes ved at tage "stdin" med på listen <option
>[fil...]</option
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-y Y</option
></term>
<listitem>
<para
>Kilden for Y-aksens data. For ASCII-filer er det søjlen. For binære filer er det feltnavnet. For at plotte flere kurver, kan dette angives flere gange. Samme kildefil, samplingsinterval og 
X-aksedata antages. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e E</option
></term>
<listitem>
<para
>Fejlbjælker for Y-aksens data. For ASCII-filer angives søjlen som indeholder data. Brug feltnavnet til binære filer. Hvis flere <option
>-y Y</option
> flag angives, kan dette også bruges flere gange. Individuelle Y-flag knyttes sammen i rækkefølge med flere E-indgange. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-x X</option
></term>
<listitem>
<para
>Kilden til X-aksens data. For ASCII-filer er det søjlen. For readdata-filer er det feltnavnet. Hvis flagene ikke angives, bruges linjenummeret i filen. Dette kan kun angives en gang. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-p P</option
></term>
<listitem>
<para
>Kilden til effektspektre. For ASCII-filer er det søjlen. For binære filer er det feltnavnet. For at plotte flere effektspektre for flere kurver, kan dette angives flere gange. Samme kildefil, samplingsinterval og FFT-længder bruges til hvert effektspektrum som der bedes fra kommandolinjen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-l P</option
></term>
<listitem>
<para
>Længden på den FFT som bruges i til at estimere effektspektre er 2^P. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-h H</option
></term>
<listitem>
<para
>Kilden til histogrammer. For ASCII-filer er det søjlen. For binære filer er det feltnavnet. Flere histogrammer kan defineres fra kommandolinjen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-m NC</option
></term>
<listitem>
<para
>Burges når flere kurver er defineret. I stedet for at plotte alle kurver i samme plot, plottes hvert i sit eget plot. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f F0</option
></term>
<listitem>
<para
>Første rammenummer (for readdata-filer) eller linjen (for ASCII-filer) som skal læses. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem>
<para
>Antal rammer (for readdata-filer) eller linjer (for ASCII-filer) som skal læses. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s NS</option
></term>
<listitem>
<para
>Antal rammer eller linjer som skal springes over ved hver indlæsning. Dette er nyttigt ved arbejde med meget store datafiler, for at gøre svartider hurtigere og spare hukommelse, i det tilfælde hvor data varierer langsomt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a</option
></term>
<listitem>
<para
>Bruges sammen med flaget <option
>-S NS</option
>: I stedet for at springe over hver NS-post, tages middelværdien af dem. Det giver en kombination af meget elementær højpasfiltrering, og mindskning af hukommelsesforbrug. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-F datafil</option
></term>
<listitem>
<para
>Sæt filen som data skal læses fra ud af kraft for alle vektorer som angives i .kst-filen. Kan kun bruges sammen med en kst-fil. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--print psfil</option
></term>
<listitem>
<para
>I stedet for at vise plottet, eksportér billedet til en Postscript-fil og afslut. Fejlinformation: Selv om der ikke er noget vindue der vises på skærmen, kræves alligevel adgang til X-serveren. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--png pngfil</option
></term>
<listitem>
<para
>I stedet for at vise plottet, eksportér billedet til en PNG-fil med størrelsen 640x480 og afslut. Fejlinformation: Selv om der ikke vises noget vindue på skærmen, kræves alligevel adgang til X-Serveren. </para>
</listitem>
</varlistentry>


</variablelist>

</sect1>

<sect1 id="command-lineexamples">
<title
>Eksempler på kommandolinjer</title>

<para
>Flere eksempler på typisk brug følger. </para>


<para
>For at plotte søjle 1 i filen (tmp.dat) med ASCII-data: <informalexample
> <screen
><userinput
><command
>kst -y 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>For at plotte søjle 2, 3 og 4 mod søjle 1 fra en ASCII-fil i et plot: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>For at plotte søjle 2, 3 og 4 mod søjle 1 fra en ASCII-fil i tre plot, arrangerede i en søjle: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>For at plotte 500 linjer i søjle 2 fra en ASCII-fil, begyndende med linje 100: <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 100 -n 500 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>For at lotte de første 100 000 linjer af søjle 2 fra en ASCII-fil, med dannelse af middelværdi for hver 100. række: <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

</sect1>


</appendix>