# Inledning

## Vad är &kst;?

&kst; är ett datauppritnings- och analysprogram. Några av funktionerna omfattar:

- Robust uppritning av strömmande data i realtid, inklusive stöd för automatisk bevakning av händelser och underrättelser.

- Kraftfullt stöd för insticksprogram och utökningar.

- Stort urval av inbyggda uppritnings- och analysfunktioner, såsom histogram, ekvationer, kurvanpassning, filtrering och effektspektrum.

- Kraftfullt grafiskt användargränssnitt, med unika visningslägen för enkel hantering av diagram.

- Möjlighet att använda färgkartor och konturkartor för tredimensionell data.

- Stöd för flera populära dataformat inklusive FITS, netCDF och HEALPix, samt ASCII. Ytterligare format kan hanteras med insticksprogram.

- Kst-skript, ett skriptspråk baserat på Javaskript som gör det möjligt att automatisera komplicerade arbetsflöden.

## Komma igång

Detta är en kortfattad inledande handledning som täcker de grundläggande funktionerna i &kst;. Vi beskriver ...

- Import och uppritning av obehandlad data

- Hantering av diagram

- Grundläggande dataanalys med &kst;

### Importera data

Låt oss börja med att beskriva hur obehandlad data kan importeras i &kst; med användning av det grafiska gränssnittet. (Det kan också göras på kommandoraden. Se appendix om Kommandoradsväljare för detaljinformation.)

Börja med att starta &kst;. När du gör det för första gången, ska dialogrutan Snabbstart normalt visas.

Dialogrutan Snabbstart
Skärmbild av dialogrutan Snabbstart

Dialogrutan har en lista med &kst;-sessioner som nyligen öppnats, samt en länk till dataguiden. Dataguiden gör det möjligt att importera data i &kst; med det grafiska gränssnittet. Vi går igenom hur det används nu.

Klicka på knappen Dataguide. En dialogruta för datakällor dyker upp som låter dig välja en fil eller nätverksresurs (t.ex. HTTP-adress) att använda som datakälla. &kst; avgör källans format från dess filändelse och innehåll.

Vi kommer att importera data från en fil som heter gyrodata.dat, som ska ingå i installationen av Kst. Platsen för filen är `$`KDEDIR`/share/apps/kst/tutorial/gyrodata.dat`, där `$`KDEDIR`` är platsen där &kde; är installerat på systemet (du kan hitta den med kommandot `kde-config --prefix`).

Välj att öppna `gyrodata.dat`. &kst; ska rapportera datakällan som typ ASCII, vilket betyder att data har ett enkelt avgränsat textformat. Fler alternativ kan ses genom att klicka på knappen Anpassa. Inställningarna för filen gyrodata.dat ska vara som visas nedan:

Datakällor - Anpassa ASCII

Stäng dialogrutan Anpassa datakälla, och klicka på knappen Nästa. Det visar en ruta där du kan välja fälten i datakällan som du vill arbeta med. I fallet med ASCII-data, är varje fält en kolumn i textfilen. Välj data från det första, andra och tredje fältet. INDEX-fältet är ett kompletterande fält som skapats av &kst;. Det innehåller heltal från 0 till N-1, där N är antalet poster i datafilen. När du väl har markerat de riktiga fälten, ska rutan se ut så här:

Dataguiden - Dialogrutan Välj data

Klicka på knappen Nästa igen, för att gå till rutan Datapresentation. Den låter dig välja några grundläggande och ofta ändrade inställningar för diagrammen som snart ska skapas.

Dataintervall används för att ange delmängden av data som ska läsas från de valda vektorerna i indatafilen. För mer information om rutan, se dokumentationen om dataguiden.

Ställ in datapresentationsrutan så att den ser ut som följer:

Dataguidens datapresentationsruta

Detta talar om för &kst; att vi vill läsa all tillgänglig data för de valda fälten, och att vi vill skapa diagram med INDEX längs X-axeln. INDEX är en automatiskt skapad vektor som anger dataelementens position i filen.

Att klicka på Nästa igen tar oss till den sista rutan i dataguiden, där det finns inställningar för att bestämma utseendet hos data som ritas upp. Vi kan välja stil på kurvan, bestämma om texter och förklaringar ska skapas från tillgängliga fältnamn, och bestämma vilka diagram kurvorna ska placeras i. Återigen är de förvalda inställningarna bra nog för tillfället.

Dataguiden - Inställning av datapresentationsrutan

Klicka nu på knappen Slutför för att skapa diagrammen. Din &kst;-session ska nu se ut ungefär så här:

Komma igång - Inledande diagram
Komma igång - Inledande diagram

Gratulerar! Du har just ritat några enkla diagram med &kst;. Att skapa diagrammen krävde en viss ansträngning, så vi bör spara den nuvarande &kst;-sessionen (den kommer att användas i handledningens nästa avsnitt). Välj Spara som... i menyn Arkiv, och spara sessionen som `min_kst_session.kst`.

Spara en KST-session
Spara en KST-session

Genom att spara &kst;-sessionen kan du senare återställa diagrammen.

### Behandling av diagram

Nu när du känner dig säker på hur man skapar diagram från importerad data i &kst;, kan vi utforska några funktioner för diagramhantering som är tillgängliga via det grafiska gränssnittet. Starta &kst; från kommandoraden med filen `min_kst_session.kst` som du tidigare sparade:

    kst min_kst_session.kst

Alla diagram som du skapade i avsnittet Importera data ska nu vara laddade i &kst;. Betrakta diagrammen där Y-axeln kallas `Kolumn 2`. För att betrakta diagrammet närmare, högerklicka på det och välj menyalternativet Maximera, som visas nedan:

Maximera ett diagram
Maximera ett diagram

Diagrammet du markerade kommer nu att maximeras inne i det nuvarande fönstret. Observera att data fortfarande ligger tätt i diagrammet, så det vore lämpligt att zooma in på ett intressant område. För att göra det, försäkra dig om är att XY-muszoom är aktiverat (välj XY-muszomm i menyn Diagram, eller klicka på knappen i verktygsraden). Dra därefter helt enkelt en rektangel omkring området du är intresserad av. Observera att muspekarens koordinater visas i nedre högra hörnet av &kst;s fönster (om de inte gör det, försäkra dig om att Visa statusrad är markerat i menyn Inställningar).

Diagramaxlarna ändras för att zooma in till det markerade området i diagrammet. Antag att du vill titta på data som ligger precis utanför området du har zoomat in till. Det kan göras med &kst;s panoreringsfunktion. Högerklicka på diagrammet och välj Upp, Ner, Vänster eller Höger i undermenyn Panorera. Diagrammet panoreras på motsvarande sätt. Det är förstås oftast enklare att använda snabbtangenten som hör ihop med menyalternativet. Det gäller för de flesta zoom- och panoreringsfunktioner. Snabbtangenter för panorering är piltangenterna, så det snabbaste sättet att panorera uppåt är att trycka på tangenten Uppåtpil. För att när som helst återgå till maximal zoom, högerklicka på diagrammet och välj Zooma maximalt i undermenyn Zoom (eller skriv M, snabbtangenten som hör ihop med Zooma maximalt).

Återställ diagrammets storlek genom att högerklicka på det och avmarkera alternativet Maximera.

Titta nu på diagrammen med Y-axlar som heter `Kolumn 2` och `Kolumn 3`. De är diagram av tippgyrot och rollgyrot från flygningen 1998 med BOOMERANG. Eftersom de två diagrammen hör ihop, kan det vara användbart att zooma och panorera i dem samtidigt. Klicka på fyrkanterna placerade i övre högra hörnet på de båda diagrammen. De ska bli gråfärgade för att ange att de två diagrammen nu är sammankopplade:

Bunden zoomning
Bunden zoomning

Innan vi försöker zooma in, ska vi ta bort diagrammet med Kolumn 1, som vi inte längre kommer att arbeta med. Högerklicka på diagrammet och välj Ta bort. Ett hål lämnas i diagramfönstret. Vi kan rätta till det genom att högerklicka var som helst inne i fönstret och välja Rensa layout Förvald sida vid sida. Nu ska de två återstående diagrammen dela maximalt utrymme inne i fönstret. Återgå till XY-muszoom när du är klar.

Försök nu zooma in på någon del i det övre diagrammet. Du märker att det undre diagrammet blir tomt. Det beror på att diagramaxlarna i det nedre diagrammet har ändrats för att stämma med axlarna i det övre diagrammet, och att det inte finns någon data i det området av det undre diagrammet. Tryck på M när muspekaren befinner sig över något av diagrammen för att återgå till maximal zoom för båda diagrammen. Håll nu nere Ctrl (det motsvarar att välja XY-muszoom i menyn Diagram eller klicka på knappen i verktygsraden). Muspekaren ändrar form för visuell återmatning. Medan Ctrl hålls nere, rita en rektangel i det övre diagrammet. Observera att rektangelns storlek begränsas så att bara X-axeln zoomas. Nu visar båda diagrammen data när de zoomas in, eftersom Y-axeln inte ändrades för något av diagrammen.

Du kan snabbt binda eller lösgöra alla diagrammen i fönstret genom att välja Bunden zoom i menyn Diagram eller genom att klicka på knappen i verktygsraden.

När du har experimenterat färdigt med zoomfunktionerna, kan du spara filen `min_kst_session.kst` igen, med ändringarna som har gjorts.

### Grundläggande analys och datahantering

Det finns mer i &kst; än bara enkel uppritning och visning av data. Du har redan sett i dataguiden att &kst; har möjlighet att skapa effektspektra av data. I själva verket har &kst; också förmåga att skapa andra dataobjekt som histogram, ekvationer och insticksprogram. Ett verktyg som kallas datahanteringen hjälper till att göra det.

Öppna nu datahanteringen genom att klicka på verktygsraden eller genom att välja Datahantering i menyn Data.

Datahantering
Datahantering

Datahanteringen innehåller den fullständiga listan med dataobjekt i nuvarande &kst;-session. Den låter dig också redigera eller skapa nya dataobjekt. Som du kan se, finns det för närvarande tre kurvor (var och en från ett par av vektorer) och fyra datavektorer listade. En sammanfattning ges för varje objekt. Se avsnittet Datahantering för mer information.

Vi såg tidigare, när vi försökte med bunden zoom i XY-zoomläge, att data i Kolumn 2 och Kolumn 3 har olika positioner i Y-led. Antag att vi skulle vilja jämföra dem på samma diagram. För att göra det måste vi förskjuta medelvärdet i ett av diagrammen. Det kan vi enkelt göra genom att använda ett ekvationsobjekt.

Börja processen att skapa en ekvation genom att klicka på motsvarande knapp under fliken Skapa dataobjekt till vänster i datahanteringen. En dialogruta för att skapa det nya objektet visas. Ställ in dialogrutan som visas nedan:

Ny ekvation
Ny ekvation

Ekvationen tar värden från datavektorn [2], subtraherar det skalära värdet [2/mean], och lägger därefter till det skalära värdet [3/mean] för att skapa en ny vektor, som är [2] förskjuten vertikalt så att den har samma medelvärde som datavektorn [3]. Observera i kombinationsrutan Skalärer, att &kst; skapar en uppsättning enkel statistik för alla vektorer (samt för många andra objekt). Den kan ofta visa sig vara användbar.

Klicka på knappen Ok i dialogrutan Ny ekvation. Nu har en ny kurva lagts till i diagrammet där Y-axeln kallas Kolumn 3. Om vi återgår till &kst;s diagramfönster kan vi zooma till diagrammet med Kolumn 3. Genom att jämföra data, ser vi vad vi misstänkte, att datavektorn [2] är i stort sett likadan som [3], men fullständigt ur fas:

Komma igång - Slutliga diagram

Detta avslutar vår grundläggande introduktion till &kst;. Vi uppmanar dig nu att experimentera med programmet. Det finns helt klart många funktioner i &kst; som inte täcks av denna handledning. Det mesta hittar man intuitivt. Du bör kanske ta en titt på några avsnitt i kapitlet Vanliga uppgifter. Lycka till!