<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 eller Z-billeder ud fra datafiler. Kst kan læse ASCII-data, readdata/dirfile kompatible binære filer, og hvis du vil (med eksterne biblioteker) FITS-billeder, PIOLib-filer, netCDF-filer, og HEALPix FITS filer. </para>

<refentry id="command-linesynopsis">

<refmeta>
<refentrytitle
>&kst;'s kommandolinjesammenfatning</refentrytitle>
</refmeta>

<refnamediv>
<refname
>kst</refname>
<refpurpose
>Et program til plot og datavisning</refpurpose>
</refnamediv>


<refsynopsisdiv>
<para
>Flagene er:</para>
<cmdsynopsis
><command
>kst</command
> <arg
>Qt-flag</arg
> <arg
>KDE-flag</arg
> <arg
>flag</arg
> <arg rep="repeat"
><replaceable
>fil</replaceable
></arg
> </cmdsynopsis>
</refsynopsisdiv>

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

<variablelist>
<!-- TODO: Add <replaceable
>s here -->
<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, BLAST dirfile-filer og andre mulige typer .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 et 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
>-z Z</option
></term>
<listitem>
<para
>Kilden for Z matrixdata (som bliver vist som et billede). For ASCII-filer er dette søjlen der indeholder z-data. For andre mulige formater (HEALPix, FITS-billede osv), er dette navnet på det ønskede matrix-felt, som vist i matrix-dialogen. Nogle matrix-kompatible datakilder tillader også at bruge  et alias som er nummeret for det ønskede matrix-felt. For at plot flere matricer, kan dette angives flere gange. </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>

</refsect1>

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

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

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

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


<informalexample>
<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: <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

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

<informalexample>
<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: <screen
><userinput
><command
>kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>(Ved brug af den mulige HEALPix Datakilde) For at plotte de første 3 kort i en HEALPix FITS fil i et 2x2 gitter: <screen
><userinput
><command
>kst -z 1 -z 2 -z 3 -m 2 healpix_example_sm.fits</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>(Ved brug af den mulige HEALPix Datakilde) For at plotte et kortmed et specifikt feltnavn i en HEALPix FITS fil: <screen
><userinput
><command
>kst -z "1 - TEMPERATURE (Kelvin)" healpix_eksempel_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:
-->
