Barth
Netterfield

    kst@omega.astro.utoronto.ca

# Användning av kommandorad och exempel

En typisk användning av Kst är från kommandoraden för att skapa X-Y diagram av datafiler. Kst kan läsa ASCII-data, eller binärfiler som fungerar med readdata.

## Kommandoradsväljare

Väljarna är:

    kst Qt-väljare KDE-väljare väljare fil

`[fil...]`

  En .kst-fil, eller en eller flera datafiler. Format som stöds är ASCII-kolumner, BOOMERANG postfiler, eller BLAST dirfile-filer. En .kst-fil lagrar alla alternativ som kan anges med andra väljare. Följande väljare kan användas för att överskrida alternativen i .kst-filen: `-F datafile`, `-n NS`, `-s NS`, `-f F0`, `-a`. Övriga kan inte överskridas. Om en överskridande väljare anges, gäller den alla vektorer i diagrammet.

  ASCII-data från standardinmatningen kan ritas upp genom att ta med "stdin" i listan `[fil...]`.

`-y Y`

  Källan för Y-axelns data. För ASCII-filer är det kolumnen. För binärfiler är det fältnamnet. För att rita upp flera kurvor, kan detta anges flera gånger. Samma källfil, samplingsintervall och X-axeldata antas.

`-e E`

  Felstaplar för Y-axelns data. För ASCII-filer ange kolumnen som innehåller data. Använd fältnamnet för binärfiler. Om flera `-y Y` väljare anges, kan detta också användas flera gånger. Individuella Y väljare kopplas ihop i ordning med flera E väljare.

`-x X`

  Källan för X-axelns data. För ASCII-filer är det kolumnen. För readdata-filer är det fältnamnet. Om väljaren inte anges, används radnumret i filen. Väljaren kan bara anges en gång.

`-p P`

  Källan för effektspektrum. För ASCII-filer är det kolumnen. För binärfiler är det fältnamnet. För att rita upp flera effektspektrum för flera kurvor, kan detta anges flera gånger. Samma källfil, samplingsintervall och FFT-längder används för varje effektspektrum som begärs från kommandoraden.

`-l P`

  Längden på den FFT som används i uppskattningar av effektspektrum är 2^P.

`-h H`

  Källan för histogram. För ASCII-filer är det kolumnen. För binärfiler är det fältnamnet. Flera histogram kan definieras från kommandoraden.

`-m NC`

  Används när flera kurvor har definierats. Istället för att rita upp alla kurvor i samma diagram, rita upp var och en i ett eget diagram.

`-f F0`

  Första postnumret (för readdata-filer) eller raden (för ASCII-filer) som ska läsas.

`-n`

  Antal poster (för readdata-filer) eller rader (för ASCII-filer) som ska läsas.

`-s NS`

  Antal poster eller rader som ska hoppas över vid varje inläsning. Detta är användbart vid arbete med mycket stora datafiler, för att snabba upp svarstider och spara minne, i fallet då data varierar långsamt.

`-a`

  Används tillsammans med väljaren `-S NS`: Istället för att hoppa över varje NS-post, medelvärdesbilda dem. Det ger en kombination av mycket elementär högpassfiltrering, och minskning av minnesbehovet.

`-F datafil`

  Överskrid filen som data ska läsas från för alla vektorer som anges i .kst-filen. Kan bara användas ihop med en kst-fil.

`--print psfil`

  Istället för att visa diagrammet, exportera bilden till en Postskript-fil och avsluta. Felinformation: Även om inga fönster visas på skärmen, krävs ändå åtkomst till X-servern.

`--png pngfil`

  Istället för att visa diagrammet, exportera bilden till en PNG-fil med storleken 640x480 och avsluta. Felinformation: Även om inga fönster visas på skärmen, krävs ändå åtkomst till X-servern.

## Exempel på kommandorader

Flera exempel på typisk användning följer.

För att rita upp kolumn 1 i filen (tmp.dat) med ASCII-data:

    kst -y 1 tmp.dat

För att rita upp kolumn 2, 3 och 4 mot kolumn 1 från en ASCII-fil i ett diagram:

    kst -x 1 -y 2 -y 3 -y 4 tmp.dat

För att rita upp kolumn 2, 3 och 4 mot kolumn 1 från en ASCII-fil i tre diagram, arrangerade i en kolumn:

    kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat

För att rita upp 500 rader av kolumn 2 från en ASCII-fil, med början på rad 100:

    kst -y 2 -f 100 -n 500 tmp.dat

För att rita upp de första 100 000 raderna av kolumn 2 från en ASCII-fil, med medelvärdesbildning av var 100:e rad:

    kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat