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