<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
>Användning av kommandorad och exempel</title>
<para
>En typisk användning av Kst är från kommandoraden för att skapa X-Y diagram av datafiler. Kst kan läsa ASCII-data, eller binärfiler som fungerar med readdata. </para>

<sect1 id="command-linesynopsis">
<title
>Kommandoradsväljare</title>
<para
>Väljarna är: <cmdsynopsis
><command
>kst</command
> <arg
>Qt-väljare</arg
> <arg
>KDE-väljare</arg
> <arg
>väljare</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 flera datafiler. Format som stöds är ASCII-kolumner, BOOMERANG postfiler, eller BLAST dirfile-filer. En .kst-fil lagrar alla alternativ som kan anges med andra väljare. Följande väljare kan användas för att överskrida alternativen i .kst-filen: <option
>-F datafile</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. Övriga kan inte överskridas. Om en överskridande väljare anges, gäller den alla vektorer i diagrammet. </para>
<para
>ASCII-data från standardinmatningen kan ritas upp genom att ta med "stdin" i listan <option
>[fil...]</option
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-y Y</option
></term>
<listitem>
<para
>Källan för Y-axelns data. För ASCII-filer är det kolumnen. För binärfiler är det fältnamnet. För att rita upp flera kurvor, kan detta anges flera gånger. Samma källfil, samplingsintervall och 
X-axeldata antas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e E</option
></term>
<listitem>
<para
>Felstaplar för Y-axelns data. För ASCII-filer ange kolumnen som innehåller data. Använd fältnamnet för binärfiler. Om flera <option
>-y Y</option
> väljare anges, kan detta också användas flera gånger. Individuella Y väljare kopplas ihop i ordning med flera E väljare. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-x X</option
></term>
<listitem>
<para
>Källan för X-axelns data. För ASCII-filer är det kolumnen. För readdata-filer är det fältnamnet. Om väljaren inte anges, används radnumret i filen. Väljaren kan bara anges en gång. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-p P</option
></term>
<listitem>
<para
>Källan för effektspektrum. För ASCII-filer är det kolumnen. För binärfiler är det fältnamnet. För att rita upp flera effektspektrum för flera kurvor, kan detta anges flera gånger. Samma källfil, samplingsintervall och FFT-längder används för varje effektspektrum som begärs från kommandoraden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-l P</option
></term>
<listitem>
<para
>Längden på den FFT som används i uppskattningar av effektspektrum är 2^P. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-h H</option
></term>
<listitem>
<para
>Källan för histogram. För ASCII-filer är det kolumnen. För binärfiler är det fältnamnet. Flera histogram kan definieras från kommandoraden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-m NC</option
></term>
<listitem>
<para
>Används när flera kurvor har definierats. Istället för att rita upp alla kurvor i samma diagram, rita upp var och en i ett eget diagram. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f F0</option
></term>
<listitem>
<para
>Första postnumret (för readdata-filer) eller raden (för ASCII-filer) som ska läsas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-n</option
></term>
<listitem>
<para
>Antal poster (för readdata-filer) eller rader (för ASCII-filer) som ska läsas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s NS</option
></term>
<listitem>
<para
>Antal poster eller rader som ska hoppas över vid varje inläsning. Detta är användbart vid arbete med mycket stora datafiler, för att snabba upp svarstider och spara minne, i fallet då data varierar långsamt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a</option
></term>
<listitem>
<para
>Används tillsammans med väljaren <option
>-S NS</option
>: Istället för att hoppa över varje NS-post, medelvärdesbilda dem. Det ger en kombination av mycket elementär högpassfiltrering, och minskning av minnesbehovet. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-F datafil</option
></term>
<listitem>
<para
>Överskrid filen som data ska läsas från för alla vektorer som anges i .kst-filen. Kan bara användas ihop med en kst-fil. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--print psfil</option
></term>
<listitem>
<para
>Istället för att visa diagrammet, exportera bilden till en Postskript-fil och avsluta. Felinformation: Även om inga fönster visas på skärmen, krävs ändå åtkomst till X-servern. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--png pngfil</option
></term>
<listitem>
<para
>Istället för att visa diagrammet, exportera bilden till en PNG-fil med storleken 640x480 och avsluta. Felinformation: Även om inga fönster visas på skärmen, krävs ändå åtkomst till X-servern. </para>
</listitem>
</varlistentry>


</variablelist>

</sect1>

<sect1 id="command-lineexamples">
<title
>Exempel på kommandorader</title>

<para
>Flera exempel på typisk användning följer. </para>


<para
>För att rita upp kolumn 1 i filen (tmp.dat) med ASCII-data: <informalexample
> <screen
><userinput
><command
>kst -y 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>För att rita upp kolumn 2, 3 och 4 mot kolumn 1 från en ASCII-fil i ett diagram: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>För att rita upp kolumn 2, 3 och 4 mot kolumn 1 från en ASCII-fil i tre diagram, arrangerade i en kolumn: <informalexample
> <screen
><userinput
><command
>kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>För att rita upp 500 rader av kolumn 2 från en ASCII-fil, med början på rad 100: <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 100 -n 500 tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

<para
>För att rita upp de första 100 000 raderna av kolumn 2 från en ASCII-fil, med medelvärdesbildning av var 100:e rad: <informalexample
> <screen
><userinput
><command
>kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</command
></userinput
></screen>
</informalexample>
</para>

</sect1>


</appendix>