<chapter id="tutorial">

<chapterinfo>
<authorgroup>
<author
><firstname
>Barth</firstname
> <othername
></othername
> <surname
>Netterfield</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
<author
><firstname
>Rick</firstname
> <othername
></othername
> <surname
>Chern</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
</authorgroup>



<copyright>
<year
>2004</year>
<holder
>British Columbia-universitetet</holder>
</copyright>



</chapterinfo>
<title
>&kst; handledning</title>



<sect1 id="Welcome">
<title
>Välkommen</title>
<para
>Välkommen till &kst;! På några få minuter kommer du att vara på väg att utforska de talrika funktionerna i detta diagramritnings- och datahanteringspaket. Här är bara några av de uppgifter du kan åstadkomma med &kst;: </para>

<itemizedlist>
<listitem>
<para
>Snabbt rita upp flera diagram bara med användning av kommandoraden. </para>
</listitem>
<listitem>
<para
>Analysera data med en omfattande uppsättning verktyg, inklusive histogram, effektspektrum och egna ekvationer. </para>
</listitem>
<listitem>
<para
>Zooma in och ut intressanta områden i diagram utan ansträngning, genom att antingen använda musen eller tangentbordet. </para>
</listitem>
<listitem>
<para
>Bevaka rörlig strömmande data med möjligheterna till realtidsuppritning i &kst;. </para>
</listitem>
</itemizedlist>
<para
>Denna handledning täcker grunderna i att installera, köra och arbeta med &kst;. Den är baserad på snabbtur genom &kst; av Barth Netterfield. Du inbjuds att ytterligare utforska vilken funktion som helst när som helst. Alla funktioner finns dokumenterade i resten av den här handboken.</para>

</sect1>

<sect1 id="commandline">
<title
>Starta &kst; från kommandoraden</title>
<para
>En vanlig användning av &kst; är att snabbt skapa diagram med data från kommandoraden. Det här sättet att skapa diagram kräver nästan ingen kunskap om det grafiska gränssnittet i &kst;, men skapar ändå omedelbart användbara resultat. </para>

<para
>Den här handledningen använder ett demonstrationspaket med datafiler som installeras med &kst; i <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/apps/kst/tutorial</filename
>, där <filename class="directory"
>$<envar
>KDEDIR</envar
></filename
> är platsen där &kde; är installerad på ditt system (du kan hitta den med kommandot <command
>kde-config --prefix</command
>).</para>

<note
><para
>Om du har en version av &kst; äldre än 1.1.0, hittar du handledningens data direkt på <ulink url="http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz"
>http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz</ulink
>. Ladda ner och packa upp paketet, och gå till resulterande katalog: <screen
><userinput
><command
>tar -zxvf kst_tutorialdata.tgz</command>
<command
>cd kst_tutorialdata</command
></userinput
></screen>

</para>
</note>

<para
>För att få en översikt över alla tillgängliga kommandoradsväljare i &kst;, skriv: <screen
><userinput
><command
>kst --help</command
></userinput
></screen>
</para>
<para
>En syntaxbeskrivning och lista med kommandon som liknar det följande visas: <screen
>Användning: kst [Qt-väljare] [KDE-väljare] [väljare] [Files]

Kst: ett datavisningsprogram

Generella väljare:
  --help                    Visa hjälp om väljare
  --help-qt                 Visa väljare specifika för Qt
  --help-kde                Visa väljare specifika för KDE
  --help-all                Visa alla väljare
  --author                  Visa information om upphovsman
  -v, --version             Visa versionsinformation
  --license                 Visa licensinformation
  --                        Slut på väljare

Väljare:
  -F &lt;dataFile&gt;             Ange datafil: används för att överskrida förvald Kst-fil [|]
  -y &lt;Y&gt;                    Fält för Y-axel (flera tillåts)
  --ye &lt;equation&gt;           Ekvation för Y-axel (flera tillåts)
  -e &lt;E&gt;                    Fält för Y-fel (flera tillåts)
  -x &lt;X&gt;                    Fält eller intervall för X-axel [INDEX]
  --xe &lt;X&gt;                  X-vektor för ekvationer x0:x1:n [INDEX]
  -p &lt;Y&gt;                    Fält för effektspektrum (flera tillåts)
  -h &lt;Y&gt;                    Fält för histogram (flera tillåts)
  -r &lt;f&gt;                    Samplingsfrekvens för effektspektrum [60.0]
  --ru &lt;U&gt;                  Enheter för samplingsfrekvens för spektral effekttäthet [Hz]
  --yu &lt;U&gt;                  Enheter för Y-vektorer [V]
  -l &lt;P&gt;                    FFT-längden är 2^P [10]
  -f &lt;F0&gt;                   Första post att läsa [-2]
  -n &lt;NS&gt;                   Antal poster att läsa [-2]
  -s &lt;NS&gt;                   Antal poster att hoppa över för varje läsning [-1]
  -a                        Applicera lågpassfilter innan poster hoppas över
  -m &lt;NC&gt;                   Separata diagram arrangerade i antalet kolumner
  -d                        Visa som punkter istället för kurvor
  -g                        Visa i förklaringsruta
  --print &lt;file&gt;            Skriv ut till fil och avsluta [&lt;none&gt;]
  --png &lt;file&gt;              Spara som en PNG-fil och avsluta [&lt;none&gt;]

Parametrar:
  Files                     Datafiler (om -y angivet) eller *.kst-fil
</screen>
</para>

<para
>Väljare specifika för &kst; listas under avdelningen <literal
>Väljare:</literal
>. Där det passar anges standardvärden med hakparenteser i slutet på beskrivningen av väljaren. Dessa värden används för väljare som inte anges. </para>

<para
>Först tar vi en titt på ASCII-filen <filename
>gyrodata.dat</filename
>, som ingår i demonstrationspaketet. ASCII-filer är en av de många filtyper som &kst; kan läsa. I ASCII-filer är data arrangerat i kolumner, där varje kolumn motsvarar ett fält, och kolumnnumren (med början på 1 från vänster till höger) motsvarar fältnamnen. Den här speciella ASCII-filen innehåller tre kolumner, och har alltså fältnamnen 1, 2 och 3. För att skapa ett diagram med den första kolumnen, skriv helt enkelt: <screen
><userinput
><command
>kst -y 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>All data i den första kolumnen ritas upp: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro1.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
<para
>Observera att inget fält angavs för diagrammets X-axel, så &kst; använde den förvalda vektorn INDEX, som förväntat. INDEX-vektorn är en speciell vektor i &kst; som innehåller heltal från 0 till N-1, där N är antalet datavärden i motsvarande vektor för Y-axeln. Stäng &kst; genom att välja <guimenuitem
>Avsluta</guimenuitem
> i menyn <guimenu
>Arkiv</guimenu
>, eller genom att skriva <keycombo action="simul"
><keycap
>Ctrl</keycap
> <keycap
>Q</keycap
></keycombo
>. </para>

<para
><filename
>gyrodata.dat</filename
> innehåller 20000 poster, så du kanske bara vill titta på en del av indata. För att bara rita upp 10000 poster, med början på post 7000, skriv: <screen
><userinput
><command
>kst -y 1 -f 7000 -n 10000 gyrodata.dat</command
></userinput
></screen>

</para>

<para
>En av styrkorna med &kst; är dess möjlighet att rita upp realtidsdata. Anta att ny data hela tiden lades till i slutet på <filename
>gyrodata.dat</filename
>. Med ett sådant scenario, skulle det vara användbart att bara rita upp den senaste delen av data. För att bara rita de senaste 10000 posterna i <filename
>gyrodata.dat</filename
>, skriv in följande: <screen
><userinput
><command
>kst -y 1 -n 10000 gyrodata.dat</command
></userinput
></screen>
</para>
<para
>Om <filename
>gyrodata.dat</filename
> uppdaterades, skulle diagrammet fortsätta att röra sig för att bara visa de sista 10000 posterna. </para>

<para
>Istället för att direkt läsa en indatafil, kan &kst; använda ASCII-data från standardinmatningen som en datakälla. För att ange standardnmatningen som indata, skriv helt enkelt <filename
>stdin</filename
> som ett av filnamnen. Det finns många användningar av den här möjligheten, som att använda &kst; som en del av en följd av ihopkopplade program: <screen
><userinput
><command
>cat gyrodata.dat | awk '{print $1 + 2}' | kst -y 1 stdin</command
></userinput
></screen>
</para>
<para
>Kommandot ovan använder <command
>awk</command
> för att lägga till 2 i första kolumnen av <filename
>gyrodata.dat</filename
> innan resultatet skickas vidare till &kst;. </para>

<para
>Observera att beskrivningen av väljaren <option
>y</option
> anger att flera förekomster av väljaren tillåts. Det gör det möjligt att snabbt rita upp mer än en kurva, eller till och med mer än ett diagram. För att rita upp alla tre fälten i <filename
>gyrodata.dat</filename
> i separata diagram, skriv in följande: <screen
><userinput
><command
>kst -y 1 -y 2 -y 3 -m 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>Väljaren <option
>m</option
> anger att skilda diagram ska användas istället för ett enda diagram, som visas nedan: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro-multiple.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="datawizard-tour">
<title
>En snabbtur i Dataguiden</title>
<para
>Även om det är snabbt och bekvämt att använda &kst; från kommandoraden, kan det finnas situationer då det är enklare att importera data från det grafiska användargränssnittet, till exempel om du redan har &kst; öppet med annan data laddad. Eller du kanske helt enkelt föredrar att använda det grafiska användargränssnittet. Genom att bli bekant med båda sätten att importera data, kan du använda &kst; effektivare. </para>

<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
> eller klicka på knappen <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-datawizard.png" format="PNG"/></imageobject
></inlinemediaobject
> på verktygsraden. Du blir tillrågad om att välja en datakälla. Bläddra till filen <filename
>gyordata.dat</filename
> som används för kommandoradsexemplen och klicka på <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
>Fälten som är tillgängliga i <filename
>gyrodata.dat</filename
> listas till vänster. Du kan filtrera listan med markerade fält genom att skriva in en sträng att matcha i textrutan ovanför listan (jokertecken som <literal
>*</literal
> stöds). Markera rutorna för fälten <guilabel
>1</guilabel
>, <guilabel
>2</guilabel
> och <guilabel
>3</guilabel
>. </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
>. I korthet är en post helt enkelt ett antal datasamplingar, och varje datafil består av ett antal poster. För en detaljerad beskrivning av begreppet, se <xref linkend="supportingadditionalfileformatsdatasourceconceptsframes"/>. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Start</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. Välj till exempel <guilabel
>Räkna från slutet</guilabel
> och skriv in 10000 som <guilabel
>Antal poster</guilabel
> för att bara läsa de sista 10000 posterna. Om <filename
>gyrodata.dat</filename
> uppdaterades i realtid, skulle ytterligare tillägg i slutet på filen läsas. </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
>. Avmarkera för tillfället <guilabel
>Läs en sampling per N poster</guilabel
>. </para>
</listitem>
</varlistentry>
</variablelist>

<para
>Effektspektrum och X-axelinställningar kan anges i avdelningen <guilabel
>Diagramtyper</guilabel
>. </para>

<variablelist>

<varlistentry>
<term
><guilabel
>X-Y</guilabel
>, <guilabel
>Effektspektrum</guilabel
> och <guilabel
>X-Y och effektspektrum</guilabel
> </term>
<listitem>
<para
>Välj <guilabel
>X-Y och effektspektrum</guilabel
> för att skapa diagram både med data själv och dess effektspektrum. För mer information om alternativ tillgängliga med effektspektrum, se <xref linkend="power-spectra"/>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>X-axelvektor</guilabel>
</term>
<listitem>
<para
>Vektorn kan användas som oberoende vektor för diagrammen. Du kan välja ett fält från datafilen, eller INDEX-vektorn. Eftersom <filename
>gyrodata.dat</filename
> inte innehåller en X-axelvektor, lämna kvar valet INDEX. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Avdelningen <guilabel
>FFT-alternativ</guilabel
> i dataguiden är bara tillgängligt om ett effektspektrum ska ritas upp. Den här guiden beskriver inte effektspektrum i detalj, så använd förvalda inställningar för den här avdelningen. </para>

<para
>När du väl är nöjd med alla inställningar, klicka på <guibutton
>Nästa</guibutton
> för att gå till nästa fönster. </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 ändra allmänna diagraminställningar. De flesta inställningar är självklara. Välj <guilabel
>Ett nytt diagram per kurva</guilabel
> för <guilabel
>Kurvans placering</guilabel
> och <guilabel
>I nytt fönster</guilabel
> för <guilabel
>Diagramplacering</guilabel
>. Det placerar alla sex diagrammen (tre kurvor och tre effektspektrum) i samma fönster. </para>


<para
>När du väl är nöjd med alla inställningar, klicka på <guibutton
>Slutför</guibutton
> så skapas diagrammen: </para>
<screenshot>
<screeninfo
>De skapade diagrammen</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-datawizard-done.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>De skapade diagrammen</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Att skapa diagrammen krävde en viss ansträngning, så vi borde spara nuvarande session i &kst; (den används i handledningens nästa avsnitt). Välj <guimenuitem
>Spara som...</guimenuitem
> i menyn <guimenu
>Arkiv</guimenu
>, och spara sessionen som <filename
>min_kst_session.kst</filename
>. </para>

<screenshot>
<screeninfo
>Spara en Kst-session</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-filesave.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Spara en Kst-session</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Att spara en session i &kst; sparar alla diagrammen, dataobjekten (du får lära dig om dem senare), och layouter som finns vid tillfället när sessionen sparas. </para>
<para
>När filerna väl har sparats, kan du avsluta &kst;. </para>
</sect1>

<sect1 id="mousezooming">
<title
>Grundläggande diagramhantering</title>
<para
>Nu när du bekvämt kan skapa diagram i &kst;, kan vi utforska några av funktionerna för diagramhantering som finns i det grafiska gränssnittet i &kst;. Starta &kst; från kommandoraden med filen <filename
>min_kst_session.kst</filename
> som du tidigare sparade: </para>
<screen
><userinput
><command
>kst min_kst_session.kst</command
></userinput
></screen>
<para
>Alla diagram du tidigare skapade ska nu vara laddade i &kst;. Titta på diagrammet med texten <literal
>PSD (V/Hz^{1/2})</literal
> på Y-axeln. För att närmare titta på diagrammet, högerklicka på det och välj menyalternativet <guimenuitem
>Maximera</guimenuitem
>, som visas nedan: </para>
<screenshot>
<screeninfo
>Maximera ett diagram</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-zoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Maximera ett diagram</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Diagrammet är nu maximerat i nuvarande fönster. Observera att allt för höga X-värden är diagrammet nästan helt jämnt, så det vore användbart att bara titta på området i diagrammet som ser intressant ut. För att göra det, försäkra dig om att du är i XY-muszoomläge (välj <guimenuitem
>XY-muszoom</guimenuitem
> i menyn <guimenu
>Diagram</guimenu
>, eller klicka på knappen <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xymousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
> i verktygsraden). Dra därefter helt enkelt en rektangel från ungeför (4, 0,0025) till (0,0) som visas nedan. Observera att muspekarens koordinater visas i nedre högra hörnet i fönstret i &kst; (om de inte är det, försäkra dig om att <guimenuitem
>Visa statusrad</guimenuitem
> är markerat i menyn <guimenu
>Inställningar</guimenu
>). </para>

<para
>Diagramaxlarna ändras för att <quote
>zooma in</quote
> på det valda området i diagrammet. Du kanske märker att det finns en topp i vänsterkanten av effektspektrum som går förbi den nya gränsen för Y-axeln. Antag att du vill titta på högsta punkten av toppen. Högerklicka på diagrammet och välj <guimenuitem
>Upp</guimenuitem
> i undermenyn <guimenu
>Panorera</guimenu
>. Diagrammet ska flyttas uppåt. Det är förstås troligen enklare att använda snabbtangenten som hör ihop med menyalternativet. Det gäller för de flesta av zoomnings- och panoreringsfunktionerna. I detta fall är snabbtangenten <keysym
>Uppåtpil</keysym
>, så det snabbaste sättet att flytta uppåt är att hålla nere tangenten <keysym
>Uppåtpil</keysym
>. För att när som helst återgå till maximal zoomning, högerklicka på diagrammet och välj <guimenuitem
>Zooma maximalt</guimenuitem
> i undermenyn <guisubmenu
>Zooma</guisubmenu
> (eller tryck på <keycap
>M</keycap
>, snabbtangenten som hör ihop med <guimenuitem
>Zooma maximalt</guimenuitem
>). </para>

<para
>Återställ storleken på diagrammet med effektspektrum genom att högerklicka på diagrammet och avmarkera <guimenuitem
>Maximera</guimenuitem
>. </para>

<para
>Titta nu på diagrammen med Y-axlarna som heter <literal
>Kolumn 2</literal
> och <literal
>Kolumn 3</literal
>. De är diagram av tippgyrot och rollgyrot, från flygningen av BOOMERANG 1998. Eftersom de två diagrammen hör ihop, kan det vara användbart att zooma och panorera dem samtidigt. Klicka på fyrkanterna som finns i övre högra hörnen på de två diagrammen. De ska nu få en mörk färg för att ange att de två diagrammen hör ihop: </para>

<screenshot>
<screeninfo
>Bunden zoomning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tiedzoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Bunden zoomning</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Innan vi försöker zooma in, ska vi ta bort alla diagram förutom de två vi arbetar med. Välj <guimenuitem
>Layoutläge</guimenuitem
> i menyn <guimenu
>Diagram</guimenu
> eller klicka på knappen <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-layoutmode.png" format="PNG"/></imageobject
></inlinemediaobject
> i verktygsraden. Högerklicka på diagrammen och välj <guimenuitem
>Ta bort</guimenuitem
>, för alla diagram utom de två vi vill behålla. Högerklicka därefter var som helst i nuvarande fönster och välj <guimenuitem
>Rensa layout</guimenuitem
>. Nu bör de två diagrammen dela på hela utrymmet inne i fönstret. Återgå till XY-muszoom när du är klar. </para>

<para
>Försök nu zooma in på någon del av det övre diagrammet. Du märker att det undre diagrammet blir tomt. Det beror på att de undre diagramaxlarna har ändrats för att stämma med de övre diagramaxlarna, och det finns ingen data i just det området i det undre diagrammet. Tryck på <keycap
>M</keycap
> medan muspekaren är över endera diagrammet för att återgå till maximal zoomning för båda diagrammen. Håll nu nere <keycap
>Ctrl</keycap
> (det motsvarar att välja <guimenu
>X-muszoom</guimenu
> i menyn <guimenu
>Diagram</guimenu
> eller att klicka på knappen <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xmousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
> i verktygsraden). Muspekaren ändrar form för visuell återmatning. Medan du håller nere tangenten <keycap
>Ctrl</keycap
>, rita en rektangel i det övre diagrammet. Observera att den streckade rektangelns höjd är begränsad så att bara X-axeln kommer att zoomas. Nu visar båda diagrammen data när de zoomas in, eftersom Y-axeln för något av diagrammen inte ändrades. </para>
<tip>
<para
>Du kan snabbt binda eller lösgöra alla diagrammen i fönstret genom att välja <guimenuitem
>Bunden zoom</guimenuitem
> i menyn <guimenu
>Diagram</guimenu
> eller genom att klicka på knappen <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-tiedzoom.png" format="PNG"/></imageobject
></inlinemediaobject
> i verktygsraden. </para>
</tip>
<para
>När du är klar med att experimentera med zoomningsfunktionerna, kan du stänga &kst;. Det finns ingen anledning att spara diagrammen den här gången (om du inte vill). </para>

</sect1>



<sect1 id="overviewdataobjects">
<title
>En kort översikt över dataobjekt</title>
<para
>Det finns mer i &kst; än bara enkel uppritning och visning av data. I dataguiden har du redan sett att &kst; har möjlighet att skapa effektspektrum för data. I själva verket kan &kst; också skapa andra dataobjekt som histogram, ekvationer och insticksprogram. Ett verktyg som kallas Datahantering kan hjälpa dig hålla reda på alla dataobjekt du skapar. </para>

<para
>Starta &kst; med filen <filename
>demo.kst</filename
>, som ingår i demonstrationspaketet: </para>
<screen
><userinput
><command
>kst demo.kst</command
></userinput
></screen>
<screenshot>
<screeninfo
>Kst med demo.kst</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-demo.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Kst med demo.kst</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Den här sessionen i &kst; innehåller vektorer och andra dataobjekt som skapas från data i <filename
>gyrodata.dat</filename
>. Det övre diagrammet innehåller azimutdata, diagrammet i mitten innehåller tippdata i blått, och det undre diagrammet visar effektspektrum för tippdata i blått. Låt oss först undersöka diagrammen noggrannare. Koppla ihop de två övre diagrammen med tekniken som du lärde dig i föregående avsnitt. Håll därefter ner <keycap
>Ctrl</keycap
> för att använda X-muszoom. Zooma nu in på ett litet område i det övre diagrammet (exempelvis från 50000 till 53000), för att få båda bundna diagrammen att zooma. Du märker att den blåa tippkurvan har en negativ korrelation med den röda azimutkurvan. Det beror på att tippgyrot var något lutat i förhållande till azimutaxeln (med ungefär 0,69 grader). Det verkliga tippvärdet <literal
>p'</literal
> är: <informalequation
> <mediaobject
> <imageobject
> <imagedata fileref="Equation-kst-correctedpitch.png" format="PNG"/> </imageobject
> </mediaobject
> </informalequation
> där <literal
>p</literal
> är ursprungligt tippvärde. <inlinemediaobject
><imageobject
><imagedata fileref="Symbol-kst-theta.png" format="PNG"/></imageobject
></inlinemediaobject
> är rotationen hos tippgyrot i förhållande till azimutaxeln, och <literal
>a</literal
> är azimutgyrot. <literal
>p'</literal
> ritas upp som den svarta kurvan i mittendiagrammet. Effektspektrum för <literal
>p'</literal
> är den svarta kurvan i diagrammet längst ner. </para>

<para
>Låt oss nu ta en titt på hur de tre diagrammen skapades. För att visa datahanteringen, välj <guimenuitem
>Datahantering...</guimenuitem
> i menyn <guimenu
>Data</guimenu
>, eller klicka på knappen <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-datamanager.png" format="PNG"/></imageobject
></inlinemediaobject
> i verktygsraden: </para>
<screenshot>
<screeninfo
>Datahantering</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datamanager.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Datahantering</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Datahanteringen innehåller den fullständiga listan med dataobjekt i nuvarande session i &kst;. Den låter dig också redigera och skapa nya dataobjekt. Som du kan se, finns det tre kurvor (var och en skapad från ett par vektorer), en ekvation, två effektspektrum och fyra datavektorer i listan. Högerklicka på C2-GY_PITCH och välj <guimenuitem
>W1-P1</guimenuitem
> i undermenyn <guisubmenu
>Ta bort från diagram</guisubmenu
>. Det tar bort kurvan från diagrammet P1 i fönstret W1. Ta också bort PSD2-V3-GY_PITCH från diagrammet P3 i fönstret W1 med samma procedur. Nu ska bara de korrigerade kurvorna visas i diagrammen: </para>

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

<para
>För att se hur det korrigerade tippgyrot skapades, markera C4-cleaned_pitch och klicka på knappen <guibutton
>Redigera</guibutton
>. Dialogrutan Redigera ekvation ska visas: </para>
<screenshot>
<screeninfo
>Redigera ekvation</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-editequation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Redigera ekvation</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Observera att ekvationen som används för att beräkna <literal
>p'</literal
> skrevs in i textrutan <guilabel
>Ekvation</guilabel
> (approximationen 1 användes för <literal
>cos(-0,69)</literal
>). Tveka inte att experimentera med inställningarna i dialogrutan. Klicka på <guibutton
>Ok</guibutton
> (för att spara eventuella ändringar som gjorts) eller <guibutton
>Avbryt</guibutton
> när du är klar. </para>

<para
>Observera att alla dataobjekt har ett tal som anges i kolumnen <guilabel
>Antal använda</guilabel
>. Talet anger antal gånger som dataobjektet antingen används av andra dataobjekt eller av diagram. Eftersom vi tog bort en kurva och ett effektspektrum, ska åtminstone två dataobjekt ha 0 angivet i kolumnen. Klicka på <guibutton
>Rensa</guibutton
> för att ta bort alla oanvända dataobjekt permanent. </para>

<para
>Klicka på <guibutton
>Stäng</guibutton
> för att stänga datahanteringen. Du kan avsluta &kst; nu om du önskar. </para>
</sect1>

<sect1 id="pluginsandevents">
<title
>En titt på insticksprogram och händelser</title>
<para
>Vi slutar vår resa genom &kst; genom att titta på två specifika typer av data: insticksprogram och händelsebevakning. </para>

<para
>Ett insticksprogram är ett flexibelt dataobjekt, vars beteende helt och hållet beror på den specifika insticksprogramfilen som väljs. Insticksprogrammet kan vara ett som ingår i den vanliga distributionen av &kst;, eller en insticksprogramfil från tredje part. Du hittar instruktioner om hur man skriver och kompilerar egna insticksprogramfiler i <xref linkend="creatingplugins"/>. Insticksprogram låter &kst; utföra godtyckliga operationer på en datamängd, eftersom det enda kravet på insticksprogram är att de tar emot en uppsättning indatavektorer och skalärer, och ger en uppsättning utdatavektorer och skalärer. </para>

<para
>Som ett exempel ska vi försöka anpassa en enkel linje till en liten mängd datapunkter. Starta &kst; med ett diagram av första fältet i datafilen <filename
>maxima.dat</filename
> som ingår i demonstrationspaketet: </para>

<screen
><userinput
><command
>kst -y 1 -d maxima.dat</command
></userinput
></screen>

<para
>Väljaren <option
>d</option
> anger att bara punkter ska ritas upp, inte linjer. Diagrammet med datapunkter ska nu visas: </para>
<screenshot>
<screeninfo
>Diagram med datapunkter</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-maxima-datapoints.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Diagram med datapunkter</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Öppna nu datahanteringen, Klicka på <guibutton
>Insticksprogram...</guibutton
> i avdelningen <guilabel
>Ny</guilabel
> för att skapa ett nytt insticksprogramobjekt. Under <guilabel
>Insticksprogramval</guilabel
>, välj insticksprogrammet <guimenuitem
>Linjär anpassning</guimenuitem
>. Just det här insticksprogrammet kräver två indatavektorer, en som innehåller X-värden och en annan som innehåller Y-värden för datapunkterna som ska anpassas. Välj <guimenuitem
>V1-INDEX</guimenuitem
> för <guilabel
>Indatavektor - X-fält</guilabel
> och <guimenuitem
>V2-1</guimenuitem
> för <guilabel
>Indatavektor - Y-fält</guilabel
>. Klicka därefter på <guibutton
>Ok</guibutton
>. Du märker att det nya insticksprogramobjektet har skapad slavvektorer för att lagra utdata. Klicka på <guibutton
>Kurva...</guibutton
> för att skapa en ny kurva från utdatavektorerna. Välj <guimenuitem
>V1-INDEX</guimenuitem
> för <guilabel
>X-axelvektor</guilabel
> och <guimenuitem
>P1-kstfit_linear_unweighted-Y Fitted</guimenuitem
> för <guilabel
>Y-axelvektor</guilabel
>. Vi vill placera kurva ovanpå datapunkterna i det befintliga diagrammet, så markera <guilabel
>Placera i befintligt diagram</guilabel
> och avmarkera <guilabel
>Placera i nytt diagram</guilabel
> under <guilabel
>Kurvans placering</guilabel
>. Klicka till sist på <guibutton
>Ok</guibutton
> för att skapa kurvan. Stäng datahanteringen för att titta på den anpassade linjen: </para>

<screenshot>
<screeninfo
>Anpassad linje</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-fittedline.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Anpassad linje</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>En procedur som liknar den du just följt låter dig skapa och rita upp utdata från vilken typ av insticksprogramobjekt som helst. Det finns dock en genväg för att skapa insticksprogram för anpassning. Genom att högerklicka på ett diagram visas den sammanhangsberoende menyn, som innehåller undermenyn <guisubmenu
>Anpassa...</guisubmenu
>. Genom att välja en kurva i undermenyn, visas dialogrutan Anpassa funktion med förvalda X- och Y-vektorer. Efter insticksprogrammet för anpassning är valt, skapas insticksprogramobjektet, kurvan från insticksprogrammets utdata och kurvan placeras i befintligt diagram genom att klicka på knappen <guibutton
>Ok</guibutton
>. </para>

<para
>Låt oss nu ta en titt på händelser. Händelseobjekt bevakar ofta andra vektorer eller skalärer och utför angivna åtgärder när vissa villkor som rör dessa vektorer eller skalärer är sanna. Klicka på <guibutton
>Händelsebevakning...</guibutton
> i avdelningen <guilabel
>Ny</guilabel
> i datahanteringen för att skapa en ny händelse: </para>
<screenshot>
<screeninfo
>Händelsebevakning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Händelsebevakning</phrase>
</textobject>
</mediaobject>
</screenshot>

<!-- FIXME: This seems to be incorrect: the equation given doesn't work -->
<para
>Antag att tippgyrots data uppdaterades i realtid, och att vi vill bli underrättade så fort det korrigerade tippgyrovärdet hamnar utanför området <literal
>[-0,60, -0,40]</literal
>. För att ställa in händelsen på så sätt, skriv in följande i textrutan <guilabel
>Uttryck</guilabel
>: </para>

<para>
<literal
>[C4-cleaned_pitch-sv]&gt;(-0.40) | [C4-cleaned_pitch-sv]&lt;(-0.60)</literal>
</para>

<para
>Observera att allt som skrivs in som ett uttryck måste vara ett Booleskt uttryck. Just det här uttrycket utvärderas som sant så fort någon av olikheterna är sanna. Välj både <guilabel
>Logga som</guilabel
> och <guilabel
>Meddela</guilabel
>, och skriv in din e-postadress till höger om kryssrutan <guilabel
>Meddela</guilabel
>. Klicka på <guibutton
>Ok</guibutton
>, så skapas händelsen. </para>

<para
>Välj nu <guimenuitem
>Felsökning av Kst...</guimenuitem
> i menyn <guimenu
>Hjälp</guimenu
>. Klicka på fliken <guilabel
>Logg</guilabel
> för att visa felsökningsloggen. Om händelsen har ställts in riktigt, ska du se varningar som anger de X-värden som händelsen aktiverades för. Kontrollera att värdena grovt stämmer överens med de du kan vänta dig från att titta på diagrammet: </para>

<screenshot>
<screeninfo
>Felsökningslogg</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-debuglog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Felsökningslogg</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Om tippgyrodata uppdaterades i realtid, skulle händelsebevakningen också aktiveras för eventuell ny data när det behövs. </para>

<para
>När du är klar, kan du avsluta &kst;. </para>
</sect1>


<sect1 id="conclusion">
<title
>Avslutning</title>

<para
>Detta avslutar &kst; handledningen. Förhoppningsvis har du fått tillräckligt med kunskap för att kunna använda &kst; bekvämt. Kom ihåg att handledningen inte täcker alla funktioner i &kst;. Det finns fortfarande mycket att utforska och experimentera med. Resten av handboken är en omfattande guide till begrepp som sträcker sig från grundläggande fönsterlayout till att skapa egna insticksprogram och läsare av datakällor. Du uppmuntras att använda &kst; på intressanta och uppfinningsrika sätt: du kommer troligen märka att det inte bara uppfyller, utan överträffar dina behov och krav. </para>
</sect1>


</chapter>

<!-- 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" "chapter")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

