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