<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>