<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "kst">
 <!ENTITY package "kdeextragear-2">
 <!ENTITY kst "<application
>KST</application
>">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % Danish "INCLUDE"
> <!-- change language only here -->
 ]>

<book lang="&language;">
<bookinfo>
<title
>&kst;-håndbogen</title>
<authorgroup>
<author
><firstname
>Barth</firstname
> <surname
>Netterfield</surname
> <affiliation
> <address
><email
>kst@omega.astro.utoronto.ca</email
></address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Erik Kjær</firstname
><surname
>Pedersen</surname
><affiliation
><address
><email
>erik@binghamton.edu</email
></address
></affiliation
><contrib
></contrib
></othercredit
>
</authorgroup>

<date
>2002-07-27</date>
<releaseinfo
>0.72</releaseinfo>

<abstract>
<para
>Kst er et todimensionalt plotte- og datavisningsprogram, med bekvemme kommandolinjeflag, kraftfuld forstørrelse med mus og tastatur, og mulighed for at indspille diagramoversigter i realtid. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kst</keyword>

</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Indledning</title>

<sect1 id="features">
<title
>Funktioner</title>

<para
>Dokumentationen for Kst var ikke færdig da du installerede programmet. Hvis du vil skrive den, så fortæl CBN om det. Hvis du kender CBN, kan du prøve at få ham til at skrive den. Ellers må du være tålmodig... </para>

</sect1>
</chapter>

<chapter id="command-line">
<title
>Brug af kommandolinje og eksempler</title>


<para
>En typisk brug af Kst er fra kommandolinjen, for at oprette X-Y plot af datafiler. Kst kan læse ASCII-data, eller binære filer som virker med readdata. Valgmulighederne er: </para>

<sect1 id="command-line-synopsis">
<title
>Kommandolinjeflag</title>

<synopsis
>kst [Qt-flag] [KDE-flag] [flag] [filer]
</synopsis>

<para
><option
>[filer]</option
> 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 opbevarer al information som kan indstilles med andre flag. Følgende flag kan bruges til at sætte flag som er indstillet i .kst-filen ud af kraft: <option
>-F datafil</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. Resten kan ikke sættes ud af kraft. Hvis et flag angives, så anvendes det på alle vektorer i plottet. </para>
<para
>ASCII-data fra standardindtastningen kan tegnes op ved at angive "stdin" i listen med <option
>[filer]</option
>. </para>

<para
><option
>-y Y</option
> Kilden til y-aksens data. For ASCII-filer er det søjlen. For binære filer er det feltnavnet. For at tegne flere kurver, kan det angives flere gange. Samme kildefil, samplingsinterval og X-akse-data antages. </para>

<para
><option
>-e E</option
> Fejlbjælker for y-akse-data. For ASCII-filer angiver det søjlen som indeholder data. For binære filer bruges feltnavnet. Hvis flere flag <option
>-y Y</option
> angives, kan dette også angives flere gange. Enkelte Y-flag tilknyttes flere E-flag i rækkefølge. </para>

<para
><option
>-x X</option
> Kilden til x-aksens data. For ASCII-filer er det søjlen. For readdata-filer er det feltnavnet. Hvis det ikke angives bruges linjenummeret i filen. Flaget kan kun angives en gang. </para>

<para
><option
>-p P</option
> Kilden til effektspektrum. For ASCII-filer er det søjlen. For binære filer er det feltnavnet. For at plotte effektspektrum for flere kurver, kan det angives flere gange. Samme kildefil, samplingsinterval og FFT-længder bruges for alle effektspektre som der bedes om på kommandolinjen. </para>

<para
><option
>-l P</option
> Længde af den FFT som bruges til at estimere effektspektrum er 2^P. </para>

<para
><option
>-h H</option
> Kilden for histogram. For ASCII-filer er det søjlen. For binære filer er det feltnavnet. Flere histogrammer kan angives på kommandolinjen. </para>

<para
><option
>-m NC</option
> Bruges når flere kurver er defineret. I stedet for at plotte alle kurver i samme diagram, plottes hver i sit eget plot. </para>

<para
><option
>-f F0</option
> Indledende rammenummer (for readdata-filer) eller række (for ASCII-filer) at læse. </para>

<para
><option
>-n</option
> Antal rammer (for readdata-filer) eller rækker (for ASCII-filer) at læse. </para>

<para
><option
>-s NS</option
> Antal rammer eller rækker at springe over for hver læsning. Dette er nyttigt ved arbejde med meget store datafiler, for at gøre svarstiden hurtigere og spare hukommelse, i det tilfælde hvor data varierer langsomt. </para>

<para
><option
>-a</option
> Brugt med <option
> -s NS</option
>: i stedet for at springe over NS-rammer, tages middelværdien af dem. Dette sørger for en kombination af meget grundlæggende højpasfiltrering og at gemme hukommelse. </para>
<para
><option
>-F datafil</option
> Sæt filen filen at læse data fra for alle vektorer som angives i .kst-filen ud af kraft. Kan kun bruges sammen med en .kst-fil. </para>

<para
><option
>--print psfil</option
> I stedet for at vise plottet, eksporteres billedet til en Postscript-fil og der afsluttes. *Fejlinformation: selvom intet vindue åbnes på skærmen, så kræves stadigvæk adgang til X-serveren.* </para>

<para
><option
>--png pngfil</option
> I stedet for at vise plottet, eksporteres billedet til en png-fil med dimensionen 640x480 og der afsluttes. *Fejlinformation: selvom ingen vinduer åbnes på skærmen, så kræves stadigvæk adgang til X-serveren.* </para>

</sect1>

<sect1>
<title
>Eksempel 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: </para>

<synopsis
>omega% kst -y 1 tmp.dat
</synopsis>

<para
>For at plotte søjle 2, 3 og 4 mod søjle 1 fra en ASCII-fil i et plot: </para>

<synopsis
>omega% kst -x 1 -y 2 -y 3 -y 4 tmp.dat
</synopsis>

<para
>For at plotte søjle 2, 3 og 4 mod søjle 1 fra en ASCII-fil i tre plot, arrangeret i en søjle: </para>

<synopsis
>omega% kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat
</synopsis>

<para
>For at plotte 500 linjer af søjle 2 fra en ASCII-fil, begyndende på linje 100: </para>

<synopsis
>omega% kst -y 2 -f 100 -n 500 tmp.dat
</synopsis>

<para
>For at plotte de første 100 000 linjer af søjle 2 fra en ASCII-fil, med middelværdidannelse af hver 100 rækker: </para>

<synopsis
>omega% kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat
</synopsis>

</sect1>

</chapter>

<chapter id="questions-answers-and-tips">
<title
>Spørgsmål, svar og vink</title>

<sect1 id="question-1">
<title
>Spørgsmål 1</title>

<para
>Svaret - gæt.</para>

</sect1>

</chapter>

<appendix id="installation">
<title
>Installation</title>

<para
>Ikke skrevet endnu </para>

<sect1 id="how-to-obtain-pab">
<title
>Hvordan får man fat på Kst</title>

<para
>Ikke skrevet endnu </para>

</sect1>

<sect1 id="requirements">
<title
>Krav</title>

<para
>Ikke skrevet endnu </para>

</sect1>

<sect1 id="compilation-and-installation">
<title
>Kompilering og installation</title>

<para
>Kompilering er meget enkel. Følgende skulle klare det: <screen
>&percnt; ./configure
&percnt; make
&percnt; make install 
</screen>
</para>

<para
>Det skulle gøre det. Skulle du støde på problemer, så rapportér dem gerne til forfatteren på <email
>cbn@omega.astro.utoronto.ca</email
>.</para>
&underFDL; </sect1>
</appendix>

</book>

