# &kst; gennemgang

Barth Netterfield

    kst@kde.org

Rick Chern

    kst@kde.org

&erik.kjaer.pedersen.role;
2004 University of British Columbia
&FDLNotice;
2004-06-23
0.98

&kst; er et program for plotplotning og behandling af data med kraftfuld støtte for plugin.

KDE kdeextragear kdeextragear-2 Kst plotning plot

## Velkommen

Velkommen til &kst;. På nogle få minutter kommer du at være på vej med at udførsel af de talrige funktioner i denne plotnings- og datahåndteringspakke. Her er kun nogle af de opgaver du kan opnå med &kst;:

- Hurtigt plotte flere grafer kun ved brug af kommandolinjen.

- Analysér data med et omfattende sæt værktøjer, inklusive histogrammer, effektspektre og egne ligninger.

- Forstør og formindsk interessante områder i plot uden anstrengelse, ved enten at bruge musen eller tastaturet.

- Overvåg levende strømmende data med mulighed for realtidsplotning i &kst;.

Denne vejledning dækker det grundlæggende i at installere, køre og arbejde med &kst;. Du indbydes til yderligere at udforske hvilken som helst funktion når som helst. Alle funktioner er dokumenterede i den officielle Kst-håndbog, tilgængelig ved at vælge Kst-håndbog i menuen Hjælp i &kst;.

## Installation

I de fleste tilfælde er det enkelt at udføre en grundinstallation af &kst;. De eneste forudsætninger for &kst; er version 3.1 eller senere af &kde; og &Qt;. Dog gør valgfrie biblioteker som &GNU; Scientific Library det muligt at kompilere &kst; med yderligere støtte for plugin og filer, og det anbefales stærkt eftersom de kræves for visse dele af vejledningen.

Hvis du bruger et pakkehåndteringssystem, kan du bruge det til at installere &kst; i stedet. Vær dog vidende om at versionen som er tilgængelig i arkivet måske ikke er den nyeste.

Først skal du sikre dig at nødvendige &kde;- og &Qt;-biblioteker er installeret på dit system. &kst; version 0.99 kræver &kde; 3.1 og &Qt; 3.1. Næsten alle større &Linux;-distributioner har pakker for &kde; og &Qt;, så det anbefales at du blot kigger i din distributions dokumentation for installation af &kde;. Mere information er tilgængelig på &kde;'s hjemmeside.

&GNU;'s videnskabelige biblioteker GSL sørger for varierende matematiske operationer for de indbyggede plugin i &kst;. Biblioteket findes på ftp://ftp.gnu.org/gnu/gsl/. Alternativt kan du finde GSL på `/gnu/gsl` via spejlstederne som er på listen på http://www.gnu.org/prep/ftp.html. Hent `gsl-[version].tar.gz`, hvor [version] er det højeste versionsnummer som er i mappen. Pak derefter filen ud:

    tar -zxvf gsl-[version].tar.gz

Erstat [version] med den hentede fils versionsnummer.

Læs filen `INSTALL` i den resulterende mappe for detaljerede instruktioner. For de fleste systemer fungerer det som følger:

    cd gsl-[version]
    ./configure
    make
    make install

Det andet (men stærkt anbefalede) bibliotek er CFITSIO. Det sørger for støtte for at læse og skrive med dataformatet FITS (Flexible Image Transport System). Biblioteket kan findes på ftp://heasarc.gsfc.nasa.gov/software/fitsio/c/. Hent `cfitsio[version].tar.gz`, hvor [version] er det højeste versionsnummer som findes i mappen. Pak derefter filen ud:

    tar -zxvf cfitsio[version].tar.gz

Erstat [version] med den hentede fils versionsnummer.

Læs filen `README` i den resulterende mappe for detaljerede instruktioner. For de fleste system fungerer det som følger:

    cd cfitsio
    ./configure --prefix=/usr
    make
    make install

Du kan blive nødt til at ændre flaget `--prefix` for netop dit system, men for de fleste systemer virker `/usr`.

Når alle forhåndskrav er opfyldte i dit system, kan du kompilere og installere &kst;. Hent den seneste kildekodepakke separat fra hjemmesiden for &kst;. Skriv derefter følgende:

    tar -zxvf kst-[version].tar.gz
    cd kst-[ver]
    ./configure --enable-final --prefix=`kde-config --prefix`
    make
    make install

Erstat [version] med versionen af &kst; som du har.

Bemærk at `kde-config --prefix` er omgivet af `. Det er meget vigtigt at `kde-config` returnerer den rigtige søgesti (formodentlig `/usr`), ellers installeres der ikke rigtigt. Du kan dobbeltkontrollere ved at køre det direkte:

    kde-config --prefix

Sørg for at noget andet end en tom søgesti vises.

Du kan gennemlæse meddelelser som vises af scriptet `configure`. Hvis det rapporterer nogle manglede biblioteker (for eksempel GSL) som ikke skal mangle, gå tilbage og sørg for at biblioteker og deklarationsfiler er installeret rigtigt på passende steder. Hvis installationen lykkes, kan du nu gå til næste afsnit i vejledningen.

## Start &kst; fra kommandolinjen

En almindelig brug af &kst; er til hurtigt at oprette plot med data fra kommandolinjen. Denne måde at oprette plot kræver næsten intet kendskab til den grafiske grænseflade i &kst;, men laver alligevel umiddelbart brugbare resultater.

Denne vejledning bruger en demonstrationspakke med datafiler som er tilgængeligt her. Hent den og pak pakken ud, og gå til den oprettede mappe:

    tar -zxvf kst_tutorialdata.tgz
    cd kst_tutorialdata

For at få en oversigt over alle tilgængelige kommandolinjeflag i &kst;, skriv:

    kst --help

En syntaksbeskrivelse og liste med kommandoer som ligner det følgende vises:

    Brug: kst [Qt-vælgare] [KDE-vælgare] [vælgare] [Files]

    Kst: et datavisningsprogram

    Generella vælgare:
      --help                    Vis hjælp om flag
      --help-qt                 Vis flag specifikke for Qt
      --help-kde                Vis flag specifikke for KDE
      --help-all                Vis alle flag
      --author                  Vis information om forfattere
      -v, --version             Vis versionsinformation
      --license                 Vis licensinformation
      --                        Slut på flag

    Flag:
      -F <dataFile>             Angiv datafil: bruges for at sætte forvalgt Kst-fil ud af kraft [|]
      -y <Y>                    Felt for Y-akse (flere tillades)
      --ye <equation>           Ligningen for Y-akse (flere tillades)
      -e <E>                    Felt for Y-fejl (flere tillades)
      -x <X>                    Felt eller interval for X-akse [INDEKS]
      --xe <X>                  X-vektor for ligninger x0:x1:n [INDEKS]
      -p <Y>                    Felt for effektspektrum (flere tillades)
      -h <Y>                    Felt for histogram (flere tillades)
      -r <f>                    Samplingsfrekvens for effektspektrum [60.0]
      --ru <U>                  Enheder for samplingsfrekvens for spektral effekttæthet [Hz]
      --yu <U>                  Enheder for Y-vektorer [V]
      -l <P>                    FFT-længden er 2^P [10]
      -f <F0>                   Første post at læse [-2]
      -n <NS>                   Antal rammer at læse [-2]
      -s <NS>                   Antal rammer at springe over for hver læsning [-1]
      -a                        Anvend lavpassfilter inden rammer springes over
      -m <NC>                   Separate plot arrangeret i antal søjler
      -d                        Vis som punkter i stedet for kurver
      -g                        Vis i forklaringsrude
      --print <file>            Udskriv til fil og afslut [<none>]
      --png <file>              Gem som en PNG-fil og afslut [<none>]

    Parametre:
      Files                     Datafiler (hvis -y angivet) eller *.kst-fil

Flag specifikke for &kst; på liste under afsnittet `Flag:`. Hvor det passer angives standardværdier med kantede parenteser i slutningen af beskrivelsen af flaget. Disse værdier bruges for flag som ikke angives.

Først tager vi et kig på ASCII-filen `gyrodata.dat`, som indgår i demonstrationspakken. ASCII-filer er en af de mange filtyper som &kst; kan læse. I ASCII-filer er data arrangeret i søjler, hvor hver søjle svarer til et felt, og søjlenummeret (begyndende på 1 fra venstre til højre) svarer til feltnavnene. Denne specielle ASCII-fil indeholder tre søjler, og har altså feltnavnene 1, 2 og 3. For at oprette et plot med den første søjle, skriv blot:

    kst -y 1 gyrodata.dat

Alle data i den første søjlen tegnes op:

Bemærk at intet felt blev angivet for plottets X-akse, så &kst; bruger standardvektoren INDEKS, som forventet. INDEKS-vektoren er en speciel vektor i &kst; som indeholder heltal fra 0 til N-1, hvor N er antal dataværdier i tilsvarende vektor for Y-aksen. Luk &kst; ved at vælge Afslut i menuen Fil, eller ved at skrive Ctrl Q.

`gyrodata.dat` indeholder 20000 rammer, så måske vil du kun kigge på en del af inddata. For at kun plotte 10000 rammer, begyndende på post 7000, skriv:

    kst -y 1 -f 7000 -n 10000 gyrodata.dat

En af styrkerne ved &kst; er dets mulighed for at plotte realtidsdata. Antag at nye data hele tiden tilføjes til slutningen på `gyrodata.dat`. Ved et sådant scenario, ville det være nyttigt at kun plotte den sidste del af data. For kun at plotte de seneste 10000 rammer i `gyrodata.dat`, indskrives følgende:

    kst -y 1 -n 10000 gyrodata.dat

Hvis `gyrodata.dat` opdateredes, vil plottet fortsætte med at bevæge sig for kun at vise de sidste 10000 rammer.

I stedet for direkte at indlæse en datafil, kan &kst; bruge ASCII-data fra stdin som en datakilde. For at angive stdin som inddata, skrives blot `stdin` som et af filnavnene. Der er mange måder at bruge denne mulighed, såsom at bruge &kst; som en del af en rækkefølge af sammenkoblede pipes:

    cat gyrodata.dat | awk '{print $1 + 2}' | kst -y 1 stdin

Kommandoen ovenfor bruger `awk` til at tilføje 2 i første søjle af `gyrodata.dat` inden resultatet sendes videre til &kst;.

Bemærk at beskrivelsen af flaget `y` angiver at flere forekomster af flaget tillades. Det gør det muligt hurtigt at plotte mere end en kurve, eller til og med mere end et plot. For at plotte alle tre felter i `gyrodata.dat` i separate plot, indskrives følgende:

    kst -y 1 -y 2 -y 3 -m 1 gyrodata.dat

Flaget `m` angiver at adskilte plot skal bruges i stedet for et enkelt plot, som vises nedenfor:

## En hurtigtur i Dataguiden

Selv om det er hurtigt og bekvemt at bruge &kst; fra kommandolinjen, kan der være situationer hvor det er nemmere at importere data fra den grafiske brugergrænseflade, for eksempel om du allerede har &kst; åben med anden data indlæst. Eller du måske helt enkelt foretrækker at bruge den grafiske brugergrænseflade. Ved at blive bekendt med begge måder at importere data, kan du bruge &kst; effektivere.

Dataguiden sørger for en hurtig og nem måde at oprette vektorer, kurver og plot i &kst; fra datafiler. For at starte guiden, vælges Dataguide... i menuen Data eller klikke på knappen på værktøjslinjen. Du bliver bedt om at vælge en datakilde. Gå til filen `gyordata.dat` som bruges i kommandolinjeeksemplet og klik på Næste. Følgende vindue vises:

Dataguidens anden skærm
Dataguidens anden skærm

Felter som er tilgængelige i `gyrodata.dat` er på listen til venstre. Du kan filtrere listen med markerede felter ved at indskrive en streng at matche i tekstfeltet ovenfor listen (jokertegn såsom `*` understøttes). Indtast `*` for at matche alt (dvs. markere alle tilgængelige felter), og klik derefter på Vælg markerede for at vælge alle markerede felter (som i dette tilfælde tilfældigvis er alle felter).

Afsnittet Dataområde bruges til at angive dataintervallet som skal læses for de valgte vektorer i inddatafilen. Følgende beskrivelse forudsætter kendskab til rammer. I korthed er en post blot et antal datasamplinger, og hver datafil består af et antal rammer. For en detaljeret beskrivelse af begrebet, se Kst's håndbog.

Startramme, Tæl fra slutningen, Antal rammer og Læs til slutningen

  Ved at bruge disse fire indstillinger, kan nedre og øvre grænse for dataintervallet angives. Vælg for eksempel Tæl fra slutningen og skriv 10000 som Antal rammer for kun at læse de sidste 10000 rammer. Hvis `gyrodata.dat` opdateredes i realtid, ville yderligere tilføjelser til slutningen på filen blive læst.

Læs en sampling per N rammer og Lavpassfilter først

  Foruden nedre og øvre grænse for dataintervallet, kan samplingerne som skal læses fra det valgte interval angives. Hvis Læs en sampling pr N rammer (hvor N er den angivne værdi) ikke er markeret, læses alle samplinger i det valgte interval. Som alternativ, kan rammer i datafilen springes over ved at markere Læs en sampling pr N rammer. Afmarkér indtil videre Læs en sampling pr N rammer.

Effektspektrum og X-akse-indstillinger kan angives i afsnittet Plottyper.

X-Y, Effektspektrum og X-Y og effektspektrum

  Vælg X-Y og effektspektrum for at oprette plot både med data selv og deres effektspektrum.

X-akse-vektor

  Vektoren kan bruges som uafhængig vektor for plottet. Du kan vælge et felt fra datafilen, eller INDEKS-vektoren. Eftersom `gyrodata.dat` ikke indeholder en X-akse-vektor, efterlades valget INDEKS.

Afsnittet FFT-tilvalg i dataguiden er kun tilgængelig hvis et effektspektrum skal plottes. Denne guide beskriver ikke effektspektre i detalje, så brug standardindstillinger for dette afsnit.

Når du er tilfreds med med alle indstillinger, klik på på Næste for at gå til næste vindue.

Dataguidens tredje skærm
Dataguidens tredje skærm

Herfra kan du ændre generelle plotindstillinger. De fleste indstillinger er selvforklarende. Vælg Et nyt plot pr kurve for Kurvens placering og I nyt vindue for Plotplacering. Det placerer alle seks plot (tre kurver og tre effektspektre) i samme vindue.

Når du er tilfreds med alle indstillinger, klik så på Afslut så laves plottene:

De genererede plot
De genererede plot

At generere plottene krævede en vis indsats, så vi vil gemme nuværende session i &kst; (den bruges i vejledningens næste afsnit). Vælg Gem som... i menuen Fil, og gem sessionen som `min_kst_session.kst`.

Gem en Kst-session
Gem en Kst-session

At gemme en session i &kst; gemmer alle plot, dataobjekter (du vil lære om dem senere), og layouter som findes på det tidspunkt hvor sessionen gemmes.

Når filerne er gemt, kan du afslutte &kst;.

## Grundlæggende plothåndtering

Nu når du har fundet ud af at oprette plot i &kst;, kan vi udforske nogen af funktionerne for plothåndtering som er i den grafiske grænseflade i &kst;. Start &kst; fra kommandolinjen med filen `min_kst_session.kst` som du tidligere gemte:

    kst min_kst_session.kst

Alle plot du tidligere lavede skulle nu være indlæste i &kst;. Kig på plottet med teksten `PSD of Column 2 (V/Hz^{1/2})` på Y-aksen. For at kigge nærmere på plottet, højreklikkes på det og menupunktet Maksimér vælges, som vist nedenfor:

Maksimér et plot
Maksimér et plot

Plottet er nu maksimeret i nuværende vindue. Bemærk at alt udenfor 4 Hz ikke ser interessant ud i dette plot, så det ville være nyttigt kun at kigge på det område i plottet som ser interessant ud. For at gøre det, skal du sørge for at du er i XY-museforstørrelsestilstand (vælg XY-museforstørrelse i menuen Plot, eller klik på knappen i værktøjslinjen). Tegn derefter helt enkelt et rektangel fra cirka (4, 0,0025) til (0,0) som vist nedenfor. Bemærk at musemarkørens koordinater vises i nederste højre hjørne i vinduet i &kst; (hvis de ikke er der, så sørg for at Vis statuslinje er markeret i menuen Indstillinger).

Forstør et plot
Forstør i et plot

Plot-akserne ændres for at forstørre til det valgte område i plottet. Du bemærker måske at der er en top i venstrekanten af effektspektret som går ud over den nye grænse for Y-aksen. Antag at du vil kigge på det højeste punkt af toppen. Højreklik på plottet og vælg Op i undermenuen Panorér. Plottet vil så blive flyttet opad. Det er naturligvis formodentlig nemmere at bruge genvejstasten som hører sammen med menupunktet. Dette gælder for de fleste af forstørrelses- og panoreringsfunktionerne. I dette tilfælde er genvejstasten Pil opad, så den hurtigste måde at flytte opad er at holde tasten Pil opad nede. For når som helst at gå tilbage til maksimal forstørrelse, højreklikkes på plottet og Forstør maksimalt vælges i undermenuen Forstør (eller tryk på genvejstasten M, som hører sammen med Forstør maksimalt).

Genopret størrelsen af plottet med effektspektre ved at højreklikke på plottet og afmarkere Maksimér.

Kig nu på plottene med Y-akser som hedder `Søjle 2` og `Søjle 3`. De er plot af henholdsvis pitch-gyro og roll-gyro, fra flyvningen af BOOMERANG 1998. Eftersom de to plot hører sammen, kan det være nyttigt at forstørre og panorere dem samtidigt. Klik på firkanterne som er i det øverste højre hjørne på de to plot. De vil nu få en mørk farve for at angive at de to plot hører sammen:

Bunden forstørrelse
Bunden forstørrelse

Inden vi forsøger at forstørre, skal vi fjerne alle plot udover de to vi arbejder med. Vælg Layouttilstand i menuen Plot eller klik på knappen i værktøjslinjen. Højreklik på plottet og vælg Fjern, for alle plot udover de to vi vil beholde. Højreklik derefter hvor som helst i nuværende vindue og vælg Ryd op i layout. Nu bør de to plot dele hele pladsen inde i vinduet. Gå tilbage til XY-museforstørrelse når du er færdig.

Forsøg nu forstørre på en del af det øverste plot. Du mærker at det nederste plot bliver tomt. Det skyldes at de nederste plot-akser er blevet ændret for at stemme med de øverste plotakser, og der er ingen data i netop dette område i det nederste plot. Tryk på M mens musemarkøren er over et af plottene for at gå tilbage til maksimal forstørrelse for begge plot. Hold nu Ctrl nede (det svarer til at vælge X-museforstørrelse i menuen Plot eller at klikke på knappen i værktøjslinjen). Musemarkøren ændrer form for visuel tilbagemelding. Mens du holder tasten Ctrl nede, tegnes et rektangel i det øverste plot. Bemærk at det prikkede rektangels højde er begrænset så kun X-aksen bliver forstørret. Nu viser begge plottene data når de forstørres, eftersom Y-aksen for et af plottene ikke ændredes.

Du kan hurtigt binde eller frigøre alle plot i vinduet ved at vælge Bunden forstørrelse i menuen Plot eller ved at klikke på knappen i værktøjslinjen.

Når du er færdig med at eksperimentere med forstørrelsesfunktionerne, kan du lukke &kst;. Der er ingen grund til at gemme plottene denne gang (hvis du ikke vil).

## En kort oversigt over dataobjekter

Der er mere i &kst; end kun enkel plotning og visning af data. I dataguiden har du allerede set at &kst; har mulighed for at oprette effektspektre for data. I virkeligheden kan &kst; også oprette andre dataobjekter såsom histogrammer, ligninger og plugin. Et værktøj som kaldes Datahåndtering kan hjælpe dig med at holde styr på alle dataobjekter du laver.

Start &kst; med filen `demo.kst`, som indgår i demonstrationspakken:

    kst demo.kst

Kst med demo.kst
Kst med demo.kst

Denne session i &kst; indeholder vektorer og andre dataobjekter som laves ud fra data i `gyrodata.dat`. Det øverste plot indeholder azimut-data, plottet i midten indeholder pitch-data i blåt, og det nederste plot viser effektspektrum for pitch-data i blåt. Lad os først undersøge plottene nøjere. Kobl de to øverste plot sammen med teknikken som du lærte dig i foregående afsnit. Hold derefter Ctrl nede for at bruge X-museforstørrelse. Forstør nu på et lille område i det øverste plot (eksempelvis fra 50000 til 53000), for at få begge bundne plot til at blive forstørret. Du mærker at den blå pitch-kurve har en negativ korrelation til den røde azimut-kurve. Det skyldes på at pitch-gyro var lidt roteret i forhold til azimut-aksen (med cirka 0,69 grader). Det sande pitch-værdi `p'` er:

hvor `p` er oprindeligt pitch-værdi. er rotationen af pitch-gyro i forhold til azimut-aksen, og `a` er azimut-gyro. `p'` tegnes op som den sorte kurve i det midterste plot. Effektspektrum for `p'` er den sorte kurve i plottet længst ned.

Lad os nu tage et kig på hvordan de tre plot oprettedes. For at vise datahåndteringen, vælg Datahåndtering... i menuen Data, eller klik på knappen i værktøjslinjen:

Datahåndtering
Datahåndtering

Datahåndteringen indeholder den fuldstændige liste med dataobjekert i nuværende session i &kst;. Den tillader dig også at redigere og oprette nye dataobjekter. Som du kan se, er der tre kurver (hver af dem oprettet fra et par vektorer), en ligning, to effektspektre og fire datavektorer på listen. Højreklik på C2-GY_PITCH og vælg W1-P1 i undermenuen Fjern fra plot. Det fjerner kurven fra plottet P1 i vinduet W1. Fjern også PSD2-V3-GY_PITCH fra plottet P3 i vinduet W1 med samme procedure. Nu vil kun de korrigerede kurver blive vist i plottene:

Kun korrigerede kurver
Kun korrigerede kurver

For at se hvordan det korrigerede pitch-gyro oprettedes, markeres C4-cleaned_pitch og der klikkes på knappen Redigér. Dialogen Redigér ligning vil blive vist:

Redigér ligning
Redigér ligning

Bemærk at ligningen som bruges til at beregne `p'` blev skrevet ind i tekstfeltet Ligning (approksimationen 1 bruges for `cos(-0,69)`). Tøv ikke med at eksperimentere med indstillingerne i dialogen. Klik på O.k. (for at gemme eventuelle ændringer som blev udført) eller Afbryd når du er færdig.

Bemærk at alle dataobjekter har et tal som angives i søjlen Antal brugte. Tallet angiver antal gange som dataobjektet enten bruges af andre dataobjekter eller af plot. Eftersom vi fjernede en kurve og et effektspektrum, skal i det mindste to dataobjekter have 0 angivet i søjlen. Klik på Ryd for at fjerne alle ubrugte dataobjekter permanent.

Klik på Luk for at lukke datahåndteringen. Du kan afslutte &kst; nu hvis du ønsker det.

## Et kig på plugin og begivenhedr

Vi slutter vor rejse gennem ved &kst; med at kigge på to specifikke typer af data: plugin og begivenhedsovervågning.

Et plugin er et fleksibelt dataobjekt, hvis opførsel helt og holdent afhænger af den specifikke plugin-fil som vælges. Plugin-filen kan være en som indgår i den almindelige distributionen af &kst;, eller en plugin-fil fra tredje part. Rent faktisk indgår instruktioner om hvordan man skriver og kompilerer egne plugin-filer i Kst's håndbog. Plugin lader &kst; udføre vilkårlige operationer på en datamængde, eftersom det eneste krav for plugin er at de tager imod et sæt inddatavektorer og skalarer, og giver et sæt uddatavektorer og skalarer.

Som et eksempel skal vi forsøge at tilpasse en enkelt linje til en lille mængde datapunkter. Start &kst; med et plot af første felt i datafilen `maxima.dat` som indgår i demonstrationspakken:

    kst -y 1 -d maxima.dat

Flaget `d` angiver at kun punkter skal tegnes, ikke linjer. Plottet med datapunkter skulle nu blive vist:

Plot med datapunkter
Plot med datapunkter

Åbn nu datahåndteringen, Klik på Plugin... i afsnittet Ny for at oprette et nyt plugin. Under Plugin-valg, vælges pluginnet Lineær tilpasning. Dette plugin kræver to inddatavektorer, en som indeholder X-værdier og en anden som indeholder Y-værdier for datapunkterne som skal tilpasses. Vælg V1-INDEX for Inddatavektor - X-felt og V2-1 for Inddatavektor - Y-felt. Klik derefter på O.k. Du bemærker at det nye plugin-objekt har oprettet slavevektorer for at opbevare uddata. Klik på Kurve... for at oprette en ny kurve ud fra uddatavektorerne. Vælg V1-INDEX for X-akse-vektor og P1-kstfit_linear_unweighted-Y Fitted for Y-akse-vektor. Vi vil placere kurven ovenpå datapunkterne i det eksisterende plot, så markér Placér i eksisterende plot og afmarkér Placér i nyt plot under Kurvens placering. Klik til sidst på O.k. for at oprette kurven. Luk datahåndteringen for at kigge på den tilpassede linje:

Tilpasset linje
Tilpasset linje

En procedure som ligner den du netop fulgte lader dig oprette og plotte uddata fra en hvilken som helst type af plugin-objekt. Der er dog en genvej til at oprette plugin for tilpasning. Ved at højreklikke på et plot vises den sammenhængsafhængige menu, som indeholder undermenuen Tilpas.... Ved at vælge en kurve i undermenuen, vises dialogen Tilpas funktion med standard X- og Y-vektorer. Efter pluginnet for indstilling er valgt, skabes plugin-objektet, kurven fra pluginnets uddata og kurven placeres i eksisterende plot ved at klikke på knappen O.k.

Lad os nu kigge på begivenheder. Begivenhedsobjekter overvåger ofte andre vektorer eller skalarer og udfører angivne handlinger når visse betingelser som berører disse vektorer eller skalarer er sande. Klik på Begivenhedsovervågning... i afsnittet Ny i datahåndteringen for at oprette en ny begivenhed:

Begivenhedsovervågning
Begivenhedsovervågning

Antag at pitch-gyroets data opdateres i realtid, og at vi vil blive underrettede så snart de korrigerede pitch-gyroværdier havner udenfor området `[-0,60, -0,40]`. For at indstill begivenheden på denne måde, indskrives følgende i tekstfeltet Udtryk:

`[C4-cleaned_pitch-sv]>(-0.40) | [C4-cleaned_pitch-sv]<(-0.60)`

Bemærk at alt som skrives ind som et udtryk skal være et Boolesk udtryk. Dette bestemte udtryk evalueres som sandt så snart en af ulighederne er sande. Vælg både Log som og Meddel, og skriv din e-mail-adresse til højre for afkrydsningsboksen Meddel. Klik på O.k., så oprettes begivenheden.

Vælg nu Fejlsøgning i Kst... i menuen Hjælp. Klik på fanebladet Log for at vise fejlsøgningsloggen. Hvis begivenheden er indstillet rigtigt, vil du se advarsler som angiver de X-værdier som begivenheden aktiveredes for. Kontrollér at værdierne groft set stemmer overens med dem du kunne vente ved at kigge på plottet:

Fejlsøgningslog
Fejlsøgningslog

Hvis pitch-gyro-ata opdateres i realtid, vil begivenhedsovervågningen også blive aktiveret for hver ny data når det behøves.

Når du er færdig, kan du afslutte &kst;.

## Konklusion

Dette afslutter gennemgangen af &kst;. Forhåbentlig har du fået tilstrækkeligt med kundskab til at kunne bruge &kst; bekvemt. Husk at vejledningen ikke dækker alle funktioner i &kst;. Der er stadigvæk meget at udforske og eksperimentere med. Kst's håndbog, tilgængelig via menuen Hjælp i &kst;, kan virke som en omfattande guide til begreber som strækker fra grundlæggende vindueslayout til at oprette egne plugin og læsere af datakilder. Du opmuntres til at bruge &kst; på interessante og nye måder: du kommer formodentlig til at mærke at det ikke kun opfylder, men overtræffer dine behov og krav.

## Medvirkende og licens

Denne gennemgang er baseret på den oprindelige hurtigtur gennem &kst;, skrevet Barth Netterfield.

&underFDL;