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 gennemgang bruger en demonstrationspakke med datafiler som installeres med Kst i $KDEDIR/share/apps/kst/tutorial, hvor $KDEDIR er stedet hvor KDE er installeret på dit system (du kan finde det med kommandoen kde-config --prefix).

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:

---

---