KST COMMAND LINE(1)

NAME
kst - A plotting and data viewing program

SYNOPSIS

The options are:

kst [Qt-options] [KDE-options] [options] [file...]

OPTIONS

[file...]
    A .kst file, or one or more data files. Supported formats are ASCII columns, BOOMERANG frame files, BLAST dirfile files, and other optionally supported types. A .kst files stores all options that can be set by other flags. The following flags can be used to override the options set in the .kst file: -F datafile, -n NS, -s NS, -f F0, -a. The rest can not be overridden. If an override flag is given, it is applied to all vectors in the plot. ASCII data from stdin can be plotted by including "stdin" in the list [file...].

-y Y
    The source for the Y axis data. For ASCII files, this is the column. For binary files, this is the field name. To plot multiple curves, this may be specified multiple times. The same source file, sample ranges, and X axis data are assumed.

--ye equation
    The values for the Y axis data are calculated from the equation specified. Multiple equations are allowed.

--xe X
    Use equation x0:x1:n to specify the X vector (INDEX). x0:x1 specifies the range of the vector, and n specifies the the number of values in X vector. e.g. -10:10:21 creates this static vector: X = {-10,-9,-8,...0...8,9,10}

-E text
    Pass argument to extension. text is of format extensionname:argumentlist e.g. kst -E js:"loadScript('intplTest.js')"

-e E
    Error bars for Y axis data. For ASCII file, refer to the column holding the data. For binary files use the field name. If multiple -y Y options are given, this may also be used multiple times. Individual Y entries are associated in order with multiple E entries.

-x X
    The source for the X axis data. For ASCII files, this is the column. For readata files, this is the field name. If this option is not specified, the row number in the file is used. This option can only be given once.

-z Z
    The source for the Z matrix data (which gets displayed as an image). For ASCII files, this is the column containing the z data. For other optional formats (HEALPix, FITS image, etc), this is the name of the desired matrix field, as displayed in the matrix dialog. Some matrix-compatible datasources also allow using an alias which is the number of the desired matrix field. To plot multiple matrices, this may be specified multiple times.

-p P
    The source for power spectra. For ASCII files, this is the column. For binary files, this is the field name. To plot power spectra of multiple curves, this may be specified multiple times. The same source file, sample ranges and fft lengths are used for all Power Spectra requested from the command line.

-l P
    The length of the FFT used in power specra estimation is 2^P.

-r f
    Specify sample rate: f for power spectrum

--ru U
    Specify the units U for psd sample rate

--yu U
    Specify the units U for psd sample rate

-h H
    The source for histograms. For ASCII files, this is the column. For binary files, this is the field name. Multiple histograms can be defined from the command line.

-m NC
    Used when multiple curves have been defined. Rather than plotting all curves in the same plot, plot each in its own plot,

-f F0
    The starting frame number (for readdata files) or row (for ASCII files) to read.

-n  The number of frames (for readdata files) or rows (for ASCII files) to read.

-s NS
    The number of frames or rows to skip each read. This is useful when working with very large data files, to speed up response and conserve memory, in the case that the data are slowly varying.

-g  Provide a legend box

-w file
    Display the data wizard

--nq
    Bypass the quickstart dialog

-a  Used in with the -s NS: rather than skipping each NS frames, average them. This provides a combination of very basic high pass filtering, and memory conservation.

-F Datafile
    Override the file to read the data from for all vectors listed in the .kst file. Can only be used in conjunction with a kst file.

--print psfile
    Rather than displaying the plot, export the image to a postscript file and exit. *BUG note: even though no windows are opened on screen, access to the X server is still required.*

--png pngfile
    Rather than displaying the plot, export the image to a png file of dimensions 640x480 and exit. *BUG note: even though no windows are opened on screen, access to the X server is still required.*

COMMAND LINE EXAMPLES

Several examples of typical use follow.

To plot column 1 a file (tmp.dat) of ASCII data:

    kst -y 1 tmp.dat

To plot column 2, 3, and 4 vs. column 1 of an ASCII file, in 1 plot:

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

To plot column 2, 3, and 4 vs. column 1 of an ASCII file, in 3 plots, arranged in 1 column:

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

To plot 500 rows of column 2 of an ASCII file, starting at line 100:

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

To plot the first 100,000 rows of column 2 of an ASCII file, averaging every 100 rows:

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

Using command to plot a spectrum from a data field of an ASCII data file with sample rate = 10HZ and FFT length = 2^14

    kst -p 2 /usr/share/apps/kst/tutorial/gyrodata.dat -r 10 -l 14

(Using optional HEALPix Data Source) To plot the first 3 maps in a HEALPix FITS file in a 2x2 grid:

    kst -z 1 -z 2 -z 3 -m 2 healpix_example_sm.fits

(Using optional HEALPix Data Source) To plot a map with a specific field name in a HEALPix FITS file:

    kst -z "1 - TEMPERATURE (Kelvin)" healpix_example_sm.fits

AUTHORS
Duncan Hanson, Rick Chern, Philip Rodrigues, Barth Netterfield, Yiwen Mao.