<appendix id="command-lineoptions">

<appendixinfo>
<author
><firstname
>Barth</firstname
> <surname
>Netterfield</surname
> <affiliation
> <address
><email
>netterfield@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 eller Z-bilder av datafiler. Kst kan läsa ASCII-data, eller binärfiler som fungerar med readdata/dirfile, och valfritt (med externa bibliotek) FITS-bilder, PIOLib-filer, netCDF-filer och HEALPix FITS-filer. </para>

<refentry id="command-linesynopsis">

<refmeta>
<refentrytitle
>Kommandoradsväljare i &kst;</refentrytitle>
</refmeta>

<refnamediv>
<refname
>kst</refname>
<refpurpose
>Ett program för diagramritning och datavisning</refpurpose>
</refnamediv>


<refsynopsisdiv>
<para
>Väljarna är:</para>
<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>
</refsynopsisdiv>

<refsect1 id="cmdline-options">
<title
>Väljare</title>

<variablelist>

<varlistentry>
<term
><option
><replaceable
>[fil...]</replaceable
></option
></term>
<listitem>
<para
>En .kst-fil, eller en eller flera datafiler. Format som stöds är ASCII-kolumner, BOOMERANG postfiler, BLAST dirfile-filer, och andra typer med valfritt stöd. 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
>--ye ekvation</option
></term>
<listitem>
<para
>Värden för Y-axelns data beräknas från angiven ekvation. Flera ekvationer är tillåtna. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--xe X</option
></term>
<listitem>
<para
>Använd ekvationen <userinput
>x0:x1:n</userinput
> för att ange X-vektorn (INDEX). x0:x1 anger vektorns intervall, och n anger antal värden i X-vektorn. </para>
<para
>t.ex. skapar -10:10:21 följande statiska vektor: X = {-10,-9,-8,...0...8,9,10} </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-E text</option
></term>
<listitem>
<para
>Skicka argument till en utökning. Formatet för <userinput
>text</userinput
> är <userinput
>utökningsnamn:argumentlista</userinput
>. </para
><para
>t.ex. <command
>kst -E js:"loadScript('intplTest.js')"</command
> </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
>-z Z</option
></term>
<listitem>
<para
>Källan för Z-matrisdata (som visas som en bild). För ASCII-filer är det kolumnen som innehåller Z-data. För andra valfria format (HEALPix, FITS-bilder, etc.), är det namnet på det önskade matrisfältet, som det visas i matrisdialogrutan. Vissa datakällor som fungerar med matriser tillåter också att ett alias används som är numret på det önskade matrisfältet. För att rita upp flera matriser kan den upprepas många gånger. </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
>-r f</option
></term>
<listitem>
<para
>Ange samplingsfrekvens <userinput
>f</userinput
> för effektspektrum </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--ru U</option
></term>
<listitem>
<para
>Ange enhet <userinput
>U</userinput
> för effektspektrats samplingsfrekvens </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--yu U</option
></term>
<listitem>
<para
>Ange enhet <userinput
>U</userinput
> för effektspektrats samplingsfrekvens </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
>-g</option
></term>
<listitem>
<para
>Tillhandahåll en förklaringsruta </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-w fil</option
></term>
<listitem>
<para
>Visa dataguiden </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>--nq</option
></term>
<listitem>
<para
>Hoppa över snabbstartsdialogrutan </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>

</refsect1>

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

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

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

</para>
</informalexample>

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


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

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

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


<informalexample>
<para
>Använd kommandot för att rita upp ett spektrum från ett datafält i en ASCII-datafil med samplingsfrekvensen = 10 Hz och FFT-längden = 2^14 <screen
><userinput>
<command>
kst -p 2 /usr/share/apps/kst/tutorial/gyrodata.dat -r 10 -l 14
</command>
</userinput
>
</screen>
</para>
</informalexample>


<informalexample>
<para
>(Med användning av valfri HEALPix-datakälla) För att rita upp de tre första avbildningarna i en HEALPix FITS-fil med ett 2x2 rutmönster: <screen
><userinput
><command
>kst -z 1 -z 2 -z 3 -m 2 healpix_exempel_sm.fits</command
></userinput
></screen>
</para>
</informalexample>

<informalexample>
<para
>(Med användning av valfri HEALPix-datakälla) För att rita upp en avbildning med ett särskilt fältnamn i en HEALPix FITS-fil: <screen
><userinput
><command
>kst -z "1 - TEMPERATUR (Kelvin)" healpix_exempel_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:
-->
