<chapter id="workingwithdata">
<title
>Arbeta med data</title>

<sect1 id="fileformats">
<title
>Filformat som stöds</title>
<para
>För närvarande stöder Kst ASCII-textfiler, BOOMERANG postfiler och BLAST dirfile-filer som datakällor, samt PIOLib- och FITS-filer med lämpliga bibliotek. Det här avsnittet beskriver grundläggande begrepp för datakällor som är gemensamma för alla filtyper, och specifika detaljer för ASCII- och BLAST dirfile-filer. </para>

<sect2 id="supportingadditionalfileformatsdatasourceconcepts">
<title
>Begrepp för datakällor</title>
<para
>En datakälla i &kst; är helt enkelt en datafil som stöds. Följande begrepp är viktiga för att förstå hur &kst; arbetar med olika datakällor. Viss terminologi introduceras också i avsnittet. </para>

<sect3 id="supportingadditionalfileformatsdatasourceconceptssamples">
<title
>Samplingar</title>
<para
>En sampling anses vara den grundläggande enheten med avseende på datafiler. Varje sampling består av ett datavärde i filen. Observera dock att en sampling kanske inte motsvarar ett värde i en datavektor i &kst;, beroende på begreppet <link linkend="supportingadditionalfileformatsdatasourceconceptsframes"
>poster</link
>. </para>
</sect3>

<sect3 id="supportingadditionalfileformatsdatasourceconceptsfields">
<title
>Fält</title>
<para
>Ett fält motsvarar oftast en vektor i &kst;. En kolumn i en ASCII-datafil anses till exempel vara ett fält. Varje fält kan ha ett explicit eller implicit namn. Läsare av datakällor tillhandahåller funktioner för att läsa och hämta fält och fältnamn. </para>
</sect3>

<sect3 id="supportingadditionalfileformatsdatasourceconceptsframes">
<title
>Poster</title>
<para
>En post motsvarar ett fast antal samplingar, och varje fält i en datafil kan ha sin eget antal samplingar per post. Storleken på en datafil mäts i antal poster den innehåller. I de flesta fall är antalet samplingar per post 1, men för vissa datafiler kan det finnas flera samplingar per post. I illustrationen nedan visas de tre första posterna i en tänkt datafil. I den här speciella datafilen har fält 1 förhållandet 5 samplingar per post, fält 2 har förhållandet 2 samplingar per post, fält 3 har förhållandet 3 samplingar per post och fält 4 har förhållandet 1 sampling per post. </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Diagram-kst-frames.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>Beroende på specifika inställningar för datavektorer i &kst;, kan data från filer läsas som poster istället för samplingar, där antingen den första samplingen i en post eller medelvärdet av alla samplingar i en post motsvarar postens värde. </para>
</sect3>

<sect3 id="supportingadditionalfileformatsdatasourceconceptsindex">
<title
>INDEX-fält</title>
<para
>Vissa datafiler kanske inte har ett fält som representerar X-axeln i ett diagram. &kst; skapar implicit ett INDEX-fält för alla datakällor. INDEX-fältet innehåller helt enkelt heltal från 0 till N-1, där N är antal rader i datafilen. </para>
</sect3>

</sect2>

<sect2 id="creatingascii">
<title
>ASCII-indatafiler</title>
<para
>Det enklaste indatafilformatet är ASCII-textfiler. Dessa filer kan oftast läsas av människor och kan enkelt skapas för hand eller med enkla skript om så önskas. Det följande är ett exempel på en ASCII-indatafil: </para>

<informalexample>
<screen
>112.5 3776 428
187.5 5380 429
262.5 5245 345
337.5 2942 184
412.5 1861 119
487.5 2424 138
567.5 2520 162
637.5 1868 144
712.5 1736 211
787.5 1736 211
862.5 2172 292
937.5 1174 377
1000.5 499 623
</screen>
</informalexample>

<para
>Varje kolumn i filen representerar ett fält, medan varje rad representerar en post. Kolumner åtskiljs med tabulatorer eller mellanslag, och rader åtskiljs med returtecken. Observera att beroende på sin struktur, kan inte ASCII-filer ha flera samplingar per post. Dessutom, eftersom kolumnerna inte har rubriker, tilldelas fältnamn av &kst; baserat på kolumnernas ordning (kolumnen längst till vänster har fältnamnet <literal
>1</literal
>). </para>

<para
>Kommentarrader i ASCII-filer börjar med ett av tecknen i uppsättningen <literal
>{#, !, /, ;, c}</literal
>. Alla kommentarrader och tomma rader ignoreras av &kst;. Giltiga tal omfattar de med decimaler, minustecken eller <literal
>e</literal
> för att ange vetenskaplig notation. Ogitliga tal (som engelska ord) ersätts med 0 av &kst;. </para>

</sect2>


<sect2 id="blastdirfiles">
<title
>BLAST dirfile-filer</title>
<para
>Datakällorna med BLAST dirfile-filer är i själva verket kataloger med filer. Varje katalog representerar en datakälla, och varje fil i katalogen, med undantag för en fil som heter <filename
>format</filename
>, representerar ett enstaka fält. FIlen som heter <filename
>format</filename
> listar varje fält och dess egenskaper. Nedan visas ett exempel på en sådan fil: </para>
<informalexample>
<screen
>scount RAW f 1
fcount RAW f 20
sine RAW f 20
ssine RAW f 1
cos RAW f 20</screen>
</informalexample>
<para
>I det här exemplet är <literal
>scount</literal
>, <literal
>fcount</literal
>, <literal
>sine</literal
>, <literal
>ssine</literal
> och <literal
>cos</literal
> fältnamn. <literal
>RAW</literal
> anger att filen är skriven med obehandlat format, och det sista talet på varje rad är antal samplingar per post. </para>

<para
>När en BLAST dirfile-fil väljes för användning i &kst; ska katalogen som innehåller fältfilerna väljas. &kst; letar automatiskt efter filen <filename
>format</filename
>, om den finns, för att ta reda på fälten och deras egenskaper. </para>

</sect2>
</sect1>

<sect1 id="datawizard">
<title
>Dataguiden</title>
<para
>Dataguiden tillhandahåller ett snabbt och enkelt sätt att skapa vektorer, kurvor och diagram i &kst; från datafiler. För att starta guiden, välj <guimenuitem
>Dataguide...</guimenuitem
> i menyn <guimenu
>Data</guimenu
>. Du blir tillfrågad om att välja en datakälla. Bläddra till en giltig datafil (eller skriv in sökvägen till datafilen) och klicka <guibutton
>Nästa</guibutton
>. Följande fönster visas. </para>
<screenshot>
<screeninfo
>Dataguidens andra skärm</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Dataguidens andra skärm</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Välj fälten du vill importera till &kst;. Du kan filtrera listan med fält genom att skriva in en sträng som matchar (jokertecken som <literal
>*</literal
> stöds) i textrutan ovanför listan. </para>

<para
>Avdelningen <guilabel
>Dataintervall</guilabel
> används för att ange dataintervallet som ska läsas för de valda vektorerna i indatafilen. Följande beskrivning förutsätter kännedom om <quote
>poster</quote
>. För en detaljerad beskrivning av begreppet, se <link linkend="fileformats"
>Filformat</link
>. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Startpost</guilabel
>, <guilabel
>Räkna från slutet</guilabel
>, <guilabel
>Antal poster</guilabel
> och <guilabel
>Läs till slutet</guilabel
> </term>
<listitem>
<para
>Genom att använda de här fyra inställningarna, kan nedre och övre gräns för dataintervallet anges. För att till exempel läsa från post 10 till 900, skriv in <userinput
>10</userinput
> för <guilabel
>Startpost</guilabel
> och <userinput
>890</userinput
> för <guilabel
>Antal poster</guilabel
>. För att läsa från post 500 till filens slut, skriv in <userinput
>500</userinput
> för <guilabel
>Startpost</guilabel
> och markera alternativet <guilabel
>Läs till slutet</guilabel
>. För att bara läsa de 450 sista posterna från filen, markera alternativet <guilabel
>Räkna från slutet</guilabel
> och skriv in <userinput
>450</userinput
> för <guilabel
>Antal poster</guilabel
>. Kombinationerna som används i de två föregående exemplen är ofta användbara för att läsa data från en fil som uppdateras i realtid. Efterföljande tillägg i filen läses, vilket gör att tillhörande vektorer också uppdateras. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Läs en sampling per N poster</guilabel
> och <guilabel
>Lågpassfilter först</guilabel
> </term>
<listitem>
<para
>Förutom nedre och övre gräns för dataintervallet, kan samplingarna som ska läsas från det valda intervallet anges. Om <guilabel
>Läs en sampling per N poster</guilabel
> (där N är det angivna värdet) inte är markerad, läses alla samplingar i det valda intervallet. Som alternativ, kan poster i datafilen hoppas över genom att markera <guilabel
>Läs en sampling per N poster</guilabel
>. Värdet på den sampling som används för att representera en post beror på om <guilabel
>Lågpassfilter först</guilabel
> markeras. Om <guilabel
>Lågpassfilter först</guilabel
> inte är markerat, är värdet samma som första samplingen i posten. Om <guilabel
>Lågpassfilter först</guilabel
> är markerat, är värdet medelvärdet av alla samplingar i den speciella posten. </para>
</listitem>
</varlistentry>
</variablelist>



<para
>Inställningar av effektspektrum och X-axel kan anges inne i avdelningen <guilabel
>Diagramtyper</guilabel
>. Inställningarna beskrivs nedan: </para>

<variablelist>

<varlistentry>
<term
><guilabel
>X-Y</guilabel
>, <guilabel
>Effektspektrum</guilabel
> och <guilabel
>X-Y och effektspektrum</guilabel
> </term>
<listitem>
<para
>Välj om bara effektspektrum ska ritas upp, bara data (X-Y), eller båda. Om effektspektrum väljes för uppritning, blir ytterligare inställningar i avdelningen tillgängliga. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>X-axelvektor</guilabel>
</term>
<listitem>
<para
>Vektorn som ska användas som oberoende vektor för diagrammen. Du kan välja ett fält från datafilen, eller vektorn INDEX. Vektorn INDEX är helt enkelt en vektor som innehåller element från 0 till N-1, där N är antal poster i datafilen. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Avdelningen <guilabel
>FFT-alternativ</guilabel
> i dataguiden är bara tillgängligt om ett effektspektrum ska ritas upp. Definitionerna nedan förutsätter grundkunskap om effektspektrum. För ytterligare information, se Numerical Recipes in C: The Art of Scientific Computing, publicerad av Cambridge University Press. </para>

<variablelist>

<varlistentry>
<term
><guilabel
>Inflätat medelvärde</guilabel
> och <guilabel
>FFT-längd</guilabel
> </term>
<listitem>
<para
>Effektspektrum definieras som <quote
>kvadratroten av absolutvärdet av de inflätade Fouriertransformerna med längden <literal
>2^x</literal
></quote
>, där x är värdet som skrivs in i rutan <guilabel
>FFT-längd</guilabel
>. Genom att markera <guilabel
>Inflätat medelvärde</guilabel
> blir det möjligt att ange längden för den inflätade Fouriertransformen. Om <guilabel
>Inflätat medelvärde</guilabel
> inte markeras, avgör &kst; längden baserat på vektorns längd. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vektorenheter</guilabel
> och <guilabel
>Samplingsenheter</guilabel
> </term>
<listitem>
<para
>Enheterna som anges i textrutorna används med syftet att automatiskt skapa axeltexter för diagrammen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Samplingsfrekvens</guibutton>
</term>
<listitem>
<para
>Samplingsfrekvensen används för att skapa X-axeln i diagram med effektspektrum. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Appodisera</guilabel>
</term>
<listitem>
<para
>Om det här alternativet markeras, appodiseras data med ett Hanning-fönster, för att reducera läckage från område till område. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Ta bort medelvärde</guilabel>
</term>
<listitem>
<para
>Välj det här alternativet för att ta bort medelvärdet från markerad data (dvs. förflytta data så att medelvärdet är noll). </para>
</listitem>
</varlistentry>
</variablelist>
<para
>När du väl är nöjd med alla inställningar, klicka på <guibutton
>Nästa</guibutton
> för att gå vidare till nästa fönster. Välj eventuella filter som du vill behandla data med, och klicka på <guibutton
>Nästa</guibutton
> för att gå till det sista fönstret. </para>

<screenshot>
<screeninfo
>Dataguidens tredje skärm</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard3.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Dataguidens tredje skärm</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Härifrån kan du ställa in allmänna diagraminställningar. De flesta inställningar är självklara. En kort överblick av varje avdelning ges nedan. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Kurvans stil</guilabel>
</term>
<listitem>
<para
>Välj om bara datapunkter ska ritas upp, bara linjer som förbinder datapunkterna, eller båda. Normalt är linjer heldragna med vikten 0, och datapunkter markeras med kryss. Linje- och datapunktsfärger väljes så att kurvor med identiska färger minimeras. </para>
</listitem>
</varlistentry>



<varlistentry>
<term>
<guilabel
>Kurvans placering</guilabel>
</term>
<listitem>
<para
>Välj diagrammen där de nya kurvorna ska placeras. <guilabel
>Gå igenom</guilabel
> skapar angivet antal nya diagram och går igenom alla diagram, och placerar en ny kurva i diagrammet varje gång. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Skapa text</guilabel>
</term>
<listitem>
<para
>Välj önskad text och förklaringar som ska placeras i diagrammen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Diagramplacering</guilabel>
</term>
<listitem>
<para
>Välj önskade fönster där de nya diagrammen ska placeras. Nya fönster kan skapas för diagrammen genom att välja <guilabel
>I nytt fönster</guilabel
>. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Så fort du är nöjd med alla inställningar, klicka på <guibutton
>Slutför</guibutton
> så skapas diagrammen. </para>

</sect1>

<sect1 id="datamanager">
<title
>Datahanteringen</title>
<para
>Datahanteringen tillhandahåller en central plats för att lägga till, ta bort och ändra alla dataobjekt som används i &kst;. Den kan kommas åt genom att välja <guimenuitem
>Datahantering</guimenuitem
> i menyn <guimenu
>Data</guimenu
>. </para>
<sect2 id="creatingdata">
<title
>Skapa nya dataobjekt</title>
<para
>För att skapa ett nytt dataobjekt inne i datahanteringen, klicka på en av knapparna som finns under <guilabel
>Ny</guilabel
>. Ett nytt fönster visas, som gör det möjligt att ange alternativ och inställningar för dataobjektet.</para>

<tip
><para
>Du kan också skapa nya kurvor genom att högerklicka på en vektor och välja <guimenuitem
>Skapa kurva...</guimenuitem
></para
></tip>

<para
>Eftersom du skapar ett nytt dataobjekt, kan du skriva in ett unikt namn som identifierar objektet. Det förvalda namnet kan också användas (om det är unikt). </para>
<para
>Inställningarna för alla uppritningsbara dataobjekt har två gemensamma avdelningar: Kurvans utseende och Kurvans placering. Dessa avdelningar beskrivs nedan. För dataspecifika inställningar, se <link linkend="datatypes"
>Datatyper</link
>. </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-curveoptions.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<note>
<para
>De <quote
>kurvor</quote
> som refereras till nedan är i allmänhet de synliga linjerna och punkterna på ett diagram när ett dataobjekt ritas upp. De refererar i allmänhet inte till dataobjektet <quote
>kurva</quote
>. </para>
</note>
<sect3 id="curveappearance">
<title
>Kurvans utseende</title>
<para
>Avdelningen Kurvans utseende låter dig ändra dataobjektets utseende när det ritas upp. </para>

<variablelist>

<varlistentry>
<term>
<inlinemediaobject
><imageobject
><imagedata fileref="Widget-kst-colourchooser.png" format="PNG"/></imageobject
></inlinemediaobject>
</term>
<listitem>
<para
>Genom att klicka på knappen visas en färgvalsdialogruta, som kan användas för att ändra färg på både linjer och punkter på kurvan. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Visa punkter</guilabel>
</term>
<listitem>
<para
>Markeras kryssrutan så visas datapunkterna som används för att rita upp kurvan. Kombinationsrutan till höger gör det möjligt att ändra punkternas form. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Visa linjer</guilabel>
</term>
<listitem>
<para
>Markeras kryssrutan så visas linjerna som sammanbinder datapunkterna i kurvan. Både linjens bredd och stil kan ändras. </para>
</listitem>
</varlistentry>

</variablelist>


</sect3>

<sect3 id="curveplacement">
<title
>Kurvans placering</title>
<para
>Avdelningen Kurvans placering anger platsen för nya kurvor. </para>

<variablelist>

<varlistentry>
<term>
<guilabel
>Diagramfönster</guilabel>
</term>
<listitem>
<para
>Ange fönstret där kurvan ska placeras. Du kan skapa ett nytt fönster genom att klicka på knappen <guibutton
>Ny...</guibutton
> </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Placera i befintligt diagram</guilabel
>, <guilabel
>Placera i nytt diagram</guilabel
> och <guilabel
>Placera inte kurvan i något diagram</guilabel
> </term>
<listitem>
<para
>Du kan välja om kurvan omedelbart ska placeras i ett nytt diagram eller i ett befintligt diagram. om <guilabel
>Placera i nytt diagram</guilabel
> markeras, kan du också välja att arrangera om diagrammens layout genom att markera <guilabel
>Nytt rutnät</guilabel
> och skriva in antal kolumner som ska användas för den nya layoutens rutnät. </para>
</listitem>
</varlistentry>

 

</variablelist>

<para
>När väl alla önskade inställningar för det nya dataobjektet har angivits, klicka på knappen <guibutton
>Ok</guibutton
> för att skapa det nya dataobjektet. </para>

</sect3>

</sect2>

<sect2 id="editinganddeletingdata">
<title
>Redigera och ta bort befintliga dataobjekt</title>
<para
>För att redigera ett befintligt dataobjekt, markera det helt enkelt i datahanteringsfönstret och klicka på knappen <guibutton
>Redigera</guibutton
>. Inställningsfönstret för det markerade objektet visas. Fönstret är identiskt med det som visas då nya dataobjekt skapas (med undantag för att avdelningen Kurvans Placering kanske saknas), så titta i <link linkend="creatingdata"
>Skapa nya dataobjekt</link
> för mer information om inställningarna och alternativen. </para>
<para
>För att ta bort ett dataobjekt, markera det i datahanteringsfönstret och klicka på knappen <guibutton
>Ta bort</guibutton
>. Observera att posten i kolumnen <guilabel
>Antal använda</guilabel
> måste vara 0 innan objektet kan tas bort. Kolumnen <guilabel
>Antal använda</guilabel
> anger antal gånger som ett enskilt dataobjekt och dess delobjekt (om det finns några) används, antingen av andra dataobjekt eller av diagram. Nedan listas några konsekvenser av den här begränsningen, att komma ihåg vid försök att ta bort dataobjekt. </para>

<itemizedlist>
<listitem>
<para
>Alla uppritningsbara objekt (kurvor, ekvationer, histogram och effektspektrum) måste tas bort från diagram innan de kan tas bort. Ett objekt kan tas bort från ett diagram genom att högerklicka på det i datahanteringsfönstret och välja önskat diagram i undermenyn <guisubmenu
>Ta bort från diagram</guisubmenu
>. </para>
</listitem>

<listitem>
<para
>Alla kurvor som använder en viss datavektor måste tas bort innan datavektorn kan tas bort. </para>
</listitem>

<listitem>
<para
>Alla delobjekt till ett överliggande dataobjekt måste vara oanvända innan det överliggande dataobjektet kan tas bort. </para>
</listitem>
</itemizedlist>

<para
>Efter en följd av borttagningar och borttagningar av kurvor från diagram, kan du märka att det finns en mängd oanvända dataobjekt som visas i datahanteringen. För att snabbt ta bort objekten, kan du klicka på knappen <guibutton
>Rensa</guibutton
>. </para>



</sect2>

</sect1>

<sect1 id="datatypes">
<title
>Datatyper</title>

<para
>Det finns sju huvudtyper av dataobjekt i &kst;. Dataobjekt kan innehålla vissa andra dataobjekt, som representeras av trädstrukturen som visas i datahanteringsfönstret. Följande diagram åskådliggör förhållandet mellan de olika datatyperna. </para>

<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Diagram-kst-datatypes.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Datatyper i &kst;</phrase>
</textobject>
</inlinemediaobject>
</para>

<para
>Som syns i diagrammet ovan, är dataobjekten kurva, ekvation, histogram och effektspektrum de enda dataobjekt som är uppritningsbara. Alla dataobjekt (förutom vektorer) har möjlighet att använda vektorer, medan ekvationer, effektspektrum, händelser och insticksprogram alla innehåller slavvektorer. </para>

<para
>Beskrivningar av varje datatyp tillhandahålls nedan, tillsammans med översikter av de inställningar och alternativ som är tillgängliga när varje typ av dataobjekt skapas eller redigeras. Inställningar som är gemensamma för nästan alla datatyper har utelämnats: Se <link linkend="creatingdata"
>Skapa nya dataobjekt</link
> för mer information. </para>

<sect2 id="vectors">
<title
>Vektorer</title>
<para
>Vektorer är ett av de oftast använda dataobjekten i &kst;. Som namnet anger, är vektorer helt enkelt ordnade listor med tal. Oftast innehåller de X- eller Y-koordinaterna för en uppsättning datapunkter. </para>
<para
>Det följande är en skärmbild av fönstret som visas när vektorer skapas eller redigeras. Förklaringar av inställningarna listas nedan. </para>

<screenshot>
<screeninfo
>Redigera vektorer</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-vectorwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Redigera vektorer</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="datavectorparameters">
<title
>Parametrar för datavektor</title>
<para
>Källfilen och fält att läsa kan anges med följande alternativ. </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Filnamn</guilabel>
</term>
<listitem>
<para
>Sökvägen till önskad datafil. Genom att klicka på knappen till höger visas ett filbläddrarfönster, som kan användas för att bläddra grafiskt till filen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Fält eller kolumn</guilabel>
</term>
<listitem>
<para
>Fältet eller kolumnen som en vektor ska skapas från. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="datarange">
<title
>Dataintervall</title>
<para
>Den här avdelningen anger dataintervallet som ska användas i datavektorn från det valda fältet. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Startpost</guilabel
>, <guilabel
>Räkna från slutet</guilabel
>, <guilabel
>Antal poster</guilabel
> och <guilabel
>Läs till slutet</guilabel
> </term>
<listitem>
<para
>Genom att använda de här fyra inställningarna, kan nedre och övre gräns för dataintervallet anges. För att till exempel läsa från post 10 till 900, skriv in <userinput
>10</userinput
> för <guilabel
>Startpost</guilabel
> och <userinput
>890</userinput
> för <guilabel
>Antal poster</guilabel
>. För att läsa från post 500 till filens slut, skriv in <userinput
>500</userinput
> för <guilabel
>Startpost</guilabel
> och markera alternativet <guilabel
>Läs till slutet</guilabel
>. För att bara läsa de 450 sista posterna från filen, markera alternativet <guilabel
>Räkna från slutet</guilabel
> och skriv in <userinput
>450</userinput
> för <guilabel
>Antal poster</guilabel
>. Kombinationerna som används i de två föregående exemplen är ofta användbara för att läsa data från en fil som uppdateras i realtid. Efterföljande tillägg i filen läses, vilket gör att tillhörande vektorer också uppdateras. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Läs en sampling per</guilabel
> och <guilabel
>Lågpassfilter först</guilabel
> </term>
<listitem>
<para
>Förutom nedre och övre gräns för dataintervallet, kan samplingarna som ska läsas från det valda intervallet anges. Om <guilabel
>Läs en sampling per</guilabel
> inte är markerad, läses alla samplingar i det valda intervallet. Om <guilabel
>Läs en sampling per</guilabel
> är markerat, läses bara en sampling per <literal
>N</literal
> poster, där <literal
>N</literal
> är antalet som skrivs in i rutan till höger. Värdet på den sampling som används för att representera en post beror på om <guilabel
>Lågpassfilter först</guilabel
> markeras. Om <guilabel
>Lågpassfilter först</guilabel
> inte är markerat, är värdet samma som första samplingen i posten. Om <guilabel
>Lågpassfilter först</guilabel
> är markerat, är värdet medelvärdet av alla samplingar i den speciella posten. </para>
</listitem>
</varlistentry>
</variablelist>

</sect3>
</sect2>

<sect2 id="curves">
<title
>Kurvor</title>
<para
>Kurvor används i huvudsak för att skapa uppritningsbara objekt från vektorer. Kurvor skapas av två vektorer, en <quote
>X-axelvektor</quote
> och en <quote
>Y-axelvektor</quote
>, som antas tillhandahålla en uppsättning datapunkter. Alltså kan en kurva ses som en uppsättning datapunkter och linjerna som förbinder dem (även om punkterna eller linjerna kanske inte är synliga i diagram). </para>
<para
>Det följande är en skärmbild av fönstret som visas när kurvor skapas eller redigeras. Förklaringar av inställningarna listas nedan. </para>

<screenshot>
<screeninfo
>Redigera kurvor</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-curvewindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Redigera kurvor</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="curvecontents">
<title
>Kurvans innehåll</title>
<para
>Innehållet i kurvan kan ställas in i den här avdelningen. </para>
<variablelist>
<varlistentry>
<term>
<guilabel
>X-axelvektor</guilabel>
</term>
<listitem>
<para
>Vektorn att använda för den oberoende (horisontella) axeln. </para>
</listitem>

</varlistentry>

<varlistentry>
<term>
<guilabel
>Y-axelvektor</guilabel>
</term>
<listitem>
<para
>Vektorn att använda för den beroende (vertikala) axeln. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>X-felstapel</guilabel
> och <guilabel
>Y-felstapel</guilabel
> </term>
<listitem>
<para
>Vektorerna som innehåller felvärden som motsvarar respektive X-axelvektor och Y-axelvektor. Vektorerna ska innehålla felstaplarnas storlek i samma ordning som datapunkterna. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>

<sect2 id="equations">
<title
>Ekvationer</title>
<para
>Ett ekvationsdataobjekt består av ett matematiskt uttryck och en oberoende variabel. Uttrycket byggs upp genom att använda en kombination av skalärer, vektorer och operatorer, och representerar oftast den beroende variabelns värden. Den oberoende variabeln kan vara en befintlig vektor eller kan skapas när ekvationsobjektet skapas eller redigeras. Eftersom en ekvation i slutändan består av en uppsättning datapunkter, är ett ekvationsobjekt uppritningsbart. </para>
<para
>Det följande är en skärmbild av fönstret som visas när ekvationer skapas eller redigeras. Förklaringar av inställningarna listas nedan. </para>

<screenshot>
<screeninfo
>Redigera ekvationer</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-equationwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Redigera ekvationer</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="equation">
<title
>Ekvation</title>
<para
>Det matematiska uttrycket som representerar den beroende variabeln kan ändras i den här avdelningen. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Operatorer</guilabel>
</term>
<listitem>
<para
>En lista med tillgängliga operatorer. Genom att välja en operator i listan infogas den vid den nuvarande markörpositionen i textrutan <guilabel
>Ekvation</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vektorer</guilabel>
</term>
<listitem>
<para
>En lista med nuvarande vektorobjekt i &kst;. Genom att välja en vektor i listan infogas den vid den nuvarande markörpositionen i textrutan <guilabel
>Ekvation</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Skalärer</guilabel>
</term>
<listitem>
<para
>En lista med tillgängliga skalärvärden. Listan består både av skalärvärden i nuvarande session i &kst;, samt några inbyggda konstanter. Genom att välja en skalär i listan infogas den vid den nuvarande markörpositionen i textrutan <guilabel
>Ekvation</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Ekvation</guilabel>
</term>
<listitem>
<para
>Det matematiska uttrycket som representerar den oberoende variabeln. Du kan skriva in det för hand in textrutan, eller du kan välja objekt att infoga med kombinationsrutan ovan. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>


<sect3 id="independentvariable">
<title
>Oberoende variabel</title>
<para
>Den här avdelningen används för att ange källan till värdena för den oberoende variabeln. </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Användning</guilabel>
</term>
<listitem>
<para
>Välj det här alternativet för att använda en befintlig vektor som oberoende variabel. Välj en vektor i kombinationsrutan, eller skapa snabbt en ny genom att klicka på knappen till höger. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Interpolera till vektorn med högst upplösning</guilabel>
</term>
<listitem>
<para
>Genom att välja det här alternativet interpoleras den valda vektorn till högsta möjliga antal samplingar. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Skapa</guilabel>
</term>
<listitem>
<para
>Välj detta för att skapa en uppsättning värden att använda som oberoende variabel. Ange det lägsta värdet som ska skapas i fältet <guilabel
>Från</guilabel
> och det högsta värdet som ska skapas i fältet <guilabel
>Till</guilabel
>. Ställ in värdet <guilabel
>Antal samplingar</guilabel
> till antalet likformigt fördelade värden att skapa mellan det lägsta värdet och det högsta (inklusive). </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="Histograms">
<title
>Histogram</title>
<para
>Ett histogramdataobjekt representerar helt enkelt ett histogram av en viss vektor. Histogramobjekt kan ritas upp. </para>
<para
>Det följande är en skärmbild av fönstret som visas när histogram skapas eller redigeras. Förklaringar av inställningarna listas nedan. </para>

<screenshot>
<screeninfo
>Redigera ekvationer</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-histogramwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Redigera ekvationer</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="histogramproperties">
<title
>Histogramegenskaper</title>
<para
>Källvektorn, samt grundläggande histogramegenskaper kan ändras från den här avdelningen. Du kan antingen ange inställningarna för hand eller använda knappen <guibutton
>Automatiska områden</guibutton
>. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Datavektor</guilabel>
</term>
<listitem>
<para
>Datavektorn som histogrammet ska skapas från. Även om en vektor krävs för att skapa ett histogram, behandlas vektorn som en oordnad mängd för syftet att skapa ett histogram. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Från</guilabel
> och <guilabel
>till</guilabel
> </term>
<listitem>
<para
>Fältet <guilabel
>Från</guilabel
> innehåller vänstra gränsen för området längst till vänster i histogrammet. Fältet <guilabel
>Till</guilabel
> innehåller högra gränsen för området längst till höger i histogrammet. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Antal områden</guilabel>
</term>
<listitem>
<para
>Skriv in totalt antal områden som ska användas i fältet <guilabel
>Antal områden</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Automatiska områden</guibutton>
</term>
<listitem>
<para
>Istället för att ange värden för <guilabel
>Från</guilabel
>, <guilabel
>Till</guilabel
> och <guilabel
>Antal områden</guilabel
>, kan du klicka på <guibutton
>Automatiska områden</guibutton
> för att automatiskt skapa värden för alla tre fälten baserat på de lägsta och högsta värdena, samt antal element som finns i källvektorn. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>


<sect3 id="yaxisnormalization">
<title
>Normalisering av y-axeln</title>
<para
>Den här avdelningen används för att ange typ av normalisering som används för histogrammets Y-axel. </para>
<variablelist>

<varlistentry>
<term>
<guilabel
>Antal i området</guilabel>
</term>
<listitem>
<para
>Genom att välja det här alternativet gör att Y-axeln motsvarar antal element i varje område. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Bråkdel i området</guilabel>
</term>
<listitem>
<para
>Genom att välja det här alternativet gör att Y-axeln motsvarar bråkdelen av antal element i varje område av totalt antal element. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Procent i området</guilabel>
</term>
<listitem>
<para
>Genom att välja det här alternativet gör att Y-axeln motsvarar procent av element (från det totala antalet element) i varje område. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Högsta område satt till 1.0</guilabel>
</term>
<listitem>
<para
>Att välja det här alternativet gör att Y-axeln representerar antal element i varje område dividerat med antal element i det största området (området med störst antal element). Med andra ord normaliseras Y-axeln till 1,0. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>


</sect2>

<sect2 id="PowerSpectra">
<title
>Effektspektrum</title>
<para
>Ett dataobjekt med ett effektspektrum representerar effektspektrum för en vektor, definierat som <quote
>kvadratroten av absolutvärdet av de inflätade Fouriertransformerna med längden <literal
>2^x</literal
>av vektorn</quote
>, där x är värdet som skrivs in i rutan <guilabel
>FFT-längd</guilabel
>.  Definitionerna nedan förutsätter grundkunskap om effektspektrum. För ytterligare information, se Numerical Recipes in C: The Art of Scientific Computing, publicerad av Cambridge University Press. </para>

<screenshot>
<screeninfo
>Fönstret Effektspektrum</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-powerspectrawindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Fönstret Effektspektrum</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="powerspectracurvecontents">
<title
>Kurvans innehåll</title>
<para
>Datavektorn, samt grundläggande egenskaper för effektspektrum kan ändras i den här avdelningen. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Datavektor</guilabel>
</term>
<listitem>
<para
>Datavektorn att skapa effektspektrum från. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Inflätat medelvärde</guilabel
> och <guilabel
>FFT-längd</guilabel
> </term>
<listitem>
<para
>Genom att markera <guilabel
>Inflätat medelvärde</guilabel
> blir det möjligt att ange längden för den inflätade Fouriertransformen. Längden anges som en tvåpotens. Om <guilabel
>Inflätat medelvärde</guilabel
> inte markeras, avgör &kst; längden baserat på vektorns längd. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vektorenheter</guilabel
> och <guilabel
>Samplingsenheter</guilabel
> </term>
<listitem>
<para
>Enheterna som anges i textrutorna används med syftet att automatiskt skapa axeltexter för diagrammen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guibutton
>Samplingsfrekvens</guibutton>
</term>
<listitem>
<para
>Samplingsfrekvensen används för att skapa X-axeln i diagram med effektspektrum. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Appodisera</guilabel>
</term>
<listitem>
<para
>Om det här alternativet markeras, appodiseras data med ett Hanning-fönster, för att reducera läckage från område till område. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Ta bort medelvärde</guilabel>
</term>
<listitem>
<para
>Välj det här alternativet för att ta bort medelvärdet från markerad data (dvs. förflytta data så att medelvärdet är noll). </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="plugins">
<title
>Insticksprogram</title>
<para
>Ett dataobjekt för insticksprogram representerar ett insticksprogram i &kst;. Alla insticksprogram har ett gemensamnt format och visas som typen <quote
>Insticksprogram</quote
> i datahanteringen. För mer information om insticksprogram, se <link linkend="pluginsandfilters"
>Insticksprogram och filter</link
>. </para>
</sect2>

<sect2 id="events">
<title
>Händelsebevakning</title>
<para
>Ett dataobjekt för händelsebevakning håller i grunden reda på en eller flera vektorer eller skalärer, och utför en angiven åtgärd när ett angivet villkor som gäller vektorerna eller skalärerna är sant. Händelsebevakning används oftast tillsammans med <quote
>rörlig</quote
> eller strömmande data. En händelsebevakning kan till exempel skapas för att bevaka om element i en datavektor som representerar en temperatur överskrider ett fördefinierat värde. </para>
<para
>Det följande är en skärmbild av fönstret som visas när händelser skapas eller redigeras. Förklaringar av inställningarna ges nedan. </para>

<screenshot>
<screeninfo
>Fönstret Händelsebevakning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Fönstret Händelsebevakning</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="eventsexpression">
<title
>Uttryck</title>
<para
>Villkoret som ska bevakas, tillsammans med andra händelseegenskaper, kan ändras i den här avdelningen. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Operatorer</guilabel>
</term>
<listitem>
<para
>En lista med tillgängliga operatorer. Genom att välja en operator i listan infogas den vid den nuvarande markörpositionen i textrutan <guilabel
>Ekvation</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vektorer</guilabel>
</term>
<listitem>
<para
>En lista med nuvarande vektorobjekt i &kst;. Genom att välja en vektor i listan infogas den vid den nuvarande markörpositionen i textrutan <guilabel
>Ekvation</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Skalärer</guilabel>
</term>
<listitem>
<para
>En lista med tillgängliga skalärvärden. Listan består både av skalärvärden i nuvarande session i &kst;, samt några inbyggda konstanter. Genom att välja en skalär i listan infogas den vid den nuvarande markörpositionen i textrutan <guilabel
>Ekvation</guilabel
>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Uttryck</guilabel>
</term>
<listitem>
<para
>Uttrycket att bevaka. Du kan skriva in direkt i textrutan, eller välja objekt att infoga med kombinationsrutorna ovan. Försäkra dig om att uttrycket som skrivs in i textrutan är ett Booleskt uttryck (dvs.. det utvärderas antingen till sant eller falskt). Det innefattar oftast att använda en likhet eller olikhet i uttrycket. Observera att vektorer som skrivs in i textrutan bevakas med avseende på deras enskilda element. </para>
<para
>Så fort uttrycket är sant, sker händelsen. Åtgärden som utförs vid en händelse sker beror på inställningarna som anges i följande två avdelningar. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Beskrivning</guilabel>
</term>
<listitem>
<para
>Den här textrutan används för att lagra en kort beskrivning av händelsen. Beskrivningen är i huvudsak tillgänglig som ett sätt att hålla reda på flera händelser. Du kan skriva in vilken text du vill i textrutan. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="eventskstdebuglog">
<title
>Kst-felsökningslogg</title>
<para
>Den här avdelningen anger inställningar för att lägga till meddelanden i felsökningsloggen i &kst; när händelser inträffar. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Logga som:</guilabel
></term>
<listitem>
<para
>Markera den här kryssrutan för att låta poster läggas till i felsökningsloggen i &kst; när händelsen inträffar. Det finns tre sorters meddelanden i felsökningsloggen: anmärkningar, varningar och fel. Välj önskat meddelande med motsvarande alternativknapp. </para>
</listitem>
</varlistentry>
</variablelist>


</sect3>

<sect3 id="eventsemailnotification">
<title
>E-postmeddelande</title>
<para
>I den här avdelningen kan inställningar för att skicka underrättelser med e-post vid händelser anges. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Meddela</guilabel
></term>
<listitem>
<para
>Markera den här kryssrutan för att låta &kst; skicka underrättelser med e-post till önskad adress när händelsen inträffar. Skriv också in e-postadressen du vill ska synas i fältet <quote
>Från</quote
> i brevet i textrutan <guilabel
>Avsändare</guilabel
>. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="eventselog">
<title
>ELOG</title>
<para
>&kst; stöder tillägg av poster i en ELOG-loggbok när händelser inträffar. Det kan vara användbart för fjärrbevakning av rörlig data, eller för att få summeringar av händelseaktiviteter. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Meddela</guilabel
></term>
<listitem>
<para
>Markeras kryssrutan så aktiveras loggningsfunktionen med ELOG för den här händelsebevakningen. Klicka på <guibutton
>Anpassa...</guibutton
> för att ange server och loggningsinställningar. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

</sect2>

</sect1>


<sect1 id="thedatamenu">
<title
>Menyn Data</title>
<para
>Menyn <guimenu
>Data</guimenu
> ger snabb åtkomst till många funktioner som har med dataobjekt i &kst; att göra. De flesta menyfunktioner duplicerar funktioner som finns på andra ställen, därför ges bara kortfattade beskrivningar nedan. </para>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Uppdatera</guimenuitem
></term>
<listitem>
<para
>Uppdaterar alla datavektorer från deras källfiler. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Dataguide...</guimenuitem
></term>
<listitem>
<para
>Visar <link linkend="datawizard"
>Dataguiden</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Datahantering</guimenuitem
></term>
<listitem>
<para
>Visar <link linkend="datamanager"
>Datahantering</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Ny/Nytt</guimenuitem
> [dataobjekt]</term>
<listitem>
<para
>Visar motsvarande dialogruta för att skapa dataobjektet. Se <link linkend="datatypes"
>Datatyper</link
> för beskrivningar av varje dialogruta. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Visa skalära värden</guimenuitem
></term>
<listitem>
<para
>Visar en dialogruta där värden på alla skalärer i den nuvarande sessionen i &kst; visas. Dialogrutan uppdateras dynamiskt om värdena ändras. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Visa vektorvärden</guimenuitem
></term>
<listitem>
<para
>Visar en dialogruta där värden på alla nuvarande vektorer kan visas. Välj en vektor att visa med kombinationsrutan. Dialogrutan uppdateras dynamiskt om värdena ändras. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Ändra datafil</guimenuitem
></term>
<listitem>
<para
>Visar en dialogruta för att snabbt ändra datafiler som vektorer hör ihop med. Välj vektorn att ändra, och bläddra därefter till en annan datafil. Klicka på <guibutton
>Verkställ</guibutton
> för att spara ändringarna. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>
